本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 亚马逊 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 | 请求到达服务的时间超过请求上的日期戳或请求到期日期（如针对预签名 URL）15 分钟。或者请求上的日期戳在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 | 输入未能满足AWS服务。。。。 | 

## 客户端错误
<a name="qs-api-errors-table-client"></a>

在下文中，您可以使用 Amazon 特定的客户端错误列表 QuickSight API。


| 错误代码 | 描述 | 
| --- | --- | 
| AccessDeniedException | 您无权访问此内容。无法验证提供的凭证。您可能无权执行请求。确保您的账户获得使用亚马逊的授权 QuickSight 服务，您的策略具有正确的权限，您使用的是正确的访问密钥。 | 
| DomainNotWhiteListedException | 指定的域不在允许列表上。Amazon 必须将嵌入控制面板的所有域添加到已批准列表 QuickSight admin。。 | 
| IdentityTypeNotSupportedException | 指定的身份类型不受支持。支持的身份类型包括：我和 QUICKSIGHT | 
| InvalidNextTokenException | NextToken 值无效。 | 
| InvalidParameterValueException | 一个或多个参数没有有效值。 | 
| PreconditionNotMetException | 未满足一个或多个先决条件。 | 
| QuickSightUserNotFoundException | 找不到用户。这可能发生在需要基于提供的用户名查找用户的任何操作中，如 DeleteUser、DescribeUser，等等。。。。。 | 
| ResourceExistsException | 指定的资源不存在。 | 
| ResourceNotFoundException | 无法找到一个或多个资源。 | 
| SessionLifetimeInMinutesInvalidException | 为会话生命周期指定的分钟数无效。会话生命周期必须介于 15 到 600 分钟之间。 | 
| ThrottlingException | 访问受限。 | 
| UnsupportedUserEditionException | 指示您正在 Amazon 上调用某个操作 QuickSight订阅中，版本不支持该操作。亚马逊 QuickSight 当前具有标准版和企业版。每个版本中并未提供所有操作和功能。 | 

### 客户端错误的常见原因
<a name="qs-api-errors-common-causes"></a>

执行请求时可能遇到错误的原因有很多。可以通过遵循以下准则来阻止或轻松解决一些错误：
+ **指定AWS 账户ID 和命名空间 ID。**— 相关AWS 账户每个请求都必须提供身份证件。命名空间必须设置为 `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 | 此批处理请求中的条目过多。 |