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. # 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.