了解 Amazon DocumentDB Amazon 资源名称（ARN） - Amazon DocumentDB
构建 ARN查找 ARN
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

了解 Amazon DocumentDB Amazon 资源名称（ARN）

您在中创建的每个资源 Amazon 都使用亚马逊资源名称 (ARN) 进行唯一标识。对于某些 Amazon DocumentDB（与 MongoDB 兼容）操作，您必须通过指定其 ARN 来唯一标识 Amazon DocumentDB 资源。例如，当您向资源中添加标签时，必须提供该资源的 ARN。

为 Amazon DocumentDB 资源构造 ARN

您可以使用以下语法为 Amazon DocumentDB 资源构造 ARN。Amazon DocumentDB 共享 Amazon Relational Database Service (Amazon RDS) ARNS 的格式。Amazon DocumentDB ARN 包含 rds 而不是含 docdb。

arn:aws:rds:region:account_number:resource_type:resource_id

区域名称 区域 可用区（计算）

美国东部（俄亥俄州）

us-east-2

3

美国东部（弗吉尼亚州北部）

us-east-1

6

US West（Oregon）

us-west-2

4

南美洲（圣保罗）

sa-east-1

3

亚太地区（香港）

ap-east-1

3

亚太地区（海得拉巴）

ap-south-2

3

亚太地区（孟买）

ap-south-1

3

亚太地区（首尔）

ap-northeast-2

4

亚太地区（新加坡）

ap-southeast-1

3

亚太地区（悉尼）

ap-southeast-2

3

亚太地区（东京)

ap-northeast-1

3

加拿大（中部）

ca-central-1

3

中国（北京）区域

cn-north-1

3

中国（宁夏）

cn-northwest-1

3

欧洲地区（法兰克福）

eu-central-1

3

欧洲地区（爱尔兰）

eu-west-1

3

欧洲地区（伦敦）

eu-west-2

3

欧洲地区（米兰）

eu-south-1

3

欧洲地区（巴黎）

eu-west-3

3

中东（阿联酋）

me-central-1

3
Amazon GovCloud （美国西部）

us-gov-west-1

3
Amazon GovCloud （美国东部）

us-gov-east-1

3
注意

Amazon DocumentDB 架构将存储和计算分开。在存储层方面，Amazon DocumentDB 会在三个 Amazon 可用区 (AZ) 中复制六个数据副本。上表中列出的 AZ 是指，您可以在给定区域中预置计算实例时使用的 AZ 数。例如，如果要在 ap-northeast-1 中启动一个 Amazon DocumentDB 集群，将在三个 AZ 之间的 6 个方向复制存储，但仅在两个 AZ 中具有计算实例。

下表显示在构造特定 Amazon DocumentDB 资源的 ARN 时应使用的格式。Amazon DocumentDB 共享 Amazon RDS ARNS 的格式。Amazon DocumentDB ARN 包含 rds 而不是含 docdb。

资源类型 ARN 格式/示例

实例 (db)

arn:aws:rds:region:account_number:db:resource_id

arn:aws:rds:us-east-1:1234567890:db:sample-db-instance

集群 (cluster)

arn:aws:rds:region:account_number:cluster:resource_id

arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster

集群参数组 (cluster-pg)

arn:aws:rds:region:account_number:cluster-pg:resource_id

arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group

安全组 (secgrp)

arn:aws:rds:region:account_number:secgrp:resource_id

arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp

集群快照 (cluster-snapshot)

arn:aws:rds:region:account_number:cluster-snapshot:resource_id

arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot

子网组 (subgrp)

arn:aws:rds:region:account_number:subgrp:resource_id

arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10

查找 Amazon DocumentDB 资源 ARN

您可以使用或查找 Amazon DocumentDB 资源的 ARN。 Amazon Web Services Management Console Amazon CLI

Using the Amazon Web Services Management Console

要使用控制台查找 ARN，请导航到要获取其 ARN 的资源，然后查看该资源的详细信息。

例如，您可以在集群的详细信息窗格中获取集群的 ARN，如以下屏幕截图所示。

控制台屏幕截图显示详细信息窗格的配置和状态部分中的 ARN。
Using the Amazon CLI

要使用特定的 Amazon DocumentDB 资源获取 ARN，请describe对该资源使用操作。 Amazon CLI 下表显示了每项 Amazon CLI 操作以及用于获取 ARN 的操作的 ARN 属性。

Amazon CLI 命令 ARN 属性

describe-db-instances

DBInstanceArn

describe-db-clusters

DBClusterArn

describe-db-parameter-groups

DBParameterGroupArn

describe-db-cluster-parameter-groups

DBClusterParameterGroupArn

describe-db-security-groups

DBSecurityGroupArn

describe-db-snapshots

DBSnapshotArn

describe-db-cluster-snapshots

DBClusterSnapshotArn

describe-db-subnet-groups

DBSubnetGroupArn
例 - 查找集群的 ARN

以下 Amazon CLI 操作查找集群的 ARN。sample-cluster

对于 Linux、macOS 或 Unix：

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'

对于 Windows：

aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterArn'

此操作的输出将类似于下文（JSON 格式）。

[
    "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]
例 - 查找多个参数组的 ARN

对于 Linux、macOS 或 Unix：

aws docdb describe-db-cluster-parameter-groups \
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'

对于 Windows：

aws docdb describe-db-cluster-parameter-groups ^
   --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn'

此操作的输出将类似于下文（JSON 格式）。

[
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp",
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6",
    "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6"
]