Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation d'Amazon QuickSight API
Dans la rubrique suivante, vous découvrirez comment commencer à utiliser Amazon QuickSight API.
**Topics**
+ [Envoi de demandes d'API](qs-api-making-api-requests.md)
+ [Amazon Resource Names (ARN) dans Amazon Resource Names QuickSight](qs-arns.md)
+ [Autorisations pour Amazon QuickSight Ressources](qs-api-permissions.md)
+ [Amazon QuickSight Erreurs de l'API](qs-api-errors.md)
# Envoi de demandes d'API
Nous vous proposons une API pour Amazon QuickSight, ainsi que des kits SDK Amazon qui vous permettent d'accéder à Amazon QuickSight à partir de votre langage de programmation préféré. Utilisation d'Amazon QuickSight, vous pouvez gérer certains aspects de votre déploiement en utilisant les kits de développement logiciel (SDK) Amazon.
Pour superviser les appels d'Amazon QuickSight API pour votre compte, vous pouvez utiliserAWS CloudTrail. CloudTrail peut contrôler les appels passés par leAWS Management Console, outils de ligne de commande et autres services. Pour plus d'informations, consultez le [Guide de l'utilisateur AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
**Topics**
+ [Connaissances préalables](#qs-api-required-knowledge)
+ [Opérations d'API disponibles pour Amazon QuickSight](#qs-api-using-libraries)
## Connaissances préalables
Si vous envisagez d'accéder à Amazon QuickSight via une API, vous devez être familiarisé avec les sujets suivants :
+ JSON
+ Services Web
+ Requêtes HTTP
+ Un ou plusieurs langages de programmation tels que JavaScript, Java, Python ou C \$1.
Il est recommandé de visiter la sectionAWS [Mise en route avec le Centre de ressources](https://aws.amazon.com//getting-started/tools-sdks/)pour découvrir ce que les SDK et les boîtes à outils Amazon ont à offrir.
Bien que vous puissiez utiliser un terminal et votre éditeur de texte préféré, vous pouvez bénéficier de l'expérience d'interface utilisateur plus visuelle que vous obtenez dans un environnement de développement intégré (IDE). Nous fournissons une liste d'IDE dans le*AWSMise en route avec le Centre de ressources*dans le[IDE et boîtes à outils IDE](https://aws.amazon.com//getting-started/tools-sdks/#IDE_and_IDE_Toolkits)Section. Ce site fournitAWSdes boîtes à outils que vous pouvez télécharger pour votre EDI préféré. Certains IDE proposent également des tutoriels pour vous aider à en savoir plus sur les langages de programmation.
## Opérations d'API disponibles pour Amazon QuickSight
Amazon QuickSight Les opérations d'API fournissent :
+ Gestion des utilisateurs et des groupes
+ Gestion des données (sources de données, jeux de données, modèles et ingestion SPICE)
+ Gestion du tableau de bord et de
+ Gestion des modèles
+ Gestion des autorisations
+ Gestion de la personnalisation
AWSfournit des bibliothèques, des exemples de code, des didacticiels et d'autres ressources aux développeurs de logiciels qui préfèrent développer des applications utilisant des opérations API propres au langage au lieu de soumettre une requête via HTTPS. Ces bibliothèques offrent des fonctions de base qui prennent soin automatiquement des tâches telles que la signature cryptographique des demandes, les nouvelles tentatives de demande et la gestion des réponses d'erreur. Ces bibliothèques permettent plus facilement de commencer à utiliser.
Pour en savoir plus sur le téléchargement des kits de développement logiciel Amazon, consultez la page[Kits SDK et outils Amazon](https://aws.amazon.com/tools/). Les liens suivants sont un exemple de la documentation d'API spécifique à chaque langue disponible.
**AWS Command Line Interface**
+ [AWS CLI QuickSight Référence des commandes](https://docs.aws.amazon.com//cli/latest/reference/quicksight/index.html)
+ [Guide de l'utilisateur AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/)
+ [Référence des commandes AWS CLI](https://docs.aws.amazon.com//cli/latest/reference/)
**AWS SDK pour .NET**
+ [Quicksight](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html)
+ [Amazon.Quicksight.Modèle](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html)
**AWS SDK pour C\$1\$1**
+ [Comme :QuickSight: :QuickSightClient Référence de classe](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html)
**AWS SDK pour Go**
+ [quicksight](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/)
**AWS SDK pour 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 pour JavaScript**
+ [QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html)
**AWS SDK pour PHP**
+ [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html)
**AWS SDK pour Python (Boto3)**
+ [QuickSight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html)
**AWS SDK pour Ruby**
+ [Comme :QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html)
# Amazon Resource Names (ARN) dans Amazon Resource Names QuickSight
Les noms ARN identifient de façon unique les ressources AWS. Un ARN identifie une ressource sans ambiguïté sur l'ensemble desAWS, par exemple dans IAMPolicies, les balises Amazon Relational Database Service (Amazon RDS) et les appels d'API. Pour récupérer l'ARN d'un Amazon QuickSight, vous pouvez utiliser la valeur`Describe`opération sur la ressource concernée.
Vous pouvez utiliser cette section pour découvrir comment fonctionnent les ARN. Le matériel fourni ici fournit des exemples spécialement conçus pour Amazon. QuickSight.
**Topics**
+ [Formats ARN](qs-arn-format.md)
+ [Amazon QuickSight ARN de la ressource](qs-resource-arns.md)
# Formats ARN
Les ARN sont délimités par des deux-points et se composent de*segments*, qui sont les parties séparées par des deux-points (`:`). Les composants et valeurs spécifiques utilisés dans les segments d'un ARN dépendent desAWSservice auquel l'ARN est destiné. L'exemple suivant illustre la façon dont les ARN sont construits.
```
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
```
Ces ARN contiennent les segments suivants :
***`partition`***- Partition dans laquelle se trouve la ressource. Pour standardRégions AWS, la partition est*aws*. Si vous disposez de ressources dans d'autres partitions, la partition est*nom de la partition AWS*. Par exemple, la partition des ressources de la région Chine (Beijing) est `aws-cn`.
***`service`***- Espace de noms du service qui identifie le service qui identifie leAWSProduit. Par exemple,`quicksight`identifie Amazon QuickSight,`s3`identifie Amazon S3,`iam`identifie IAM, etc.
***`region`***— LeRégion AWSdans laquelle se situe la ressource. Les ARN de certaines ressources ne requièrent pas de paramètre de base de données de typeRégion AWS, ce composant peut donc être supprimé dans certains cas, comme dans le cas de S3 par exemple, ce composant peut être supprimé. Amazon QuickSight Les ARN nécessitent unRégion AWS.
***`account-id`***— ID duCompte AWSqui possède la ressource. Lorsque vous utilisez le numéro de compte dans un ARN ou une opération d'API, vous omettez les traits d'union (par exemple, 123456789012). Les ARN de certaines ressources ne requièrent pas de numéro de compte, ce composant peut donc être supprimé. Amazon QuickSight Les ARN nécessitent unCompte AWSnombre. Cependant, le numéro de compte et laRégion AWSsont omis des ARN de compartiment S3, comme indiqué ci-dessous.
```
arn:aws:s3:::bucket_name
arn:aws:s3:::bucket_name/key_name
```
***`resource`*ou*`resource-type`***- Le contenu de cette partie de l'ARN varie en fonction du service. Un identifiant de ressource peut être le nom ou l'ID de la ressource (par exemple, nom ou ID de ressource)`user/Bob`ou`instance/i-1234567890abcdef0`) ou un chemin d'accès à la ressource. Par exemple, certains identifiants de ressources incluent une ressource parent (`sub-resource-type/parent-resource/sub-resource`) ou un qualificatif tel qu'une version (*resource-type* :*resource-nom-ressource* :*qualificatif*).
Certains ARN de ressource peuvent inclure un chemin d'accès, une variable ou un caractère générique.
Vous pouvez utiliser des caractères génériques (`*`et`?`) au sein de n'importe quel segment ARN. Un astérisque (`*`) représente n'importe quelle combinaison de zéro ou de plusieurs caractères, et un point d'interrogation (`?`) représente un seul caractère quelconque. Vous pouvez utiliser plusieurs caractères \$1 ou ? dans chaque segment, mais un caractère générique ne peut pas s'étendre à plusieurs segments. Si vous utilisez l'ARN pour les autorisations, évitez d'utiliser`*`caractères génériques si possible, pour limiter l'accès aux seuls éléments requis. Voici quelques exemples d'utilisation de chemins, de caractères génériques et de variables.
Dans l'exemple suivant, nous utilisons un ARN S3. Vous pouvez l'utiliser lorsque vous accordez des autorisations à S3 dans une IAMPolicy. Cet ARN S3 indique un chemin et un fichier sont spécifiés.
**Note**
Le terme*Nom de la touche*est utilisé pour décrire ce qui ressemble à un chemin et un fichier après`bucketname/`. Ces noms sont appelés noms de clés car un bucket ne contient pas réellement de structures de dossiers comme celles utilisées dans le système de fichiers de votre ordinateur. À la place, la barre oblique (`/`) est un délimiteur qui permet de rendre l'organisation du bucket plus intuitive. Dans ce cas, le nom du compartiment est`examplebucket`, et le nom de la clé est`developers/design_info.doc`.
```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json
```
Si vous souhaitez identifier tous les objets du compartiment, vous pouvez utiliser un caractère générique pour indiquer que tous les noms de clé (ou chemins et fichiers) sont inclus dans l'ARN, comme suit.
```
arn:aws:s3:::examplebucket/*
```
Vous pouvez utiliser une partie d'un nom de clé et le caractère générique pour identifier tous les objets qui commencent par un motif spécifique. Dans ce cas, il ressemble à un nom de dossier et à un caractère générique, comme illustré ci-dessous. Toutefois, cet ARN inclut également tous les « sous-dossiers » à l'intérieur de`my-data`.
```
arn:aws:s3:::examplebucket/my-data/*
```
Vous pouvez spécifier un nom partiel en ajoutant un caractère générique. Celui-ci identifie tous les objets commençant par`my-data/sales-export*`.
```
arn:aws:s3:::examplebucket/my-data/sales-export*
```
Dans ce cas, la spécification à l'aide de ce caractère générique inclut les objets dont le nom est le suivant :
+ `my-data/sales-export-1.xlsx`
+ `my-data/sales-export-new.txt`
+ `my-data/sales-export-2019/file1.txt`
Vous pouvez utiliser des caractères génériques des deux types (astérisques et points d'interrogation) en combinaison ou séparément, comme indiqué ci-dessous.
```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.*
```
Ou, si vous souhaitez pérenniser l'ARN, vous pouvez remplacer l'année entière par un caractère générique, plutôt que d'utiliser uniquement des caractères génériques pour les deux derniers chiffres.
```
arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.*
```
Pour en savoir plus sur les ARN S3, consultez[Spécification des ressources d'une stratégie](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)et[Clé d'objet et métadonnées](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)dans le*Manuel de l'utilisateur Amazon Simple Storage Service.*
# Amazon QuickSight ARN de la ressource
Les types de ressources suivants sont définis par Amazon QuickSight: utilisateur, groupe et tableau de bord. Ils sont utilisés sur Amazon QuickSight Appels d'API et en tant qu'éléments des instructions IAMPermission. Pour trouverup-to-date Informations pour Amazon QuickSight (préfixe de service : quicksight) ressources, actions et clés de contexte de condition à utiliser dans les stratégies IAMPermission, consultez la section relative aux stratégies IAMPermission[Actions, ressources et clés de condition pour Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)dans le*Guide de l'utilisateur.*
| Type de ressource | Format ARN | Clés de condition |
| --- | --- | --- |
| utilisateur | arn : \$1 \$1utilisateur\$1 : quicksight\$1\$1\$1 \$1Account\$1\$1\$1\$1\$1 utilisateur/\$1\$1 Account\$1\$1\$1\$1ResourceId\$1 | N/A |
| groupe | arn : \$1 \$1Account\$1\$1 : quicksight\$1\$1\$1 \$1Account\$1\$1\$1\$1\$1\$1\$1 : groupe/ \$1\$1Account\$1\$1ResourceId\$1 | N/A |
| tableau de bord | arn : \$1 \$1Account\$1\$1 : quicksight\$1\$1\$1 \$1Account\$1\$1\$1\$1 : tableau de bord/\$1 \$1Account\$1\$1\$1ResourceId\$1 | N/A |
Les ARN de ressources sont construits à partir des segments qui décrivent votre ressource. Par exemple, un ARN de ressource pour une analyse se compose des segments suivants.
```
arn::quicksight:::/
```
Les segments sont définis comme suit :
+ *`partition`*— Par exemple,`aws`ou`aws-cn`.
+ *`aws-region`*— LeRégion AWSqui contient la ressource.
+ *`aws-account-id`*— LeCompte AWSqui contient la ressource. Cela exclut les traits d'union.
+ *`resource-type`*— Le type de ressource. Pour cet exemple, il s'agit de`analyses`. Pour un tableau de bord, c'est`dashboard`.
+ *`resource-id`*Identificateur unique d'une ressource spécifique.
LeRégion AWS, le type de ressource et l'ID de ressource sont identifiés dans l'URL de la ressource lorsque vous utilisez Amazon QuickSight console Par exemple, supposons que l'URL de l'analyse dont vous souhaitez obtenir un ARN.
```
https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```
Le Région AWS est `us-east-2`. Le type de ressource est`analysis`. L'ID de ressource dans cette URL est`4036e682-7de6-4c05-8a76-be51b9ec9b29`. Si votre numéro de compte est`111122223333`, alors l'ARN de cette analyse est le suivant.
```
arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```
Pour obtenir votreCompte AWScontactez votre administrateur système.
# Autorisations pour Amazon QuickSight Ressources
Si vous ne connaissez pas avec certitude l'autorisation nécessaire, vous pouvez essayer d'effectuer un appel. Le client vous indique ensuite quelle est l'autorisation manquante. Vous pouvez utiliser un astérisque (`*`) dans le champ Ressource de votre stratégie d'autorisation au lieu de spécifier des ressources explicites. Nous vous recommandons toutefois vivement de restreindre le plus possible chaque autorisation. Vous pouvez restreindre l'accès des utilisateurs en spécifiant ou en excluant des ressources dans la stratégie, en utilisant leur Amazon Amazon. QuickSight ARN. Pour récupérer l'ARN d'un Amazon QuickSight , utilisez la valeur`Describe`opération sur la ressource concernée.
Avant de pouvoir appeler Amazon QuickSight Opérations d'API, vous avez besoin du`quicksight:operation-name`autorisation dans une stratégie associée à votre IAMIdentity. Par exemple, pour appeler `list-users`, vous avez besoin de l'autorisation `quicksight:ListUsers`. Le même modèle s'applique à toutes les opérations. Si vous essayez d'effectuer l'appel, vous ne disposez pas des autorisations nécessaires pour appeler, l'erreur générée vous indiquera quelle autorisation est manquante. Nous vous recommandons vivement de restreindre le plus possible chaque autorisation.
Vous pouvez ajouter des conditions dans IAM pour restreindre encore plus l'accès à une API dans certains scénarios. Par exemple, lorsque vous ajoutez `User1` dans `Group1`, la ressource principale est `Group1`. Vous pouvez autoriser ou refuser l'accès à certains groupes. Ou vous pouvez également modifier Amazon QuickSight IAmKey`quicksight:UserName`pour ajouter une condition pour autoriser ou empêcher l'ajout de certains utilisateurs à ce groupe.
Pour plus d'informations, consultez les ressources suivantes :
+ [Actions, ressources et clés de condition](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_amazonquicksight.html)
+ [Éléments de stratégie IAMJSON](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html)
Pour voir le plus up-to-date liste d'Amazon QuickSight actions, voir[Actions définies par Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html#amazonquicksight-actions-as-permissions)dans le*IAM User Guide*.
## Bonnes pratiques
Amazon QuickSight vous permet de partager des analyses, des tableaux de bord, des modèles et des thèmes avec jusqu'à 100 directeurs. UN*principal*, les valeurs suivantes sont possibles :
+ Amazon Resource Name (ARN) d'un Amazon Resource Name (ARN) QuickSight utilisateur ou groupe associé à une source de données ou à un ensemble de données. (Il s'agit du scénario courant.)
+ L'ARN d'une Amazon QuickSight utilisateur, groupe ou espace de noms associé à une analyse, un tableau de bord, un modèle ou un thème. (Il s'agit du scénario courant.)
+ L'ARN d'unAWSracine du compte : Il s'agit d'un ARN IAM plutôt que d'un QuickSight ARN. Utilisez cette option uniquement pour partager des ressources (modèles) entreAWScomptes. (Ce scénario est moins courant.)
Si vous souhaitez partager ces ressources avec davantage de mandataires, envisagez d'attribuer des autorisations de ressources au niveau du groupe ou de l'espace de noms. Par exemple, si vous ajoutez des utilisateurs à un groupe et que vous partagez une ressource avec le groupe, le groupe compte comme un seul mandant, même s'il est partagé avec tous les membres du groupe.
# Amazon QuickSight Erreurs de l'API
Amazon QuickSight Il existe deux types de codes d'erreur dans :
+ **Erreurs de client**- Ces erreurs sont généralement dues à une action du client. Par exemple, la spécification d'un paramètre incorrect ou non valide dans la demande, ou l'utilisation d'une action ou d'une ressource pour un utilisateur qui n'est pas autorisé à utiliser cette action ou ressource. Ces erreurs sont accompagnées d'un code de réponse HTTP de type 400.
+ **Erreurs de serveur**- Ces erreurs sont généralement dues à une erreur de typeAWSProblème côté serveur. Ces erreurs sont accompagnées d'un code de réponse HTTP de type 500.
**Topics**
+ [Erreurs de client courantes](#qs-api-errors-client)
+ [Erreurs de client](#qs-api-errors-table-client)
+ [Erreurs de serveur](#qs-api-errors-table-server)
## Erreurs de client courantes
Vous trouverez ci-dessous une liste des erreurs de client courantes que toutes les actions peuvent renvoyer.
| Code d'erreur | Description |
| --- | --- |
| AuthFailure | Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que les informations de votre carte bancaire sont correctes et que vous utilisez les bonnes clés d'accès. |
| Blocked | Votre compte est actuellement bloqué. Si vous avez des questions, envoyez un message à l'adresse aws-verification@amazon.com. |
| DryRunOperation | L'utilisateur disposant des autorisations requises, la demande aurait dû aboutir, mais le paramètre DryRun a été utilisé. |
| IdempotentParameterMismatch | La demande utilise le même jeton client qu'une demande précédente non identique. Vous ne devez pas réutiliser de jeton client avec des demandes différentes, sauf si les demandes sont identiques. |
| IncompleteSignature | La signature de la demande n'est pas conforme à laAWSnormes. |
| InvalidAction | L'action ou l'opération demandée n'est pas valide. Vérifiez que l'action est entrée correctement. |
| InvalidCharacter | Un caractère spécifié n'est pas valide. |
| InvalidClientTokenId | Le certificat X.509 ou l'ID de clé d'accès AWS fourni(e) n'existe pas dans nos archives. |
| InvalidPaginationToken | Le jeton de pagination spécifié n'est pas valide ou a expiré. |
| InvalidParameter | Un paramètre spécifié dans une demande n'est pas valide, n'est pas pris en charge ou ne peut pas être utilisé. Le message renvoyé fournit une explication de la valeur d'erreur. |
| InvalidParameterCombination | Indique une combinaison de paramètres incorrecte ou un paramètre manquant. |
| InvalidParameterValue | Une valeur spécifiée dans un paramètre n'est pas valide, n'est pas prise en charge ou ne peut pas être utilisée. Vérifiez que vous spécifiez une ressource en utilisant son ID complet. Le message renvoyé fournit une explication de la valeur d'erreur. |
| InvalidQueryParameter | LeAWSla chaîne de requête est incorrecte ou ne respecte pas la chaîne de requête ouAWSnormes. |
| MalformedQueryString | La chaîne de requête contient une erreur de syntaxe. |
| MissingAction | Il manque une action ou un paramètre requis dans la demande. |
| MissingAuthenticationToken | La demande doit contenir un ID de clé d'accès AWS (enregistré) ou un certificat X.509 valide. |
| MissingParameter | Il manque un paramètre requis dans la demande. Assurez-vous que vous avez fourni toutes les paramètres requis pour la demande, tels que l'ID de ressource. |
| OptInRequired | Vous n'êtes pas autorisé à utiliser le service demandé. Assurez-vous que vous êtes abonné au service que vous essayez d'utiliser. Si vous êtes nouveau surAWS, l'activation de votre compte peut prendre un certain temps, le temps que les informations de votre carte de crédit soient vérifiées. |
| PendingVerification | Votre compte est en attente de vérification. Tant que le processus de vérification n'est pas terminé, il est possible que vous ne puissiez pas effectuer de demandes avec ce compte. Si vous avez des questions, contactez [AWS Support](https://console.aws.amazon.com/support/home#/). |
| RequestExpired | La demande a atteint le service plus de 15 minutes après la date affichée sur la demande ou la date d'expiration de la demande (comme pour les URL pré-signées). Ou bien l'horodatage sur la demande est de plus de 15 minutes dans le future. Si vous utilisez des informations d'identification de sécurité temporaires, cette erreur peut également se produire si les informations d'identification ont expiré. Pour plus d'informations, consultez [Informations d'identification de sécurité temporaires](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) dans le Guide de l'utilisateur IAM. |
| UnauthorizedOperation | Vous n'êtes pas autorisé à effectuer cette opération. Vérifiez vos politiques IAM, et assurez-vous que vous utilisez les bonnes clés d'accès. |
| UnknownParameter | Un paramètre inconnu ou non reconnu a été fourni. Les demandes qui peuvent provoquer cette erreur sont notamment celles qui incluent un paramètre mal orthographié ou non pris en charge pour la version de l'API spécifiée. |
| UnsupportedInstanceAttribute | L'attribut spécifié ne peut pas être modifié. |
| UnsupportedOperation | La demande spécifiée inclut une opération non prise en charge. Le message retourné fournit des informations détaillées sur l'opération non prise en charge. |
| UnsupportedProtocol | Le protocole que vous avez utilisé n'est pas pris en charge. |
| ValidationError | L'entrée ne satisfait pas les contraintes spécifiées par un objet de typeAWSservice. |
## Erreurs de client
Ci-dessous, vous trouverez la liste des erreurs liées aux clients propres à Amazon. QuickSight Opérations d'API.
| Code d'erreur | Description |
| --- | --- |
| AccessDeniedException | Vous n'avez pas accès à cet élément. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès. |
| DomainNotWhiteListedException | Le domaine spécifié ne figure pas sur la liste des domaines approuvés (allowlist). Tous les domaines associés aux tableaux de bord intégrés doivent être ajoutés à la liste approuvée par Amazon. QuickSight Admin. |
| IdentityTypeNotSupportedException | Le type d'identité spécifié n'est pas pris en charge. Types d'identité pris en charge incluent : Je suis et QUICKSIGHT. |
| InvalidNextTokenException | La valeur NextToken n'est pas valide. |
| InvalidParameterValueException | Un ou plusieurs paramètres n'ont pas de valeur valide. |
| PreconditionNotMetException | Une ou plusieurs conditions préalables ne sont pas remplies. |
| QuickSightUserNotFoundException | L'utilisateur est introuvable. Cela peut se produire dans toute opération qui nécessite de rechercher un utilisateur en se basant sur le nom d'utilisateur fourni, par exemple : par exemple : DeleteUser,DescribeUser, etc. |
| ResourceExistsException | La ressource spécifiée n'existe pas. |
| ResourceNotFoundException | Une ou plusieurs ressources n'ont pas pu être trouvées. |
| SessionLifetimeInMinutesInvalidException | Le nombre de minutes spécifié pour la durée de vie d'une session n'est pas valide. La durée de vie de la session doit être comprise entre 15 et 600 minutes. |
| ThrottlingException | L'accès est limité. |
| UnsupportedUserEditionException | Indique que vous appelez une opération portant sur Amazon QuickSightdont l'édition n'inclut pas la prise en charge de cette opération. Amazon QuickSight dispose actuellement des éditions Standard Edition et Enterprise Edition. Toutes les opérations et fonctionnalités ne sont pas disponibles dans chaque édition. |
### Causes courantes des erreurs de client
Il existe un certain nombre de raisons pour lesquelles vous pouvez rencontrer une erreur en effectuant une demande. Certaines erreurs peuvent être évitées ou facilement résolues en suivant ces consignes :
+ **Spécifiez laCompte AWSID et espace de nom**— Les éléments pertinentsCompte AWSUne pièce d'identité doit être fournie avec chaque demande. L'espace de noms doit être défini sur `default`.
+ **Permettre la cohérence à terme**— Certaines erreurs sont dues au fait qu'une demande précédente n'a pas encore été propagée dans le système.
+ **Utiliser un intervalle de veille entre les taux de demande**— Amazon QuickSight Les demandes d'API sont limitées pour conserver les performances du service. Si vos demandes ont été limitées, vous obtenez une erreur.
+ **Utiliser l'ID complet de la ressource**— Lorsque vous spécifiez une ressource, assurez-vous que vous utilisez son ID complet, et non pas le nom ou la description fourni (e) par l'utilisateur.
+ **Vérifier vos services**assurez-vous que vous êtes bien inscrit à tous les services que vous essayez d'utiliser. Pour vérifier à quels services vous êtes inscrit, consultez la page de la page consacrée à la**Mon compte**Section du[AWSPage d'accueil](https://aws.amazon.com/).
+ **Vérifier vos autorisations**assurez-vous que vous disposez des autorisations requises pour effectuer la demande.
+ **Vérifier votre VPC**— Certaines ressources ne peuvent pas être partagées entre des clouds privés virtuels (VPC), par exemple les groupes de sécurité.
+ **Vérifier vos informations d'identification**— Assurez-vous de fournir vos clés d'accès lorsque vous faites des demandes et que vous avez correctement saisi les informations d'identification. De plus, si vous possédez plusieurs comptes, assurez-vous que vous utilisez les bonnes informations d'identification pour un compte spécifique. Si les informations d'identification fournies sont incorrectes, il se peut que vous obteniez l'erreur suivante :`Client.AuthFailure`.
## Erreurs de serveur
Ci-dessous, vous trouverez la liste des erreurs qui peuvent être renvoyées par le serveur.
| Code d'erreur | Description |
| --- | --- |
| BatchClientRequestTokensNotDistinctException – | Les jetons de demande de traitement par lots orientée client ne sont pas uniques. |
| EmptyBatchRequestException | La demande de traitement par lots était vide. |
| InternalFailureException | Une défaillance interne s'est produite. |
| InternalServiceError | Une erreur interne du service s'est produite. |
| InvalidBatchClientRequestTokenException | LeAWSjeton de demande pour cette demande de traitement par lots client n'est pas valide. |
| InvalidParameterException | Un ou plusieurs paramètres contiennent une valeur non valide. |
| LimitExceededException | Une limite est dépassée. |
| ResourceUnavailableException | Cette ressource n'est pas disponible actuellement. |
| TooManyEntriesInBatchRequestException | Cette demande de traitement par lots contient trop d'entrées. |