本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# DeleteAnalysis
<a name="API_DeleteAnalysis"></a>

刪除 Amazon Resource (Amazon) QuickSight。您可以選擇性地包含復原視窗，在此期間您可以還原分析。如果您未指定復原時段值，則操作會預設 30 天。亞馬遜 QuickSight 將附加一個`DeletionTime`戳記到指定恢復窗口結束的響應。在恢復窗口結束時，亞馬遜 QuickSight 永久刪除分析。

在復原時段結束之前的任何時段，您都可以使用`RestoreAnalysis`API 操作以刪除`DeletionTime`戳記並取消刪除分析。分析在 API 中保持可見，直到它被刪除為止，因此您可以對其進行描述，但無法從中創建模板。

亞馬遜無法訪問計劃刪除的分析 QuickSight 主控台。若要在主控台中存取它，請將其還原。刪除分析並不會刪除您從中發佈的儀表板。

## 請求語法
<a name="API_DeleteAnalysis_RequestSyntax"></a>

```
DELETE /accounts/AwsAccountId/analyses/AnalysisId?force-delete-without-recovery=ForceDeleteWithoutRecovery&recovery-window-in-days=RecoveryWindowInDays HTTP/1.1
```

## URI 請求參數
<a name="API_DeleteAnalysis_RequestParameters"></a>

請求會使用下列 URI 參數。

 ** [AnalysisId](#API_DeleteAnalysis_RequestSyntax) **   <a name="QS-DeleteAnalysis-request-AnalysisId"></a>
您要刪除的分析。  
長度限制：長度下限為 1。長度上限為 2048。  
模式：`[\w\-]+`  
必要：是

 ** [AwsAccountId](#API_DeleteAnalysis_RequestSyntax) **   <a name="QS-DeleteAnalysis-request-AwsAccountId"></a>
的 IDAWS您要刪除分析的帳戶。  
長度限制：12。  
模式：`^[0-9]{12}$`  
必要：是

 ** [ForceDeleteWithoutRecovery](#API_DeleteAnalysis_RequestSyntax) **   <a name="QS-DeleteAnalysis-request-ForceDeleteWithoutRecovery"></a>
此選項的預設值`NoForceDeleteWithoutRecovery`。若要立即刪除分析，請加入`ForceDeleteWithoutRecovery`選項。刪除分析後就無法復原。

 ** [RecoveryWindowInDays](#API_DeleteAnalysis_RequestSyntax) **   <a name="QS-DeleteAnalysis-request-RecoveryWindowInDays"></a>
一個值，指定的天數，亞馬遜 QuickSight 在刪除分析之前等待。您無法使用此參數搭配`ForceDeleteWithoutRecovery`相同 API 呼叫中的選項。預設值為 30。  
有效範圍：最小值為 7。最大值為 30。

## 請求主體
<a name="API_DeleteAnalysis_RequestBody"></a>

請求沒有請求主體。

## 回應語法
<a name="API_DeleteAnalysis_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "AnalysisId": "string",
   "Arn": "string",
   "DeletionTime": number,
   "RequestId": "string"
}
```

## 回應元素
<a name="API_DeleteAnalysis_ResponseElements"></a>

如果動作成功，則服務傳回下列 HTTP 回應。

 ** [Status](#API_DeleteAnalysis_ResponseSyntax) **   <a name="QS-DeleteAnalysis-response-Status"></a>
請求的 HTTP 狀態。

服務會傳回下列 JSON 格式的資料。

 ** [AnalysisId](#API_DeleteAnalysis_ResponseSyntax) **   <a name="QS-DeleteAnalysis-response-AnalysisId"></a>
刪除分析的 ID。  
類型：字串  
長度限制：長度下限為 1。長度上限為 2048。  
模式：`[\w\-]+`

 ** [Arn](#API_DeleteAnalysis_ResponseSyntax) **   <a name="QS-DeleteAnalysis-response-Arn"></a>
刪除分析的 Amazon Resource Name (ARN)。  
類型：字串

 ** [DeletionTime](#API_DeleteAnalysis_ResponseSyntax) **   <a name="QS-DeleteAnalysis-response-DeletionTime"></a>
排定分析的刪除日期和時間。  
類型：時間戳記

 ** [RequestId](#API_DeleteAnalysis_ResponseSyntax) **   <a name="QS-DeleteAnalysis-response-RequestId"></a>
所以此AWS此操作的請求 ID。  
類型：字串

## 錯誤
<a name="API_DeleteAnalysis_Errors"></a>

如需所有動作常見的錯誤相關資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** ConflictException **   
更新或刪除資源可能會導致不一致的狀態。  
HTTP 狀態碼：HTTP 狀態碼：409

 ** InternalFailureException **   
發生內部故障。  
HTTP 狀態碼：HTTP 狀態碼：500

 ** InvalidParameterValueException **   
一或多個參數的值無效。  
HTTP 狀態碼：HTTP 狀態碼：400

 ** ResourceNotFoundException **   
無法找到一個或多個資源。  
HTTP 狀態碼：HTTP 狀態碼：404

 ** ThrottlingException **   
存取已調節。  
HTTP 狀態碼：HTTP 狀態碼：429

 ** UnsupportedUserEditionException **   
此錯誤表示您正在呼叫 Amazon Resource (Amazon) 的操作 QuickSight訂閱版本不包括對該操作的支持。Amazon QuickSight 目前包含 Standard Edition (企業版)。不是每個版本都會提供所有操作和功能。  
HTTP 狀態碼：HTTP 狀態碼：403

## 另請參閱
<a name="API_DeleteAnalysis_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列界面](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/DeleteAnalysis) 
+  [AWS適用於的 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/DeleteAnalysis) 
+  [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/DeleteAnalysis)