Informazioni su Amazon DocumentDB Amazon Resource Names () ARNs

Le risorse che AWS crei sono identificate in modo univoco con un Amazon Resource Name (ARN). Per alcune operazioni con Amazon DocumentDB (con compatibilità con MongoDB), devi identificare in modo univoco una risorsa Amazon DocumentDB specificandone l'ARN. Ad esempio, quando aggiungi un tag a una risorsa, devi fornire l'ARN della risorsa.

Creazione di un ARN per una risorsa Amazon DocumentDB

Puoi creare un ARN per una risorsa Amazon DocumentDB utilizzando la seguente sintassi. Amazon DocumentDB condivide il formato di Amazon Relational Database Service (Amazon RDS). ARNs Amazon DocumentDB ARNs contiene rds e non contiene. docdb

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

Nome della regione	Regione	Zone di disponibilità (elaborazione)
Stati Uniti orientali (Ohio)	us-east-2	3
Stati Uniti orientali (Virginia settentrionale)	us-east-1	6
US West (Oregon)	us-west-2	4
Africa (Città del Capo)	af-south-1	3
Sud America (San Paolo)	sa-east-1	3
Asia Pacifico (Hong Kong)	ap-east-1	3
Asia Pacific (Hyderabad)	ap-south-2	3
Asia Pacifico (Mumbai)	ap-south-1	3
Asia Pacifico (Seoul)	ap-northeast-2	4
Asia Pacifico (Singapore)	ap-southeast-1	3
Asia Pacifico (Sydney)	ap-southeast-2	3
Asia Pacifico (Tokyo)	ap-northeast-1	3
Canada (Centrale)	ca-central-1	3
Regione Cina (Pechino)	cn-north-1	3
Cina (Ningxia)	cn-northwest-1	3
Europa (Francoforte)	eu-central-1	3
Europa (Irlanda)	eu-west-1	3
Europa (Londra)	eu-west-2	3
Europa (Milano)	eu-south-1	3
Europa (Parigi)	eu-west-3	3
Europa (Spagna)	eu-south-2	3
Medio Oriente (Emirati Arabi Uniti)	me-central-1	3
AWS GovCloud (Stati Uniti occidentali)	us-gov-west-1	3
AWS GovCloud (Stati Uniti orientali)	us-gov-east-1	3

Nota

L'architettura Amazon DocumentDB separa storage ed elaborazione. Per il livello di storage, Amazon DocumentDB replica sei copie dei dati in tre zone di AWS disponibilità (). AZs AZs Quelli elencati nella tabella precedente sono il numero di istanze AZs che è possibile utilizzare in una determinata regione per fornire istanze di calcolo. Ad esempio, se avvii un cluster Amazon DocumentDB in ap-northeast-1, lo storage verrà replicato in sei modi su tre, ma le istanze di calcolo saranno disponibili solo in due. AZs AZs

La tabella seguente mostra il formato da utilizzare per creare un ARN per una particolare risorsa Amazon DocumentDB. Amazon DocumentDB condivide il formato di Amazon RDS. ARNs Amazon DocumentDB ARNs contiene rds e non contiene. docdb

Tipo di risorsa	Formato ARN/Esempio
Istanza (db)	arn:aws:rds:region:account_number:db:resource_id arn:aws:rds:us-east-1:1234567890:db:sample-db-instance
Cluster (cluster)	arn:aws:rds:region:account_number:cluster:resource_id arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster
Gruppo di parametri del 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
Gruppo di sicurezza (secgrp)	arn:aws:rds:region:account_number:secgrp:resource_id arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp
Snapshot del cluster (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
Gruppo di sottoreti (subgrp)	arn:aws:rds:region:account_number:subgrp:resource_id arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10

Ricerca dell'ARN di una risorsa Amazon DocumentDB

Puoi trovare l'ARN di una risorsa Amazon DocumentDB utilizzando AWS Management Console o il. AWS CLI

Using the AWS Management Console

Per trovare un ARN utilizzando la console, accedi alla risorsa di cui desideri l'ARN e visualizzane i relativi dettagli.

Ad esempio, è possibile ottenere l'ARN per un cluster selezionando la scheda Configurazione nella pagina dei dettagli del cluster. L'ARN è disponibile nella sezione Configurazioni e stato, come mostrato nella schermata seguente.

Using the AWS CLI

Per ottenere un ARN utilizzando il AWS CLI per una particolare risorsa Amazon DocumentDB, usa describe l'operazione per quella risorsa. La tabella seguente mostra ogni AWS CLI operazione e la proprietà ARN utilizzata con l'operazione per ottenere un ARN.

AWS CLI Comando	Proprietà 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

Esempio - Ricerca dell'ARN per un cluster

L' AWS CLI operazione seguente trova l'ARN per il cluster. sample-cluster

Per Linux, macOS o Unix:

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

Per Windows:

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

L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).

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

Esempio - ARNs Ricerca di più gruppi di parametri

Per Linux, macOS o Unix:

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

Per Windows:

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

L'aspetto dell'output di questa operazione è simile al seguente (formato 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"
]