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

Region Name Region Endpoint Protocol
美国东部 (俄亥俄) us-east-2 rds.us-east-2.amazonaws.com HTTPS
美国东部 (弗吉尼亚北部) us-east-1 rds.us-east-1.amazonaws.com HTTPS
美国西部 (加利福尼亚北部) us-west-1 rds.us-west-1.amazonaws.com HTTPS
美国西部 (俄勒冈) us-west-2 rds.us-west-2.amazonaws.com HTTPS
亚太区域 (香港) ap-east-1 rds.ap-east-1.amazonaws.com HTTPS
亚太区域 (孟买) ap-south-1 rds.ap-south-1.amazonaws.com HTTPS
亚太区域(大阪本地) ap-northeast-3 rds.ap-northeast-3.amazonaws.com HTTPS
亚太区域 (首尔) ap-northeast-2 rds.ap-northeast-2.amazonaws.com HTTPS
亚太地区 (新加坡) ap-southeast-1 rds.ap-southeast-1.amazonaws.com HTTPS
亚太地区 (悉尼) ap-southeast-2 rds.ap-southeast-2.amazonaws.com HTTPS
亚太地区 (东京) ap-northeast-1 rds.ap-northeast-1.amazonaws.com HTTPS
加拿大(中部) ca-central-1 rds.ca-central-1.amazonaws.com HTTPS
中国 (北京) cn-north-1 rds.cn-north-1.amazonaws.com.cn HTTPS
China (Ningxia) cn-northwest-1 rds.cn-northwest-1.amazonaws.com.cn HTTPS
欧洲 (法兰克福) eu-central-1 rds.eu-central-1.amazonaws.com HTTPS
欧洲 (爱尔兰) eu-west-1 rds.eu-west-1.amazonaws.com HTTPS
欧洲 (伦敦) eu-west-2 rds.eu-west-2.amazonaws.com HTTPS
欧盟 (巴黎) eu-west-3 rds.eu-west-3.amazonaws.com HTTPS
欧盟 (斯德哥尔摩) eu-north-1 rds.eu-north-1.amazonaws.com HTTPS
南美洲 (圣保罗) sa-east-1 rds.sa-east-1.amazonaws.com HTTPS
AWS GovCloud (美国) 东部 us-gov-east-1 rds.us-gov-east-1.amazonaws.com HTTPS
AWS GovCloud(美国) us-gov-west-1 rds.us-gov-west-1.amazonaws.com HTTPS

下表显示在构建特定 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
数据库参数组

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 的资源,然后查看该资源的详细信息。例如,您可以从数据库实例详细信息的 Configuration (配置) 选项卡获取数据库实例的 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

本页内容: