Amazon Relational Database Service
Guide de l'utilisateur (Version de l'API 2014-10-31)

Utilisation des Amazon Resource Names (ARN) dans Amazon RDS

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.

Création d'un ARN pour Amazon RDS

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>

Region Name Region Endpoint Protocol
USA Est (Ohio) us-east-2 rds.us-east-2.amazonaws.com HTTPS
USA Est (Virginie du Nord) us-east-1 rds.us-east-1.amazonaws.com HTTPS
USA Ouest (Californie du Nord) us-west-1 rds.us-west-1.amazonaws.com HTTPS
USA Ouest (Oregon) us-west-2 rds.us-west-2.amazonaws.com HTTPS
Asie-Pacifique (Hong Kong) ap-east-1 rds.ap-east-1.amazonaws.com HTTPS
Asie-Pacifique (Mumbai) ap-south-1 rds.ap-south-1.amazonaws.com HTTPS
Asie-Pacifique (Osaka-Local) ap-northeast-3 rds.ap-northeast-3.amazonaws.com HTTPS
Asie-Pacifique (Séoul) ap-northeast-2 rds.ap-northeast-2.amazonaws.com HTTPS
Asie-Pacifique (Singapour) ap-southeast-1 rds.ap-southeast-1.amazonaws.com HTTPS
Asie-Pacifique (Sydney) ap-southeast-2 rds.ap-southeast-2.amazonaws.com HTTPS
Asie-Pacifique (Tokyo) ap-northeast-1 rds.ap-northeast-1.amazonaws.com HTTPS
Canada (Centre) ca-central-1 rds.ca-central-1.amazonaws.com HTTPS
Chine (Pékin) cn-north-1 rds.cn-north-1.amazonaws.com.cn HTTPS
Chine (Ningxia) cn-northwest-1 rds.cn-northwest-1.amazonaws.com.cn HTTPS
UE (Francfort) eu-central-1 rds.eu-central-1.amazonaws.com HTTPS
UE (Irlande) eu-west-1 rds.eu-west-1.amazonaws.com HTTPS
UE (Londres) eu-west-2 rds.eu-west-2.amazonaws.com HTTPS
UE (Paris) eu-west-3 rds.eu-west-3.amazonaws.com HTTPS
UE (Stockholm) eu-north-1 rds.eu-north-1.amazonaws.com HTTPS
Amérique du Sud (São Paulo) sa-east-1 rds.sa-east-1.amazonaws.com HTTPS
AWS GovCloud (USA Est) us-gov-east-1 rds.us-gov-east-1.amazonaws.com HTTPS
AWS GovCloud (US) us-gov-west-1 rds.us-gov-west-1.amazonaws.com HTTPS

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:<region>:<account>:db:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1

Cluster DB

arn:aws:rds:<region>:<account>:cluster:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1
Abonnement aux événements

arn:aws:rds:<region>:<account>:es:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:es:my-subscription
Groupe d'options DB

arn:aws:rds:<region>:<account>:og:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:og:my-og
Groupe de paramètres de base de données

arn:aws:rds:<region>:<account>:pg:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs
Groupe de paramètres de cluster DB

arn:aws:rds:<region>:<account>:cluster-pg:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone
instance de base de données réservée

arn:aws:rds:<region>:<account>:ri:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql
Security Group DB

arn:aws:rds:<region>:<account>:secgrp:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:secgrp:my-public
Instantané DB

arn:aws:rds:<region>:<account>:snapshot:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-snap-20130507
Instantané de cluster DB

arn:aws:rds:<region>:<account>:cluster-snapshot:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-snap-20160809
Groupe de sous-réseaux DB

arn:aws:rds:<region>:<account>:subgrp:<name>

Par exemple :

arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10

Obtention d'un ARN existant

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

AWS Management Console

Pour obtenir un ARN depuis l'AWS Management Console, accédez à la ressource pour laquelle vous souhaitez obtenir un ARN, puis 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, comme illustré ci-après.


    				Instance de base de données ARN

AWS CLI

Pour obtenir un ARN depuis l'AWS CLI pour une ressource RDS particulière, utilisez la commande describe pour cette ressource. Le tableau suivant illustre chaque commande de l'interface de ligne de commande AWS CLI et la propriété d'ARN utilisée avec la commande pour obtenir un ARN.

Commande de l'AWS CLI Propriété d'ARN
describe-event-subscriptions EventSubscriptionArn
describe-certificates CertificateArn
describe-db-parameter-groups DBParameterGroupArn
describe-db-cluster-parameter-groups DBClusterParameterGroupArn
describe-db-instances DBInstanceArn
describe-db-security-groups DBSecurityGroupArn
describe-db-snapshots DBSnapshotArn
describe-events SourceArn
describe-reserved-db-instances ReservedDBInstanceArn
describe-db-subnet-groups DBSubnetGroupArn
describe-option-groups OptionGroupArn
describe-db-clusters DBClusterArn
describe-db-cluster-snapshots DBClusterSnapshotArn

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

Exemple

Pour Linux, OS X ou Unix :

aws rds describe-db-instances \ --db-instance-identifier DBInstanceIdentifier \ --region us-west-2

Pour Windows :

aws rds describe-db-instances ^ --db-instance-identifier DBInstanceIdentifier ^ --region us-west-2

API

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

Action d'API RDS Propriété d'ARN
DescribeEventSubscriptions EventSubscriptionArn
DescribeCertificates CertificateArn
DescribeDBParameterGroups DBParameterGroupArn
DescribeDBClusterParameterGroups DBClusterParameterGroupArn
DescribeDBInstances DBInstanceArn
DescribeDBSecurityGroups DBSecurityGroupArn
DescribeDBSnapshots DBSnapshotArn
DescribeEvents SourceArn
DescribeReservedDBInstances ReservedDBInstanceArn
DescribeDBSubnetGroups DBSubnetGroupArn
DescribeOptionGroups OptionGroupArn
DescribeDBClusters DBClusterArn
DescribeDBClusterSnapshots DBClusterSnapshotArn