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

# 亞馬遜 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 | 此批次請求中有太多項目。 |