Amazon Relational Database Service
用户指南 (API 版本 2014-10-31)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

在 Amazon RDS 中使用 Amazon 资源名称 (ARN)

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

构建 Amazon RDS 的 ARN

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

arn:aws-cn:rds:<region>:<account number>:<resourcetype>:<name>

区域 名称 终端节点
美国西部(俄勒冈)区域 us-west-2 https://rds.us-west-2.amazonaws.com
美国西部(加利福利亚北部)区域 us-west-1 https://rds.us-west-1.amazonaws.com
美国东部(俄亥俄)区域 us-east-2 https://rds.us-east-2.amazonaws.com
美国东部(弗吉尼亚北部)地区 us-east-1 https://rds.us-east-1.amazonaws.com
亚太地区 (孟买) 区域 ap-south-1 https://rds.ap-south-1.amazonaws.com
亚太区域(首尔) ap-northeast-2 https://rds.ap-northeast-2.amazonaws.com
亚太区域(新加坡) ap-southeast-1 https://rds.ap-southeast-1.amazonaws.com
亚太区域(悉尼) ap-southeast-2 https://rds.ap-southeast-2.amazonaws.com
亚太区域(东京) ap-northeast-1 https://rds.ap-northeast-1.amazonaws.com
加拿大 (中部) 区域 ca-central-1 https://rds.ca-central-1.amazonaws.com
中国(北京)区域 cn-north-1 https://rds.cn-north-1.amazonaws.com.cn
欧洲(法兰克福)区域 eu-central-1 https://rds.eu-central-1.amazonaws.com
欧洲(爱尔兰)区域 eu-west-1 https://rds.eu-west-1.amazonaws.com
欧洲 (伦敦) 区域 eu-west-2 https://rds.eu-west-2.amazonaws.com
欧洲 (巴黎) 区域 eu-west-3 https://rds.eu-west-3.amazonaws.com
南美洲(圣保罗)区域 sa-east-1 https://rds.sa-east-1.amazonaws.com
AWS GovCloud(美国) us-gov-west-1 https://rds.us-gov-west-1.amazonaws.com

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

资源类型 ARN 格式
数据库实例

arn:aws-cn:rds:<region>:<account>:db:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:db:my-mysql-instance-1

数据库集群

arn:aws-cn:rds:<region>:<account>:cluster:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:cluster:my-aurora-cluster-1
事件订阅

arn:aws-cn:rds:<region>:<account>:es:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:es:my-subscription
数据库选项组

arn:aws-cn:rds:<region>:<account>:og:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:og:my-og-oracle-tde
数据库参数组

arn:aws-cn:rds:<region>:<account>:pg:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:pg:my-param-enable-logs
数据库集群参数组

arn:aws-cn:rds:<region>:<account>:cluster-pg:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:cluster-pg:my-cluster-param-timezone
预留数据库实例

arn:aws-cn:rds:<region>:<account>:ri:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:ri:my-reserved-postgresql
数据库安全组

arn:aws-cn:rds:<region>:<account>:secgrp:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:secgrp:my-public
数据库快照

arn:aws-cn:rds:<region>:<account>:snapshot:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:snapshot:my-mysql-snap-20130507
数据库集群快照

arn:aws-cn:rds:<region>:<account>:cluster-snapshot:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:cluster-snapshot:my-aurora-snap-20160809
数据库子网组

arn:aws-cn:rds:<region>:<account>:subgrp:<name>

例如:

arn:aws-cn:rds:us-east-2:123456789012:subgrp:my-subnet-10

获取现有 ARN

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

AWS 管理控制台

要从 AWS 管理控制台中获取一个 ARN,请导航到要获取 ARN 的资源,然后查看该资源的详细信息。例如,您可以从数据库实例详细信息中获取数据库实例的 ARN,如下所示。

 数据库实例 ARN

AWS CLI

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

AWS CLI 命令 ARN 属性
describe-event-subscriptions EventSubscriptionArn
describe-certificates CertificateArn
describe-db-parameter-groups DBParameterGroupArn
describe-db-cluster-parameter-groups DBClusterParameterGroupArn
describe-db-instances DBInstanceArn
describe-db-security-groups DBSecurityGroupArn
describe-db-snapshots DBSnapshotArn
describe-events SourceArn
describe-reserved-db-instances ReservedDBInstanceArn
describe-db-subnet-groups DBSubnetGroupArn
describe-option-groups OptionGroupArn
describe-db-clusters DBClusterArn
describe-db-cluster-snapshots DBClusterSnapshotArn

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

针对 Linux、OS X 或 Unix:

aws rds describe-db-instances \ --db-instance-identifier DBInstanceIdentifier \ --region us-west-2

对于 Windows:

aws rds describe-db-instances ^ --db-instance-identifier DBInstanceIdentifier ^ --region us-west-2

API

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

RDS API 操作 ARN 属性
DescribeEventSubscriptions EventSubscriptionArn
DescribeCertificates CertificateArn
DescribeDBParameterGroups DBParameterGroupArn
DescribeDBClusterParameterGroups DBClusterParameterGroupArn
DescribeDBInstances DBInstanceArn
DescribeDBSecurityGroups DBSecurityGroupArn
DescribeDBSnapshots DBSnapshotArn
DescribeEvents SourceArn
DescribeReservedDBInstances ReservedDBInstanceArn
DescribeDBSubnetGroups DBSubnetGroupArn
DescribeOptionGroups OptionGroupArn
DescribeDBClusters DBClusterArn
DescribeDBClusterSnapshots DBClusterSnapshotArn

本页内容: