Naming rules and restrictions for Azure resources
This article summarizes naming rules and restrictions for Azure resources. For recommendations about how to name resources, see Recommended naming and tagging conventions.
This article also lists resources by resource provider namespace. For a list of how resource providers match Azure services, see Azure resource providers for Azure services.
Note
Resource and resource group names are case-insensitive unless specifically noted in the Valid Characters column.
When using various APIs to retrieve the name for a resource or resource group, the returned value might have different casing than what you originally specified for the name. The returned value could also display different case values than what is listed in the Valid Characters column.
Always perform a case-insensitive comparison of names.
In the following tables, the term alphanumeric refers to:
- a through z (lowercase letters)
- A through Z (uppercase letters)
- 0 through 9 (numbers)
Note
Resources with a public endpoint can't include reserved words or trademarks in the name. For a list of blocked words, see Resolve reserved resource name errors.
Don't use # in a resource name since this interferes with URL parsing during Azure Resource Manager requests.
Microsoft.AnalysisServices
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| servers | resource group | 3-63 | Lowercase letters and numbers Start with a lowercase letter. |
Microsoft.ApiManagement
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| service | global | 1-50 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / issues | api | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / issues / attachments | issue | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / issues / comments | issue | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / operations | api | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / operations / tags | operation | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / releases | api | 1-80 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric or underscore. |
| service / apis / schemas | api | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / tagDescriptions | api | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / apis / tags | api | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / api-version-sets | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / authorizationServers | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / backends | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / certificates | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / diagnostics | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / groups | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / groups / users | group | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / identityProviders | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / loggers | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / notifications | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / notifications / recipientEmails | notification | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / openidConnectProviders | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / policies | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / products | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / products / apis | product | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / products / groups | product | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / products / tags | product | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / properties | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / subscriptions | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / tags | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / templates | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| service / users | service | 1-80 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
Microsoft.App
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| containerApps | resource group | 2-32 | nLowercase letters, numbers, and hyphens Start with a letter and end with alphanumeric. |
Microsoft.AppConfiguration
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| configurationStores* | global | 5-50 | Alphanumerics and hyphens Can’t contain a sequence of more than two hyphens. Can’t start with or end with a hyphen. |
| configurationStores / replicas | configurationStore | 1-50 The combined length of the configurationStore name and the replica name can’t exceed 60 characters. |
Only alphanumerics are valid. |
* {storeName}-{replicaName} needs to be globally unique.
Microsoft.AppPlatform
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| spring | global | 4-32 | Lowercase letters, numbers, and hyphens |
Microsoft.Authorization
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| locks | scope of assignment | 1-90 | Alphanumerics, periods, underscores, hyphens, and parentheses Can't end in period. |
| policyAssignments | scope of assignment | 1-128 display name 1-64 resource name 1-24 resource name at management group scope |
Display name can contain any characters. Resource name can't use: #<>%&:\?/ or control characters. Can't end with period or space. |
| policyDefinitions | scope of definition | 1-128 display name 1-64 resource name |
Display name can contain any characters. Resource name can't use: #<>%&:\?/ or control characters. Can't end with period or space. |
| policyExemptions | scope of exemption | 1-128 display name 1-64 resource name |
Display name can contain any characters. Resource name can't use: #<>%&:\?/ or control characters. Can't end with period or space. |
| policySetDefinitions | scope of definition | 1-128 display name 1-64 resource name |
Display name can contain any characters. Resource name can't use: #<>%&:\?/ or control characters. Can't end with period or space. |
| roleAssignments | tenant | 36 | Must be a globally unique identifier (GUID). |
| roleDefinitions | tenant | 36 | Must be a GUID. |
Microsoft.Automation
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| automationAccounts | resource group & region (See note below) |
6-50 | Alphanumerics and hyphens Start with a letter and end with alphanumeric. |
| automationAccounts / certificates | automation account | 1-128 | Can't use:<>*%&:\?.+/ or control characters Can't end with space. |
| automationAccounts / connections | automation account | 1-128 | Can't use:<>*%&:\?.+/ or control characters Can't end with space. |
| automationAccounts / credentials | automation account | 1-128 | Can't use:<>*%&:\?.+/ or control characters Can't end with space. |
| automationAccounts / runbooks | automation account | 1-63 | Alphanumerics, underscores, and hyphens Start with a letter. |
| automationAccounts / schedules | automation account | 1-128 | Can't use:<>*%&:\?.+/ or control characters Can't end with space. |
| automationAccounts / variables | automation account | 1-128 | Can't use:<>*%&:\?.+/ or control characters Can't end with space. |
| automationAccounts / watchers | automation account | 1-63 | Alphanumerics, underscores, and hyphens Start with a letter. |
| automationAccounts / webhooks | automation account | 1-128 | Can't use:<>*%&:\?.+/ or control characters Can't end with space. |
Note
Automation account names are unique per region and resource group. Names for deleted Automation accounts might not be immediately available.
Microsoft.AVS
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| privateClouds | resource group | 1-80 | Alphanumerics, periods, hyphens, and underscores Start with alphanumeric and end with alphanumeric or underscore. |
Microsoft.Batch
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| batchAccounts | Region | 3-24 | Lowercase letters and numbers |
| batchAccounts / applications | batch account | 1-64 | Alphanumerics, underscores, and hyphens |
| batchAccounts / certificates | batch account | 5-45 | Alphanumerics, underscores, and hyphens |
| batchAccounts / pools | batch account | 1-64 | Alphanumerics, underscores, and hyphens |
Microsoft.Blockchain
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| blockchainMembers | global | 2-20 | Lowercase letters and numbers Start with lowercase letter. |
Microsoft.Blueprint
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| blueprint | Management groups, Subscriptions, Resource groups | 90 | Alphanumerics, underscores, and hyphens |
| blueprintAssignments | Management groups, Subscriptions, Resource groups | 90 | Alphanumerics, underscores, and hyphens |
Microsoft.BotService
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| botServices | global | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. |
| botServices / channels | bot service | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. |
| botServices / Connections | bot service | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. |
| enterpriseChannels | resource group | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. |
Microsoft.Cache
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| Redis | global | 1-63 | Alphanumerics and hyphens Start and end with alphanumeric. Consecutive hyphens not allowed. |
| Redis / firewallRules | Redis | 1-256 | Alphanumerics |
Microsoft.Cdn
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| profiles | resource group | 1-260 | Alphanumerics and hyphens Start and end with alphanumeric. |
| profiles / endpoints | global | 1-50 | Alphanumerics and hyphens Start and end with alphanumeric. |
| profiles / originGroups | global | 1-50 | Alphanumerics and hyphens Start and end with alphanumeric. |
| profiles / originGroups / origins | global | 1-50 | Alphanumerics and hyphens Start and end with alphanumeric. |
| profiles / afdEndpoints / routes | global | 1-50 | Alphanumerics and hyphens Start and end with alphanumeric. |
Microsoft.CertificateRegistration
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| certificateOrders | resource group | 3-50 | Alphanumerics |
Microsoft.CognitiveServices
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| accounts | resource group | 2-64 | Alphanumerics and hyphens Start and end with alphanumeric. |
Microsoft.Compute
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| availabilitySets | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| cloudservices | resource group | 1-15 See note below. |
Can't use spaces, control characters, or these characters:~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Can't start with underscore. Can't end with period or hyphen. |
| diskEncryptionSets | resource group | 1-80 | Alphanumerics, underscores, and hyphens |
| disks | resource group | 1-80 | Alphanumerics, underscores, and hyphens |
| galleries | resource group | 1-80 | Alphanumerics and periods Start and end with alphanumeric. |
| galleries / applications | gallery | 1-80 | Alphanumerics, hyphens, and periods Start and end with alphanumeric. |
| galleries / applications/versions | application | 32-bit integer | Numbers and periods (Each segment is converted to an int32. So each segment has a max value of 2,147,483,647.) |
| galleries / images | gallery | 1-80 | Alphanumerics, underscores, hyphens, and periods Start and end with alphanumeric. |
| galleries / images / versions | image | 32-bit integer | Numbers and periods Each segment is converted to an int32, so each segment has a max value of 2,147,483,647. |
| images | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| snapshots | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| virtualMachines | resource group | 1-15 (Windows) 1-64 (Linux) See note below. |
Can't use spaces, control characters, or these characters:~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Windows virtual machines can't include periods or end with hyphens. Linux virtual machines can't end with periods or hyphens. |
| virtualMachineScaleSets | resource group | 1-15 (Windows) 1-64 (Linux) See note below. |
Can't use spaces, control characters, or these characters:~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?Can't start with underscore. Can't end with period or hyphen. |
Note
Azure virtual machines have two distinct names: resource name and host name. When you create a virtual machine in the portal, the same value is used for both names. The restrictions in the preceding table are for the host name. The actual resource name can have up to 64 characters.
Microsoft.Communication
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| communicationServices | global | 1-63 | Alphanumerics and hyphens Can't start or end with hyphen. Can't use underscores. |
Microsoft.ConfidentialLedger
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| ledgers | Resource group | 3-32 | Alphanumerics and hyphens Can't start or end with hyphen. |
Microsoft.Consumption
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| budgets | subscription or resource group | 1-63 | Alphanumerics, hyphens, and underscores |
Microsoft.ContainerInstance
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| containerGroups | resource group | 1-63 | Lowercase letters, numbers, and hyphens Can't start or end with hyphen. Consecutive hyphens aren't allowed. |
Microsoft.ContainerRegistry
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| registries | global | 5-50 | Alphanumerics |
| registries / buildTasks | registry | 5-50 | Alphanumerics |
| registries / buildTasks/steps | build task | 5-50 | Alphanumerics |
| registries / replications | registry | 5-50 | Alphanumerics |
| registries / scopeMaps | registry | 5-50 | Alphanumerics, hyphens, and underscores |
| registries / tasks | registry | 5-50 | Alphanumerics, hyphens, and underscores |
| registries / tokens | registry | 5-50 | Alphanumerics, hyphens, and underscores |
| registries / webhooks | registry | 5-50 | Alphanumerics |
Microsoft.ContainerService
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| managedClusters | resource group | 1-63 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| managedClusters / agentPools | managed cluster | 1-12 for Linux 1-6 for Windows |
Lowercase letters and numbers Can't start with a number. |
Microsoft.CustomerInsights
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| hubs | resource group | 1-64 | Alphanumerics Start with a letter. |
| hubs / authorizationPolicies | hub | 1-50 | Alphanumerics, underscores, and periods Start and end with alphanumeric. |
| hubs / connectors | hub | 1-128 | Alphanumerics and underscores Start with a letter. |
| hubs / connectors/mappings | connector | 1-128 | Alphanumerics and underscores Start with a letter. |
| hubs / interactions | hub | 1-128 | Alphanumerics and underscores Start with a letter. |
| hubs / kpi | hub | 1-512 | Alphanumerics and underscores Start with a letter. |
| hubs / links | hub | 1-512 | Alphanumerics and underscores Start with a letter. |
| hubs / predictions | hub | 1-512 | Alphanumerics and underscores Start with a letter. |
| hubs / profiles | hub | 1-128 | Alphanumerics and underscores Start with a letter. |
| hubs / relationshipLinks | hub | 1-512 | Alphanumerics and underscores Start with a letter. |
| hubs / relationships | hub | 1-512 | Alphanumerics and underscores Start with a letter. |
| hubs / roleAssignments | hub | 1-128 | Alphanumerics and underscores Start with a letter. |
| hubs / views | hub | 1-512 | Alphanumerics and underscores Start with a letter. |
Microsoft.CustomProviders
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| associations | resource group | 1-180 | Can't use:%&\\?/ or control charactersCan't end with period or space. |
| resourceProviders | resource group | 3-64 | Can't use:%&\\?/ or control charactersCan't end with period or space. |
Microsoft.DataBox
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| jobs | resource group | 3-24 | Alphanumerics, hyphens, underscores, and periods |
Microsoft.Databricks
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| workspaces | resource group | 3-64 | Alphanumerics, underscores, and hyphens |
Microsoft.DataFactory
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| factories | global | 3-63 | Alphanumerics and hyphens Start and end with alphanumeric. |
| factories / dataflows | factory | 1-260 | Can't use:<>*#.%&:\\+?/ or control charactersStart with alphanumeric. |
| factories / datasets | factory | 1-260 | Can't use:<>*#.%&:\\+?/- or control charactersStart with alphanumeric. |
| factories / integrationRuntimes | factory | 3-63 | Alphanumerics and hyphens Start and end with alphanumeric. |
| factories / linkedservices | factory | 1-260 | Can't use:<>*#.%&:\\+?/ or control charactersStart with alphanumeric. |
| factories / pipelines | factory | 1-260 | Can't use:<>*#.%&:\\+?/ or control charactersStart with alphanumeric. |
| factories / triggers | factory | 1-260 | Can't use:<>*#.%&:\\+?/ or control charactersStart with alphanumeric. |
| factories / triggers / rerunTriggers | trigger | 1-260 | Can't use:<>*#.%&:\\+?/ or control charactersStart with alphanumeric. |
Microsoft.DataLakeAnalytics
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| accounts | global | 3-24 | Lowercase letters and numbers |
| accounts / computePolicies | account | 3-60 | Alphanumerics, hyphens, and underscores |
| accounts / dataLakeStoreAccounts | account | 3-24 | Lowercase letters and numbers |
| accounts / firewallRules | account | 3-50 | Alphanumerics, hyphens, and underscores |
| accounts / storageAccounts | account | 3-60 | Alphanumerics, hyphens, and underscores |
Microsoft.DataLakeStore
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| accounts | global | 3-24 | Lowercase letters and numbers |
| accounts / firewallRules | account | 3-50 | Alphanumerics, hyphens, and underscores |
| accounts / virtualNetworkRules | account | 3-50 | Alphanumerics, hyphens, and underscores |
Microsoft.DataMigration
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| services | resource group | 2-62 | Alphanumerics, hyphens, periods, and underscores Start with alphanumeric. |
| services / projects | service | 2-57 | Alphanumerics, hyphens, periods, and underscores Start with alphanumeric. |
Microsoft.DataProtection
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| backupVaults | resource group | 2-50 | Alphanumerics and hyphens Start with a letter. |
| backupvaults / backupInstances | backup vault | 1-75 | Alphanumerics and hyphens |
| backupVaults / backupPolicies | backup vault | 1-75 | Alphanumerics and hyphens |
Microsoft.DBforMariaDB
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| servers | global | 3-63 | Lowercase letters, hyphens, and numbers Can't start or end with hyphen. |
| servers / databases | servers | 1-63 | Alphanumerics and hyphens |
| servers / firewallRules | servers | 1-128 | Alphanumerics, hyphens, and underscores |
| servers / virtualNetworkRules | servers | 1-128 | Alphanumerics and hyphens |
Microsoft.DBforMySQL
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| servers | global | 3-63 | Lowercase letters, hyphens, and numbers Can't start or end with hyphen. |
| servers / databases | servers | 1-63 | Alphanumerics and hyphens |
| servers / firewallRules | servers | 1-128 | Alphanumerics, hyphens, and underscores |
| servers / virtualNetworkRules | servers | 1-128 | Alphanumerics and hyphens |
Microsoft.DBforPostgreSQL
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| servers | global | 3-63 | Lowercase letters, hyphens, and numbers Can't start or end with hyphens. |
| servers / databases | servers | 1-63 | Alphanumerics and hyphens |
| servers / firewallRules | servers | 1-128 | Alphanumerics, hyphens, and underscores |
| servers / virtualNetworkRules | servers | 1-128 | Alphanumerics and hyphens |
Microsoft.DesktopVirtualization
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| applicationGroups | resource group | 3-64 | Alphanumerics, underscores, periods, and hyphens Start with a letter or number. End with letter, number, or underscore. |
| hostPools | resource group | 3-64 | Alphanumerics, underscores, periods, and hyphens Start with a letter or number. End with letter, number, or underscore. |
| workspaces | resource group | 3-64 | Alphanumerics, underscores, periods, and hyphens Start with a letter or number. End with letter, number, or underscore. |
Microsoft.Devices
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| IotHubs | global | 3-50 | Alphanumerics and hyphens Can't end with hyphen. |
| IotHubs / certificates | IoT hub | 1-64 | Alphanumerics, hyphens, periods, and underscores |
| IotHubs / eventHubEndpoints / ConsumerGroups | eventHubEndpoints | 1-50 | Alphanumerics, hyphens, periods, and underscores |
| provisioningServices | resource group | 3-64 | Alphanumerics and hyphens End with alphanumeric. |
| provisioningServices / certificates | provisioningServices | 1-64 | Alphanumerics, hyphens, periods, and underscores |
Microsoft.DevTestLab
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| labs | resource group | 1-50 | Alphanumerics, underscores, and hyphens |
| labs / customimages | lab | 1-80 | Alphanumerics, underscores, hyphens, and parentheses |
| labs / formulas | lab | 1-80 | Alphanumerics, underscores, hyphens, and parentheses |
| labs / virtualmachines | lab | 1-15 (Windows) 1-64 (Linux) |
Alphanumerics and hyphens Start and end with alphanumeric; can't be all numbers. |
Microsoft.DocumentDB
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| databaseAccounts | global | 3-44 | Lowercase letters, numbers, and hyphens Start with lowercase letter or number. |
Microsoft.ElasticSan (preview)
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| elasticSans | global | 3-24 | Lowercase letters, numbers, hyphens, and underscores Start with lowercase letter or number. Must begin and end with a letter or number. Each hyphen and underscore must be preceded and followed by an alphanumeric character. |
| elasticSans / volumeGroups | elastic san | 3-63 | Lowercase letters, numbers, and hyphens Start with lowercase letter or number. Must begin and end with a letter or number. Each hyphen must be preceded and followed by an alphanumeric character. |
Microsoft.EventGrid
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| domains | resource group | 3-50 | Alphanumerics and hyphens |
| domains / topics | domain | 3-50 | Alphanumerics and hyphens |
| eventSubscriptions | resource group | 3-64 | Alphanumerics and hyphens |
| topics | region | 3-50 | Alphanumerics and hyphens |
Microsoft.EventHub
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| clusters | resource group | 6-50 | Alphanumerics and hyphens Start with a letter. End with letter or number. |
| namespaces | global | 6-50 | Alphanumerics and hyphens Start with a letter. End with letter or number. |
| namespaces / AuthorizationRules | namespace | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with letter or number. |
| namespaces / disasterRecoveryConfigs | global | 6-50 | Alphanumerics and hyphens Start with a letter. End with alphanumeric. |
| namespaces / eventhubs | namespace | 1-256 | Alphanumerics, periods, hyphens, and underscores Start and end with letter or number. |
| namespaces / eventhubs / authorizationRules | event hub | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with letter or number. |
| namespaces / eventhubs / consumergroups | event hub | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with letter or number. |
Microsoft.HDInsight
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| clusters | global | 3-59 | Alphanumerics and hyphens Start and end with letter or number. |
Microsoft.ImportExport
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| jobs | resource group | 2-64 | Alphanumerics and hyphens Start with a letter. |
Microsoft.Insights
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| actionGroups | resource group | 1-260 | Can't use::<>+/&%\?| or control characters Can't end with space or period. |
| autoScaleSettings | resource group | 1-260 | Can't use::<>+/&%\?| or control characters Can't end with space or period. |
| components | resource group | 1-260 | Can't use:%&\?/ or control characters Can't end with space or period. |
| scheduledQueryRules | resource group | 1-260 | Can't use:*<>%{}&:\\?/#| or control characters Can't end with space or period. |
| metricAlerts | resource group | 1-260 | Can't use:*#&+:<>?@%{}\/| or control characters Can't end with space or period. |
| activityLogAlerts | resource group | 1-260 | Can't use:<>*%{}&:\\?+/#| or control characters Can't end with space or period. |
Microsoft.AlertsManagement
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| prometheusRuleGroups | resource group | 1-260 | Can't use:<>*%{}&:\\?+/#| or control characters Can't end with space or period. |
Microsoft.IoTCentral
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| IoTApps | global | 2-63 | Lowercase letters, numbers, and hyphens Start with lowercase letter or number. |
Microsoft.KeyVault
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| vaults | global | 3-24 | Alphanumerics and hyphens Start with a letter. End with letter or number. Can't contain consecutive hyphens. |
| vaults / secrets | Vault | 1-127 | Alphanumerics and hyphens |
Microsoft.Kusto
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| clusters | global | 4-22 | Lowercase letters and numbers Start with a letter. |
| /clusters / databases | cluster | 1-260 | Alphanumerics, hyphens, spaces, and periods |
| /clusters / databases / dataConnections | database | 1-40 | Alphanumerics, hyphens, spaces, and periods |
| /clusters / databases / eventhubconnections | database | 1-40 | Alphanumerics, hyphens, spaces, and periods |
Microsoft.LabServices
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| labplans | resource group | 1-100 | Alphanumerics, hyphens, periods, and underscores Start with a letter and end with alphanumeric. |
| labs | resource group | 1-100 | Alphanumerics, hyphens, periods, and underscores Start with a letter and end with alphanumeric. |
Microsoft.LoadTestService
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| loadtests | global | 1-64 | Can't use:<>*&@:?+/\,;=.|[]" or spaceCan't start with underscore, hyphen, or number. Can't end with underscore or hyphen. |
Microsoft.Logic
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| integrationAccounts | resource group | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / assemblies | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / batchConfigurations | integration account | 1-20 | Alphanumerics |
| integrationAccounts / certificates | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / maps | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / partners | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / rosettanetprocessconfigurations | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / schemas | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationAccounts / sessions | integration account | 1-80 | Alphanumerics, hyphens, underscores, periods, and parentheses |
| integrationServiceEnvironments | resource group | 1-80 | Alphanumerics, hyphens, periods, and underscores |
| integrationServiceEnvironments / managedApis | integration service environment | 1-80 | Alphanumerics, hyphens, periods, and underscores |
| workflows | resource group | 1-43 | Alphanumerics, hyphens, underscores, periods, and parentheses |
Microsoft.MachineLearning
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| commitmentPlans | resource group | 1-260 | Can't use:<>*%&:?+/\\ or control charactersCan't end with a space. |
| webServices | resource group | 1-260 | Can't use:<>*%&:?+/\\ or control charactersCan't end with a space. |
| workspaces | resource group | 1-260 | Can't use:<>*%&:?+/\\ or control charactersCan't end with a space. |
Microsoft.MachineLearningServices
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| workspaces | resource group | 3-33 | Alphanumerics, hyphens, and underscores |
| workspaces / computes | workspace | 3-24 for compute instance 3-32 for AML compute 2-16 for other compute types |
Alphanumerics and hyphens |
| workspaces / datastores | workspace | Maximum 255 characters for datastore name | Datastore name consists only of lowercase letters, digits, and underscores. |
Microsoft.ManagedIdentity
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| userAssignedIdentities | resource group | 3-128 | Alphanumerics, hyphens, and underscores Start with a letter or number. |
Microsoft.Management
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| managementgroups | tenant | 1-90 | Alphanumerics, hyphens, underscores, periods, and parentheses Start with a letter or number. Can't end with period. |
Microsoft.Maps
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| accounts | resource group | 1-98 (for resource group name and account name) | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. |
Microsoft.Media
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| mediaservices | Azure region | 3-24 | Lowercase letters and numbers |
| mediaservices / liveEvents | Media service | 1-32 | Alphanumerics and hyphens Start with alphanumeric. |
| mediaservices / liveEvents / liveOutputs | Live event | 1-256 | Alphanumerics and hyphens Start with alphanumeric. |
| mediaservices / streamingEndpoints | Media service | 1-24 | Alphanumerics and hyphens Start with alphanumeric. |
Microsoft.MobileNetwork
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| mobileNetworks | Resource Group | 1-64 | Alphanumerics and hyphens Start with alphanumeric. |
| mobileNetworks / sites | Mobile Network | 1-64 | Alphanumerics and hyphens Start with alphanumeric. |
| mobileNetworks / slices | Mobile Network | 1-64 | Alphanumerics and hyphens Start with alphanumeric. |
| mobileNetworks / services | Mobile Network | 1-64 | Alphanumerics and hyphens Start with alphanumeric. The following words can't be used on their own as the name: default, requested, service. |
| mobileNetworks / dataNetworks | Mobile Network | 1-64 | Alphanumeric, hyphens, and a period/dot (.) Start and end with alphanumeric. Note: A period/dot ( .) must be followed by an alphanumeric character. |
| mobileNetworks / simPolicies | Mobile Network | 1-64 | Alphanumerics and hyphens Start with alphanumeric. |
| packetCoreControlPlanes | Resource Group | 1-64 | Alphanumeric, underscores and hyphens Start with alphanumeric. |
| packetCoreControlPlanes / packetCoreDataPlanes | Packet Core Control Plane | 1-64 | Alphanumeric, underscores, and hyphens Start with alphanumeric. |
| packetCoreControlPlanes / packetCoreDataPlanes / attachedDataNetworks | Mobile Network | 1-64 | Alphanumeric, hyphens and a period/dot (.) Start and end with alphanumeric. Note: A period/dot ( .) must be followed by an alphanumeric character. |
| simGroups | Resource Group | 1-64 | Alphanumeric, underscores, and hyphens Start with alphanumeric. |
| simGroups / sims | Sim Group | 1-64 | Alphanumeric, underscores, and hyphens Start with alphanumeric. |
Microsoft.NetApp
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| netAppAccounts | resource group | 1-128 | Alphanumerics, underscores, and hyphens Start with alphanumeric. |
| netAppAccounts / backups | NetApp account | 3-225 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. |
| netAppAccounts / backupPolicies | NetApp account | 1-64 | Alphanumerics, underscores, and hyphens Start with alphanumeric. |
| netAppAccounts / capacityPools | NetApp account | 1-64 | Alphanumerics, underscores, and hyphens Start with alphanumeric. |
| netAppAccounts / snapshots | NetApp account | 1-255 | Alphanumerics, underscores, and hyphens Start with alphanumeric. |
| netAppAccounts / snapshotPolicies | NetApp account | 1-64 | Alphanumerics, underscores, and hyphens Start with alphanumeric. |
| netAppAccounts / volumes | NetApp account | 1-64 | Alphanumerics, underscores, and hyphens Start with alphanumeric. Volume can't be named bin or default. |
| netAppAccounts / volumeGroups | NetApp account | 3-64 | Alphanumerics, underscores, and hyphens Start with alphanumeric. |
Microsoft.Network
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| applicationGateways | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| applicationSecurityGroups | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| azureFirewalls | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| bastionHosts | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| connections | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| dnsForwardingRuleset | resource group | 1-80 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| dnsResolvers | resource group | 1-80 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| dnsResolvers / inboundEndpoints | resource group | 1-80 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| dnsResolvers / outboundEndpoints | resource group | 1-80 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| dnsZones | resource group | 1-63 characters 2 to 34 labels Each label is a set of characters separated by a period. For example, contoso.com has two labels. |
Each label can contain alphanumerics, underscores, and hyphens. Each label is separated by a period. |
| expressRouteCircuits | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| firewallPolicies | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| firewallPolicies / ruleGroups | firewall policy | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| frontDoors | global | 5-64 | Alphanumerics and hyphens Start and end with alphanumeric. |
| frontdoorWebApplicationFirewallPolicies | resource group | 1-128 | Alphanumerics Start with a letter. |
| loadBalancers | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| loadBalancers / inboundNatRules | load balancer | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| localNetworkGateways | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| networkInterfaces | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| networkSecurityGroups | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| networkSecurityGroups / securityRules | network security group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| networkWatchers | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| privateDnsZones | resource group | 1-63 characters 2 to 34 labels Each label is a set of characters separated by a period. For example, contoso.com has two labels. |
Each label can contain alphanumerics, underscores, and hyphens. Each label is separated by a period. |
| privateDnsZones / virtualNetworkLinks | private Domain Name System zone | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| privateEndpoints | resource group | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| privateLinkServices | resource group | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| privateLinkServices / privateEndpointConnections | private link service | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| publicIPAddresses | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| publicIPPrefixes | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| routeFilters | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| routeFilters / routeFilterRules | route filter | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| routeTables | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| routeTables / routes | route table | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| serviceEndpointPolicies | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| trafficmanagerprofiles | global | 1-63 | Alphanumerics, hyphens, and periods Start and end with alphanumeric. |
| virtualNetworkGateways | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| virtualNetworks | resource group | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| virtualnetworks / subnets | virtual network | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| virtualNetworks / virtualNetworkPeerings | virtual network | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| virtualWans | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| vpnGateways | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| vpnGateways / vpnConnections | VPN gateway | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
| vpnSites | resource group | 1-80 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric. End with alphanumeric or underscore. |
Microsoft.NetworkCloud
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| bareMetalMachineKeySets | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| bareMetalMachines | resource group | 2-64 | Alphanumerics |
| bmcKeySets | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| cloudServicesNetworks | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| clusterManagers | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| clusters | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| clusters / metricsConfigurations | cluster | see value | Must be default. |
| edgeClusters | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| edgeClusters / nodes | edge cluster | 2-64 | Alphanumerics |
| kubernetesClusters | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| kubernetesClusters / agentPools | kubernetes cluster | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| kubernetesClusters / features | kubernetes cluster | 2-63 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. Only predefined values are valid. |
| l2Networks | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| l3Networks | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| racks | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| registrationHubs | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| registrationHubs / machines | registration hub | 2-40 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| storageAppliances | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| trunkedNetworks | resource group | 2-30 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| volumes | resource group | 2-64 | Alphanumerics, underscores, and hyphens Start and end with alphanumeric. |
| virtualMachines | resource group | 2-64 | Alphanumerics |
| virtualMachines / consoles | virtual machine | see value | Must be default. |
Microsoft.NotificationHubs
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| namespaces | global | 6-50 | Alphanumerics and hyphens Start with a letter. End with alphanumeric. |
| namespaces / AuthorizationRules | namespace | 1-256 | Alphanumerics, periods, hyphens, and underscores Start alphanumeric. |
| namespaces / notificationHubs | namespace | 1-260 | Alphanumerics, periods, hyphens, and underscores Start alphanumeric. |
| namespaces / notificationHubs / AuthorizationRules | notification hub | 1-256 | Alphanumerics, periods, hyphens, and underscores Start alphanumeric. |
Microsoft.OperationalInsights
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| clusters | resource group | 4-63 | Alphanumerics and hyphens Start and end with alphanumeric. |
| workspaces | resource group | 4-63 | Alphanumerics and hyphens Start and end with alphanumeric. |
Microsoft.OperationsManagement
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| solutions | workspace | N/A | For solutions authored by Microsoft, the name must be in the pattern:SolutionType(WorkspaceName)For solutions authored by third parties, the name must be in the pattern: SolutionType[WorkspaceName]For example, a valid name is: AntiMalware(contoso-IT)The solution type is case-sensitive. |
Microsoft.Portal
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| dashboards | resource group | 3-160 | Alphanumerics and hyphens To use restricted characters, add a tag named hidden-title with the dashboard name you want to use. The portal displays that name when showing the dashboard. |
Microsoft.PowerBI
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| workspaceCollections | region | 3-63 | Alphanumerics and hyphens Can't start with hyphen. Can't use consecutive hyphens. |
Microsoft.PowerBIDedicated
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| capacities | region | 3-63 | Lowercase letters or numbers Start with lowercase letter. |
Microsoft.Quantum
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| workspaces | region | 2-54 | Alphanumerics and hyphens Can't start or end with hyphen. |
Microsoft.RecoveryServices
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| vaults | resource group | 2-50 | Alphanumerics and hyphens Start with a letter. |
| vaults / backupPolicies | vault | 3-150 | Alphanumerics and hyphens Start with a letter. Can't end with hyphen. |
Microsoft.Relay
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| namespaces | global | 6-50 | Alphanumerics and hyphens Start with a letter. End with a letter or number. |
| namespaces / AuthorizationRules | namespace | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphanumeric. |
| namespaces / HybridConnections | namespace | 1-260 | Alphanumerics, periods, hyphens, underscores, and slashes Start and end with alphanumeric. |
| namespaces / HybridConnections/authorizationRules | hybrid connection | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphanumeric. |
| namespaces / WcfRelays | namespace | 1-260 | Alphanumerics, periods, hyphens, underscores, and slashes Start and end with alphanumeric. |
| namespaces / WcfRelays / authorizationRules | Wcf relay | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphanumeric. |
Microsoft.Resources
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| deployments | resource group | 1-64 | Alphanumerics, underscores, parentheses, hyphens, and periods |
| resourcegroups | subscription | 1-90 | Underscores, hyphens, periods, parentheses, and letters or digits as defined by the Char.IsLetterOrDigit functionValid characters are members of the following categories in UnicodeCategory: UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, OtherLetter, DecimalDigitNumber. Can't end with period. |
| tagNames | resource | 1-512 | Can't use:<>%&\?/ or control characters |
| tagNames / tagValues | tag name | 1-256 | All characters |
| templateSpecs | resource group | 1-90 | Alphanumerics, underscores, parentheses, hyphens, and periods |
Microsoft.Security
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| advancedThreatProtectionSettings | resource group | see value | Must be current |
| alertsSuppressionRules | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| assessmentMetadata | assessment type | 1-260 | Alphanumerics, underscores, and hyphens |
| assessments | assessment type | 1-260 | Alphanumerics, underscores, and hyphens |
| automations | resource group | 1-260 | Alphanumerics, underscores, and hyphens |
| autoProvisioningSettings | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| connectors | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| deviceSecurityGroups | resource group | 1-260 | Alphanumerics, underscores, and hyphens |
| informationProtectionPolicies | resource group | see values | Use one of:customeffective |
| iotSecuritySolutions | resource group | 1-260 | Alphanumerics, underscores, and hyphens |
| locations / applicationWhitelistings | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| locations / jitNetworkAccessPolicies | resource group | 1-260 | Alphanumerics, underscores, and hyphens |
| ingestionSettings | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| pricings | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| securityContacts | subscription | 1-260 | Alphanumerics, underscores, and hyphens |
| settings | subscription | see values | Use one of:MCASSentinelWDATPWDATP_EXCLUDE_LINUX_PUBLIC_PREVIEW |
| serverVulnerabilityAssessments | resource type | see value | Must be Default |
| sqlVulnerabilityAssessments / baselineRules | Vulnerability assessment | 1-260 | Alphanumerics, underscores, and hyphens |
Microsoft.ServiceBus
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| namespaces | global | 6-50 | Alphanumerics and hyphens Start with a letter. End with a letter or number. For more information, see Create namespace. |
| namespaces / AuthorizationRules | namespace | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphnumeric. |
| namespaces / disasterRecoveryConfigs | global | 6-50 | Alphanumerics and hyphens Start with a letter. End with alphanumeric. |
| namespaces / migrationConfigurations | namespace | Should always be $default. | |
| namespaces / queues | namespace | 1-260 | Alphanumerics, periods, hyphens, underscores, and slashes Start and end with alphanumeric. |
| namespaces / queues / authorizationRules | queue | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphnumeric. |
| namespaces / topics | namespace | 1-260 | Alphanumerics, periods, hyphens, underscores, and slashes Start and end with alphanumeric. |
| namespaces / topics / authorizationRules | topic | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphnumeric. |
| namespaces / topics / subscriptions | topic | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphnumeric. |
| namespaces / topics / subscriptions / rules | subscription | 1-50 | Alphanumerics, periods, hyphens, and underscores Start and end with alphnumeric. |
Microsoft.ServiceFabric
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| clusters | region | 4-23 | Lowercase letters, numbers, and hyphens Start with lowercase letter. End with lowercase letter or number. |
Microsoft.SignalRService
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| signalR | global | 3-63 | Alphanumerics and hyphens Start with a letter. End with letter or number. |
Microsoft.Sql
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| managedInstances | global | 1-63 | Lowercase letters, numbers, and hyphens Can't start or end with hyphen. |
| servers | global | 1-63 | Lowercase letters, numbers, and hyphens Can't start or end with hyphen. |
| servers / administrators | server | Must be ActiveDirectory. |
|
| servers / databases | server | 1-128 | Can't use:<>*%&:\/? or control charactersCan't end with period or space. |
| servers / databases / syncGroups | database | 1-150 | Alphanumerics, hyphens, and underscores |
| servers / elasticPools | server | 1-128 | Can't use:<>*%&:\/? or control charactersCan't end with period or space. |
| servers / failoverGroups | global | 1-63 | Lowercase letters, numbers, and hyphens Can't start or end with hyphen. |
| servers / firewallRules | server | 1-128 | Can't use:<>*%&:;\/? or control charactersCan't end with period. |
| servers / keys | server | Must be in format:VaultName_KeyName_KeyVersion. |
Microsoft.Storage
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| storageAccounts | global | 3-24 | Lowercase letters and numbers |
| storageAccounts / blobServices | storage account | Must be default. |
|
| storageAccounts / blobServices / containers | storage account | 3-63 | Lowercase letters, numbers, and hyphens Start with lowercase letter or number. Can't use consecutive hyphens. |
| storageAccounts / fileServices | storage account | Must be default. |
|
| storageAccounts / fileServices / shares | storage account | 3-63 | Lowercase letters, numbers, and hyphens Can't start or end with hyphen. Can't use consecutive hyphens. |
| storageAccounts / managementPolicies | storage account | Must be default. |
|
| blob | container | 1-1024 | Any URL characters and case sensitive |
| queue | storage account | 3-63 | Lowercase letters, numbers, and hyphens Can't start or end with hyphens. Can't use consecutive hyphens. |
| table | storage account | 3-63 | Alphanumerics Start with a letter. |
Microsoft.StorageSync
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| storageSyncServices | resource group | 1-260 | Alphanumerics, spaces, periods, hyphens, and underscores Can't end with period or space. |
| storageSyncServices / syncGroups | storage sync service | 1-260 | Alphanumerics, spaces, periods, hyphens, and underscores Can't end with period or space. |
Microsoft.StorSimple
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| managers | resource group | 2-50 | Alphanumerics and hyphens Start with a letter. End with alphanumeric. |
Microsoft.StreamAnalytics
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| streamingjobs | resource group | 3-63 | Alphanumerics, hyphens, and underscores |
| streamingjobs / functions | streaming job | 3-63 | Alphanumerics, hyphens, and underscores |
| streamingjobs / inputs | streaming job | 3-63 | Alphanumerics, hyphens, and underscores |
| streamingjobs / outputs | streaming job | 3-63 | Alphanumerics, hyphens, and underscores |
| streamingjobs / transformations | streaming job | 3-63 | Alphanumerics, hyphens, and underscores |
Microsoft.Synapse
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| privateLinkHubs | resource group | 1-45 | Lowercase letters and numbers |
| workspaces | global | 1-50 | Lowercase letters, hyphens, and numbers Start and end with letter or number. Can't contain -ondemand. |
| workspaces / bigDataPools | workspace | 1-15 | Letters and numbers Start with a letter. End with letter or number. Can't contain reserved words. |
| workspaces / sqlPools | workspace | 1-60 | Can't contain <>*%&:\/?@- or control characters Can't end with . or space. Can't contain reserved words. |
Microsoft.TimeSeriesInsights
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| environments | resource group | 1-90 | Can't use:'<>%&:\?/# or control characters |
| environments / accessPolicies | environment | 1-90 | Can't use:'<>%&:\?/# or control characters |
| environments / eventSources | environment | 1-90 | Can't use:'<>%&:\?/# or control characters |
| environments / referenceDataSets | environment | 3-63 | Alphanumerics |
Microsoft.Web
| Entity | Scope | Length | Valid Characters |
|---|---|---|---|
| certificates | resource group | 1-260 | Can't use:/ Can't end with a space or period. |
| serverfarms | resource group | 1-60 | Alphanumeric, hyphens, and Unicode characters that can be mapped to Punycode |
| sites | Global or per domain; see note below. | 2-60 | Alphanumeric, hyphens, and Unicode characters that can be mapped to Punycode Can't start or end with hyphen. |
| sites / slots | site | 2-59 | Alphanumeric, hyphens, and Unicode characters that can be mapped to Punycode |
| sites / privateEndpointConnections | site | 2-64 | Alphanumerics, underscores, periods, and hyphens Start with alphanumeric; end alphanumeric or underscore. |
Note
A web site must have a globally unique URL. When you create a web site that uses a hosting plan, the URL is http://<app-name>.azurewebsites.net. The app name must be globally unique. When you create a web site that uses an App Service Environment, the app name must be unique within the domain for the App Service Environment. For both cases, the URL of the site is globally unique.
Azure Functions has the same naming rules and restrictions as Microsoft.Web/sites. When generating the host ID, the function app name is truncated to 32 characters. This can cause host ID collision when a shared storage account is used. For more information, see Host ID considerations.
Unicode characters are parsed to Punycode using the IdnMapping.GetAscii method
Next steps
For recommendations about how to name resources, see Ready: Recommended naming and tagging conventions.
Resources with public endpoints can't include reserved words or trademarks in their names. For a list of the blocked words, see Resolve reserved resource name errors.