AWS documentdb: Fix example account numbers and document cluster resource ID ARNs
Summary
Corrects example account numbers to 12 digits and adds a note explaining the cluster resource ID, its stability across renames, and how billing ARNs may use the lowercase resource ID.
Security assessment
Purely documentation accuracy: fixing malformed example account numbers and clarifying ARN formats for billing reconciliation. No security implication.
Evidence
arn:aws:rds:us-east-1:123456789012:db:sample-db-instance
Diff
diff --git a/documentdb/latest/devguide/documentdb-arns.md b/documentdb/latest/devguide/documentdb-arns.md index fcaa0ac..f19a26d 100644 --- a//documentdb/latest/devguide/documentdb-arns.md +++ b//documentdb/latest/devguide/documentdb-arns.md @@ -76 +76 @@ Instance (`db`) | `arn:aws:rds:`region`:`account_number`:db:`resource_id`` - arn:aws:rds:us-east-1:1234567890:db:sample-db-instance + arn:aws:rds:us-east-1:123456789012:db:sample-db-instance @@ -81 +81 @@ Cluster (`cluster`) | `arn:aws:rds:`region`:`account_number`:cluster:`resource_ - arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster + arn:aws:rds:us-east-1:123456789012:cluster:sample-db-cluster @@ -86 +86 @@ Cluster parameter group (`cluster-pg`) | `arn:aws:rds:`region`:`account_number` - arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group + arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-db-cluster-parameter-group @@ -91 +91 @@ Security group (`secgrp`) | `arn:aws:rds:`region`:`account_number`:secgrp:`reso - arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp + arn:aws:rds:us-east-1:123456789012:secgrp:sample-public-secgrp @@ -96 +96 @@ Cluster snapshot (`cluster-snapshot`) | `arn:aws:rds:`region`:`account_number`: - arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot + arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-db-cluster-snapshot @@ -101 +101,13 @@ Subnet group (`subgrp`) | `arn:aws:rds:`region`:`account_number`:subgrp:`resour - arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10 + arn:aws:rds:us-east-1:123456789012:subgrp:sample-subnet-10 + +###### Note + +Each Amazon DocumentDB cluster also has a cluster resource ID, which is the value of the `DbClusterResourceId` field (for example, `cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ`). Unlike the cluster identifier, the cluster resource ID doesn't change if you rename the cluster. The cluster ARN that Amazon DocumentDB API operations return, such as `DBClusterArn` in the output of `describe-db-clusters`, uses the cluster identifier. Use that ARN when you call Amazon DocumentDB API operations. + +In billing data, such as AWS Cost Explorer and the AWS Cost and Usage Report, charges for a cluster can appear under an ARN that uses the cluster resource ID in lowercase, for example `arn:aws:rds:us-east-1:123456789012:cluster:cluster-abcdefghijklmnopqrstuvwxyz`. To find the cluster that the ARN refers to, list the identifier and resource ID of each of your clusters, and then match the resource ID without regard to case: + + + aws docdb describe-db-clusters \ + --filter Name=engine,Values=docdb \ + --query "DBClusters[*].[DBClusterIdentifier,DbClusterResourceId]" \ + --output table