Zdieľať cez

az billing profile

  • Preview

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

Manage profile.

Commands

Name Description Type Status
az billing profile create

Creates or updates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

 Core Preview
az billing profile list

List the billing profiles that a user has access to. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

 Core Preview
az billing profile reservation

Manage profile reservation.

 Core Preview
az billing profile reservation list

List the reservations for a billing profile and the roll up counts of reservations group by provisioning state.

 Core Preview
az billing profile show

Get a billing profile by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

 Core Preview
az billing profile update

Creates or updates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

 Core Preview
az billing profile wait

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

 Core Preview

az billing profile create

Edit
Preview

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

Creates or updates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

az billing profile create --account-name
                          --name
                          [--bill-to]
                          [--display-name]
                          [--enabled-azure-plans]
                          [--invoice-email-opt-in {false, true}]
                          [--invoice-sections-value]
                          [--no-wait]
                          [--po-number]

Examples

Create a billing profile

az billing profile create --account-name "{billingAccountName}" --name "{billingProfileName}" --bill-to address-line1="Test Address 1" city="Redmond" country="US" first-name="Test" last-name="User" postal-code="12345" region="WA" --display-name "Finance" --enabled-azure-plans sku-id="0001" --enabled-azure-plans sku-id="0002" --invoice-email-opt-in true --po-number "ABC12345"

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--name -n

The ID that uniquely identifies a billing profile.

Optional Parameters

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

--bill-to

Billing address.

Usage: --bill-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.

--display-name

The name of the billing profile.

--enabled-azure-plans

Information about the enabled azure plans.

Usage: --enabled-azure-plans sku-id=XX sku-id: The sku id. Multiple actions can be specified by using more than one --enabled-azure-plans argument.

--invoice-email-opt-in

Flag controlling whether the invoices for the billing profile are sent through email.

Property Value
Accepted values: false, true
--invoice-sections-value

The invoice sections associated to the billing profile. Expected value: json-string/@json-file.

--no-wait

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

Property Value
Default value: False
--po-number

The purchase order name that will appear on the invoices generated for the billing profile.

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

Edit
Preview

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

List the billing profiles that a user has access to. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

az billing profile list --account-name
                        [--expand]

Examples

List billing profiles with default properties

az billing profile list --account-name "{billingAccountName}"

List billing profiles with desired expanded properties

az billing profile list --expand "invoiceSections" --account-name "{billingAccountName}"

Required Parameters

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

--expand

May be used to expand the invoice sections.

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

Edit
Preview

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

Get a billing profile by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

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

Examples

Show a billing profile with default properties

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

Show a billing profile with expaned properties

az billing profile show --expand "invoiceSections" --account-name "{billingAccountName}" --name "{billingProfileName}"

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--name -n

The ID that uniquely identifies a billing profile.

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

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 profile update

Edit
Preview

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

Creates or updates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner Agreement.

az billing profile update --account-name
                          --name
                          [--bill-to]
                          [--display-name]
                          [--enabled-azure-plans]
                          [--invoice-email-opt-in {false, true}]
                          [--invoice-sections-value]
                          [--no-wait]
                          [--po-number]

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--name -n

The ID that uniquely identifies a billing profile.

Optional Parameters

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

--bill-to

Billing address.

Usage: --bill-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.

--display-name

The name of the billing profile.

--enabled-azure-plans

Information about the enabled azure plans.

Usage: --enabled-azure-plans sku-id=XX sku-id: The sku id. Multiple actions can be specified by using more than one --enabled-azure-plans argument.

--invoice-email-opt-in

Flag controlling whether the invoices for the billing profile are sent through email.

Property Value
Accepted values: false, true
--invoice-sections-value

The invoice sections associated to the billing profile. Expected value: json-string/@json-file.

--no-wait

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

Property Value
Default value: False
--po-number

The purchase order name that will appear on the invoices generated for the billing profile.

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 profile wait

Edit
Preview

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

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

Examples

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

az billing profile wait --expand "invoiceSections" --account-name "{billingAccountName}" --name "{billingProfileName}" --created

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

az billing profile wait --expand "invoiceSections" --account-name "{billingAccountName}" --name "{billingProfileName}" --updated

Required Parameters

--account-name

The ID that uniquely identifies a billing account.

--name -n

The ID that uniquely identifies a billing profile.

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

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