Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Comprendre les noms de ressources Amazon (ARN) Amazon DocumentDB
Ressources que vous créez dans AWS sont chacun identifiés de manière unique par un Amazon Resource Name (ARN). Pour certaines opérations Amazon DocumentDB (avec compatibilité avec MongoDB), vous devez identifier de manière unique une ressource Amazon DocumentDB en spécifiant son ARN. Par exemple, lorsque vous ajoutez une balise à une ressource, vous devez fournir l'ARN de la ressource.
Création d'un ARN pour une ressource Amazon DocumentDB
Vous pouvez créer un ARN pour une ressource Amazon DocumentDB en utilisant la syntaxe suivante. Amazon DocumentDB partage le format des ARN Amazon Relational Database Service (Amazon RDS). Les ARN Amazon DocumentDB contiennent rds et non docdb.
arn:aws:rds:region:account_number:resource_type:resource_id
| Nom de la région | Région | Zones de disponibilité (calcul) |
|---|---|---|
USA Est (Ohio) |
|
3 |
USA Est (Virginie du Nord) |
|
6 |
USA Ouest (Oregon) |
|
4 |
Afrique (Le Cap) |
|
3 |
Amérique du Sud (São Paulo) |
|
3 |
Asie-Pacifique (Hong Kong) |
|
3 |
Asie-Pacifique (Hyderabad) |
|
3 |
Asie-Pacifique (Malaisie) |
|
3 |
Asie-Pacifique (Mumbai) |
|
3 |
Asie-Pacifique (Osaka) |
|
3 |
Asie-Pacifique (Séoul) |
|
4 |
Asie-Pacifique (Singapour) |
|
3 |
Asie-Pacifique (Sydney) |
|
3 |
Asie-Pacifique (Jakarta) |
|
3 |
Asie-Pacifique (Melbourne) |
|
3 |
Asie-Pacifique (Thaïlande) |
|
3 |
Asie-Pacifique (Tokyo) |
|
3 |
Canada (Centre) |
|
3 |
Canada-Ouest (Calgary) |
|
3 |
Région Chine (Pékin) |
|
3 |
Chine (Ningxia) |
|
3 |
Europe (Francfort) |
|
3 |
Europe (Zurich) |
|
3 |
Europe (Irlande) |
|
3 |
Europe (Londres) |
|
3 |
Europe (Milan) |
|
3 |
Europe (Paris) |
|
3 |
Europe (Espagne) |
|
3 |
Europe (Stockholm) |
|
3 |
Mexique (Centre) |
|
3 |
Moyen-Orient (EAU) |
|
3 |
Israël (Tel Aviv) |
|
3 |
| AWS GovCloud (US-West) |
|
3 |
| AWS GovCloud (US-East) |
|
3 |
Note
L'architecture Amazon DocumentDB sépare le stockage et le calcul. Pour la couche de stockage, Amazon DocumentDB réplique six copies de vos données sur trois AWS Zones de disponibilité (AZ). Les zones de zone de disponibilité répertoriées dans le tableau ci-dessus représentent le nombre de zones de sécurité que vous pouvez utiliser dans une région donnée pour provisionner des instances de calcul. Par exemple, si vous lancez un cluster Amazon DocumentDB dans ap-northeast-1, votre stockage sera répliqué de six manières sur trois AZ, mais vos instances de calcul ne seront disponibles que dans deux AZ.
Le tableau suivant indique le format que vous devez utiliser lors de la création d'un ARN pour une ressource Amazon DocumentDB particulière. Amazon DocumentDB partage le format des ARN Amazon RDS. Les ARN Amazon DocumentDB contiennent rds et non docdb.
| Type de ressource | Format ARN/Exemple |
|---|---|
|
Instance ( |
|
|
Cluster ( |
|
|
Groupe de paramètres du cluster ( |
|
|
Groupe de sécurité ( |
|
|
Instantané du cluster ( |
|
|
Groupe de sous-réseaux ( |
|
Note
Chaque cluster Amazon DocumentDB possède également un ID de ressource de cluster, qui correspond à la valeur de DbClusterResourceId champ (par exemple, cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ). Contrairement à l'identifiant du cluster, l'ID de ressource du cluster ne change pas si vous renommez le cluster. L'ARN du cluster renvoyé par les opérations de l'API Amazon DocumentDB, tel que DBClusterArn dans la sortie de describe-db-clusters, utilise l'identifiant du cluster. Utilisez cet ARN lorsque vous appelez les opérations d'API Amazon DocumentDB.
Dans les données de facturation, telles que AWS Cost Explorer et AWS Rapport sur les coûts et l'utilisation, les frais d'un cluster peuvent apparaître sous un ARN qui utilise l'ID de ressource du cluster en minuscules, par exemple arn:aws:rds:us-east-1:123456789012:cluster:cluster-abcdefghijklmnopqrstuvwxyz. Pour trouver le cluster auquel l'ARN fait référence, listez l'identifiant et l'ID de ressource de chacun de vos clusters, puis faites correspondre l'ID de ressource sans tenir compte des majuscules et minuscules :
aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --query "DBClusters[*].[DBClusterIdentifier,DbClusterResourceId]" \ --output table
Recherche d'un ARN de ressource Amazon DocumentDB
Vous pouvez trouver l'ARN d'une ressource Amazon DocumentDB à l'aide du Console de gestion AWS ou le AWS CLI.
