Share via


az billing account

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

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

--expand

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

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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 billing account list-invoice-section

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

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

--next-token

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

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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 billing account show

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

--expand

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

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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 billing account update

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

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

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.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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 billing account wait

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

--created

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

Default value: False
--custom

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

--deleted

Wait until deleted.

Default value: False
--exists

Wait until the resource exists.

Default value: False
--expand

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

--interval

Polling interval in seconds.

Default value: 30
--timeout

Maximum wait in seconds.

Default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.

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.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.