Amazon QuickSight API Errors
Amazon QuickSight has two types of error codes:
-
Client errors – These errors are usually caused by something the client did. An example is specifying an incorrect or invalid parameter in the request, or using an action or resource for a user that doesn't have permission to use the action or resource. These errors are accompanied by a 400-series HTTP response code.
-
Server errors – These errors are usually caused by an AWS server-side issue. These errors are accompanied by a 500-series HTTP response code.
Common Client Errors
Following, you can find a list of the common client errors that all actions can return.
| Error Code | Description |
|---|---|
AuthFailure |
The provided credentials could not be validated. You might not be authorized to carry out the request. Ensure that your account is authorized to use the Amazon QuickSight service, that your credit card details are correct, and that you are using the correct access keys. |
Blocked |
Your account is currently blocked. Contact Support |
DryRunOperation |
The user has the required permissions, so the request would have
succeeded, but the DryRun parameter was used. |
IdempotentParameterMismatch |
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. |
IncompleteSignature |
The request signature does not conform to AWS standards. |
InvalidAction |
The action or operation requested is not valid. Verify that the action is typed correctly. |
InvalidCharacter |
A specified character is invalid. |
InvalidClientTokenId |
The X.509 certificate or AWS access key ID provided does not exist in our records. |
InvalidPaginationToken |
The specified pagination token is not valid or is expired. |
InvalidParameter |
A parameter specified in a request is not valid, is unsupported, or cannot be used. The returned message provides an explanation of the error value. |
InvalidParameterCombination |
Indicates an incorrect combination of parameters, or a missing parameter. |
InvalidParameterValue |
A value specified in a parameter is not valid, is unsupported, or cannot be used. Ensure that you specify a resource by using its full ID. The returned message provides an explanation of the error value. |
InvalidQueryParameter |
The AWS query string is malformed or does not adhere to AWS standards. |
MalformedQueryString |
The query string contains a syntax error. |
MissingAction |
The request is missing an action or a required parameter. |
MissingAuthenticationToken |
The request must contain either a valid (registered) AWS access key ID or X.509 certificate. |
MissingParameter |
The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the resource ID. |
OptInRequired |
You are not authorized to use the requested service. Ensure that you have subscribed to the service you are trying to use. If you are new to AWS, your account might take some time to be activated while your credit card details are being verified. |
PendingVerification |
Your account is pending verification. Until the verification process is complete, you
might not be able to carry out requests with this account. If you
have questions, contact AWS Support |
RequestExpired |
The request reached the service more than 15 minutes after the date stamp on the request or the request expiration date (such as for presigned URLs). Or the date stamp on the request is more than 15 minutes in the future. If you're using temporary security credentials, this error can also occur if the credentials have expired. For more information, see Temporary Security Credentials in the IAM User Guide. |
UnauthorizedOperation |
You are not authorized to perform this operation. Check your IAM policies, and ensure that you are using the correct access keys. |
UnknownParameter |
An unknown or unrecognized parameter was supplied. Requests that could cause this error include supplying a misspelled parameter or a parameter that is not supported for the specified API version. |
UnsupportedInstanceAttribute |
The specified attribute cannot be modified. |
UnsupportedOperation |
The specified request includes an unsupported operation. The returned message provides details of the unsupported operation. |
UnsupportedProtocol |
The protocol you used is unsupported. |
ValidationError |
The input fails to satisfy the constraints specified by an AWS service. |
Client Errors
Following, you can find a list of client errors that are specific to Amazon QuickSight API operations.
| Error Code | Description |
|---|---|
| AccessDeniedException | You don't have access to this. The provided credentials could not be validated. You might not be authorized to carry out the request. Ensure that your account is authorized to use the Amazon QuickSight service, that your policies have the correct permissions, and that you are using the correct access keys. |
| DomainNotWhiteListedException | The domain specified is not on the allowlist. All domains for embedded dashboards must be added to the approved list by an Amazon QuickSight admin. |
| IdentityTypeNotSupportedException | The identity type specified is not supported. Supported identity types include: IAMand QUICKSIGHT. |
| InvalidNextTokenException | The NextToken value isn't valid. |
| InvalidParameterValueException | One or more parameters don't have a valid value. |
| PreconditionNotMetException | One or more preconditions aren't met. |
| QuickSightUserNotFoundException | The user is not found. This could happen in any operation that requires finding a user based on the provided user name, such as DeleteUser, DescribeUser, and so on. |
| ResourceExistsException | The resource specified doesn't exist. |
| ResourceNotFoundException | One or more resources couldn't be found. |
| SessionLifetimeInMinutesInvalidException | The number of minutes specified for the lifetime of a session is invalid. The session lifetime must be between 15 and 600 minutes. |
| ThrottlingException | Access is throttled. |
| UnsupportedUserEditionException | Indicates that you are calling an operation on an Amazon QuickSight subscription where the edition does not include support for that operation. Amazon QuickSight currently has Standard Edition and Enterprise Edition. Not every operation and capability is available in every edition. |
Common Causes of Client Errors
There are a number of reasons that you might encounter an error while performing a request. Some errors can be prevented or easily solved by following these guidelines:
-
Specify the AWS account ID and Namespace – The relevant AWS account ID must be provided with each request. The Namespace must be set to
default. -
Allow for eventual consistency – Some errors are caused because a previous request has not yet propagated thorough the system.
-
Use a sleep interval between request rates – Amazon QuickSight API requests are throttled to help maintain the performance of the service. If your requests have been throttled, you get an error.
-
Use the full ID of the resource – When specifying a resource, ensure that you use its full ID, and not its user-supplied name or description.
-
Check your services – Ensure that you have signed up for all the services you are attempting to use. You can check which services you're signed up for by going to the My Account section of the AWS home page
. -
Check your permissions – Ensure that you have the required permissions to carry out the request.
-
Check your VPC – Some resources cannot be shared between virtual private clouds (VPCs), for example security groups.
-
Check your credentials – Ensure that you provide your access keys when you are making requests and that you have entered the credentials correctly. Also, if you have more than one account, ensure that you are using the correct credentials for a particular account. If the provided credentials are incorrect, you might get the following error:
Client.AuthFailure.
Server Errors
Following, you can find a list of errors that can be returned by the server.
| Error Code | Description |
|---|---|
| BatchClientRequestTokensNotDistinctException – | The batch client request tokens are not unique. |
| EmptyBatchRequestException | The batch request was empty. |
| InternalFailureException | An internal failure occurred. |
| InternalServiceError | There was an internal error from the service. |
| InvalidBatchClientRequestTokenException | The AWS request token for this client batch request is invalid. |
| InvalidParameterException | One or more parameters has an invalid value. |
| LimitExceededException | A limit is exceeded. |
| ResourceUnavailableException | This resource is currently unavailable. |
| TooManyEntriesInBatchRequestException | There are too many entries in this batch request. |
