# Nomes de recurso da Amazon (ARNs) no Amazon RDS
<a name="USER_Tagging.ARN"></a>

Os recursos criados na Amazon Web Services são identificados de forma exclusiva com um nome de recurso da Amazon (ARN). Para determinadas operações do Amazon RDS, você precisará identificar exclusivamente um recurso do Amazon RDS especificando seu ARN. Por exemplo, quando você cria uma réplica de leitura da instância de banco de dados do RDS, é necessário fornecer o ARN para a instância de banco de dados de origem. 

Para ter informações sobre como criar um ARN e obter um ARN existente, consulte os tópicos a seguir.

**Topics**
+ [Criar um ARN para o Amazon RDS](USER_Tagging.ARN.Constructing.md)
+ [Obter um ARN existente para o Amazon RDS](USER_Tagging.ARN.Getting.md)

# Criar um ARN para o Amazon RDS
<a name="USER_Tagging.ARN.Constructing"></a>

Os recursos criados na Amazon Web Services são identificados de forma exclusiva com um nome de recurso da Amazon (ARN). Você pode criar um ARN para um recurso do Amazon RDS usando a seguinte sintaxe. 

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

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

A tabela a seguir mostra o formato que deve ser usado para criar um ARN para um tipo de recurso específico do Amazon RDS. 


****  

| Tipo de recurso | Formato ARN | 
| --- | --- | 
| Instância de banco de dados  |  arn:aws:rds:*<region>*:*<account>*:db:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1</pre>  | 
| Cluster de banco de dados |  arn:aws:rds:*<region>*:*<account>*:cluster:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1</pre>  | 
| Assinatura de eventos  |  arn:aws:rds:*<region>*:*<account>*:es:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:es:my-subscription</pre>  | 
| Grupo de opções do banco de dados  |  arn:aws:rds:*<region>*:*<account>*:og:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:og:my-og</pre>  | 
| DB parameter group (Grupo de parâmetros de banco de dados)  |  arn:aws:rds:*<region>*:*<account>*:pg:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs</pre>  | 
| Parameter group do cluster de banco de dados  |  arn:aws:rds:*<region>*:*<account>*:cluster-pg:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone</pre>  | 
| Instância de banco de dados reservada  |  arn:aws:rds:*<region>*:*<account>*:ri:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql</pre>  | 
| Grupo de segurança de banco de dados  |  arn:aws:rds:*<region>*:*<account>*:secgrp:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:secgrp:my-public</pre>  | 
| Snapshot de banco de dados automatizado |  arn:aws:rds:*<region>*:*<account>*:snapshot:rds:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23</pre>  | 
| Snapshot de cluster de banco de dados automatizado |  arn:aws:rds:*<region>*:*<account>*:cluster-snapshot:rds:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16</pre>  | 
| Snapshot de banco de dados manual |  arn:aws:rds:*<region>*:*<account>*:snapshot:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap</pre>  | 
| Snapshot de cluster de banco de dados manual |  arn:aws:rds:*<region>*:*<account>*:cluster-snapshot:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap</pre>  | 
| Grupo de sub-rede de banco de dados |  arn:aws:rds:*<region>*:*<account>*:subgrp:*<name>* Por exemplo: <pre>arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10</pre>  | 

# Obter um ARN existente para o Amazon RDS
<a name="USER_Tagging.ARN.Getting"></a>

Você pode obter o ARN de um recurso do RDS usando o Console de gerenciamento da AWS, a AWS Command Line Interface (AWS CLI) ou a API do RDS. 

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

Para obter um ARN do Console de gerenciamento da AWS, navegue até o recurso para o qual deseja um ARN e veja os detalhes desse recurso.

Por exemplo, é possível obter o ARN de uma instância de banco de dados da guia **Configuração** dos detalhes da instância de banco de dados.

![\[ARN da instância de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/DB-instance-arn.png)


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

Para obter um ARN a partir da AWS CLI para um recurso do RDS específico, use o comando `describe` para esse recurso. A tabela a seguir mostra cada comando da AWS CLI e a propriedade do ARN usada com o comando para obter um ARN. 


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

Por exemplo, o seguinte comando da AWS CLI obtém o ARN para uma instância de banco de dados.

**Example**  
Para Linux, macOS ou 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}"
```
A saída desse comando é semelhante à seguinte:  

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

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

Para obter um ARN para um recurso do RDS específico, é possível chamar as seguintes operações da API do RDS e usar as propriedades do ARN mostradas a seguir.


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