Construction d'un ARN Obtention d'un ARN existant

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 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'un cluster de base de données dans l'onglet Configuration des détails de ce cluster.

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-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
DescribeDBClusters	DB ClusterArn
Décrit B ClusterSnapshots	DB ClusterSnapshotArn

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Balisage des ressources RDS

Mises à jour d'Aurora