Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Informazioni su Amazon DocumentDB Amazon Resource Names () ARNs
<a name="documentdb-arns"></a>

Le risorse che AWS crei sono identificate in modo univoco con un Amazon Resource Name (ARN). Per alcune operazioni con Amazon DocumentDB (con compatibilità con MongoDB), devi identificare in modo univoco una risorsa Amazon DocumentDB specificandone l'ARN. Ad esempio, quando aggiungi un tag a una risorsa, devi fornire l'ARN della risorsa. 

**Topics**
+ [Costruzione di un ARN](#documentdb-arns-constructing)
+ [Ricerca di un ARN](#documentdb-arns-find)

## Creazione di un ARN per una risorsa Amazon DocumentDB
<a name="documentdb-arns-constructing"></a>

Puoi creare un ARN per una risorsa Amazon DocumentDB utilizzando la seguente sintassi. Amazon DocumentDB condivide il formato di Amazon Relational Database Service (Amazon RDS). ARNs Amazon DocumentDB ARNs contiene `rds` e non contiene. `docdb`

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


| Nome della regione | Regione | Zone di disponibilità (elaborazione) | 
| --- | --- | --- | 
| Stati Uniti orientali (Ohio) | `us-east-2` | 3 | 
| Stati Uniti orientali (Virginia settentrionale) | `us-east-1` | 6 | 
| Stati Uniti occidentali (Oregon) | `us-west-2` | 4 | 
| Africa (Città del Capo) | `af-south-1` | 3 | 
| Sud America (San Paolo) | `sa-east-1` | 3 | 
| Asia Pacifico (Hong Kong) | `ap-east-1` | 3 | 
| Asia Pacifico (Hyderabad) | `ap-south-2` | 3 | 
| Asia Pacifico (Malesia) | `ap-southeast-5` | 3 | 
| Asia Pacifico (Mumbai) | `ap-south-1` | 3 | 
| Asia Pacifico (Osaka) | `ap-northeast-3` | 3 | 
| Asia Pacifico (Seul) | `ap-northeast-2` | 4 | 
| Asia Pacifico (Singapore) | `ap-southeast-1` | 3 | 
| Asia Pacifico (Sydney) | `ap-southeast-2` | 3 | 
| Asia Pacifico (Giacarta) | `ap-southeast-3` | 3 | 
| Asia Pacifico (Melbourne) | `ap-southeast-4` | 3 | 
| Asia Pacifico (Thailandia) | `ap-southeast-7` | 3 | 
| Asia Pacifico (Tokyo) | `ap-northeast-1` | 3 | 
| Canada (Centrale) | `ca-central-1` | 3 | 
| Regione Cina (Pechino) | `cn-north-1` | 3 | 
| Cina (Ningxia) | `cn-northwest-1` | 3 | 
| Europa (Francoforte) | `eu-central-1` | 3 | 
| Europa (Zurigo) | `eu-central-2` | 3 | 
| Europa (Irlanda) | `eu-west-1` | 3 | 
| Europa (Londra) | `eu-west-2` | 3 | 
| Europa (Milano) | `eu-south-1` | 3 | 
| Europa (Parigi) | `eu-west-3` | 3 | 
| Europa (Spagna) | `eu-south-2` | 3 | 
| Europa (Stoccolma) | `eu-north-1` | 3 | 
| Messico (centrale) | `mx-central-1` | 3 | 
| Medio Oriente (Emirati Arabi Uniti) | `me-central-1` | 3 | 
| Israele (Tel Aviv) | `il-central-1` | 3 | 
| AWS GovCloud (Stati Uniti occidentali) | `us-gov-west-1` | 3 | 
| AWS GovCloud (Stati Uniti orientali) | `us-gov-east-1` | 3 | 

**Nota**  
L'architettura Amazon DocumentDB separa storage ed elaborazione. Per il livello di storage, Amazon DocumentDB replica sei copie dei dati in tre zone di AWS disponibilità (). AZs AZs Quelli elencati nella tabella precedente sono il numero di istanze AZs che è possibile utilizzare in una determinata regione per fornire istanze di calcolo. Ad esempio, se avvii un cluster Amazon DocumentDB in ap-northeast-1, lo storage verrà replicato in sei modi su tre, ma le istanze di calcolo saranno disponibili solo in due. AZs AZs

La tabella seguente mostra il formato da utilizzare per creare un ARN per una particolare risorsa Amazon DocumentDB. Amazon DocumentDB condivide il formato di Amazon RDS. ARNs Amazon DocumentDB ARNs contiene `rds` e non contiene. `docdb`


| Tipo di risorsa | Formato ARN/Esempio | 
| --- | --- | 
|  Istanza (`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>  | 
|  Gruppo di parametri del cluster (`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>  | 
|  Gruppo di sicurezza (`secgrp`)  |  `arn:aws:rds:region:account_number:secgrp:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp</pre>  | 
|  Snapshot del cluster (`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>  | 
|  Gruppo di sottoreti (`subgrp`)  |  `arn:aws:rds:region:account_number:subgrp:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10</pre>  | 

## Ricerca dell'ARN di una risorsa Amazon DocumentDB
<a name="documentdb-arns-find"></a>

Puoi trovare l'ARN di una risorsa Amazon DocumentDB utilizzando Console di gestione AWS o il. AWS CLI

------
#### [ Using the Console di gestione AWS ]

Per trovare un ARN utilizzando la console, accedi alla risorsa di cui desideri l'ARN e visualizzane i relativi dettagli. 

Ad esempio, è possibile ottenere l'ARN per un cluster selezionando la scheda **Configurazione** nella pagina dei dettagli del cluster. L'ARN è disponibile nella sezione **Configurazioni e stato**, come mostrato nella schermata seguente.

![\[Screenshot della console che mostra un ARN nella sezione sullo stato e le configurazioni del riquadro dei dettagli.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/documentdb-arn.png)


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

Per ottenere un ARN utilizzando il AWS CLI per una particolare risorsa Amazon DocumentDB, usa `describe` l'operazione per quella risorsa. La tabella seguente mostra ogni AWS CLI operazione e la proprietà ARN utilizzata con l'operazione per ottenere un ARN. 


| AWS CLI Comando | Proprietà ARN | 
| --- | --- | 
|  `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 - Ricerca dell'ARN per un cluster**  
L' AWS CLI operazione seguente trova l'ARN per il cluster. `sample-cluster`  
Per Linux, macOS o Unix:  

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

```
aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).  

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

**Example - ARNs Ricerca di più gruppi di parametri**  
Per Linux, macOS o Unix:  

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

```
aws docdb describe-db-cluster-parameter-groups ^
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).  

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

------