本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
亚马逊 QuickSight API 错误
亚马逊 QuickSight 具有两种错误代码:
-
客户端错误数— 这些错误一般由客户端执行的操作导致。例如,在请求中指定不正确或无效的参数,或者为无权使用操作或资源的用户使用操作或资源。这些错误伴随 400 系列的 HTTP 响应代码。
-
服务器错误数— 这些错误一般由AWS服务器端问题。这些错误伴随 500 系列的 HTTP 响应代码。
常见客户端错误
接下来,您可以找到所有操作可以返回的常见客户端错误列表。
错误代码 | 描述 |
---|---|
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 Support |
RequestExpired |
请求到达服务的时间超过请求上的日期戳或请求到期日期(如针对预签名 URL)15 分钟。或者请求上的日期戳在future 15 分钟以上。如果您使用的是临时安全凭证,则此错误还可能在凭证过期的情况下出现。有关更多信息,请参阅《IAM 用户指南》中的临时安全凭证。 |
UnauthorizedOperation |
您没有权限执行此操作。检查您的 IAM 策略,并确保您使用的是正确的访问密钥。 |
UnknownParameter |
提供的参数未知或无法识别。可能导致此错误的请求包括提供拼写错误的参数或指定 API 版本支持的参数。 |
UnsupportedInstanceAttribute |
指定的属性无法修改。 |
UnsupportedOperation |
指定的请求包含不受支持的操作。返回的消息提供不受支持的操作的详细信息。 |
UnsupportedProtocol |
您使用的协议不受支持。 |
ValidationError |
输入未能满足AWS服务。。。。 |
客户端错误
在下文中,您可以使用 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 当前具有标准版和企业版。每个版本中并未提供所有操作和功能。 |
客户端错误的常见原因
执行请求时可能遇到错误的原因有很多。可以通过遵循以下准则来阻止或轻松解决一些错误:
-
指定AWS 账户ID 和命名空间 ID。— 相关AWS 账户每个请求都必须提供身份证件。命名空间必须设置为
default
。 -
允许最终一致性— 由于之前的请求未在系统中彻底传播,因此导致了一些错误。
-
在请求速率之间使用休眠间隔— Amazon QuickSight 将阻止 API 请求,以帮助维护服务性能。如果您的请求受限,您将收到错误。
-
使用资源的完整 ID— 指定资源时,请确保使用资源的完整 ID,而不是用户提供的资源名称或描述。
-
检查您的服务。— 确保您已注册尝试使用的所有服务。您可以前往查看您注册的服务我的账户。的 部分AWS主页
. -
检查您的权限。— 确保您具有执行请求所需的权限。
-
检查您的 VPC。— VPC)之间不能共享某些资源,如安全组。
-
检查您的凭证。— 请确保您在提出请求时提供访问密钥,并且已正确输入凭据。此外,如果您有多个账户,请确保您使用的是特定账户的正确凭证。如果提供的凭证不正确,则可能会收到以下错误:
Client.AuthFailure
.
服务器错误
在下文中,您可以找到服务器会返回的错误列表。
错误代码 | 描述 |
---|---|
BatchClientRequestTokensNotDistinctException – | 批处理客户端请求令牌不唯一。 |
EmptyBatchRequestException | 批处理请求为空。 |
InternalFailureException | 出现内部故障。 |
InternalServiceError | 服务中存在内部错误。 |
InvalidBatchClientRequestTokenException | 这些区域有:AWS此客户端批处理请求的请求令牌无效。 |
InvalidParameterException | 一个或多个参数具有无效值。 |
LimitExceededException | 超出限制。 |
ResourceUnavailableException | 此资源当前不可用。 |
TooManyEntriesInBatchRequestException | 此批处理请求中的条目过多。 |