

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

# 使用 Amazon QuickSight API
<a name="qs-using-the-quicksight-api"></a>

接下來，您可以了解如何開始使用 Amazon QuickSight API。

**Topics**
+ [提出 API 請求](qs-api-making-api-requests.md)
+ [Amazon Resource Name (ARN) QuickSight](qs-arns.md)
+ [Amazon 的許可 QuickSight 資源](qs-api-permissions.md)
+ [亞馬遜 QuickSight API 錯誤](qs-api-errors.md)

# 提出 API 請求
<a name="qs-api-making-api-requests"></a>

我們提供 Amazon API QuickSight，以及 Amazon SpKs，可讓您存取 Amazon Simple 的 Amazon SDK QuickSight 從您慣用的程式設計語言。使用 Amazon QuickSight，您可以使用 Amazon 開發套件來管理部署的某些層面。

若要監控對 Amazon 所做的呼叫 QuickSight API 為您的帳戶，您可以使用AWS CloudTrail。CloudTrail 可以監控所做的呼叫AWS 管理主控台、命令列工具和其他服務。如需詳細資訊，請參閱 [AWS CloudTrail 使用者指南](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。

**Topics**
+ [前準備知識](#qs-api-required-knowledge)
+ [Amazon 的可用 API 操作 QuickSight](#qs-api-using-libraries)

## 前準備知識
<a name="qs-api-required-knowledge"></a>

如果您打算訪問亞馬遜 QuickSight 透過 API，您應熟悉下列項目：
+ JSON
+ Web 服務
+ HTTP 請求
+ 一種或多種程式設計語言，例如 JavaScript、、、、、、、、、、、、、、、、Python，，

我們建議您造訪AWS [資源中心入門](https://aws.amazon.com//getting-started/tools-sdks/)了解 Amazon 軟體開發套件和工具包所提供的功能。

雖然您可以使用終端機和您最喜愛的文字編輯器，但是您可能會從整合式開發環境 (IDE) 中獲得的視覺化 UI 體驗中受益。我們在中提供 IDE 的列表*AWS資源中心入門*中的[IDE 和 IDE 工具組](https://aws.amazon.com//getting-started/tools-sdks/#IDE_and_IDE_Toolkits)區段。本網站提供AWS您可以為偏好的 IDE 下載的工具包。有些 IDE 也提供教學課程，協助您進一步了解程式設計語言。

## Amazon 的可用 API 操作 QuickSight
<a name="qs-api-using-libraries"></a>

亞馬遜 QuickSight API 作業提供：
+ 使用者和群組管理
+ 資料管理 (資料來源、資料集、範本和 SPICE 擷取)
+ 儀表板和分析管理
+ 範本管理
+ 許可管理
+ 客製化管理

AWS提供程式庫、範本程式碼、範本程式碼、範本程式碼、範本程式碼、教學與其他資源。這些程式庫提供可自動處理任務的基本功能，例如密碼編譯簽署請求、重試請求，以及處理錯誤回應。這些程式庫可讓您輕鬆開始使用。

如需下載 Amazon 開發套件的詳細資訊，請參閱[Amazon 開發套件和工具](https://aws.amazon.com/tools/)。以下連結是可用的特定語言 API 文件的範例。

**AWS Command Line Interface**
+ [AWS CLI QuickSight 命令參考](https://docs.aws.amazon.com//cli/latest/reference/quicksight/index.html)
+ 《[AWS CLI 使用者指南](https://docs.aws.amazon.com//cli/latest/userguide/)》
+ [AWS CLI 命令參考](https://docs.aws.amazon.com//cli/latest/reference/)

**適用於 .NET 的 AWS SDK**
+ [亚马逊。快速视线](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html)
+ [亞馬遜快速視野](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html)

**適用於 C\$1\$1 的 AWS SDK**
+ [AWS::QuickSight::QuickSightClient 類別參考](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html)

**適用於 Go 的 AWS SDK**
+ [quicksight](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/)

**適用於 Java 的 AWS SDK**
+ [QuickSightClient](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/package-frame.html)
+ [QuickSightModel](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/model/package-frame.html)

**適用於 JavaScript 的 AWS SDK**
+ [QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html)

**適用於 PHP 的 AWS SDK**
+ [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html)

**適用於 Python (Boto3) 的 AWS SDK**
+ [QuickSight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html)

**適用於 Ruby 的 AWS SDK**
+ [AWS::QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html)

# Amazon Resource Name (ARN) QuickSight
<a name="qs-arns"></a>

Amazon Resource Name (ARN) 唯一識別 AWS 資源。ARN 明確識別所有資源AWS例如，在 IAM 政策、Amazon Relational Database Service (Amazon RDS) 標籤和 API 呼叫。若要擷取 Amazon 的 ARN QuickSight資源，您可以使用`Describe`對相關資源的操作。

您可以使用此部分來了解 ARN 的運作方式。這裡提供的材料是專門針對亞馬遜的示例 QuickSight。

**Topics**
+ [ARN 格式](qs-arn-format.md)
+ [亞馬遜 QuickSight 資源 ARN](qs-resource-arns.md)

# ARN 格式
<a name="qs-arn-format"></a>

ARN 由冒號分隔，並由*段*，這是由冒號分隔的部分（`:`。ARN 的段中使用的特定組件和值取決於哪一個AWSARN 所用的服務。下列範例會顯示 ARN 的建構方法。

```
arn:partition:service:region:account-id:resource-id
arn:partition:service:region:account-id:resource-type/resource-id
arn:partition:service:region:account-id:resource-type:resource-id
```

這些 ARN 包含下列區段：

***`partition`***— 資源所在的分割區。適用於標準AWS 區域，分區是*aws*。如果您有其他分割區的資源，則該分割區為*aws 分區名稱*。例如，中國 (北京) 區域的資源分割區，即為 `aws-cn`。

***`service`***— 識別的服務命名空間AWS產品。例如：`quicksight`標識亞馬遜 QuickSight、`s3`識別 Amazon S3，`iam`辨識 IAM，以此類推。

***`region`***— 該AWS 區域資源所在。某些資源的 ARN 不需要AWS 區域，因此在某些情況下可以省略此元件，例如 S3 的情況。亞馬遜 QuickSight ARN 需要AWS 區域。

***`account-id`***— 的 IDAWS 帳戶擁有資源。當您在 ARN 或 API 作業中使用帳號時，您可以省略連字號 (例如，123456789012)。某些資源的 ARN 不需要帳號，因此可以省略此元件。亞馬遜 QuickSight ARN 需要AWS 帳戶數字。不過，帳號和AWS 區域從 S3 儲存貯體 ARN 省略，如下所示。

```
arn:aws:s3:::bucket_name
arn:aws:s3:::bucket_name/key_name
```

***`resource`*或者*`resource-type`***— 這部分的 ARN 內容依服務而異。資源識別符可以是資源的名稱或 ID (例如，`user/Bob`或者`instance/i-1234567890abcdef0`) 或資源路徑。例如，某些資源識別碼包含父資源 (`sub-resource-type/parent-resource/sub-resource`) 或限定詞，例如版本 (*resource-type*：*resource-type*：*修飾語*。

有些資源 ARN 可以包含路徑、變數或萬用字元。

您可以使用萬用字元 (`*`和`?`) 在任何 ARN 區段內。星號 (`*`) 代表零或更多字元的任何組合，而問號 (`?`) 則代表任何單一字元。您可以在每個區段使用多個 \$1 或 ? 字元，但萬用字元不能跨區段。如果您使用 ARN 獲得權限，請避免使用`*`萬用字元 (如果可能)，以限制只存取必要元素。以下是使用路徑、萬用字元和變數的一些範例。

在下列範例中，我們使用 S3 ARN。當您在 IAM 政策中授予 S3 許可時，可以使用此功能。這 S3 ARN 顯示一個路徑和文件被指定。

**注意**  
術語長期*金鑰名稱*用於描述之後看起來像路徑和文件`bucketname/`。這些被稱為鍵名稱，因為存儲桶實際上並不包含像計算機文件系統中使用的那些文件夾結構。而是斜線 (`/`) 是一個分隔符，有助於使桶的組織更直觀。在此情況下，儲存貯體名稱為`examplebucket`，並且金鑰名稱是`developers/design_info.doc`。

```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json
```

如果您想要識別值區中的所有物件，可以使用萬用字元來指示所有金鑰名稱 (或路徑和檔案) 都包含在 ARN 中，如下所示。

```
arn:aws:s3:::examplebucket/*
```

您可以使用索引鍵名稱的一部分加上萬用字元來識別以特定模式開頭的所有物件。在這種情況下，它類似於一個文件夾名稱加一個通配符，如下所示。但是，此 ARN 還包含其中的任何「子文件夾」`my-data`。

```
arn:aws:s3:::examplebucket/my-data/*
```

您可以新增萬用字元來指定部分名稱。這一個標識任何以`my-data/sales-export*`。

```
arn:aws:s3:::examplebucket/my-data/sales-export*
```

在這種情況下，使用此萬用字元指定會包含具有如下名稱的物件：
+ `my-data/sales-export-1.xlsx`
+ `my-data/sales-export-new.txt`
+ `my-data/sales-export-2019/file1.txt`

您可以組合或單獨使用這兩種類型的萬用字元 (星號和問號)，如下所示。

```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.*

arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.*
```

或者，如果您想要面向未來的 ARN，您可以用通配符替換整個年份，而不僅僅是使用最後兩個數字的通配符。

```
arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.*
```

若要閱讀有關 S3 ARN 的更多資訊，請參閱[在政策中指定資源](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)和[物件金鑰與中繼資料](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)中的*Amazon Simple Storage Service 使用者指南。*

# 亞馬遜 QuickSight 資源 ARN
<a name="qs-resource-arns"></a>

以下資源類型由亞馬遜定義 QuickSight：使用者、群組和儀表板。這些在亞馬遜使用 QuickSight API 調用和作為 IAM 權限語句的元素。若要尋找up-to-date Amazon 資訊 QuickSight (服務字首：快速檢視) 可在 IAM 許可政策中使用的資源、動作和條件內容金鑰，請參閱[Amazon 的動作、資源和條件金鑰 QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)中的*適用於的用戶指南。*


| 資源類型 | ARN 格式 | 條件索引鍵 | 
| --- | --- | --- | 
| 使用者 | arn: \$1 \$1Partition\$1: \$1 \$1Partition\$1ResourceId\$1 | N/A | 
| 群組 | arn: \$1 \$1Partition\$1: \$1 \$1Partition\$1ResourceId\$1 | N/A | 
| 儀表板 | arn: \$1 \$1Partition\$1: \$1 \$1Partition\$1ResourceId\$1 | N/A | 

資源 ARN 是根據描述資源的區段建構而成。例如，用於分析的資源 ARN 由下列區段組成。

```
arn:<partition>:quicksight:<aws-region>:<aws-account-id>:<resource-type>/<resource-id>
```

區段的定義如下：
+ *`partition`*— 例如，`aws`或者`aws-cn`。
+ *`aws-region`*— 該AWS 區域包含資源。
+ *`aws-account-id`*— 該AWS 帳戶包含資源。這不包括連字符。
+ *`resource-type`*— 資源的類型。在此範例中，這是`analyses`。對於儀表板，它是`dashboard`。
+ *`resource-id`*— 特定資源的唯一識別符。

所以此AWS 區域當您使用亞馬遜時，資源類型和資源 ID 在資源的 URL 中標識 QuickSight 主控台。例如，假設這是您想要 ARN 的分析 URL。

```
https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```

AWS 區域 為 `us-east-2`。resource-type 是`analysis`。此網址中的資源 ID 為`4036e682-7de6-4c05-8a76-be51b9ec9b29`。若您的帳戶號號碼為`111122223333`，則此分析的 ARN 如下所示。

```
arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```

若要取得您的AWS 帳戶number, 請聯絡系統管理員。

# Amazon 的許可 QuickSight 資源
<a name="qs-api-permissions"></a>

如果您不確定必要許可是什麼，您可以嘗試呼叫。然後，用戶端會告訴您遺失的權限是什麼。您可以使用星號 (`*`) 在權限原則的 [資源] 欄位中，而不是指定明確的資源。但建議您盡可能限制每個許可。您可以在政策中使用資源的 Amazon Amazon 指定或排除資源，藉此限制使用者存取。 QuickSight ARN。若要擷取 Amazon 的 ARN QuickSight 資源，使用`Describe`對相關資源的操作。

在您可以致電 Amazon QuickSight API 操作，您需要`quicksight:operation-name`附加到您的 IAM 身份的策略中的權限。例如，若要呼叫 `list-users`，您必須具備 `quicksight:ListUsers` 許可。同樣的模式適用於所有操作。如果您嘗試呼叫，您沒有呼叫的許可，產生的錯誤會向您顯示缺少的許可。但強烈建議您盡可能限制每個許可。

您可以在 IAM 中新增條件，進一步限制某些情況下的 API 存取。例如，當您新增 `User1` 到 `Group1`，主要資源為 `Group1`。您可以允許或拒絕存取特定群組。或者您也可以編輯 Amazon QuickSight 艾姆基`quicksight:UserName`，以新增條件，以允許或防止特定使用者新增至該群組。

如需詳細資訊，請參閱下列內容：
+ [動作、資源及條件索引鍵](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_amazonquicksight.html)
+ [IAMJSON 政策元素](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html)



看到最多 up-to-date 亚马逊列表 QuickSight 動作，請參閱[Amazon 定義的動作 QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html#amazonquicksight-actions-as-permissions)中的*IAM User Guide*。

## 最佳實務
<a name="qs-api-permissions-best-practices"></a>

亞馬遜 QuickSight 可讓您與最多 100 位主參與者共用分析、控制面板、範本和主題。一個*主要*可為下列其中之一：
+ Amazon Resource Name (ARN) 的 Amazon Resource Name (ARN) QuickSight 與資料來源或資料集相關聯的使用者或群組。(這是常見的)。
+ Amazon 的 ARN QuickSight 與分析、儀表板、範本或主題相關聯的使用者、群組或命名空間。(這是常見的)。
+ ARN 的 ARNAWS帳戶根：這是一個 IAM ARN，而不是一個 QuickSight ARN。使用此選項僅可共用資源 (範本)AWS帳戶。(這是最少見的)。

如果您想要與更多主參與者共用這些資源，請考慮在群組或命名空間層級指派資源權限。例如，如果您將使用者新增至群組並將資源共用至群組，即使該群組共用給群組中的每個人，該群組仍會計為一個主參與者。

# 亞馬遜 QuickSight API 錯誤
<a name="qs-api-errors"></a>

亞馬遜 QuickSight 有兩種錯誤代碼類型：
+ **客戶端錯誤**— 這些錯誤通常由客戶端所做的事情造成。例如，在請求中指定不正確或無效的參數，或者針對未擁有使用動作或資源之許可的使用者使用動作或資源。這些錯誤會伴隨 400 系列的 HTTP 回應代碼。
+ **伺服器錯誤**— 這些錯誤通常由AWS伺服器端問題。這些錯誤會伴隨 500 系列的 HTTP 回應代碼。

**Topics**
+ [常見的用戶端錯誤](#qs-api-errors-client)
+ [用戶端錯誤](#qs-api-errors-table-client)
+ [伺服器錯誤](#qs-api-errors-table-server)

## 常見的用戶端錯誤
<a name="qs-api-errors-client"></a>

接下來，您可以看到所有動作可傳回的常見用戶端錯誤清單。


| 錯誤代碼 | 描述 | 
| --- | --- | 
| AuthFailure | 提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶被授權使用亞馬遜 QuickSight 服務，您的信用卡詳細信息是正確的，以及您使用正確的存取金鑰。 | 
| Blocked | 您的帳戶目前已封鎖。如有任何問題，請聯絡 aws-verification@amazon.com。 | 
| DryRunOperation | 使用者擁有必要許可，因此請求會成功，但其中使用了 DryRun 參數。 | 
| IdempotentParameterMismatch | 請求使用了與先前請求 (但為非相同請求) 相同的用戶端字符。請勿以不同請求重複使用用戶端字符，除非請求相同。 | 
| IncompleteSignature | 請求簽章未符合AWS標準。 | 
| InvalidAction | 請求的動作或操作無效。確認已正確輸入動作。 | 
| InvalidCharacter | 指字的字元無效。 | 
| InvalidClientTokenId | 提供的 X.509 憑證或 AWS 存取金鑰 ID 不存在於我們的記錄中。 | 
| InvalidPaginationToken | 指定的分頁字符無效或已過期。 | 
| InvalidParameter | 在請求中指定的一個參數無效、未支援或無法使用。傳回之訊息會提供錯誤值的說明。 | 
| InvalidParameterCombination | 指出不正確的參數組合或遺漏的參數。 | 
| InvalidParameterValue | 在參數中指定的一個值無效、未支援或無法使用。請確認您使用完整的 ID 來指定資源。傳回之訊息會提供錯誤值的說明。 | 
| InvalidQueryParameter | 所以此AWS查詢字串格式不正確或未遵循AWS標準。 | 
| MalformedQueryString | 查詢字串包含語法錯誤。 | 
| MissingAction | 請求中遺失動作或必要參數。 | 
| MissingAuthenticationToken | 請求必須包含有效 (已註冊) 的 AWS 存取金鑰 ID 或 X.509 憑證。 | 
| MissingParameter | 請求缺少必要參數。請確認您已針對請求提供了所有必要參數，例如資源 ID。 | 
| OptInRequired | 您未獲授權使用請求的服務。請確認您已訂閱您嘗試使用的服務。若您是初次使用AWS，在驗證您的信用卡詳細資訊時，您的帳戶可能會需要一些時間才能啟用。 | 
| PendingVerification | 您的帳戶正在等待驗證。在驗證程序完成之前，您可能無法透過此帳戶執行請求。如有任何問題，請聯絡 [AWS 支援](https://console.aws.amazon.com/support/home#/)。 | 
| RequestExpired | 請求送達服務已超過請求上之後或請求過期日期之後的 15 分鐘後或請求過期日期 (例如預先簽章的 URL)。或者請求上的日期戳記 future 超過 15 分鐘。如果您使用的是暫時安全登入資料，如果登入資料已過期，此錯誤也可能會發生。如需詳細資訊，請參閱《IAM 使用者指南》中的[臨時安全登入資料](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)。 | 
| UnauthorizedOperation | 未授權您執行此操作。請檢查您的 IAM 政策，並確認您使用正確的存取金鑰。 | 
| UnknownParameter | 提供的參數未知或無法辨識。可能導致此錯誤的請求包括提供拼寫錯誤的參數或指定之 API 版本不支援的參數。 | 
| UnsupportedInstanceAttribute | 指定的屬性無法修改。 | 
| <a name="UnsupportedOperation"></a> UnsupportedOperation  | 指定的請求包含不支援的操作。傳回的訊息會提供未支援操作的詳細資訊。 | 
| UnsupportedProtocol | 不支援您使用的通訊協定。 | 
| ValidationError | 輸入不符合由指定的限制AWSService (服務。 | 

## 用戶端錯誤
<a name="qs-api-errors-table-client"></a>

接下來，您可以看到 Amazon 的用戶端錯誤清單，且這些錯誤列表 QuickSight API 操作。


| 錯誤代碼 | 描述 | 
| --- | --- | 
| AccessDeniedException | 您無法存取。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶被授權使用亞馬遜 QuickSight 服務，您的政策擁有正確的許可，以及您使用正確的存取金鑰。 | 
| DomainNotWhiteListedException | 指定的網域不在允許清單中。內嵌儀表板的所有網域都必須由 Amazon 新增至核准的清單 QuickSight admin (admin)。 | 
| IdentityTypeNotSupportedException | 不支援指定的身分類型。支援的身分類型包括：IAMAND 快速視覺。 | 
| InvalidNextTokenException | NextToken 值無效。 | 
| InvalidParameterValueException | 一個或多個參數的值無效。 | 
| PreconditionNotMetException | 未滿足一個或多個先決條件。 | 
| QuickSightUserNotFoundException | 找不到使用者。這可能發生於需要根據所提供使用者名稱尋找使用者的任何操作，例如 DeleteUser、DescribeUser，以此類推。 | 
| ResourceExistsException | 指定的資源不存在。 | 
| ResourceNotFoundException | 無法找到一個或多個資源。 | 
| SessionLifetimeInMinutesInvalidException | 針對工作階段生命週期指定的分鐘數無效。工作階段生命週期必須介於 15 和 600 分鐘。 | 
| ThrottlingException | 存取已調節。 | 
| UnsupportedUserEditionException | 表示您正在呼叫 Amazon 上的操作 QuickSight訂閱 (其版本不包括對該操作的支援)。亞馬遜 QuickSight 目前包含 Standard Edition (標準版) 和企業版 不是每個版本都會提供所有操作和功能。 | 

### 常見的用戶端錯誤原因
<a name="qs-api-errors-common-causes"></a>

可能會有數種原因導致您在執行請求時遇到錯誤。遵循這些準則，就可避免或輕易解決一些錯誤：
+ **指定AWS 帳戶ID 和命名空間**— 相關AWS 帳戶每個請求都必須提供 ID。命名空間必須設為 `default`。
+ **允許最終一致性**— 有些錯誤的原因是先前的請求尚未透過系統傳播。
+ **請求率之間使用睡眠間隔**— Amazon QuickSight API 請求會受到調節，以協助維持服務的效能。如果您的請求受到調節，則您會遇到錯誤。
+ **使用資源的完整 ID**— 指定資源時，請確認您使用其完整的 ID，而非其使用者提供的名稱或描述。
+ **檢查您的服務**— 請確認您已註冊您嘗試使用的所有服務。您可以前往以檢查您所註冊的服務**我的帳戶帳戶**的 區段[AWS首頁](https://aws.amazon.com/)。
+ **檢查您的許可**— 請確認您擁有執行請求的必要許可。
+ **檢查 VPC**— 某些資源無法在虛擬私有雲 (VPC) 之間共用，例如安全群組。
+ **檢查您的登入資料**— 請務必在提出要求時提供存取金鑰，並且已正確輸入認證。此外，如果您有超過一個帳戶，請確認您針對特定帳戶使用正確的登入資料。如果提供的登入資料不正確，您可能會遇到以下錯誤：`Client.AuthFailure`。

## 伺服器錯誤
<a name="qs-api-errors-table-server"></a>

接下來，您可以看到可由伺服器傳回的錯誤清單。


| 錯誤代碼 | 描述 | 
| --- | --- | 
| BatchClientRequestTokensNotDistinctException –  | 批次用戶端請求字符不是唯一的。 | 
| EmptyBatchRequestException | 批次請求為空。 | 
| InternalFailureException | 發生內部故障。 | 
| InternalServiceError | 服務發生內部錯誤。 | 
| InvalidBatchClientRequestTokenException | 所以此AWS此用戶端批次請求的請求字符無效。 | 
| InvalidParameterException | 一個或多個參數有無效值。 | 
| LimitExceededException | 已超過上限。 | 
| ResourceUnavailableException | 此資源目前無法使用。 | 
| TooManyEntriesInBatchRequestException | 此批次請求中有太多項目。 | 