Informazioni su Amazon DocumentDB Amazon Resource Names (ARN)

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 degli ARN di Amazon Relational Database Service (Amazon RDS). Gli ARN di Amazon DocumentDB contengono e non contengonords. 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
Stati Uniti occidentali (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 Pacifico (Hyderabad)	`ap-south-2`	3
Asia Pacifico (Malesia)	`ap-southeast-5`	3
Asia Pacifico (Mumbai)	`ap-south-1`	3
Asia Pacifico (Osaka)	`ap-northeast-3`	3
Asia Pacifico (Seul)	`ap-northeast-2`	4
Asia Pacifico (Singapore)	`ap-southeast-1`	3
Asia Pacifico (Sydney)	`ap-southeast-2`	3
Asia Pacifico (Giacarta)	`ap-southeast-3`	3
Asia Pacifico (Melbourne)	`ap-southeast-4`	3
Asia Pacifico (Thailandia)	`ap-southeast-7`	3
Asia Pacifico (Tokyo)	`ap-northeast-1`	3
Canada (Centrale)	`ca-central-1`	3
Canada occidentale (Calgary)	`ca-west-1`	3
Regione Cina (Pechino)	`cn-north-1`	3
Cina (Ningxia)	`cn-northwest-1`	3
Europa (Francoforte)	`eu-central-1`	3
Europa (Zurigo)	`eu-central-2`	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
Europa (Stoccolma)	`eu-north-1`	3
Messico (centrale)	`mx-central-1`	3
Medio Oriente (Emirati Arabi Uniti)	`me-central-1`	3
Israele (Tel Aviv)	`il-central-1`	3
AWS GovCloud (US-West)	`us-gov-west-1`	3
AWS GovCloud (US-East)	`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 su tre zone di AWS disponibilità (AZ). Le zone di disponibilità elencate nella tabella riportata sopra rappresentano il numero di zone di disponibilità che è possibile utilizzare in una determinata regione per effettuare il provisioning delle istanze di calcolo. Ad esempio, se stai lanciando un cluster Amazon DocumentDB in ap-northeast-1, lo storage verrà replicato in sei modi su tre AZ, ma le tue istanze di calcolo saranno disponibili solo in due AZ.

La tabella seguente mostra il formato da utilizzare per creare un ARN per una particolare risorsa Amazon DocumentDB. Amazon DocumentDB condivide il formato degli ARN Amazon RDS. Gli ARN di Amazon DocumentDB contengono e non contengonords. 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 Console di gestione AWS o il. AWS CLI

Using the Console di gestione AWS

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.

Screenshot della console che mostra un ARN nella sezione sullo stato e le configurazioni del riquadro dei dettagli.

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- Ricerca degli ARN per 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"
]

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Connessione agli endpoint

Applicazione di tag alle risorse