Naming rules and restrictions for Azure resources

This article summarizes naming rules and restrictions for Azure resources.

This article lists resources by resource provider namespace. For a list of how resource providers match Azure services, see 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 may have different casing than what you originally specified for the name. The returned value may even display different case values than what is listed in the valid characters table.

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

All resources with a public endpoint can't include reserved words or trademarks in the name. For a list of the blocked words, see Resolve reserved resource name errors.

Don't use # in a resource name. It interferes with URL parsing on Azure Resource Manager requests.

Microsoft.AnalysisServices

Entity Scope Length Valid Characters
servers resource group 3-63 Lowercase letters and numbers.

Start with lowercase letter.

Microsoft.ApiManagement

Entity Scope Length Valid Characters
service global 1-50 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis / issues api 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis / issues / attachments issue 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis / issues / comments issue 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis / operations api 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis / operations / tags operation 1-80 Alphanumerics and hyphens.

Start with 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 letter and end with alphanumeric.
service / apis / tagDescriptions api 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / apis / tags api 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / api-version-sets service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / authorizationServers service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / backends service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / certificates service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / diagnostics service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / groups service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / groups / users group 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / identityProviders service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / loggers service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / notifications service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / notifications / recipientEmails notification 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / openidConnectProviders service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / policies service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / products service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / products / apis product 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / products / groups product 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / products / tags product 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / properties service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / subscriptions service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / tags service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / templates service 1-80 Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
service / users service 1-80 Alphanumerics and hyphens.

Start with 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 2 hyphens.

Can�t start with or end with an hyphen.
configurationStores / replicas configurationStore 1-50

The combined length of the configurationStore name and the replica name can�t exceed 60 characters.
Alphanumerics only.

* {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 parenthesis.

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 globally unique identifier (GUID).

Microsoft.Automation

Entity Scope Length Valid Characters
automationAccounts resource group & region
(See note below)
6-50 Alphanumerics and hyphens.

Start with 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 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 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, hyhens, 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 VMs can't include period or end with hyphen.

Linux VMs can't end with period or hyphen.
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.
openShiftManagedClusters resource group 1-30 Alphanumerics.

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

Entity Scope Length Valid Characters
applicationGroups resource group 3-64 Alphanumerics, underscores, periods, and hyphens.

Start with letter or number. End with letter, number, or underscore.
hostPools resource group 3-64 Alphanumerics, underscores, periods, and hyphens.

Start with letter or number. End with letter, number, or underscore.
workspaces resource group 3-64 Alphanumerics, underscores, periods, and hyphens.

Start with 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 a 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 a 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 letter. End with letter or number.
namespaces global 6-50 Alphanumerics and hyphens.

Start with 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 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 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.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 letter. End with letter or digit. 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 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 parenthesis.
integrationAccounts / assemblies integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
integrationAccounts / batchConfigurations integration account 1-20 Alphanumerics.
integrationAccounts / certificates integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
integrationAccounts / maps integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
integrationAccounts / partners integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
integrationAccounts / rosettanetprocessconfigurations integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
integrationAccounts / schemas integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
integrationAccounts / sessions integration account 1-80 Alphanumerics, hyphens, underscores, periods, and parenthesis.
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 parenthesis.

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 letter or number.

Microsoft.Management

Entity Scope Length Valid Characters
managementgroups tenant 1-90 Alphanumerics, hyphens, underscores, periods, and parentheses.

Start with letter or number.

Cannot 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 cannot 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 cannot 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 alphanumeric or underscore.
applicationSecurityGroups resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End 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 alphanumeric or underscore.
connections resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
dnsForwardingRuleset resource group 1-80 Alphanumerics, underscores and hyphens.

Start with alphanumeric. End alphanumeric.
dnsResolvers resource group 1-80 Alphanumerics, underscores and hyphens.

Start with alphanumeric. End alphanumeric.
dnsResolvers / inboundEndpoints resource group 1-80 Alphanumerics, underscores and hyphens.

Start with alphanumeric. End alphanumeric.
dnsResolvers / outboundEndpoints resource group 1-80 Alphanumerics, underscores and hyphens.

Start with alphanumeric. End 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 2 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 alphanumeric or underscore.
firewallPolicies resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
firewallPolicies / ruleGroups firewall policy 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
frontDoors global 5-64 Alphanumerics and hyphens.

Start and end with alphanumeric.
frontdoorWebApplicationFirewallPolicies resource group 1-128 Alphanumerics.

Start with letter.
loadBalancers resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
loadBalancers / inboundNatRules load balancer 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
localNetworkGateways resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
networkInterfaces resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
networkSecurityGroups resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
networkSecurityGroups / securityRules network security group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
networkWatchers resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End 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 2 labels.
Each label can contain alphanumerics, underscores, and hyphens.

Each label is separated by a period.
privateDnsZones / virtualNetworkLinks private DNS zone 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
privateEndpoints resource group 2-64 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
privateLinkServices resource group 2-64 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
privateLinkServices / privateEndpointConnections private link service 2-64 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
publicIPAddresses resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
publicIPPrefixes resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
routeFilters resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
routeFilters / routeFilterRules route filter 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
routeTables resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
routeTables / routes route table 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
serviceEndpointPolicies resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End 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 alphanumeric or underscore.
virtualNetworks resource group 2-64 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
virtualnetworks / subnets virtual network 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
virtualNetworks / virtualNetworkPeerings virtual network 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
virtualWans resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
vpnGateways resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
vpnGateways / vpnConnections VPN gateway 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.
vpnSites resource group 1-80 Alphanumerics, underscores, periods, and hyphens.

Start with alphanumeric. End alphanumeric or underscore.

Microsoft.NetworkCloud

Entity Scope Length Valid Characters
bareMetalMachineKeySets resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
bareMetalMachines resource group 2-64 Alphanumerics.
bmcKeySets resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
cloudServicesNetworks resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
clusterManagers resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
clusters resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
clusters / metricsConfigurations cluster see value Must be default.
edgeClusters resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
edgeClusters / nodes edge cluster 2-64 Alphanumerics.
kubernetesClusters resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
kubernetesClusters / agentPools kubernetes cluster 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
kubernetesClusters / features kubernetes cluster 2-63 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.

Only predefined values.
l2Networks resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
l3Networks resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
racks resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
registrationHubs resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
registrationHubs / machines registration hub 2-40 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
storageAppliances resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
trunkedNetworks resource group 2-30 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. End with alphanumeric.
volumes resource group 2-64 Alphanumerics, underscores, and hyphens.

Start with alphanumeric. 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 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 letter.
vaults / backupPolicies vault 3-150 Alphanumerics and hyphens.

Start with 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 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 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, case sensitive
queue storage account 3-63 Lowercase letters, numbers, and hyphens.

Can't start or end with hyphen. Can't use consecutive hyphens.
table storage account 3-63 Alphanumerics.

Start with 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 letter. End with letter or number.

Can't contain reserved word.
workspaces / sqlPools workspace 1-60 Can't contain <>*%&:\/?@- or control characters.

Can't end with . or space.

Can't contain reserved word.

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