了解 Amazon DocumentDB Amazon 資源名稱（）ARNs - Amazon DocumentDB
構建一個 ARN尋找一個 ARN

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

了解 Amazon DocumentDB Amazon 資源名稱（）ARNs

您在中建立的每個資源都 AWS 會以 Amazon 資源名稱 (ARN) 唯一標識。對於某些 Amazon DocumentDB (與 MongoDB 相容性) 作業，您必須透過指定資源來唯一識別 Amazon DocumentDB 資源。ARN例如，當您將標籤新增至資源時，必須提供資源的標籤ARN。

構建一個 Amazon DocumentDB ARN 資源

您可以使用以下語法ARN為 Amazon DocumentDB 資源構造。Amazon DocumentDB 共享 Amazon Relational Database Service（AmazonRDS）的格式。ARNSAmazon DocumentDB ARNs 包含rds而不是。docdb

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

區域名稱 區域 可用區域 (計算)

美國東部 (俄亥俄)

us-east-2

3

美國東部 (維吉尼亞北部)

us-east-1

6

美國西部 (奧勒岡)

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

Europe (Paris)

eu-west-3

3

中東 (UAE)

me-central-1

3
AWS GovCloud (美國西部)

us-gov-west-1

3
AWS GovCloud (美國東部)

us-gov-east-1

3
注意

Amazon DocumentDB 架構分隔存儲和運算。對於儲存層，Amazon DocumentDB 會跨三個 AWS 可用區域複寫六個資料副本 ()。AZs上表中AZs列出的AZs是您可以在指定區域中用來佈建運算執行個體的數目。舉例來說，如果您要在 ap-northeast-1 中啟動 Amazon DocumentDB 叢集，您的儲存將會以六種方式複寫到三種，AZs但您的運算執行個體只有兩種可用。AZs

下表顯示ARN針對特定 Amazon DocumentDB 資源建構時應使用的格式。Amazon DocumentDB 股 Amazon 的格式。RDS ARNSAmazon DocumentDB ARNs 包含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

您可以使用 AWS Management Console 或找到 Amazon DocumentDB 資源ARN的。 AWS CLI

Using the AWS Management Console

若要尋找ARN使用主控台的資源，請瀏覽至您想要的ARN資源，然後檢視該資源的詳細資訊。

例如，您可以取得叢集的 ARN [詳細資料] 窗格中的叢集，如下列螢幕擷取畫面所示。

控制台屏幕截圖顯示ARN在詳細信息窗格的配置和狀態部分中。
Using the AWS CLI

若要取得特定 Amazon DocumentDB 資源的ARN使用方式，請使用該資源的describe作業。 AWS CLI 下表顯示每個 AWS CLI 作業，以及與作業搭配使用以取得的ARN屬性ARN。

AWS 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找叢集

下列 AWS CLI 作業會尋找叢集的sample-cluster。ARN

若為 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"
]
範例 -尋找多ARNs個參數群組

若為 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"
]