Share via


az billing invoice section

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

Manage invoice section.

Commands

Name Description Type Status
az billing invoice section create

Creates or updates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

Core Preview
az billing invoice section initiate-transfer

Sends a request to a user in another billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

Core Preview
az billing invoice section list

List the invoice sections that a user has access to. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

Core Preview
az billing invoice section show

Get an invoice section by its ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

Core Preview
az billing invoice section update

Creates or updates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

Core Preview
az billing invoice section wait

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

Core Preview

az billing invoice section create

Preview

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

Creates or updates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing invoice section create --account-name
                                  --invoice-section-name
                                  --profile-name
                                  [--display-name]
                                  [--labels]
                                  [--no-wait]

Examples

Create an invoice section

az billing invoice section create --account-name "{billingAccountName}" --profile-name "{billingProfileName}" --name "{invoiceSectionName}" --display-name "invoiceSection1" --labels costCategory="Support" pcCode="A123456"

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--invoice-section-name --name -n

The ID that uniquely identifies an invoice section.

--profile-name

The ID that uniquely identifies a billing profile.

Optional Parameters

--display-name

The name of the invoice section.

--labels

Dictionary of metadata associated with the invoice section. Expect value: KEY1=VALUE1 KEY2=VALUE2 ...

--no-wait

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

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.

az billing invoice section initiate-transfer

Preview

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

Sends a request to a user in another billing account to transfer billing ownership of their subscriptions. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing invoice section initiate-transfer --billing-account-name
                                             --billing-profile-name
                                             --invoice-section-name
                                             [--recipient-email-id]
                                             [--reseller-id]

Required Parameters

--billing-account-name

The ID that uniquely identifies a billing account.

--billing-profile-name

The ID that uniquely identifies a billing profile.

--invoice-section-name

The ID that uniquely identifies an invoice section.

Optional Parameters

--recipient-email-id

The email ID of the recipient to whom the transfer request is sent.

--reseller-id

Optional MPN ID of the reseller for transfer requests that are sent from a Microsoft Partner Agreement billing 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.

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 invoice section list

Preview

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

List the invoice sections that a user has access to. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing invoice section list --account-name
                                --profile-name

Examples

List invoice sections by billing account and billing profile

az billing invoice section list --account-name "{billingAccountName}" --profile-name "{billingProfileName}"

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--profile-name

The ID that uniquely identifies a billing profile.

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 invoice section show

Preview

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

Get an invoice section by its ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing invoice section show --account-name
                                --invoice-section-name
                                --profile-name

Examples

Show an invoice section

az billing invoice section show --account-name "{billingAccountName}" --profile-name "{billingProfileName}" --name "{invoiceSectionName}"

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--invoice-section-name --name -n

The ID that uniquely identifies an invoice section.

--profile-name

The ID that uniquely identifies a billing profile.

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 invoice section update

Preview

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

Creates or updates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

az billing invoice section update --account-name
                                  --invoice-section-name
                                  --profile-name
                                  [--display-name]
                                  [--labels]
                                  [--no-wait]

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--invoice-section-name --name -n

The ID that uniquely identifies an invoice section.

--profile-name

The ID that uniquely identifies a billing profile.

Optional Parameters

--display-name

The name of the invoice section.

--labels

Dictionary of metadata associated with the invoice section. Expect value: KEY1=VALUE1 KEY2=VALUE2 ...

--no-wait

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

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.

az billing invoice section wait

Preview

Command group 'billing invoice section' 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 invoice section is met.

az billing invoice section wait --account-name
                                --invoice-section-name
                                --profile-name
                                [--created]
                                [--custom]
                                [--deleted]
                                [--exists]
                                [--interval]
                                [--timeout]
                                [--updated]

Examples

Pause executing next line of CLI script until the billing invoice section is successfully created.

az billing invoice section wait --account-name "{billingAccountName}" --profile-name "{billingProfileName}" --name "{invoiceSectionName}" --created

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

az billing invoice section wait --account-name "{billingAccountName}" --profile-name "{billingProfileName}" --name "{invoiceSectionName}" --updated

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--invoice-section-name --name -n

The ID that uniquely identifies an invoice section.

--profile-name

The ID that uniquely identifies a billing profile.

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