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
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 (USA-Ost)	us-gov-east-1	rds.us-gov-east-1.amazonaws.com rds.us-gov-east-1.api.aws	HTTPS HTTPS
AWS GovCloud (USA-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 für eine RDS-Ressource über die AWS Management Console, AWS Command Line Interface (AWS CLI) oder RDS-API abrufen.

Konsole

Um einen ARN aus der AWS Management Console abzurufen, navigieren Sie zu der Ressource, für die Sie einen ARN erhalten möchten, und zeigen Sie 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 aus der AWS CLI für eine bestimmte RDS-Ressource abzurufen, verwenden Sie den Befehl describe für diese Ressource. Die folgende Tabelle zeigt die einzelnen AWS CLI-ARN-Befehle sowie die ARN-Eigenschaft, die mit dem Befehl verwendet wird, um einen ARN abzurufen.

AWS CLI command	ARN-Eigenschaft
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

Der folgende AWS CLI-Befehl ruft die ARN für eine DB-Instance ab.

Beispiel

Für Linux, macOS oder Unix:


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

Für 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
DescribeDBParameterGroups	DBParameterGroupArn
DescribeDBClusterParameterGroups	DBClusterParameterGroupArn
DescribeDBInstances	DBInstanceArn
DescribeDBSecurityGroups	DBSecurityGroupArn
DescribeDBSnapshots	DBSnapshotArn
DescribeEvents	SourceArn
DescribeReservedDBInstances	ReservedDBInstanceArn
DescribeDBSubnetGroups	DBSubnetGroupArn
DescribeOptionGroups	OptionGroupArn
DescribeDBClusters	DBClusterArn
DescribeDBClusterSnapshots	DBClusterSnapshotArn

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