Erstellen eines ARN Abrufen eines vorhandenen ARN

Arbeiten mit Amazon-Ressourcennamen (ARN) in Amazon RDS

In Amazon Web Services erstellte Ressourcen werden anhand eines Amazon-Ressourcennamens (ARN) eindeutig identifiziert. Für bestimmte Amazon RDS-Operationen müssen Sie eine Amazon RDS-Ressource eindeutig identifizieren, indem Sie ihren ARN angeben. Wenn Sie beispielsweise ein Lesereplikat einer RDS-DB-Instance erstellen, müssen Sie den ARN für die Quell-DB-Instance bereitstellen.

Erstellen eines ARN für Amazon RDS

In Amazon Web Services erstellte Ressourcen werden anhand eines Amazon-Ressourcennamens (ARN) eindeutig identifiziert. Sie können mithilfe der folgenden Syntax einen ARN für eine Amazon RDS-Ressource erstellen.

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

Name der Region	Region	Endpunkt	Protocol (Protokoll)
USA Ost (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
USA Ost (Nord-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 West (Nordkalifornien)	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
USA 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
Afrika (Kapstadt)	af-south-1	rds.af-south-1.amazonaws.com rds.af-south-1.api.aws	HTTPS HTTPS
Asien-Pazifik (Hongkong)	ap-east-1	rds.ap-east-1.amazonaws.com rds.ap-east-1.api.aws	HTTPS HTTPS
Asien-Pazifik (Hyderabad)	ap-south-2	rds.ap-south-2.amazonaws.com rds.ap-south-2.api.aws	HTTPS HTTPS
Asien-Pazifik (Jakarta)	ap-southeast-3	rds.ap-southeast-3.amazonaws.com rds.ap-southeast-3.api.aws	HTTPS HTTPS
Asien-Pazifik (Melbourne)	ap-southeast-4	rds.ap-southeast-4.amazonaws.com rds.ap-southeast-4.api.aws	HTTPS HTTPS
Asien-Pazifik (Mumbai)	ap-south-1	rds.ap-south-1.amazonaws.com rds.ap-south-1.api.aws	HTTPS HTTPS
Asien-Pazifik (Osaka)	ap-northeast-3	rds.ap-northeast-3.amazonaws.com rds.ap-northeast-3.api.aws	HTTPS HTTPS
Asien-Pazifik (Seoul)	ap-northeast-2	rds.ap-northeast-2.amazonaws.com rds.ap-northeast-2.api.aws	HTTPS HTTPS
Asien-Pazifik (Singapur)	ap-southeast-1	rds.ap-southeast-1.amazonaws.com rds.ap-southeast-1.api.aws	HTTPS HTTPS
Asien-Pazifik (Sydney)	ap-southeast-2	rds.ap-southeast-2.amazonaws.com rds.ap-southeast-2.api.aws	HTTPS HTTPS
Asien-Pazifik (Tokio)	ap-northeast-1	rds.ap-northeast-1.amazonaws.com rds.ap-northeast-1.api.aws	HTTPS HTTPS
Kanada (Zentral)	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
Kanada West (Calgary)	ca-west-1	rds.ca-west-1.amazonaws.com rds-fips.ca-west-1.amazonaws.com	HTTPS HTTPS
Europa (Frankfurt)	eu-central-1	rds.eu-central-1.amazonaws.com rds.eu-central-1.api.aws	HTTPS HTTPS
Europa (Irland)	eu-west-1	rds.eu-west-1.amazonaws.com rds.eu-west-1.api.aws	HTTPS HTTPS
Europa (London)	eu-west-2	rds.eu-west-2.amazonaws.com rds.eu-west-2.api.aws	HTTPS HTTPS
Europa (Mailand)	eu-south-1	rds.eu-south-1.amazonaws.com rds.eu-south-1.api.aws	HTTPS HTTPS
Europa (Paris)	eu-west-3	rds.eu-west-3.amazonaws.com rds.eu-west-3.api.aws	HTTPS HTTPS
Europa (Spanien)	eu-south-2	rds.eu-south-2.amazonaws.com rds.eu-south-2.api.aws	HTTPS HTTPS
Europa (Stockholm)	eu-north-1	rds.eu-north-1.amazonaws.com rds.eu-north-1.api.aws	HTTPS HTTPS
Europa (Zürich)	eu-central-2	rds.eu-central-2.amazonaws.com rds.eu-central-2.api.aws	HTTPS HTTPS
Israel (Tel Aviv)	il-central-1	rds.il-central-1.amazonaws.com rds.il-central-1.api.aws	HTTPS HTTPS
Naher Osten (Bahrain)	me-south-1	rds.me-south-1.amazonaws.com rds.me-south-1.api.aws	HTTPS HTTPS
Naher Osten (VAE)	me-central-1	rds.me-central-1.amazonaws.com rds.me-central-1.api.aws	HTTPS HTTPS
Südamerika (São Paulo)	sa-east-1	rds.sa-east-1.amazonaws.com rds.sa-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (US-Ost)	us-gov-east-1	rds.us-gov-east-1.amazonaws.com rds.us-gov-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (US-West)	us-gov-west-1	rds.us-gov-west-1.amazonaws.com rds.us-gov-west-1.api.aws	HTTPS HTTPS

Die folgende Tabelle zeigt das Format, das Sie beim Erstellen eines ARN für einen bestimmten Amazon RDS-Ressourcentyp verwenden sollten.

Ressourcentyp	ARN-Format
DB-Instance	arn:aws:rds:`<region>`:`<account>`:db:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1`
DB-Cluster	arn:aws:rds:`<region>`:`<account>`:cluster:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1`
Ereignisabonnement	arn:aws:rds:`<region>`:`<account>`:es:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:es:my-subscription`
DB-Optionsgruppe	arn:aws:rds:`<region>`:`<account>`:og:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:og:my-og`
DB-Parametergruppe	arn:aws:rds:`<region>`:`<account>`:pg:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs`
DB-Cluster-Parametergruppe	arn:aws:rds:`<region>`:`<account>`:cluster-pg:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone`
Reservierte DB-Instance	arn:aws:rds:`<region>`:`<account>`:ri:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql`
DB-Sicherheitsgruppe	arn:aws:rds:`<region>`:`<account>`:secgrp:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:secgrp:my-public`
Automatisierter DB-Snapshot	arn:aws:rds:`<region>`:`<account>`:snapshot:rds:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23`
Automatisierter DB-Cluster-Snapshot	arn:aws:rds:`<region>`:`<account>`:cluster-snapshot:rds:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16`
Manueller DB-Snapshot	arn:aws:rds:`<region>`:`<account>`:snapshot:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap`
Manueller DB-Cluster-Snapshot	arn:aws:rds:`<region>`:`<account>`:cluster-snapshot:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap`
DB-Subnetzgruppe	arn:aws:rds:`<region>`:`<account>`:subgrp:`<name>` Zum Beispiel: `arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10`

Abrufen eines vorhandenen ARN

Sie können den ARN einer RDS-Ressource mithilfe der AWS Management Console, AWS Command Line Interface (AWS CLI) oder der RDS-API abrufen.

Konsole

Um einen ARN von der zu erhalten AWS Management Console, navigieren Sie zu der Ressource, für die Sie einen ARN benötigen, und sehen Sie sich die Details für diese Ressource an.

Sie können den ARN für eine DB-Instance beispielsweise auf der Seite Konfiguration der DB-Instance-Details abrufen.

AWS CLI

Um einen ARN AWS CLI für eine bestimmte RDS-Ressource abzurufen, verwenden Sie den describe Befehl für diese Ressource. Die folgende Tabelle zeigt jeden AWS CLI Befehl und die ARN-Eigenschaft, die mit dem Befehl verwendet wird, um einen ARN abzurufen.

AWS CLI Befehl	ARN-Eigenschaft
describe-event-subscriptions	EventSubscriptionArn
describe-certificates	CertificateArn
describe-db-parameter-groups	DB ParameterGroupArn
describe-db-cluster-parameter-Gruppen	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	Reservierte Datenbank InstanceArn
describe-db-subnet-groups	DB SubnetGroupArn
describe-option-groups	OptionGroupArn
describe-db-clusters	DB ClusterArn
describe-db-cluster-snapshots	DB ClusterSnapshotArn

Mit dem folgenden AWS CLI Befehl wird beispielsweise der ARN für eine DB-Instance abgerufen.

Beispiel

Für LinuxmacOS, oderUnix:


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

Windows:


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

Die Ausgabe dieses Befehls sieht wie folgt aus:



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

RDS-API

Um einen ARN für eine bestimmte RDS-Ressource abzurufen, können Sie die folgenden RDS-API-Operationen aufrufen und die folgenden ARN-Eigenschaften verwenden.

RDS-API-Operation	ARN-Eigenschaft
DescribeEventSubscriptions	EventSubscriptionArn
DescribeCertificates	CertificateArn
Beschrieben B ParameterGroups	DB ParameterGroupArn
Beschrieben B ClusterParameterGroups	DB ClusterParameterGroupArn
DescribeDBInstances	DB InstanceArn
Beschrieben B SecurityGroups	DB SecurityGroupArn
DescribeDBSnapshots	DB SnapshotArn
DescribeEvents	SourceArn
DescribeReservedDB-Instances	Reservierte Datenbank InstanceArn
Beschriebenes B SubnetGroups	DB SubnetGroupArn
DescribeOptionGroups	OptionGroupArn
DescribeDBClusters	DB ClusterArn
Beschrieben B ClusterSnapshots	DB ClusterSnapshotArn

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Markieren von RDS-Ressourcen

Arbeiten mit Speicher