Azure Cosmos DB account naming convention
The CAF abbreviation for Azure Cosmos DB account is cosmos.
Names can be 3 to 44 characters long and allow lowercase alphanumerics and hyphens.
The name must be globally unique across all of Azure.
Naming rules
| CAF abbreviation | cosmos |
|---|---|
| Length | 3 to 44 characters |
| Allowed characters | Lowercase letters and numbers, hyphens |
| Scope of uniqueness | Global (must be unique across all of Azure) |
| CAF pattern | cosmos-{workload}-{environment}-{region}-{instance} |
Rules follow Microsoft's resource naming rules and CAF abbreviations. Some resource types have extra start/end character restrictions, so verify against the official docs before locking in a convention.
Example names
Generated by the same engine as the name generator, so length and character rules are already applied.
| Scenario | Generated name | Length |
|---|---|---|
| Payments API, production | cosmos-payments-prod-eus-001 | 28/44 |
| Web app, development | cosmos-webapp-dev-weu-002 | 25/44 |
| Analytics with company prefix | cosmos-contoso-analytics-stage-uks-001 | 38/44 |
Naming in Terraform and Bicep
Build the name from variables so one module produces the right name in every environment.
locals {
cosmos_db_name = lower("cosmos-${var.workload}-${var.environment}-${var.region}-001")
}var cosmosDbName = toLower('cosmos-${workload}-${environment}-${region}-001')Generate Azure Cosmos DB account names for your workload
Free, no login. Validation and Terraform, Bicep, or CSV export included.
Open in the generator →Related Databases resources
See the full list of Azure resource naming rules or read the complete CAF naming guide.