Memahami Nama Sumber Daya Amazon DocumentDB Amazon () ARNs

Sumber daya yang Anda buat masing-masing AWS diidentifikasi secara unik dengan Nama Sumber Daya Amazon (ARN). Untuk operasi Amazon DocumentDB (dengan kompatibilitas MongoDB) tertentu, Anda harus secara unik mengidentifikasi sumber daya Amazon DocumentDB dengan menentukan ARN-nya. Misalnya, saat Anda menambahkan tag ke sumber daya, Anda harus menyediakan ARN sumber daya.

Membangun ARN untuk sumber daya Amazon DocumentDB

Anda dapat membangun ARN untuk sumber daya Amazon DocumentDB menggunakan sintaks berikut. Amazon DocumentDB membagikan format Amazon Relational Database Service (Amazon RDS). ARNs Amazon ARNs DocumentDB rds berisi dan tidak. docdb

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

Nama Wilayah	Wilayah	Availability Zone (penghitungan)
AS Timur (Ohio)	us-east-2	3
AS Timur (Virginia Utara)	us-east-1	6
AS Barat (Oregon)	us-west-2	4
Afrika (Cape Town)	af-south-1	3
Amerika Selatan (Sao Paulo)	sa-east-1	3
Asia Pasifik (Hong Kong)	ap-east-1	3
Asia Pasifik (Hyderabad)	ap-south-2	3
Asia Pasifik (Mumbai)	ap-south-1	3
Asia Pasifik (Seoul)	ap-northeast-2	4
Asia Pasifik (Singapura)	ap-southeast-1	3
Asia Pasifik (Sydney)	ap-southeast-2	3
Asia Pasifik (Tokyo)	ap-northeast-1	3
Kanada (Pusat)	ca-central-1	3
Wilayah Tiongkok (Beijing)	cn-north-1	3
Tiongkok (Ningxia)	cn-northwest-1	3
Eropa (Frankfurt)	eu-central-1	3
Eropa (Irlandia)	eu-west-1	3
Eropa (London)	eu-west-2	3
Eropa (Milan)	eu-south-1	3
Eropa (Paris)	eu-west-3	3
Eropa (Spanyol)	eu-south-2	3
Eropa (Stockholm)	eu-north-1	3
Timur Tengah (UEA)	me-central-1	3
Israel (Tel Aviv)	il-central-1	3
AWS GovCloud (AS-Barat)	us-gov-west-1	3
AWS GovCloud (AS-Timur)	us-gov-east-1	3

catatan

Arsitektur Amazon DocumentDB memisahkan penyimpanan dan komputasi. Untuk lapisan penyimpanan, Amazon DocumentDB mereplikasi enam salinan data Anda di AWS tiga Availability Zones (). AZs Yang AZs tercantum dalam tabel di atas adalah jumlah AZs yang dapat Anda gunakan di wilayah tertentu untuk menyediakan instance komputasi. Sebagai contoh, jika Anda meluncurkan cluster Amazon DocumentDB di ap-northeast-1, penyimpanan Anda akan direplikasi enam cara di tiga tetapi instans komputasi Anda hanya akan tersedia dalam dua. AZs AZs

Tabel berikut menunjukkan format yang harus Anda gunakan saat membangun ARN untuk jenis sumber daya Amazon DocumentDB tertentu. Amazon DocumentDB membagikan format Amazon RDS. ARNs Amazon ARNs DocumentDB rds berisi dan tidak. docdb

Jenis Sumber Daya	Format/Contoh ARN
Contoh (db)	arn:aws:rds:region:account_number:db:resource_id arn:aws:rds:us-east-1:1234567890:db:sample-db-instance
Klaster (cluster)	arn:aws:rds:region:account_number:cluster:resource_id arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster
Grup parameter klaster (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
Grup keamanan (secgrp)	arn:aws:rds:region:account_number:secgrp:resource_id arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp
Snapshot klaster (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
Grup subnet (subgrp)	arn:aws:rds:region:account_number:subgrp:resource_id arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10

Menemukan ARN sumber daya Amazon DocumentDB

Anda dapat menemukan ARN dari sumber daya Amazon DocumentDB menggunakan atau file. AWS Management Console AWS CLI

Using the AWS Management Console

Untuk menemukan ARN dengan menggunakan konsol, arahkan navigasi ke sumber daya yang Anda inginkan untuk ARN, dan lihat detail untuk sumber daya tersebut.

Misalnya, Anda bisa mendapatkan ARN untuk klaster dengan memilih tab Konfigurasi pada halaman detail cluster. ARN dapat ditemukan di bagian Konfigurasi dan status, seperti yang ditunjukkan pada gambar berikut.

Using the AWS CLI

Untuk mendapatkan ARN menggunakan sumber daya Amazon DocumentDB tertentu, gunakan describe operasi AWS CLI untuk sumber daya tersebut. Tabel berikut menunjukkan setiap AWS CLI operasi dan properti ARN yang digunakan dengan operasi untuk mendapatkan ARN.

AWS CLI Perintah	Properti 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

contoh - Menemukan ARN untuk klaster

AWS CLI Operasi berikut menemukan ARN untuk cluster. sample-cluster

Untuk Linux, macOS, atau Unix:

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

Untuk Windows:

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

Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).

[
    "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]

contoh - Menemukan ARNs beberapa grup parameter

Untuk Linux, macOS, atau Unix:

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

Untuk Windows:

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

Output dari operasi ini terlihat seperti berikut (format 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"
]