Share via

az account subscription

  • Experimental

Note

This reference is part of the account extension for the Azure CLI (version 2.38.0 or higher). The extension will automatically install the first time you run an az account subscription command. Learn more about extensions.

This command group is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage subscriptions.

Commands

Name Description Type Status
az account subscription cancel

Cancel subscription.

 Extension Experimental
az account subscription enable

Enable subscription.

 Extension Experimental
az account subscription list

Get all subscriptions for a tenant.

 Extension Experimental
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.

 Extension Experimental
az account subscription rename

Rename subscription.

 Extension Experimental
az account subscription show

Get details about a specified subscription.

 Extension Experimental

az account subscription cancel

Experimental

Command group 'account subscription' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Cancel subscription.

az account subscription cancel --id --subscription-id
                               [--yes]

Examples

Cancel subscription

az account subscription cancel --subscription-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Required Parameters

--id --subscription-id

Subscription Id.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--yes -y

Do not prompt for confirmation.

Property Value
Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az account subscription enable

Experimental

Command group 'account subscription' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Enable subscription.

az account subscription enable --id --subscription-id

Examples

Enable subscription

az account subscription enable --subscription-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Required Parameters

--id --subscription-id

Subscription Id.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az account subscription list

Experimental

Command group 'account subscription' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get all subscriptions for a tenant.

az account subscription list

Examples

listSubscriptions

az account subscription list
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az account subscription list-location

Experimental

Command group 'account subscription' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

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 list-location --id --subscription-id

Examples

listLocations

az account subscription list-location --subscription-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Required Parameters

--id --subscription-id

The ID of the target subscription.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az account subscription rename

Experimental

Command group 'account subscription' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Rename subscription.

az account subscription rename --id --subscription-id
                               [--name --subscription-name]

Examples

Rename subscription

az account subscription rename --subscription-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Required Parameters

--id --subscription-id

Subscription Id.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name --subscription-name -n

New subscription name.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False

az account subscription show

Experimental

Command group 'account subscription' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get details about a specified subscription.

az account subscription show --id --subscription-id

Examples

getSubscription

az account subscription show --subscription-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Required Parameters

--id --subscription-id

The ID of the target subscription.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Property Value
Default value: False