az billing account

Preview

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

Billing account.

Commands

Name	Description	Type	Status
az billing account invoice-section	Manage account invoice section.	Core	Preview
az billing account invoice-section list	List all invoice sections for which a user has access.	Core	Preview
az billing account invoice-section show	Get the InvoiceSection by id.	Core	Preview
az billing account list	List the billing accounts that a user has access to.	Core	Preview
az billing account list-invoice-section	List the invoice sections for which the user has permission to create Azure subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.	Core	Preview
az billing account reservation	Manage account reservation.	Core	Preview
az billing account reservation list	List the reservations for a billing account and the roll up counts of reservations group by provisioning states.	Core	Preview
az billing account show	Get a billing account by its ID.	Core	Preview
az billing account transaction	Manage billing acount transaction.	Core	Preview
az billing account transaction list	List the billed and unbilled transactions by billing account name for given start and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice ID and do not include tax. Tax is added to the amount once an invoice is generated.	Core	Preview
az billing account update	Update the properties of a billing account. Currently, displayName and address can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.	Core	Preview
az billing account wait	Place the CLI in a waiting state until a condition of the billing account is met.	Core	Preview

az billing account list

Edit

Preview

Command group 'billing account' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List the billing accounts that a user has access to.

az billing account list [--expand]

Examples

List billing accounts

az billing account list

List billing account with desired expanded arguments

az billing account list --expand "soldTo,billingProfiles,billingProfiles/invoiceSections"

List billing account with desired expanded arguments

az billing account list --expand "enrollmentDetails,departments,enrollmentAccounts"

Optional Parameters

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

--expand

May be used to expand the soldTo, invoice sections and billing profiles.

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.

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

Property	Value
Default value:	False

az billing account list-invoice-section

Edit

Preview

Command group 'billing account' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List the invoice sections for which the user has permission to create Azure subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing account list-invoice-section --billing-account-name
                                        [--max-items]
                                        [--next-token]

Required Parameters

--billing-account-name

The ID that uniquely identifies a billing account.

Optional Parameters

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

--max-items

Total number of items to return in the command's output. If the total number of items available is more than the value specified, a token is provided in the command's output. To resume pagination, provide the token value in --next-token argument of a subsequent command.

Property	Value
Parameter group:	Pagination Arguments

--next-token

Token to specify where to start paginating. This is the token value from a previously truncated response.

Property	Value
Parameter group:	Pagination Arguments

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.

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

Property	Value
Default value:	False

az billing account show

Edit

Preview

Command group 'billing account' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get a billing account by its ID.

az billing account show --name
                        [--expand]

Examples

Show an billing acount with expanded properties

az billing account show --expand "soldTo,billingProfiles,billingProfiles/invoiceSections" --name "{billingAccountName}"

Show an billing acount with default properties

az billing account show --name "{billingAccountName}"

Required Parameters

--name -n

The ID that uniquely identifies a billing account.

Optional Parameters

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

--expand

May be used to expand the soldTo, invoice sections and billing profiles.

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.

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

Property	Value
Default value:	False

az billing account update

Edit

Preview

Command group 'billing account' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Update the properties of a billing account. Currently, displayName and address can be updated. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing account update --name
                          [--billing-profiles-value]
                          [--departments]
                          [--display-name]
                          [--enrollment-accounts]
                          [--no-wait]
                          [--sold-to]

Examples

Update a billing account

az billing account update --name "{billingAccountName}" --display-name "Test Account" --sold-to address-line1="Test Address 1" city="Redmond" company-name="Contoso" country="US" first-name="Test" last-name="User" postal-code="12345" region="WA"

Required Parameters

--name -n

The ID that uniquely identifies a billing account.

Optional Parameters

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

--billing-profiles-value

The billing profiles associated with the billing account. Expected value: json-string/@json-file.

--departments

The departments associated to the enrollment. Expected value: json-string/@json-file.

--display-name

The billing account name.

--enrollment-accounts

The accounts associated to the enrollment. Expected value: json-string/@json-file.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--sold-to

The address of the individual or organization that is responsible for the billing account.

Usage: --sold-to first-name=XX last-name=XX company-name=XX address-line1=XX address-line2=XX address-line3=XX city=XX district=XX region=XX country=XX postal-code=XX email=XX phone-number=XX.

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.

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

Property	Value
Default value:	False

az billing account wait

Edit

Preview

Command group 'billing account' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Place the CLI in a waiting state until a condition of the billing account is met.

az billing account wait --name
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--expand]
                        [--interval]
                        [--timeout]
                        [--updated]

Examples

Pause executing next line of CLI script until the billing account is successfully updated.

az billing account wait --name "{billingAccountName}" --updated

Required Parameters

--name -n

The ID that uniquely identifies a billing account.

Optional Parameters

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

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Property	Value
Parameter group:	Wait Condition Arguments

--deleted

Wait until deleted.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wait until the resource exists.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--expand

May be used to expand the soldTo, invoice sections and billing profiles.

--interval

Polling interval in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	30

--timeout

Maximum wait in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
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.

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

Property	Value
Default value:	False

Share via

az billing account

Commands

az billing account list

Examples

Optional Parameters

az billing account list-invoice-section

Required Parameters

Optional Parameters

az billing account show

Examples

Required Parameters

Optional Parameters

az billing account update

Examples

Required Parameters

Optional Parameters

az billing account wait

Examples

Required Parameters

Optional Parameters

Feedback