Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Descripción de los nombres de recursos de Amazon DocumentDB () ARNs
<a name="documentdb-arns"></a>

Cada uno de los recursos que cree AWS se identifica de forma única con un nombre de recurso de Amazon (ARN). Para determinadas operaciones de Amazon DocumentDB (compatible con MongoDB), debe identificar de forma inequívoca un recurso de Amazon DocumentDB mediante su ARN. Por ejemplo, cuando añade una etiqueta a un recurso, debe proporcionar el ARN del recurso. 

**Topics**
+ [Creación de un nombre ARN](#documentdb-arns-constructing)
+ [Búsqueda de un ARN](#documentdb-arns-find)

## Creación de un ARN para un recurso de Amazon DocumentDB
<a name="documentdb-arns-constructing"></a>

Puede crear un ARN para un recurso de Amazon DocumentDB utilizando la siguiente sintaxis. Amazon DocumentDB comparte el formato de Amazon Relational Database Service (Amazon RDS). ARNs Amazon DocumentDB ARNs contiene `rds` y no. `docdb`

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


| Nombre de la región | Region | Zonas de disponibilidad (cálculo) | 
| --- | --- | --- | 
| Este de EE. UU. (Ohio) | `us-east-2` | 3 | 
| Este de EE. UU. (Norte de Virginia) | `us-east-1` | 6 | 
| Oeste de EE. UU. (Oregón) | `us-west-2` | 4 | 
| África (Ciudad del Cabo) | `af-south-1` | 3 | 
| América del Sur (São Paulo) | `sa-east-1` | 3 | 
| Asia-Pacífico (Hong Kong) | `ap-east-1` | 3 | 
| Asia-Pacífico (Hyderabad) | `ap-south-2` | 3 | 
| Asia-Pacífico (Malasia) | `ap-southeast-5` | 3 | 
| Asia-Pacífico (Mumbai) | `ap-south-1` | 3 | 
| Asia-Pacífico (Osaka) | `ap-northeast-3` | 3 | 
| Asia-Pacífico (Seúl) | `ap-northeast-2` | 4 | 
| Asia-Pacífico (Singapur) | `ap-southeast-1` | 3 | 
| Asia-Pacífico (Sídney) | `ap-southeast-2` | 3 | 
| Asia-Pacífico (Yakarta) | `ap-southeast-3` | 3 | 
| Asia-Pacífico (Melbourne) | `ap-southeast-4` | 3 | 
| Asia-Pacífico (Tailandia) | `ap-southeast-7` | 3 | 
| Asia-Pacífico (Tokio) | `ap-northeast-1` | 3 | 
| Canadá (centro) | `ca-central-1` | 3 | 
| Región China (Pekín) | `cn-north-1` | 3 | 
| China (Ningxia) | `cn-northwest-1` | 3 | 
| Europa (Fráncfort) | `eu-central-1` | 3 | 
| Europa (Zúrich) | `eu-central-2` | 3 | 
| Europa (Irlanda) | `eu-west-1` | 3 | 
| Europa (Londres) | `eu-west-2` | 3 | 
| Europa (Milán) | `eu-south-1` | 3 | 
| Europa (París) | `eu-west-3` | 3 | 
| Europa (España) | `eu-south-2` | 3 | 
| Europa (Estocolmo) | `eu-north-1` | 3 | 
| México (centro) | `mx-central-1` | 3 | 
| Medio Oriente (EAU) | `me-central-1` | 3 | 
| Israel (Tel Aviv) | `il-central-1` | 3 | 
| AWS GovCloud (EE. UU.-Oeste) | `us-gov-west-1` | 3 | 
| AWS GovCloud (Estados Unidos-Este) | `us-gov-east-1` | 3 | 

**nota**  
La arquitectura de Amazon DocumentDB separa el almacenamiento y la computación. Para la capa de almacenamiento, Amazon DocumentDB replica seis copias de los datos en tres zonas de AWS disponibilidad (). AZs Las que AZs aparecen en la tabla anterior son las AZs que puede utilizar en una región determinada para aprovisionar instancias informáticas. Por ejemplo, si lanza un clúster de Amazon DocumentDB en ap-northeast-1, su almacenamiento se replicará de seis formas en tres, pero sus instancias de procesamiento solo estarán disponibles en dos. AZs AZs

En la siguiente tabla se muestra el formato que debe utilizar al crear un ARN para un tipo de recurso concreto de Amazon DocumentDB. Amazon DocumentDB comparte el formato de Amazon RDS. ARNs Amazon DocumentDB ARNs contiene `rds` y no. `docdb`


| Tipo de recurso | Formato de ARN / Ejemplo | 
| --- | --- | 
|  Instancia (`db`)  |  `arn:aws:rds:region:account_number:db:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:db:sample-db-instance</pre>  | 
|  Clúster (`cluster`)  |  `arn:aws:rds:region:account_number:cluster:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster</pre>  | 
|  Grupo de parámetros del clúster (`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>  | 
|  Grupo de seguridad (`secgrp`)  |  `arn:aws:rds:region:account_number:secgrp:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp</pre>  | 
|  Instantánea de clúster (`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>  | 
|  Grupo de subredes (`subgrp`)  |  `arn:aws:rds:region:account_number:subgrp:resource_id` <pre>arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10</pre>  | 

## Búsqueda de un ARN de recurso de Amazon DocumentDB
<a name="documentdb-arns-find"></a>

Puede encontrar el ARN de un recurso de Amazon DocumentDB mediante Consola de administración de AWS el o el. AWS CLI

------
#### [ Using the Consola de administración de AWS ]

Para buscar un ARN mediante la consola, vaya al recurso cuyo ARN desea obtener y consulte los detalles de ese recurso. 

Por ejemplo, puede obtener el ARN de un clúster desde la pestaña **Configuración** de los detalles del clúster. El ARN se encuentra en la sección **Configuraciones y estado**, como se muestra en la siguiente captura de pantalla.

![\[Captura de pantalla de la consola que muestra un ARN en la sección de configuraciones y estado del panel de detalles.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/documentdb-arn.png)


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

Para obtener un ARN mediante un recurso concreto de Amazon DocumentDB, utilice `describe` la operación AWS CLI para ese recurso. En la tabla siguiente se muestran cada AWS CLI operación y la propiedad ARN que se utiliza con la operación para obtener un ARN. 


| AWS CLI Comando | Propiedad 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 - Búsqueda del ARN de un clúster**  
La siguiente AWS CLI operación busca el ARN del clúster. `sample-cluster`  
Para Linux, macOS o Unix:  

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

```
aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).  

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

**Example - ARNs Búsqueda de varios grupos de parámetros**  
Para Linux, macOS o Unix:  

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

```
aws docdb describe-db-cluster-parameter-groups ^
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'
```
La salida de esta operación será similar a lo que se indica a continuación (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"
]
```

------