Utilisation des Amazon Resource Names (ARN) dans Amazon RDS - Amazon Relational Database Service

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

Nom de la région Région Point de terminaison Protocole
US East (Ohio) us-east-2

rds.us-east-2.amazonaws.com

rds-fips.us-east-2.api.aws

rds.us-east-2.api.aws

rds-fips.us-east-2.amazonaws.com

HTTPS

HTTPS

HTTPS

HTTPS

US East (N. Virginia) us-east-1

rds.us-east-1.amazonaws.com

rds-fips.us-east-1.api.aws

rds-fips.us-east-1.amazonaws.com

rds.us-east-1.api.aws

HTTPS

HTTPS

HTTPS

HTTPS

USA Ouest (Californie du Nord) us-west-1

rds.us-west-1.amazonaws.com

rds.us-west-1.api.aws

rds-fips.us-west-1.amazonaws.com

rds-fips.us-west-1.api.aws

HTTPS

HTTPS

HTTPS

HTTPS

US West (Oregon) us-west-2

rds.us-west-2.amazonaws.com

rds-fips.us-west-2.amazonaws.com

rds.us-west-2.api.aws

rds-fips.us-west-2.api.aws

HTTPS

HTTPS

HTTPS

HTTPS

Afrique (Le Cap) af-south-1

rds.af-south-1.amazonaws.com

rds.af-south-1.api.aws

HTTPS

HTTPS

Asie-Pacifique (Hong Kong) ap-east-1

rds.ap-east-1.amazonaws.com

rds.ap-east-1.api.aws

HTTPS

HTTPS

Asie-Pacifique (Hyderabad) ap-south-2

rds.ap-south-2.amazonaws.com

rds.ap-south-2.api.aws

HTTPS

HTTPS

Asie-Pacifique (Jakarta) ap-southeast-3

rds.ap-southeast-3.amazonaws.com

rds.ap-southeast-3.api.aws

HTTPS

HTTPS

Asie-Pacifique (Melbourne) ap-southeast-4

rds.ap-southeast-4.amazonaws.com

rds.ap-southeast-4.api.aws

HTTPS

HTTPS

Asia Pacific (Mumbai) ap-south-1

rds.ap-south-1.amazonaws.com

rds.ap-south-1.api.aws

HTTPS

HTTPS

Asie-Pacifique (Osaka) ap-northeast-3

rds.ap-northeast-3.amazonaws.com

rds.ap-northeast-3.api.aws

HTTPS

HTTPS

Asia Pacific (Seoul) ap-northeast-2

rds.ap-northeast-2.amazonaws.com

rds.ap-northeast-2.api.aws

HTTPS

HTTPS

Asie-Pacifique (Singapour) ap-southeast-1

rds.ap-southeast-1.amazonaws.com

rds.ap-southeast-1.api.aws

HTTPS

HTTPS

Asia Pacific (Sydney) ap-southeast-2

rds.ap-southeast-2.amazonaws.com

rds.ap-southeast-2.api.aws

HTTPS

HTTPS

Asie-Pacifique (Tokyo) ap-northeast-1

rds.ap-northeast-1.amazonaws.com

rds.ap-northeast-1.api.aws

HTTPS

HTTPS

Canada (Central) ca-central-1

rds.ca-central-1.amazonaws.com

rds.ca-central-1.api.aws

rds-fips.ca-central-1.api.aws

rds-fips.ca-central-1.amazonaws.com

HTTPS

HTTPS

HTTPS

HTTPS

Canada Ouest (Calgary) ca-west-1

rds.ca-west-1.amazonaws.com

rds-fips.ca-west-1.amazonaws.com

HTTPS

HTTPS

Europe (Francfort) eu-central-1

rds.eu-central-1.amazonaws.com

rds.eu-central-1.api.aws

HTTPS

HTTPS

Europe (Irlande) eu-west-1

rds.eu-west-1.amazonaws.com

rds.eu-west-1.api.aws

HTTPS

HTTPS

Europe (Londres) eu-west-2

rds.eu-west-2.amazonaws.com

rds.eu-west-2.api.aws

HTTPS

