View a markdown version of this page

Informazioni su Amazon DocumentDB Amazon Resource Names (ARN) - Amazon DocumentDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Informazioni su Amazon DocumentDB Amazon Resource Names (ARN)

Risorse che crei in AWS sono ciascuna identificata in modo univoco con un Amazon Resource Name (ARN). Per alcune operazioni di Amazon DocumentDB (con compatibilità con MongoDB), è necessario 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 rds e non docdb.

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

Nome della regione Regione Zone di disponibilità (calcolo)

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 tuoi dati su tre AWS Zone di disponibilità (AZ). Le AZ elencate nella tabella precedente sono il numero di AZ che è possibile utilizzare in una determinata regione per 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 rds e non docdb.

Tipo di risorsa Formato ARN/Esempio

Istanza (db)

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

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

Cluster (cluster)

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

arn:aws:rds:us-east-1:123456789012: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:123456789012: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:123456789012: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:123456789012: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:123456789012:subgrp:sample-subnet-10
Nota

Ogni cluster Amazon DocumentDB ha anche un ID di risorsa del cluster, che è il valore di DbClusterResourceId campo (ad esempio, cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ). A differenza dell'identificatore del cluster, l'ID della risorsa del cluster non cambia se si rinomina il cluster. L'ARN del cluster restituito dalle operazioni dell'API Amazon DocumentDB, ad esempio DBClusterArn nell'output di describe-db-clusters, utilizza l'identificatore del cluster. Usa quell'ARN quando chiami le operazioni API di Amazon DocumentDB.

Nei dati di fatturazione, ad esempio AWS Cost Explorer e AWS Rapporto sui costi e sull'utilizzo, gli addebiti per un cluster possono essere visualizzati in un ARN che utilizza l'ID della risorsa del cluster in lettere minuscole, ad esempio arn:aws:rds:us-east-1:123456789012:cluster:cluster-abcdefghijklmnopqrstuvwxyz. Per trovare il cluster a cui fa riferimento l'ARN, elenca l'identificatore e l'ID della risorsa di ciascuno dei cluster, quindi abbina l'ID della risorsa indipendentemente dalle maiuscole e minuscole:

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

Trovare un ARN di risorse 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 Configurazione scheda nella pagina dei dettagli del cluster. L'ARN può essere trovato nella Configurazioni e stato sezione, 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 usando il AWS CLI per una particolare risorsa Amazon DocumentDB, usa describe operazione per quella risorsa. La tabella seguente mostra ciascuna 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

Quanto segue AWS CLI l'operazione 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" ]