az account

Reference

Manage Azure subscription information.

Commands

az account accept-ownership-status	Accept subscription ownership status.
az account alias	Manage subscription alias.
az account alias create	Create Alias Subscription.
az account alias delete	Delete Alias.
az account alias list	List Alias Subscriptions.
az account alias show	Get Alias Subscription.
az account alias wait	Place the CLI in a waiting state until a condition of the account alias is met.
az account clear	Clear all subscriptions from the CLI's local cache.
az account create	Create a subscription.
az account get-access-token	Get a token for utilities to access Azure.
az account list	Get a list of subscriptions for the logged in account. By default, only 'Enabled' subscriptions from the current cloud is shown.
az account list-locations	List supported regions for the current subscription.
az account lock	Manage Azure subscription level locks.
az account lock create	Create a subscription lock.
az account lock delete	Delete a subscription lock.
az account lock list	List lock information in the subscription.
az account lock show	Show the details of a subscription lock.
az account lock update	Update a subscription lock.
az account management-group	Manage Azure Management Groups.
az account management-group check-name-availability	Check if a Management Group Name is Valid.
az account management-group create	Create a new management group.
az account management-group delete	Delete an existing management group.
az account management-group entities	Entity operations (Management Group and Subscriptions) for Management Groups.
az account management-group entities list	List all entities for the authenticated user.
az account management-group hierarchy-settings	Provide operations for hierarchy settings defined at the management group level. Settings can only be set on the root Management Group of the hierarchy.
az account management-group hierarchy-settings create	Create hierarchy settings defined at the Management Group level.
az account management-group hierarchy-settings delete	Delete the hierarchy settings defined at the Management Group level.
az account management-group hierarchy-settings list	Get all the hierarchy settings defined at the Management Group level.
az account management-group hierarchy-settings update	Update the hierarchy settings defined at the Management Group level.
az account management-group list	List all management groups.
az account management-group show	Get a specific management group.
az account management-group subscription	Subscription operations for Management Groups.
az account management-group subscription add	Add a subscription to a management group.
az account management-group subscription remove	Remove an existing subscription from a management group.
az account management-group subscription show	Show the details of a subscription under a known management group.
az account management-group subscription show-sub-under-mg	Get the subscription under a management group.
az account management-group tenant-backfill	Backfill Tenant Subscription Operations for Management Groups.
az account management-group tenant-backfill get	Get the backfill status for a tenant.
az account management-group tenant-backfill start	Start backfilling subscriptions for a tenant.
az account management-group update	Update an existing management group.
az account set	Set a subscription to be the current active subscription.
az account show	Get the details of a subscription.
az account subscription	Manage subscriptions.
az account subscription cancel	Cancel subscription.
az account subscription enable	Enable subscription.
az account subscription list	Get all subscriptions for a tenant.
az account subscription list-location	This operation provides all the locations that are available for resource providers; however, each resource provider may support a subset of this list.
az account subscription rename	Rename subscription.
az account subscription show	Get details about a specified subscription.
az account tenant	Manage tenant.
az account tenant list	Get the tenants for your account.

az account accept-ownership-status

Accept subscription ownership status.

az account accept-ownership-status --subscription-id

Required Parameters

--subscription-id

Subscription Id. Required.

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

Edit

Clear all subscriptions from the CLI's local cache.

To clear the current subscription, use 'az logout'.

az account clear

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

Create a subscription.

az account create --enrollment-account-name
                  --offer-type {MS-AZR-0017P, MS-AZR-0148P, MS-AZR-USGOV-0015P, MS-AZR-USGOV-0017P, MS-AZR-USGOV-0148P}
                  [--display-name]
                  [--owner-object-id]
                  [--owner-spn]
                  [--owner-upn]

Required Parameters

--enrollment-account-name --enrollment-account-object-id

The name of the enrollment account which should be used to create a subscription.

--offer-type

The offer type of the subscription. For example, MS-AZR-0017P (EnterpriseAgreement) and MS-AZR-0148P (EnterpriseAgreement devTest) are available.

accepted values: MS-AZR-0017P, MS-AZR-0148P, MS-AZR-USGOV-0015P, MS-AZR-USGOV-0017P, MS-AZR-USGOV-0148P

Optional Parameters

--display-name

The display name of the subscription.

--owner-object-id

The object id(s) of the owner(s) which should be granted access to the new subscription.

--owner-spn

The service principal name(s) of the owner(s) which should be granted access to the new subscription.

--owner-upn

The user principal name(s) of owner(s) who should be granted access to the new subscription.

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 account get-access-token

Edit

Get a token for utilities to access Azure.

The token will be valid for at least 5 minutes with the maximum at 60 minutes. If the subscription argument isn't specified, the current account is used.

az account get-access-token [--name]
                            [--resource]
                            [--resource-type {aad-graph, arm, batch, data-lake, media, ms-graph, oss-rdbms}]
                            [--scope]
                            [--tenant]

Examples

Get an access token for the current account

az account get-access-token

Get an access token for a specific subscription

az account get-access-token --subscription 00000000-0000-0000-0000-000000000000

Get an access token for a specific tenant

az account get-access-token --tenant 00000000-0000-0000-0000-000000000000

Get an access token to use with MS Graph API

az account get-access-token --resource-type ms-graph

Optional Parameters

--name --subscription -n -s

Name or ID of subscription.

--resource

Azure resource endpoints in AAD v1.0.

--resource-type

Type of well-known resource.

accepted values: aad-graph, arm, batch, data-lake, media, ms-graph, oss-rdbms

--scope

Space-separated AAD scopes in AAD v2.0. Default to Azure Resource Manager.

--tenant -t

Tenant ID for which the token is acquired. Only available for user and service principal account, not for MSI or Cloud Shell account.

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

Edit

Get a list of subscriptions for the logged in account. By default, only 'Enabled' subscriptions from the current cloud is shown.

az account list [--all]
                [--refresh]

Optional Parameters

--all

List all subscriptions from all clouds, rather than just 'Enabled' ones.

default value: False

--refresh

Retrieve up-to-date subscriptions from server.

default value: False

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 account list-locations

Edit

List supported regions for the current subscription.

az account list-locations

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

Edit

Set a subscription to be the current active subscription.

az account set --name

Required Parameters

--name --subscription -n -s

Name or ID of subscription.

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

Edit

Get the details of a subscription.

If the subscription isn't specified, shows the details of the default subscription.

az account show [--name]

Optional Parameters

--name --subscription -n -s

Name or ID of subscription.

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 account

Commands

az account accept-ownership-status

Required Parameters

az account clear

az account create

Required Parameters

Optional Parameters

az account get-access-token

Examples

Optional Parameters

az account list

Optional Parameters

az account list-locations

az account set

Required Parameters

az account show

Optional Parameters

Feedback

Additional resources