HTTPS

Europe (Milan) eu-south-1

rds.eu-south-1.amazonaws.com

rds.eu-south-1.api.aws

HTTPS

HTTPS

Europe (Paris) eu-west-3

rds.eu-west-3.amazonaws.com

rds.eu-west-3.api.aws

HTTPS

HTTPS

Europe (Espagne) eu-south-2

rds.eu-south-2.amazonaws.com

rds.eu-south-2.api.aws

HTTPS

HTTPS

Europe (Stockholm) eu-north-1

rds.eu-north-1.amazonaws.com

rds.eu-north-1.api.aws

HTTPS

HTTPS

Europe (Zurich) eu-central-2

rds.eu-central-2.amazonaws.com

rds.eu-central-2.api.aws

HTTPS

HTTPS

Israël (Tel Aviv) il-central-1

rds.il-central-1.amazonaws.com

rds.il-central-1.api.aws

HTTPS

HTTPS

Moyen-Orient (Bahreïn) me-south-1

rds.me-south-1.amazonaws.com

rds.me-south-1.api.aws

HTTPS

HTTPS

Moyen-Orient (EAU) me-central-1

rds.me-central-1.amazonaws.com

rds.me-central-1.api.aws

HTTPS

HTTPS

Amérique du Sud (São Paulo) sa-east-1

rds.sa-east-1.amazonaws.com

rds.sa-east-1.api.aws

HTTPS

HTTPS

AWS GovCloud (USA Est) us-gov-east-1

rds.us-gov-east-1.amazonaws.com

rds.us-gov-east-1.api.aws

HTTPS

HTTPS

AWS GovCloud (US-Ouest) us-gov-west-1

rds.us-gov-west-1.amazonaws.com

rds.us-gov-west-1.api.aws

HTTPS

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>

Exemples :

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

Cluster DB

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

Exemples :

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

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

Exemples :

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

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

Exemples :

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>

Exemples :

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>

Exemples :

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>

Exemples :

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

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

Exemples :

arn:aws:rds:us-east-2:123456789012:secgrp:my-public
Instantané de base de données automatique

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

Exemples :

arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23
Instantané de cluster de base de données automatique

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

Exemples :

arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16
Instantané de base de données manuel

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

Exemples :

arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap
Instantané de cluster de base de données manuel

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

Exemples :

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

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

Exemples :

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 à l'aide de l' AWS Management Console API, AWS Command Line Interface (AWS CLI) ou RDS.

Console

Pour obtenir un ARN auprès du AWS 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

AWS CLI

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.

AWS CLI commande Propriété d'ARN
describe-event-subscriptions EventSubscriptionArn
describe-certificates CertificateArn
describe-db-parameter-groups DB ParameterGroupArn
describe-db-cluster-parameter-groupes DB ClusterParameterGroupArn
describe-db-instances DB InstanceArn
describe-db-security-groups DB SecurityGroupArn
describe-db-snapshots DB SnapshotArn
describe-events SourceArn
describe-reserved-db-instances DB réservé InstanceArn
describe-db-subnet-groups DB SubnetGroupArn
describe-option-groups OptionGroupArn
describe-db-clusters DB ClusterArn
describe-db-cluster-snapshots DB ClusterSnapshotArn

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

Exemple

Pour LinuxmacOS, ou Unix :

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

Dans 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

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.

Opération d'API RDS Propriété d'ARN
DescribeEventSubscriptions EventSubscriptionArn
DescribeCertificates CertificateArn
Décrit B ParameterGroups DB ParameterGroupArn
Décrit B ClusterParameterGroups DB ClusterParameterGroupArn
DescribeDBInstances DB InstanceArn
Décrit B SecurityGroups DB SecurityGroupArn
DescribeDBSnapshots DB SnapshotArn
DescribeEvents SourceArn
DescribeReservedinstances de base de données DB réservé InstanceArn
Décrit B SubnetGroups DB SubnetGroupArn
DescribeOptionGroups OptionGroupArn
DescribeDBClusters DB ClusterArn
Décrit B ClusterSnapshots DB ClusterSnapshotArn