Naming rules and restrictions for Azure resources

  • Article
  • 03/14/2025

This article summarizes naming rules and restrictions for Azure resources.

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.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.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.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.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.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 characters

Start with alphanumeric.
factories / datasets factory 1-260 Can't use:
<>*#.%&:\\+?/- or control characters

Start 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 characters

Start with alphanumeric.
factories / pipelines factory 1-260 Can't use:
<>*#.%&:\\+?/ or control characters

Start with alphanumeric.
factories / triggers factory 1-260 Can't use:
<>*#.%&:\\+?/ or control characters

Start with alphanumeric.
factories / triggers / rerunTriggers trigger 1-260 Can't use:
<>*#.%&:\\+?/ or control characters

Start with alphanumeric.

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.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.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 characters

Can't end with a space.
webServices resource group 1-260 Can't use:
<>*%&:?+/\\ or control characters

Can't end with a space.
workspaces resource group 1-260 Can't use:
<>*%&:?+/\\ or control characters

Can'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.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 and hyphens

Start and end with alphanumeric.

Note: A period/dot (.) is not allowed in the profile name.
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 function

Valid 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:
custom
effective
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:
MCAS
Sentinel
WDATP
WDATP_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 characters

Can'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 characters

Can'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 characters

Can'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.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>.chinacloudsites.cn. 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