az maps account

Reference

Manage Azure Maps accounts.

Commands

az maps account create	Create a Maps Account. A Maps Account holds the keys which allow access to the Maps REST APIs.
az maps account delete	Delete a Maps Account.
az maps account keys	Manage Azure Maps account keys.
az maps account keys list	Get the keys to use with the Maps APIs. A key is used to authenticate and authorize access to the Maps REST APIs. Only one key is needed at a time; two are given to provide seamless key regeneration.
az maps account keys renew	Regenerate either the primary or secondary key for use with the Maps APIs. The old key will stop working immediately.
az maps account list	Show all maps accounts in a subscription or in a resource group.
az maps account show	Show the details of a maps account.
az maps account update	Updates a Maps Account. Only a subset of the parameters may be updated after creation, such as Sku, Tags, Properties.

az maps account create

Edit

Create a Maps Account. A Maps Account holds the keys which allow access to the Maps REST APIs.

az maps account create --account-name
                       --resource-group
                       --sku {G2, S0, S1}
                       [--accept-tos]
                       [--disable-local-auth {false, true}]
                       [--kind {Gen1, Gen2}]
                       [--linked-resources]
                       [--tags]
                       [--type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                       [--user-identities]

Examples

Create Account with Managed Identities

az maps account create --type "SystemAssigned, UserAssigned" --user-identities "{\"/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName\":{}}" --kind "Gen2" --disable-local-auth false --linked-resources id="/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.Storage/accounts/mystorageacc" unique-name="myBatchStorageAccount" --linked-resources id="/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.Storage/accounts/mystorageacc" unique-name="myBlobDataSource" --tags test="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Create Gen1 Account

az maps account create --kind "Gen1" --disable-local-auth false --tags test="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Create Gen2 Account

az maps account create --kind "Gen2" --disable-local-auth true --tags test="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Required Parameters

--account-name --name -n

The name of the maps account.

--resource-group -g

Resource group name.

--sku -s

The name of the SKU, in standard format (such as S0).

accepted values: G2, S0, S1

Optional Parameters

--accept-tos

You must agree to the License and Privacy Statement to create an account.

--disable-local-auth

Allows toggle functionality on Azure Policy to disable Azure Maps local authentication support. This will disable Shared Keys authentication from any usage.

accepted values: false, true

--kind

Get or Set Kind property.

accepted values: Gen1, Gen2

--linked-resources

Sets the resources to be used for Managed Identities based operations for the Map account resource.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--type

The identity type.

accepted values: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned

--user-identities

The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Expected value: json-string/@json-file.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az maps account delete

Edit

Delete a Maps Account.

az maps account delete [--account-name]
                       [--ids]
                       [--resource-group]
                       [--subscription]

Examples

DeleteAccount

az maps account delete --name "myMapsAccount" --resource-group "myResourceGroup"

Optional Parameters

--account-name --name -n

The name of the maps account.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--resource-group -g

Resource group name.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az maps account list

Edit

Show all maps accounts in a subscription or in a resource group.

az maps account list [--resource-group]

Optional Parameters

--resource-group -g

Resource group name.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az maps account show

Edit

Show the details of a maps account.

az maps account show [--account-name]
                     [--ids]
                     [--resource-group]
                     [--subscription]

Examples

Show the details of a maps account. (autogenerated)

az maps account show --name MyMapsAccount --resource-group MyResourceGroup

Optional Parameters

--account-name --name -n

The name of the maps account.

--ids

--resource-group -g

Resource group name.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az maps account update

Edit

Updates a Maps Account. Only a subset of the parameters may be updated after creation, such as Sku, Tags, Properties.

az maps account update --sku {G2, S0, S1}
                       [--account-name]
                       [--disable-local-auth {false, true}]
                       [--ids]
                       [--kind {Gen1, Gen2}]
                       [--linked-resources]
                       [--resource-group]
                       [--subscription]
                       [--tags]
                       [--type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                       [--user-identities]

Examples

Update Account Managed Identities

az maps account update --type "SystemAssigned, UserAssigned" --user-identities "{\"/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName\":{}}" --kind "Gen2" --linked-resources id="/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}" unique-name="myBatchStorageAccount" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S1"

Update Account Tags

az maps account update --tags specialTag="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Update to Gen1 Account

az maps account update --kind "Gen1" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Update to Gen2 Account

az maps account update --kind "Gen2" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Required Parameters

--sku -s

The name of the SKU, in standard format (such as S0).

accepted values: G2, S0, S1

Optional Parameters

--account-name --name -n

The name of the maps account.

--disable-local-auth

Allows toggle functionality on Azure Policy to disable Azure Maps local authentication support. This will disable Shared Keys authentication from any usage.

accepted values: false, true

--ids

--kind

Get or Set Kind property.

accepted values: Gen1, Gen2

--linked-resources

Sets the resources to be used for Managed Identities based operations for the Map account resource.

--resource-group -g

Resource group name.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--type

The identity type.

accepted values: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned

--user-identities

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az maps account

Commands

az maps account create

Examples

Required Parameters

Optional Parameters

az maps account delete

Examples

Optional Parameters

az maps account list

Optional Parameters

az maps account show

Examples

Optional Parameters

az maps account update

Examples

Required Parameters

Optional Parameters

Feedback

Additional resources