

# Nombres de recursos de Amazon (ARN) en Amazon RDS
<a name="USER_Tagging.ARN"></a>

Cada recurso que se crea en Amazon Web Services se identifica de forma inequívoca mediante un nombre de recurso de Amazon (ARN). Para determinadas operaciones de Amazon RDS, debe identificar de forma inequívoca un recurso de Amazon RDS mediante su ARN. Por ejemplo, al crear una réplica de lectura de una instancia de base de datos de RDS, debe proporcionar el ARN de la instancia de base de datos de origen. 

Para obtener información sobre la creación de un ARN y la obtención de un ARN existente, consulte los siguientes temas.

**Topics**
+ [Creación de un nombre ARN para Amazon RDS](USER_Tagging.ARN.Constructing.md)
+ [Obtención de un ARN existente para Amazon RDS](USER_Tagging.ARN.Getting.md)

# Creación de un nombre ARN para Amazon RDS
<a name="USER_Tagging.ARN.Constructing"></a>

Cada recurso que se crea en Amazon Web Services se identifica de forma inequívoca mediante un nombre de recurso de Amazon (ARN). Puede crear un ARN para un recurso de Amazon RDS utilizando la siguiente sintaxis. 

 `arn:aws:rds:<region>:<account number>:<resourcetype>:<name>` 

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.Constructing.html)

En la siguiente tabla se muestra el formato que debe utilizar al crear un ARN para un tipo de recurso concreto de Amazon RDS. 


****  

| Tipo de recurso | Formato de ARN | 
| --- | --- | 
| Instancia de base de datos  |  arn:aws:rds:*<region>*:*<account>*:db:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1</pre>  | 
| Clúster de base de datos |  arn:aws:rds:*<region>*:*<account>*:clúster:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1</pre>  | 
| Suscripción a eventos  |  arn:aws:rds:*<region>*:*<account>*:es:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:es:my-subscription</pre>  | 
| Grupo de opciones de base de datos  |  arn:aws:rds:*<region>*:*<account>*:og:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:og:my-og</pre>  | 
| DB Parameter Group (Grupo de parámetros de base de datos)  |  arn:aws:rds:*<region>*:*<account>*:pg:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs</pre>  | 
| Grupo de parámetros de clúster de base de datos  |  arn:aws:rds:*<region>*:*<account>*:clúster-pg:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone</pre>  | 
| Instancia de base de datos reservada  |  arn:aws:rds:*<region>*:*<account>*:ri:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql</pre>  | 
| Grupo de seguridad de base de datos  |  arn:aws:rds:*<region>*:*<account>*:secgrp:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:secgrp:my-public</pre>  | 
| Instantánea de base de datos automatizada |  arn:aws:rds:*<region>*:*<account>*:snapshot:rds:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23</pre>  | 
| Instantánea de clúster de base de datos automatizada |  arn:aws:rds:*<region>*:*<account>*:clúster-snapshot:rds:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16</pre>  | 
| Instantánea de base de datos manual |  arn:aws:rds:*<region>*:*<account>*:snapshot:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap</pre>  | 
| Instantánea de un clúster de base de datos manual |  arn:aws:rds:*<region>*:*<account>*:clúster-snapshot:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap</pre>  | 
| Grupo de subred de base de datos |  arn:aws:rds:*<region>*:*<account>*:subgrp:*<name>* Por ejemplo: <pre>arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10</pre>  | 

# Obtención de un ARN existente para Amazon RDS
<a name="USER_Tagging.ARN.Getting"></a>

Puede obtener el ARN de un recurso de RDS mediante la Consola de administración de AWS, la AWS Command Line Interface (AWS CLI) o la API de RDS. 

## Consola
<a name="USER_Tagging.ARN.CON"></a>

Para obtener un ARN desde la Consola de administración de AWS, vaya al recurso cuyo ARN desea obtener y consulte los detalles de ese recurso.

Por ejemplo, puede obtener el ARN de una instancia de base de datos desde la pestaña **Configuración** de los detalles de la instancia de base de datos.

![\[ARN de una instancia de base de datos.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/DB-instance-arn.png)


## AWS CLI
<a name="USER_Tagging.ARN.CLI"></a>

Para obtener el ARN de un recurso concreto de RDS desde la AWS CLI, se utiliza el comando `describe` con dicho recurso. En la siguiente tabla se muestran los distintos comandos de AWS CLI, junto con la propiedad ARN que se utiliza con el comando para obtener un ARN. 


****  
<a name="cli-command-arn-property"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.Getting.html)

Por ejemplo, el siguiente comando de la AWS CLI obtiene el ARN de una instancia de base de datos.

**Example**  
Para Linux, macOS o Unix:  

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

```
aws rds describe-db-instances ^
--db-instance-identifier DBInstanceIdentifier ^
--region us-west-2 ^
--query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"
```
El resultado de ese comando es como el siguiente:  

```
[
    {
        "DBInstanceArn": "arn:aws:rds:us-west-2:account_id:db:instance_id", 
        "DBInstanceIdentifier": "instance_id"
    }
]
```

## API de RDS
<a name="USER_Tagging.ARN.API"></a>

Para obtener el ARN de un recurso concreto de RDS, puede llamar a las siguientes operaciones de la API de RDS y utilizar las propiedades ARN que se muestran a continuación.


****  
<a name="rds-operation-arn-property"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.Getting.html)