azure-naming-research

# Azure Naming Research ## Procedure ### 1. Look up CAF abbreviation Query the CAF abbreviations page for the official slug and resource provider namespace: **URL**: `https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/ready/azure-best-practices/resource-abbreviations` Prefer Microsoft Docs MCP tools (`microsoft_docs_search`, `microsoft_docs_fetch`) when available. Search by: 1. Terraform resource name without `azurerm_` prefix (e.g., "container app") 2. Resource provider namespace if known 3. Common name (e.g., "Container Apps") Extract: **CAF abbreviation** (slug), **resource display name**, **resource provider namespace**. If not found, the resource is out-of-doc — set `"out_of_doc": true` in the JSON entry and omit `official.slug` and `official.resource_provider_namespace`. ### 2. Look up Azure naming rules Query the naming rules page for constraints: **URL**: `https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/resource-name-rules` Find the section matching the resource provider namespace from step 1. Extract: **scope**, **length** (min-max), **valid characters**. ### 3. Derive field values See [references/regex-patterns.md](references/regex-patterns.md) for the regex conversion tables. - **scope** mapping: "globally unique"→`"global"`, "resource group"→`"resourceGroup"`, "within parent"→`"parent"`, "subscription"→`"subscription"` - **dashes**: `true` if hyphens allowed - **lowercase**: `true` if only lowercase letters allowed - **validation_regex** and **regex**: Use the pattern tables in the reference file. Both MUST use escaped double quotes: `"\"pattern\""` Never guess at constraints — mark as UNKNOWN if not verifiable.