Grundlegendes zu Amazon DocumentDB Amazon Resource Names () ARNs - Amazon DocumentDB
Konstruieren eines ARNSuche nach einem ARN

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Grundlegendes zu Amazon DocumentDB Amazon Resource Names () ARNs

Ressourcen, die Sie in erstellen, AWS sind jeweils eindeutig mit einem Amazon-Ressourcennamen (ARN) gekennzeichnet. Für bestimmte Amazon DocumentDB DocumentDB-Operationen (mit MongoDB-Kompatibilität) müssen Sie eine Amazon DocumentDB DocumentDB-Ressource eindeutig identifizieren, indem Sie ihre angeben. ARN Wenn Sie beispielsweise einer Ressource ein Tag hinzufügen, müssen Sie das der Ressource angeben. ARN

Eine ARN für eine Amazon DocumentDB DocumentDB-Ressource erstellen

Sie können eine ARN für eine Amazon DocumentDB DocumentDB-Ressource mit der folgenden Syntax erstellen. Amazon DocumentDB verwendet das Format von Amazon Relational Database Service (AmazonRDS). ARNS Amazon DocumentDB ARNs enthält rds und nichtdocdb.

arn:aws:rds:region:account_number:resource_type:resource_id

Name der Region Region Verfügbarkeitszonen (Datenverarbeitung)

USA Ost (Ohio)

us-east-2

3

USA Ost (Nord-Virginia)

us-east-1

6

USA West (Oregon)

us-west-2

4

Afrika (Kapstadt)

af-south-1

3

Südamerika (São Paulo)

sa-east-1

3

Asien-Pazifik (Hongkong)

ap-east-1

3

Asien-Pazifik (Hyderabad)

ap-south-2

3

Asien-Pazifik (Mumbai)

ap-south-1

3

Asien-Pazifik (Seoul)

ap-northeast-2

4

Asien-Pazifik (Singapur)

ap-southeast-1

3

Asien-Pazifik (Sydney)

ap-southeast-2

3

Asien-Pazifik (Tokio)

ap-northeast-1

3

Kanada (Zentral)

ca-central-1

3

Region China (Peking)

cn-north-1

3

China (Ningxia)

cn-northwest-1

3

Europa (Frankfurt)

eu-central-1

3

Europa (Irland)

eu-west-1

3

Europa (London)

eu-west-2

3

Europa (Milan)

eu-south-1

3

Europa (Paris)

eu-west-3

3

Europa (Spain)

eu-south-2

3

Naher Osten (UAE)

me-central-1

3
AWS GovCloud (US-West)

us-gov-west-1

3
AWS GovCloud (US-Ost)

us-gov-east-1

3
Anmerkung

Die Amazon DocumentDB DocumentDB-Architektur trennt Speicher und Datenverarbeitung. Für die Speicherebene repliziert Amazon DocumentDB sechs Kopien Ihrer Daten in drei AWS Availability Zones ()AZs. Die in der obigen Tabelle AZs aufgeführten sind die Anzahl der InstancesAZs, die Sie in einer bestimmten Region zur Bereitstellung von Compute-Instances verwenden können. Wenn Sie beispielsweise einen Amazon DocumentDB-Cluster in ap-northeast-1 starten, wird Ihr Speicher auf sechs Arten auf drei Arten repliziert, Ihre Compute-Instances sind AZs jedoch nur auf zwei verfügbar. AZs

Die folgende Tabelle zeigt das Format, das Sie verwenden sollten, wenn Sie eine ARN für eine bestimmte Amazon DocumentDB DocumentDB-Ressource erstellen. Amazon DocumentDB teilt das Format von Amazon RDSARNS. Amazon DocumentDB ARNs enthält rds und nichtdocdb.

Ressourcentyp ARNFormat//Beispiel

Instance (db)

arn:aws:rds:region:account_number:db:resource_id

arn:aws:rds:us-east-1:1234567890:db:sample-db-instance

Cluster (cluster)

arn:aws:rds:region:account_number:cluster:resource_id

arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster

Cluster-Parametergruppe (cluster-pg)

arn:aws:rds:region:account_number:cluster-pg:resource_id

arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group

Sicherheitsgruppe (secgrp)

arn:aws:rds:region:account_number:secgrp:resource_id

arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp

Cluster-Snapshot (cluster-snapshot)

arn:aws:rds:region:account_number:cluster-snapshot:resource_id

arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot

Subnetzgruppe (subgrp)

arn:aws:rds:region:account_number:subgrp:resource_id

arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10

Eine Amazon DocumentDB DocumentDB-Ressource finden ARN

Sie können die ARN einer Amazon DocumentDB DocumentDB-Ressource mit dem AWS Management Console oder dem AWS CLI finden.

Using the AWS Management Console

Um ARN mithilfe der Konsole nach einer Ressource zu suchen, navigieren Sie zu der Ressource, für die Sie eine Ressource ARN suchen, und sehen Sie sich die Details für diese Ressource an.

Sie können beispielsweise den Wert ARN für einen Cluster im Detailbereich für den Cluster abrufen, wie im folgenden Screenshot gezeigt.

Der Konsolen-Screenshot zeigt eine ARN im Bereich Konfigurationen und Status des Detailbereichs.
Using the AWS CLI

Um die AWS CLI für eine ARN bestimmte Amazon DocumentDB DocumentDB-Ressource zu verwenden, verwenden Sie den describe Vorgang für diese Ressource. Die folgende Tabelle zeigt jeden AWS CLI Vorgang und die ARN Eigenschaft, die mit dem Vorgang verwendet wird, um eine ARN zu erhalten.

AWS CLI Befehl ARNEigentum

describe-db-instances

DBInstanceArn

describe-db-clusters

DBClusterArn

describe-db-parameter-groups

DBParameterGroupArn

describe-db-cluster-parameter-groups

DBClusterParameterGroupArn

describe-db-security-groups

DBSecurityGroupArn

describe-db-snapshots

DBSnapshotArn

describe-db-cluster-snapshots

DBClusterSnapshotArn

describe-db-subnet-groups

DBSubnetGroupArn
Beispiel - Suche nach dem ARN für einen Cluster

Mit der folgenden AWS CLI Operation wird der ARN für den Cluster gefundensample-cluster.

Für Linux, macOS oder Unix:

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'

Für Windows:

aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'

Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSONFormat).

[
    "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]
Beispiel - ARNs Suche nach mehreren Parametergruppen

Für Linux, macOS oder Unix:

aws docdb describe-db-cluster-parameter-groups \
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'

Für Windows:

aws docdb describe-db-cluster-parameter-groups ^
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'

Die Ausgabe dieser Operation sieht ungefähr wie folgt aus (JSONFormat).

[
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp",
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6",
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6"
]