As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Usar a Amazon QuickSight API A seguir, é possível descobrir como começar a usar a Amazon. QuickSight API. **Topics** + [ # Como fazer solicitações de API ](qs-api-making-api-requests.md) + [ # Nomes de recurso da Amazon (ARN) na Amazon QuickSight ](qs-arns.md) + [ # Permissões para a Amazon QuickSight Recursos ](qs-api-permissions.md) + [ # Amazônia QuickSight Erros de API do ](qs-api-errors.md) # Como fazer solicitações de API Fornecemos uma API para a Amazon QuickSight, e também SDKs da Amazon SDKs que permitem que você acesse a Amazon QuickSight da sua linguagem de programação preferencial. Usar a Amazon QuickSight, você pode gerenciar alguns aspectos da sua implantação usando os SDKs da Amazon. Para monitorar as chamadas feitas para a Amazon QuickSight API para sua conta, você pode usarAWS CloudTrail. CloudTrail pode monitorar chamadas feitas peloConsole de gerenciamento da AWS, ferramentas de linha de comando e outros serviços. Para obter mais informações, consulte o [Guia do usuário do AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). **Topics** + [ ## Conhecimentos necessários ](#qs-api-required-knowledge) + [ ## Operações de API disponíveis para a Amazon QuickSight ](#qs-api-using-libraries) ## Conhecimentos necessários Se você planeja acessar a Amazon QuickSight por meio de uma API, você deve estar familiarizado com o seguinte: + JSON + Serviços da web + Solicitações HTTP + Uma ou mais linguagens de programação, como o JavaScript, C\$1. Recomendamos visitar oAWS [Centro de recursos de conceitos básicos](https://aws.amazon.com//getting-started/tools-sdks/)para um tour pelo que os Amazon SDKs e kits de ferramentas têm a oferecer. Embora você possa usar um terminal e seu editor de texto favorito, você pode se beneficiar da experiência de interface do usuário mais visual obtida em um ambiente de desenvolvimento integrado (IDE). Fornecemos uma lista de IDEs no*AWSCentro de recursos de conceitos básicos*no[Kits de ferramentas IDE e IDE](https://aws.amazon.com//getting-started/tools-sdks/#IDE_and_IDE_Toolkits)seção. Este site forneceAWSkits de ferramentas que você pode baixar para seu IDE preferido. Alguns IDEs também oferecem tutoriais para ajudá-lo a aprender mais sobre linguagens de programação. ## Operações de API disponíveis para a Amazon QuickSight Amazônia QuickSight As operações de API do fornecem: + Gerenciamento de usuários e grupos + Gerenciamento de dados (fontes de dados, conjuntos de dados, modelos e ingestão de SPICE) + Painel e análise de URSS + Gerenciamento de modelos + Permissions management + Gerenciamento de personalização AWSA fornece bibliotecas, códigos de exemplo, tutoriais e outros recursos para os desenvolvedores de software que preferem criar aplicativos usando operações de APIs específicas para linguagem, em vez de enviar uma solicitação via HTTPS. Essas bibliotecas fornecem funções básicas que cuidam automaticamente de tarefas como a assinatura criptografada das solicitações, novas tentativas de solicitações e tratamento das respostas de erro. Essas bibliotecas ajudam a facilitar para você começar. Para obter mais informações sobre como fazer download dos Amazon SDKs, consulte o[Amazon SDKs e ferramentas](https://aws.amazon.com/tools/). Os links a seguir são uma amostra da documentação da API específica do idioma disponível. **AWS Command Line Interface** + [AWS CLI QuickSight Referência de comando](https://docs.aws.amazon.com//cli/latest/reference/quicksight/index.html) + [Manual do usuário do AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/) + [Referência de comandos da AWS CLI](https://docs.aws.amazon.com//cli/latest/reference/) **AWS SDK para .NET** + [Amazon.Quicksight](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html) + [Amazon.Quicksight.Modelo](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html) **AWS SDK para C\$1\$1** + [Como:QuickSight::QuickSightClient Referência de classe](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html) **AWS SDK para Go** + [quicksight](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/) **AWS SDK para Java** + [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) **AWS SDK para JavaScript** + [QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html) **AWS SDK para PHP** + [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html) **AWS SDK para Python (Boto3)** + [QuickSight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html) **AWS SDK para Ruby** + [Como:QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html) # Nomes de recurso da Amazon (ARN) na Amazon QuickSight Nomes de recurso da Amazon (ARNs) identificam apenas recursos da AWS. Um ARN identifica um recurso de forma inequívoca em todos osAWS, por exemplo, em IAMPolicies, tags do Amazon Relational Database Service (Amazon RDS) e chamadas de API. Para recuperar o ARN de uma Amazon QuickSight, você pode usar o`Describe`operação no recurso relevante. Você pode usar esta seção para aprender como os ARNs funcionam. O material aqui fornece exemplos voltados especificamente para a Amazon. QuickSight. **Topics** + [ # Formatos ARN ](qs-arn-format.md) + [ # Amazônia QuickSight ARNs de recursos do ](qs-resource-arns.md) # Formatos ARN Os ARNs são delimitados por dois pontos e compostos de*segmentos*, que são partes separadas por dois pontos (`:`). Os componentes e valores específicos usados nos segmentos de um ARN dependem de quaisAWSserviço para o qual o ARN se destina. O exemplo a seguir mostra como os ARNs são construídos. ``` 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 ``` Esses ARNs contêm os seguintes segmentos: ***`partition`***— A partição onde o recurso se encontra. Para o padrãoRegiões da AWS, a partição é*aws*. Se você tem recursos em outras partições, a partição é*aws-partitionname*. Por exemplo, a partição de recursos na região China (Pequim) é `aws-cn`. ***`service`***— O namespace de serviço que identifica aAWSproduto. Por exemplo,`quicksight`identifica a Amazon QuickSight,`s3`identifica o Amazon S3,`iam`identifica o IAM e assim por diante. ***`region`***— ORegião da AWSem que o recurso reside. Os ARNs de alguns recursos não exigem umaRegião da AWS, portanto, este componente pode ser omitido em alguns casos, como no caso do S3. Amazônia QuickSight Os ARNs exigem umRegião da AWS. ***`account-id`***— O ID doConta da AWSque possui o recurso. Ao usar o número da conta em um ARN ou uma operação de API, você omite os hifens (por exemplo, 123456789012). Os ARNs de alguns recursos não exigem um número de conta, portanto, este componente pode ser omitido. Amazônia QuickSight Os ARNs exigem umConta da AWSnúmero. No entanto, o número da conta e oRegião da AWSsão omitidos dos ARNs do bucket do S3, conforme mostrado a seguir. ``` arn:aws:s3:::bucket_name arn:aws:s3:::bucket_name/key_name ``` ***`resource`*ou*`resource-type`***— O conteúdo dessa parte do ARN varia de acordo com o serviço. Um identificador de recurso pode ser o nome ou o ID do recurso (por exemplo,`user/Bob`ou`instance/i-1234567890abcdef0`) ou um caminho de recurso. Por exemplo, alguns identificadores de recursos incluem um recurso pai (`sub-resource-type/parent-resource/sub-resource`) ou um qualificador, como uma versão (*Tipo de recurso do*:*resource-name*:*qualificadora*). Alguns ARNs de recursos podem incluir um caminho, uma variável ou um curinga. Você pode usar caracteres curingas (`*`e`?`) dentro de qualquer segmento de ARN. Um asterisco (`*`) representa qualquer combinação de zero ou mais caracteres, e um ponto de interrogação (`?`) representa qualquer caractere único. É possível usar vários caracteres \$1 ou ? em cada segmento, mas um curinga não pode abranger segmentos. Se você estiver usando o ARN para permissões, evite usar`*`curingas, se possível, para limitar o acesso somente aos elementos necessários. Veja a seguir alguns exemplos de para o uso de caminhos, caracteres curinga e variáveis. No exemplo a seguir, usamos um ARN S3. Você pode usar isso ao conceder permissões ao S3 em uma IAMPolicy. Este ARN do S3 mostra um caminho e um arquivo especificados. **nota** O termo*nome da chave*é usado para descrever o que parece ser um caminho e um arquivo após`bucketname/`. Eles são chamados de nomes de chave porque um intervalo não contém estruturas de pastas como as usadas no sistema de arquivos do seu computador. Em vez disso, a barra (`/`) é um delimitador que ajuda a tornar a organização do bucket mais intuitiva. Nesse caso, o nome do bucket é`examplebucket`e o nome da chave é`developers/design_info.doc`. ``` arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json ``` Se você quiser identificar todos os objetos no bucket, poderá usar um caractere curinga para indicar que todos os nomes de chave (ou caminhos e arquivos) estão incluídos no ARN, como a seguir. ``` arn:aws:s3:::examplebucket/* ``` Você pode usar parte de um nome de chave mais o curinga para identificar todos os objetos que começam com um padrão específico. Nesse caso, ele se assemelha a um nome de pasta mais um curinga, conforme mostrado a seguir. No entanto, esse ARN também inclui quaisquer “subpastas” dentro do`my-data`. ``` arn:aws:s3:::examplebucket/my-data/* ``` Você pode especificar um nome parcial adicionando um curinga. Este identifica todos os objetos que começam com`my-data/sales-export*`. ``` arn:aws:s3:::examplebucket/my-data/sales-export* ``` Nesse caso, especificar o uso desse curinga inclui os objetos com nomes como os seguintes: + `my-data/sales-export-1.xlsx` + `my-data/sales-export-new.txt` + `my-data/sales-export-2019/file1.txt` Você pode usar curingas de ambos os tipos (asteriscos e pontos de interrogação) em combinação ou separadamente, conforme mostrado a seguir. ``` arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.* arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.* ``` Ou, se você quiser preparar o ARN para o futuro, poderá substituir o ano inteiro por um curinga, em vez de usar apenas curingas para os dois últimos dígitos. ``` arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.* arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.* ``` Para ler mais sobre os ARNs do S3, consulte[Especificação de recursos em uma política](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)e[Chave de objeto e metadados](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)no*Guia do usuário do Amazon Simple Storage Service.* # Amazônia QuickSight ARNs de recursos do Os seguintes tipos de recursos são definidos pela Amazon QuickSight: usuário, grupo e painel. Eles são usados na Amazon QuickSight Chamadas de API e como elementos das declarações IAMPermission. Para encontrar oup-to-date informações para a Amazon QuickSight (prefixo do serviço: visão rápida) recursos, ações e chaves de contexto de condição para uso em políticas do IAMPermission, consulte[Ações, recursos e chaves de condição da Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)no*Guia do usuário do Iam.* | Tipo de recurso | Formato de Nome de região da Amazon (ARN) | Chaves de condição | | --- | --- | --- | | user | arn::::::::::::::::::::::::::::::::::::::ResourceId\$1 | N/D | | grupo | arn::::::::::::::::::::::::::::::::::::::ResourceId\$1 | N/D | | painel | arn::::::::::::::::::::::::::::::::::::::::ResourceId\$1 | N/D | Os ARNs de recursos são construídos a partir dos segmentos que descrevem seu recurso. Por exemplo, um ARN de recurso para uma análise consiste nos seguintes segmentos. ``` arn::quicksight:::/ ``` Os segmentos são definidos da seguinte forma: + *`partition`*— Por exemplo,`aws`ou`aws-cn`. + *`aws-region`*— ORegião da AWSque contém o recurso. + *`aws-account-id`*— OConta da AWSque contém o recurso. Isso exclui os hífens. + *`resource-type`*— O tipo de recurso. Para este exemplo, isso é`analyses`. Para um painel, é`dashboard`. + *`resource-id`*— O identificador exclusivo de um recurso específico. ORegião da AWS, o tipo de recurso e o ID do recurso são identificados na URL do recurso quando você estiver usando a Amazon QuickSight console do . Por exemplo, suponhamos que esta seja a URL da análise para a qual é necessário um ARN. ``` https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29 ``` O Região da AWS é `us-east-2`. O tipo de recurso do é`analysis`. O ID do recurso nesse URL é`4036e682-7de6-4c05-8a76-be51b9ec9b29`. Se o seu número de conta da`111122223333`, então o ARN para essa análise é o seguinte. ``` arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29 ``` Para obter oConta da AWS, entre em contato com o administrador do sistema. # Permissões para a Amazon QuickSight Recursos Se você não souber qual é a permissão necessária, poderá tentar fazer uma chamada. O cliente então informa qual é a permissão que falta. Você pode usar asterisco (`*`) no campo Recurso da sua política de permissão em vez de especificar recursos explícitos. No entanto, é altamente recomendável restringir cada permissão o máximo possível. Você pode restringir o acesso do usuário especificando ou excluindo recursos na política, usando a Amazon QuickSight ARN. Para recuperar o ARN de uma Amazon QuickSight recurso, use o`Describe`operação no recurso relevante. Antes de ligar para a Amazon QuickSight Operações de API, você precisa do`quicksight:operation-name`permissão em uma política anexada ao seu IAMIdentity. Por exemplo, para chamar `list-users`, você precisa da permissão `quicksight:ListUsers`. O mesmo padrão se aplica a todas as operações. Se você tentar fazer a chamada para a qual você não tem permissão para chamar, o erro resultante informará qual permissão está faltando. Recomendamos que você restrinja cada permissão o máximo possível. Você pode adicionar condições ao IAM para restringir ainda mais o acesso a uma API em alguns cenários. Por exemplo, quando você adicionar `User1` a `Group1`, o principal recurso será `Group1`. Você pode permitir ou negar o acesso a determinados grupos. Ou você também pode editar a Amazon. QuickSight Eu sou a chave`quicksight:UserName`para adicionar uma condição para permitir ou impedir que determinados usuários sejam adicionados a esse grupo. Para obter mais informações, consulte as informações a seguir. + [Ações, recursos e chaves de condição](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_amazonquicksight.html) + [Elementos de política do IAMJSON](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html) Para ver o máximo up-to-date lista da Amazon QuickSight ações, consulte[Ações definidas pela Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html#amazonquicksight-actions-as-permissions)no*Manual do usuário do IAM*. ## Melhores práticas Amazônia QuickSight permite compartilhar análises, painéis, modelos e temas com até 100 diretores. UMA*diretor*pode ser um dos seguintes: + O nome de recurso da Amazon (ARN) de uma Amazon QuickSight usuário ou grupo associado a uma fonte de dados ou conjunto de dados. (Isso é comum.) + O ARN de uma Amazon QuickSight usuário, grupo ou namespace associado a uma análise, painel, modelo ou tema. (Isso é comum.) + O ARN de umAWSraiz de conta da: Este é um ARN do IAM em vez de um QuickSight ARN. Use essa opção somente para compartilhar recursos (modelos) entreAWScontas. (Isso é menos comum.) Se você quiser compartilhar esses recursos com mais entidades, considere atribuir permissões de recursos no nível de grupo ou namespace. Por exemplo, se você adicionar usuários a um grupo e compartilhar um recurso com o grupo, o grupo contará como um principal, mesmo que seja compartilhado com todos no grupo. # Amazônia QuickSight Erros de API do Amazônia QuickSight O tem dois tipos de códigos de erro: + **Erros de cliente**— Esses erros geralmente são causados por algo que o cliente fez. Um exemplo é especificar um parâmetro incorreto ou inválido na solicitação ou usar uma ação ou recurso para um usuário que não tem permissão para usar a ação ou recurso. Esses erros são acompanhados por um código de resposta HTTP da série 400. + **Erros de servidor**— Esses erros geralmente são causados por umaAWSproblema no lado do servidor. Esses erros são acompanhados por um código de resposta HTTP da série 500. **Topics** + [ ## Erros de cliente comuns ](#qs-api-errors-client) + [ ## Erros de cliente ](#qs-api-errors-table-client) + [ ## Erros de servidor ](#qs-api-errors-table-server) ## Erros de cliente comuns A seguir, você pode encontrar uma lista dos erros de cliente comuns que todas as ações podem retornar. | Código de erro | Descrição | | --- | --- | | AuthFailure | Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se os detalhes do seu cartão de crédito estão corretos e se você está usando as chaves de acesso corretas. | | Blocked | Sua conta está bloqueada no momento. Entre em contato com aws-verification@amazon.com se tiver dúvidas. | | DryRunOperation | O usuário tem as permissões necessárias, por isso, a solicitação teria sido bem-sucedida. Porém, o parâmetro DryRun foi usado. | | IdempotentParameterMismatch | A solicitação usa o mesmo token do cliente de uma solicitação anterior, mas não idêntica. Não reutilize um token do cliente com diferentes solicitações, a menos que as solicitações sejam idênticas. | | IncompleteSignature | A assinatura da solicitação não atende aoAWSpadrões. | | InvalidAction | A ação ou operação solicitada é inválida. Verifique se a ação foi digitada corretamente. | | InvalidCharacter | Um caractere especificado é inválido. | | InvalidClientTokenId | O certificado X.509 ou o ID de chave de acesso da AWS fornecido não existe em nossos registros. | | InvalidPaginationToken | O token de paginação especificado é inválido ou expirou. | | InvalidParameter | Um parâmetro especificado em uma solicitação é inválido, não tem suporte ou não pode ser usado. A mensagem retornada fornece uma explicação do valor do erro. | | InvalidParameterCombination | Indica uma combinação de parâmetros incorreta ou um parâmetro ausente. | | InvalidParameterValue | Um valor especificado em um parâmetro é inválido, não tem suporte ou não pode ser usado. Certifique-se de especificar um recurso usando seu ID completo. A mensagem retornada fornece uma explicação do valor do erro. | | InvalidQueryParameter | OAWSstring de consulta da é malformada ou não segue aAWSpadrões. | | MalformedQueryString | A string de consulta contém um erro de sintaxe. | | MissingAction | A solicitação carece de uma ação ou de um parâmetro necessário. | | MissingAuthenticationToken | A solicitação deve conter um ID de chave de acesso da AWS válido (registrado) ou um certificado X.509. | | MissingParameter | A solicitação não possui um parâmetro necessário. Certifique-se de que você tenha fornecido todos os parâmetros necessários para a solicitação; por exemplo, o ID do recurso. | | OptInRequired | Você não tem permissão para usar o serviço solicitado. Verifique se você se inscreveu no serviço que está tentando usar. Se você é novo noAWS, sua conta pode levar algum tempo para ser ativada enquanto os detalhes do seu cartão de crédito estão sendo verificados. | | PendingVerification | Sua conta tem uma verificação pendente. Até que o processo de verificação seja concluído, talvez você não consiga executar solicitações com essa conta. Em caso de dúvidas, entre em contato com [AWS Support](https://console.aws.amazon.com/support/home#/). | | RequestExpired | A solicitação atingiu o serviço mais de 15 minutos após a data na solicitação ou a data na solicitação ou a data na solicitação (como para pre-signed URLs). Ou o carimbo de data na solicitação é de mais de 15 minutos no future. Se você estiver usando credenciais de segurança temporárias, esse erro também pode ocorrer se as credenciais expiraram. Para obter mais informações, consulte [Credenciais de segurança temporárias](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) no Manual do usuário do IAM. | | UnauthorizedOperation | Você não tem autorização para executar esta operação. Verifique suas políticas do IAM e certifique-se de estar usando as chaves de acesso corretas. | | UnknownParameter | Foi fornecido um parâmetro desconhecido ou não reconhecido. As solicitações que podem causar esse erro incluem fornecer um parâmetro errado ou um parâmetro que não é compatível com a versão de API especificada. | | UnsupportedInstanceAttribute | O atributo especificado não pode ser modificado. | | UnsupportedOperation | A solicitação especificada inclui uma operação incompatível. A mensagem retornada oferece detalhes da operação incompatível. | | UnsupportedProtocol | O protocolo que você usou é incompatível. | | ValidationError | A entrada deixa de atender às restrições especificadas por umAWSserviçoServiço. | ## Erros de cliente A seguir, você pode encontrar uma lista de erros de cliente específicos para a Amazon. QuickSight Operações de API do. | Código de erro | Descrição | | --- | --- | | AccessDeniedException | Você não tem acesso a isso. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas. | | DomainNotWhiteListedException | O domínio especificado não está na lista de permissões. Todos os domínios para painéis incorporados devem ser adicionados à lista aprovada por uma Amazon QuickSight admin. | | IdentityTypeNotSupportedException | O tipo de identidade especificado não é compatível. Os tipos de identidade compatíveis incluem: EU SOU E QUICKSIGHT. | | InvalidNextTokenException | O valor NextToken é inválido. | | InvalidParameterValueException | Um ou mais parâmetros não têm um valor válido. | | PreconditionNotMetException | Uma ou mais pré-condições não foram atendidas. | | QuickSightUserNotFoundException | O usuário não foi encontrado. Isso pode acontecer em qualquer operação que exija encontrar um usuário com base no nome de usuário fornecido, como DeleteUser,DescribeUsere assim por diante. | | ResourceExistsException | O recurso especificado não existe. | | ResourceNotFoundException | Não foi possível encontrar um ou mais recursos. | | SessionLifetimeInMinutesInvalidException | O número de minutos especificado para o tempo de vida de uma sessão é inválido. O tempo de vida da sessão deve estar entre 15 e 600 minutos. | | ThrottlingException | O acesso é limitado. | | UnsupportedUserEditionException | Indica que você está chamando uma operação na Amazon QuickSightassinatura em que a edição não inclui suporte para essa operação. Amazônia QuickSight atualmente tem Standard Edition e Enterprise Edition. Nem todas operações e recursos estão disponível em todas as edições. | ### Causas comuns de erros de cliente Há vários motivos pelos quais você pode encontrar um erro ao executar uma solicitação. Alguns erros podem ser evitados ou facilmente resolvidos seguindo estas diretrizes: + **Especifique oConta da AWSID e namespace**— O relevanteConta da AWSO ID deve ser fornecido com cada solicitação. O namespace deve ser definido como `default`. + **Permitir consistência eventual**— Alguns erros são causados porque uma solicitação anterior ainda não foi propagada pelo sistema. + **Use um intervalo de sono entre as taxas de solicitação**— Amazon QuickSight As solicitações de API do são limitadas para ajudar a manter o desempenho do serviço. Se as solicitações foram limitadas, você receberá um erro. + **Use o ID completo do recurso**— Ao especificar um recurso, certifique-se de usar seu ID completo, e não seu nome ou descrição fornecida pelo usuário. + **Verificar os serviços**— certifique-se de que você se inscreveu em todos os serviços que está tentando usar. Você pode verificar em quais serviços se inscreveu acessando a**Minha conta**Seção do do[AWSPágina inicial do](https://aws.amazon.com/). + **Verificar as permissões**— certifique-se de que você tem as permissões necessárias para executar a solicitação. + **Verificar a VPC**— alguns recursos não podem ser compartilhados entre nuvens privadas virtuais (VPCs), por exemplo, grupos de segurança. + **Verificar as credenciais da**— certifique-se de fornecer suas chaves de acesso quando estiver fazendo solicitações e se inseriu as credenciais corretamente. Além disso, se você tiver mais de uma conta, certifique-se de estar usando as credenciais corretas para uma determinada conta. Se as credenciais fornecidas estão incorretas, você pode receber o seguinte erro:`Client.AuthFailure`. ## Erros de servidor A seguir, você pode encontrar uma lista de erros que podem ser retornados pelo servidor. | Código de erro | Descrição | | --- | --- | | BatchClientRequestTokensNotDistinctException – | Os tokens de solicitação do cliente de lote não são exclusivos. | | EmptyBatchRequestException | A solicitação de lote estava vazia. | | InternalFailureException | Ocorreu um erro interno. | | InternalServiceError | Ocorreu um erro interno no serviço. | | InvalidBatchClientRequestTokenException | OAWStoken de solicitação para essa solicitação de lote do cliente é inválido. | | InvalidParameterException | Um ou mais parâmetros têm um valor inválido. | | LimitExceededException | Um limite foi excedido. | | ResourceUnavailableException | Este recurso está indisponível no momento. | | TooManyEntriesInBatchRequestException | Há muitas entradas nesta solicitação de lote. |