View a markdown version of this page

Memahami Amazon DocumentDB Amazon Resource Name (ARN) - Amazon DocumentDB
Membuat konsep ARNMenemukan ARN

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memahami Amazon DocumentDB Amazon Resource Name (ARN)

Sumber daya yang Anda buat di AWS Masing-masing 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 berbagi format ARN Amazon Relational Database Service (Amazon RDS). ARN Amazon DocumentDB terdiri atas rds dan bukan docdb.

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

Nama Wilayah Region 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

Africa (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 (Malaysia)

ap-southeast-5

3

Asia Pasifik (Mumbai)

ap-south-1

3

Asia Pasifik (Osaka)

ap-northeast-3

3

Asia Pasifik (Seoul)

ap-northeast-2

4

Asia Pasifik (Singapura)

ap-southeast-1

3

Asia Pasifik (Sydney)

ap-southeast-2

3

Asia Pasifik (Jakarta)

ap-southeast-3

3

Asia Pacific (Melbourne)

ap-southeast-4

3

Asia Pasifik (Thailand)

ap-southeast-7

3

Asia Pasifik (Tokyo)

ap-northeast-1

3

Kanada (Pusat)

ca-central-1

3

Kanada Barat (Calgary)

ca-west-1

3

Wilayah Tiongkok (Beijing)

cn-north-1

3

Tiongkok (Ningxia)

cn-northwest-1

3

Eropa (Frankfurt)

eu-central-1

3

Europe (Zurich)

eu-central-2

3

Eropa (Irlandia)

eu-west-1

3

Eropa (London)

eu-west-2

3

Europe (Milan)

eu-south-1

3

Eropa (Paris)

eu-west-3

3

Eropa (Spanyol)

eu-south-2

3

Eropa (Stockholm)

eu-north-1

3

Meksiko (Tengah)

mx-central-1

3

Timur Tengah (UAE)

me-central-1

3

Israel (Tel Aviv)

il-central-1

3
AWS GovCloud (US-West)

us-gov-west-1

3
AWS GovCloud (US-East)

us-gov-east-1

3
catatan

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

Tabel berikut menunjukkan format yang harus Anda gunakan saat membangun ARN untuk jenis sumber daya Amazon DocumentDB tertentu. Amazon DocumentDB berbagi format Amazon RDS ARN. ARN Amazon DocumentDB terdiri atas rds dan bukan docdb.

Jenis Sumber Daya Format/Contoh ARN

Contoh (db)

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

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

Klaster (cluster)

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

arn:aws:rds:us-east-1:123456789012: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:123456789012: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:123456789012:secgrp:sample-public-secgrp

Snapshot klaster (cluster-snapshot)

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

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

Grup subnet (subgrp)

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

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

Setiap cluster Amazon DocumentDB juga memiliki ID sumber daya cluster, yang merupakan nilai dari DbClusterResourceId bidang (misalnya, cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ). Berbeda dengan pengidentifikasi cluster, ID sumber daya cluster tidak berubah jika Anda mengganti nama cluster. Cluster ARN yang dikembalikan oleh operasi API Amazon DocumentDB, seperti DBClusterArn dalam output dari describe-db-clusters, menggunakan pengidentifikasi cluster. Gunakan ARN tersebut saat Anda memanggil operasi API Amazon DocumentDB.

Dalam data penagihan, seperti AWS Penjelajah Biaya dan AWS Laporan Biaya dan Penggunaan, biaya untuk cluster dapat muncul di bawah ARN yang menggunakan ID sumber daya cluster dalam huruf kecil, misalnya arn:aws:rds:us-east-1:123456789012:cluster:cluster-abcdefghijklmnopqrstuvwxyz. Untuk menemukan cluster yang dirujuk ARN, daftarkan pengenal dan ID sumber daya dari masing-masing cluster Anda, lalu cocokkan ID sumber daya tanpa memperhatikan kasus:

aws docdb describe-db-clusters \
    --filter Name=engine,Values=docdb \
    --query "DBClusters[*].[DBClusterIdentifier,DbClusterResourceId]" \
    --output table

Menemukan sumber daya Amazon DocumentDB ARN

Anda dapat menemukan ARN sumber daya Amazon DocumentDB menggunakan Konsol Manajemen AWS atau AWS CLI.

Using the Konsol Manajemen AWS

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 cluster dengan memilih Konfigurasi tab pada halaman detail cluster. ARN dapat ditemukan di Konfigurasi dan status bagian, seperti yang ditunjukkan pada tangkapan layar berikut.

Cuplikan layar konsol yang menampilkan ARN di bagian konfigurasi dan status pada panel detail.
Using the AWS CLI

Untuk mendapatkan ARN menggunakan AWS CLI untuk sumber daya Amazon DocumentDB tertentu, gunakan describe operasi untuk sumber daya tersebut. Tabel berikut menunjukkan masing-masing 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

Berikut ini AWS CLI operasi 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'

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

[
    "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster"
]
contoh- Menemukan ARN untuk 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"
]