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 RDS
<a name="USER_Tagging.ARN"></a>

Les ressources créées dans Amazon Web Services sont chacune identifiées de façon unique par un Amazon Resource Name (ARN). Pour certaines opérations Amazon RDS, vous devez identifier une ressource Amazon RDS de manière unique en spécifiant son ARN. Par exemple, lorsque vous créez un réplica en lecture d'instance de base de données RDS, vous devez fournir l'ARN pour l'instance de base de données source. 

Pour en savoir plus sur la construction d’un ARN et l’obtention d’un ARN existant, consultez les rubriques suivantes.

**Topics**
+ [Création d’un ARN pour Amazon RDS](USER_Tagging.ARN.Constructing.md)
+ [Obtention d’un ARN existant pour Amazon RDS](USER_Tagging.ARN.Getting.md)

# Création d’un ARN pour Amazon RDS
<a name="USER_Tagging.ARN.Constructing"></a>

Les ressources créées dans Amazon Web Services sont chacune identifiées de façon unique par un Amazon Resource Name (ARN). Vous pouvez construire un ARN pour une ressource Amazon RDS en utilisant la syntaxe suivante. 

 `arn:aws:rds:<region>:<account number>:<resourcetype>:<name>` 

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.Constructing.html)

Le tableau suivant indique le format à utiliser lors de la création d’un ARN pour un type de ressource Amazon RDS particulier. 


****  

| Type de ressource | Format ARN | 
| --- | --- | 
| instance de base de données  |  arn:aws:rds : ::db : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1</pre>  | 
| Cluster DB |  arn:aws:rds : ::cluster : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1</pre>  | 
| Abonnement aux événements  |  arn:aws:rds : ::es : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:es:my-subscription</pre>  | 
| Groupe d’options DB  |  arn:aws:rds : ::og : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:og:my-og</pre>  | 
| Groupe de paramètres de base de données  |  arn:aws:rds : ::pg : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs</pre>  | 
| Groupe de paramètres de cluster de bases de données  |  arn:aws:rds : ::cluster-pg : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone</pre>  | 
| instance de base de données réservée  |  arn:aws:rds : ::ri : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql</pre>  | 
| Groupe de sécurité de base de données  |  arn:aws:rds : ::secgrp : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:secgrp:my-public</pre>  | 
| Instantané de base de données automatique |  arn:aws:rds : :snapshot:rds : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23</pre>  | 
| Instantané de cluster de bases de données automatique |  arn:aws:rds : ::cluster-snapshot:rds : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16</pre>  | 
| Instantané de base de données manuel |  arn:aws:rds : ::snapshot : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap</pre>  | 
| Instantané de cluster de bases de données manuel |  arn:aws:rds : ::cluster-snapshot : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap</pre>  | 
| Groupe de sous-réseaux de base de données |  arn:aws:rds : ::subgrp : *<region>* *<account>* *<name>* Par exemple : <pre>arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10</pre>  | 

# Obtention d’un ARN existant pour Amazon RDS
<a name="USER_Tagging.ARN.Getting"></a>

Vous pouvez obtenir l'ARN d'une ressource RDS en utilisant l'APIAWS Management Console, AWS Command Line Interface (AWS CLI) ou RDS. 

## Console
<a name="USER_Tagging.ARN.CON"></a>

Pour obtenir un ARN auprès duAWS Management Console, accédez à la ressource pour laquelle vous souhaitez un ARN et consultez les détails de cette ressource.

Par exemple, vous pouvez obtenir l’ARN d’une instance de base de données dans l’onglet **Configuration** des détails de cette instance.

![\[ARN de l’instance de base de données\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/DB-instance-arn.png)


## AWS CLI
<a name="USER_Tagging.ARN.CLI"></a>

Pour obtenir un ARN à partir du AWS CLI pour une ressource RDS particulière, vous devez utiliser la `describe` commande correspondant à cette ressource. Le tableau suivant présente chaque AWS CLI commande, ainsi que la propriété ARN utilisée avec la commande pour obtenir un ARN. 


****  
<a name="cli-command-arn-property"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.Getting.html)

Par exemple, la AWS CLI commande suivante obtient l'ARN d'une instance de base de données.

**Example**  
Pour Linux, macOS ou Unix :  

```
aws rds describe-db-instances \
--db-instance-identifier DBInstanceIdentifier \
--region us-west-2 \
--query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"
```
Pour Windows :  

```
aws rds describe-db-instances ^
--db-instance-identifier DBInstanceIdentifier ^
--region us-west-2 ^
--query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"
```
La sortie de cette commande se présente comme suit :  

```
[
    {
        "DBInstanceArn": "arn:aws:rds:us-west-2:account_id:db:instance_id", 
        "DBInstanceIdentifier": "instance_id"
    }
]
```

## API RDS
<a name="USER_Tagging.ARN.API"></a>

Pour obtenir un ARN pour une ressource RDS particulière, vous pouvez appeler les opérations d’API RDS suivantes et utiliser les propriétés d’ARN illustrées ci-après.


****  
<a name="rds-operation-arn-property"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.Getting.html)