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)
Les noms ARN identifient de façon unique les ressources AWS L'ARN permet de spécifier une ressource sans aucune ambiguïté sur l'ensemble d'AWS, comme par exemple dans les stratégies IAM, les balises Amazon Relational Database Service (Amazon RDS) et les appels d'API.
Sommaire
Format
Voici les formats généraux des ARN. Les formats spécifiques dépendent de la ressource.
Pour utiliser un ARN, remplacez l' italicized
Texte avec les informations spécifiques à la ressource. Sachez que les ARN de certaines
ressources omettent la région, l'ID du compte ou la région et l'ID du compte.
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
partition
-
Partition dans laquelle se trouve la ressource. Une partition est un groupe de régions AWS. Chaque compte AWS est étendu à une partition.
Les partitions prises en charge sont les suivantes :
-
aws
- RégionsAWS -
aws-cn
- Régions de Chine -
aws-us-gov
- RégionsAWS GovCloud (US)
-
service
-
Espace de noms du service qui identifie le produit AWS. Par exemple,
s3
pour les ressources Amazon S3. region
-
La région. Par exemple,
us-east-2
pour USA Est (Ohio). account-id
-
L'ID du compte AWS qui possède la ressource, sans les traits d'union. Par exemple,
123456789012
. resource-id
-
Identificateur de la ressource. Cette partie de l'ARN peut être le nom ou l'ID de la ressource ou d'un chemin d'accès de la ressource. Par exemple,
user/Bob
pour un utilisateur IAM ouinstance/i-1234567890abcdef0
pour une instance EC2. Certains identifiants de ressource incluent une ressource parent (type-sous-ressource/ressource-parent/sous-ressource) ou un qualificateur tel qu'une version (type-ressource:nom-ressource:qualificateur).
Chemins d'accès dans les ARN
Certains ARN de ressource peuvent inclure un chemin. Par exemple, dans Amazon S3,
l'identificateur de ressource est un nom d'objet qui peut inclure des barres obliques
(/
) pour former un chemin d'accès. De même, les noms d'utilisateur et les noms de groupe
IAM peuvent inclure des chemins d'accès.
Les chemins peuvent inclure un caractère générique, à savoir un astérisque (*
). Par exemple, si vous écrivez une stratégie IAM, vous pouvez spécifier tous les
utilisateurs IAM ayant le chemin d'accès product_1234
à l'aide d'un caractère générique comme suit :
arn:aws:iam::123456789012:user/Development/product_1234/*
De même, vous pouvez spécifier user/*
pour indiquer tous les utilisateurs ou group/*
pour indiquer tous les groupes, comme dans les exemples suivants :
"Resource":"arn:aws:iam::123456789012:user/*" "Resource":"arn:aws:iam::123456789012:group/*"
Vous ne pouvez pas utiliser un caractère générique pour spécifier tous les utilisateurs
dans l'élément Principal
d'une stratégie basée sur les ressources ou d'une stratégie d'approbation de rôle.
Les groupes ne sont pas pris en charge comme des principaux dans les stratégies.
L'exemple suivant illustre les ARN d'un compartiment Amazon S3 dans lequel le nom de la ressource inclut un chemin d'accès :
arn:aws:s3:::my_corporate_bucket/* arn:aws:s3:::my_corporate_bucket/Development/*
Vous ne pouvez pas utiliser de caractère générique dans la partie de l'ARN qui spécifie
le type de ressource, comme le terme user
d'un ARN IAM
Ce qui suit n'est pas autorisé :
arn:aws:iam::123456789012:u* |
ARN de la ressource
La documentation de AWS Identity and Access Management (IAM) répertorie les ARN pris en charge par chaque service pour une utilisation dans les autorisations au niveau des ressources. Pour plus d'informations, consultez Actions, ressources et clés de condition pour les services AWS dans le IAM Guide de l'utilisateur.