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
<a name="documentdb-arns"></a>

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

**Topics**
+ [Konstruieren eines ARN](#documentdb-arns-constructing)
+ [Suchen eines ARNs](#documentdb-arns-find)

## Einen ARN für eine Amazon DocumentDB DocumentDB-Ressource erstellen
<a name="documentdb-arns-constructing"></a>

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

`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 (Malaysia) | `ap-southeast-5` | 3 | 
| Asien-Pazifik (Mumbai) | `ap-south-1` | 3 | 
| Asien-Pazifik (Osaka) | `ap-northeast-3` | 3 | 
| Asien-Pazifik (Seoul) | `ap-northeast-2` | 4 | 
| Asien-Pazifik (Singapur) | `ap-southeast-1` | 3 | 
| Asien-Pazifik (Sydney) | `ap-southeast-2` | 3 | 
| Asien-Pazifik (Jakarta) | `ap-southeast-3` | 3 | 
| Asien-Pazifik (Melbourne) | `ap-southeast-4` | 3 | 
| Asien-Pazifik (Thailand) | `ap-southeast-7` | 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 (Zürich) | `eu-central-2` | 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 | 
| Europa (Stockholm) | `eu-north-1` | 3 | 
| Mexiko (Zentral) | `mx-central-1` | 3 | 
| Naher Osten (VAE) | `me-central-1` | 3 | 
| Israel (Tel Aviv) | `il-central-1` | 3 | 
| AWS GovCloud (USA 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 Instances AZs , 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 einen ARN für eine bestimmte Amazon DocumentDB DocumentDB-Ressource erstellen. Amazon DocumentDB teilt das Format von Amazon RDS ARNs. Amazon DocumentDB ARNs enthält `rds` und nicht`docdb`.


| Ressourcentyp | ARN-Format/Beispiel | 
| --- | --- | 
|  Instance (`db`)  |  `arn:aws:rds:region:account_number:db:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:db:sample-db-instance</pre>  | 
|  Cluster (`cluster`)  |  `arn:aws:rds:region:account_number:cluster:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster</pre>  | 
|  Cluster-Parametergruppe (`cluster-pg`)  |  `arn:aws:rds:region:account_number:cluster-pg:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group</pre>  | 
|  Sicherheitsgruppe (`secgrp`)  |  `arn:aws:rds:region:account_number:secgrp:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp</pre>  | 
|  Cluster-Snapshot (`cluster-snapshot`)  |  `arn:aws:rds:region:account_number:cluster-snapshot:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot</pre>  | 
|  Subnetzgruppe (`subgrp`)  |  `arn:aws:rds:region:account_number:subgrp:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10</pre>  | 

## Einen ARN für eine Amazon DocumentDB DocumentDB-Ressource finden
<a name="documentdb-arns-find"></a>

Sie können den ARN einer Amazon DocumentDB DocumentDB-Ressource mit dem AWS-Managementkonsole oder dem AWS CLI ermitteln.

------
#### [ Using the AWS-Managementkonsole ]

Um einen ARN über die Konsole zu suchen, 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 beispielsweise den ARN für einen Cluster abrufen, indem Sie auf der Cluster-Detailseite die Registerkarte **Konfiguration** auswählen. Die ARN finden Sie im Abschnitt **Konfigurationen und Status**, wie im folgenden Screenshot gezeigt.

![\[Konsolen-Screenshot mit einem ARN im Konfigurations- und Statusbereich des Detailbereichs.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/documentdb-arn.png)


------
#### [ Using the AWS CLI ]

Um einen ARN mit der AWS CLI für eine bestimmte Amazon DocumentDB DocumentDB-Ressource zu erhalten, 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 zum Abrufen eines ARN verwendet wird. 


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

**Example - ARN Ihres Clusters suchen**  
Mit der folgenden AWS CLI Operation wird der ARN für den Cluster ermittelt`sample-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 dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).  

```
[
    "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]
```

**Example - 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 in etwa folgendermaßen aus (JSON-Format).  

```
[
    "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"
]
```

------