

# Amazon RDS 中的 Amazon 资源名称（ARN）
<a name="USER_Tagging.ARN"></a>

Amazon Web Services 中创建的资源分别使用 Amazon Resource Name (ARN) 进行唯一标识。对于某些 Amazon RDS 操作，您必须通过指定 Amazon RDS 资源的 ARN 来唯一标识该资源。例如，当您创建 RDS 数据库实例只读副本时，必须提供源数据库实例的 ARN。

有关构造 ARN 和获取现有 ARN 的信息，请参阅以下主题。

**Topics**
+ [构建 Amazon RDS 的 ARN](USER_Tagging.ARN.Constructing.md)
+ [获取 Amazon RDS 的现有 ARN](USER_Tagging.ARN.Getting.md)

# 构建 Amazon RDS 的 ARN
<a name="USER_Tagging.ARN.Constructing"></a>

Amazon Web Services 中创建的资源分别使用 Amazon Resource Name (ARN) 进行唯一标识。您可以使用以下语法为 Amazon RDS 资源构建 ARN。

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

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

下表显示在构建特定 Amazon RDS 资源类型的 ARN 时应使用的格式。


****  

| 资源类型 | ARN 格式 | 
| --- | --- | 
| 数据库实例  |  arn:aws:rds:*<region>*:*<account>*:db:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:db:my-mysql-instance-1</pre>  | 
| 数据库群集 |  arn:aws:rds:*<region>*:*<account>*:cluster:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1</pre>  | 
| 事件订阅  |  arn:aws:rds:*<region>*:*<account>*:es:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:es:my-subscription</pre>  | 
| 数据库选项组  |  arn:aws:rds:*<region>*:*<account>*:og:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:og:my-og</pre>  | 
| 数据库参数组  |  arn:aws:rds:*<region>*:*<account>*:pg:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:pg:my-param-enable-logs</pre>  | 
| 数据库集群参数组  |  arn:aws:rds:*<region>*:*<account>*:cluster-pg:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone</pre>  | 
| 预留数据库实例  |  arn:aws:rds:*<region>*:*<account>*:ri:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:ri:my-reserved-postgresql</pre>  | 
| 数据库安全组  |  arn:aws:rds:*<region>*:*<account>*:secgrp:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:secgrp:my-public</pre>  | 
| 自动数据库快照 |  arn:aws:rds:*<region>*:*<account>*:snapshot:rds:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:snapshot:rds:my-mysql-db-2019-07-22-07-23</pre>  | 
| 自动数据库集群快照 |  arn:aws:rds:*<region>*:*<account>*:cluster-snapshot:rds:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:rds:my-aurora-cluster-2019-07-22-16-16</pre>  | 
| 手动数据库快照 |  arn:aws:rds:*<region>*:*<account>*:snapshot:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:snapshot:my-mysql-db-snap</pre>  | 
| 手动数据库集群快照 |  arn:aws:rds:*<region>*:*<account>*:cluster-snapshot:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-cluster-snap</pre>  | 
| 数据库子网组 |  arn:aws:rds:*<region>*:*<account>*:subgrp:*<name>* 例如： <pre>arn:aws:rds:us-east-2:123456789012:subgrp:my-subnet-10</pre>  | 

# 获取 Amazon RDS 的现有 ARN
<a name="USER_Tagging.ARN.Getting"></a>

您可以使用 AWS 管理控制台、AWS Command Line Interface (AWS CLI) 或 RDS API 来获取 RDS 资源的 ARN。

## 控制台
<a name="USER_Tagging.ARN.CON"></a>

要从 AWS 管理控制台中获取一个 ARN，请导航到要获取 ARN 的资源，然后查看该资源的详细信息。

例如，您可以从数据库实例详细信息的**配置**选项卡获取数据库实例的 ARN。

![\[数据库实例 ARN。\]](http://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/DB-instance-arn.png)


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

要从 AWS CLI 为特定 RDS 资源获取 ARN，请对该资源使用 `describe` 命令。下表显示了每个 AWS CLI 命令，以及与命令配合使用以获取 ARN 的 ARN 属性。


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

例如，以下 AWS CLI 命令获取数据库实例的 ARN。

**Example**  
对于 Linux、macOS 或 Unix：  

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

```
aws rds describe-db-instances ^
--db-instance-identifier DBInstanceIdentifier ^
--region us-west-2 ^
--query "*[].{DBInstanceIdentifier:DBInstanceIdentifier,DBInstanceArn:DBInstanceArn}"
```
该命令的输出如下所示：  

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

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

要为特定 RDS 资源获取 ARN，您可以调用以下 RDS API 操作并使用如下所示的 ARN 属性。


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