你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Billing Profiles - Update

Service:

Billing

API Version:

2019-10-01-preview

汇报计费配置文件的属性。 目前，可以更新 displayName、poNumber、帐单地址和 invoiceEmailOptIn。 协议类型为 Microsoft 客户协议 或 Microsoft 合作伙伴协议 的计费帐户支持此操作。

PATCH https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}?api-version=2019-10-01-preview

URI 参数

名称	在	必需	类型	说明
billingAccountName	path	True	string	唯一标识计费帐户的 ID。
billingProfileName	path	True	string	唯一标识计费配置文件的 ID。
api-version	query	True	string	要与客户端请求一起使用的 API 版本。 当前版本为 2019-10-01-preview。

请求正文

名称	类型	说明
properties.address	AddressDetails	帐单邮寄地址。
properties.displayName	string	计费配置文件的名称。
properties.enabledAzurePlans	AzurePlan[]	有关已启用的 Azure 计划的信息。
properties.invoiceEmailOptIn	boolean	控制是否通过电子邮件发送计费对象信息的发票的标志。
properties.invoiceSections	InvoiceSection[]	与计费对象信息关联的发票科目。
properties.poNumber	string	将为计费对象信息生成的发票上显示的采购订单名称。

响应

名称	类型	说明
200 OK	BillingProfile	没问题。 请求已成功。
202 Accepted		已接受。 计费对象信息更新正在进行中。 Headers Location: string Retry-After: string
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

UpdateBillingProfile

Sample Request

HTTP

PATCH https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}?api-version=2019-10-01-preview

{
  "properties": {
    "displayName": "BillingProfile11",
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345"
  }
}

Sample Response

Status code:

202

Location: /providers/Microsoft.Billing/billingOperations/ed2975a8-8f77-43bb-a717-ace54326b14b?api-version=2018-05-31-preview
Retry-After: 60

Status code:

200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}",
  "name": "{billingProfileName}",
  "type": "Microsoft.Billing/billingAccounts/billingProfiles",
  "properties": {
    "displayName": "BillingProfile11",
    "address": {
      "companyName": "Contoso",
      "firstName": "Test",
      "lastName": "User",
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "postalCode": "00000",
      "region": "WA",
      "country": "US"
    },
    "currency": "USD",
    "enabledAzurePlans": [
      {
        "skuId": "0001",
        "skuDescription": "Microsoft Azure Dev/Test"
      },
      {
        "skuId": "0002",
        "skuDescription": "Microsoft Azure Standard"
      }
    ],
    "invoiceDay": 5,
    "invoiceEmailOptIn": true,
    "poNumber": "ABC12345",
    "status": "Active",
    "spendingLimit": "Off"
  }
}

定义

名称	说明
AddressDetails	地址详细信息。
AzurePlan	Azure 计划的详细信息。
BillingProfile	计费配置文件。
BillingProfileStatus	计费配置文件的状态。
BillingRelationshipType	标识计费对象信息支付哪些服务和购买。
ErrorDetails	错误的详细信息。
ErrorResponse	错误响应指示服务无法处理传入请求。 错误消息中提供了原因。
ErrorSubDetails
IndirectRelationshipInfo	间接动作的客户合作伙伴的计费配置文件详细信息。
InvoiceSection	发票科目。
InvoiceSectionState	标识发票科目的状态。
SpendingLimit	计费对象信息支出限制。
StatusReasonCode	指定计费配置文件状态的原因。
targetCloud	标识与发票科目关联的云环境。 这是一个系统管理的可选字段，当发票科目与各种云中的帐户关联时会更新。

AddressDetails

地址详细信息。

名称	类型	说明
addressLine1	string	地址行 1。
addressLine2	string	地址行 2。
addressLine3	string	地址行 3。
city	string	地址城市。
companyName	string	公司名称。
country	string	国家/地区代码使用 ISO2,2 位格式。
firstName	string	名字。
lastName	string	姓氏。
postalCode	string	邮政编码。
region	string	地址区域。

AzurePlan

Azure 计划的详细信息。

名称	类型	说明
skuDescription	string	SKU 说明。
skuId	string	SKU ID。

BillingProfile

计费配置文件。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.address	AddressDetails	帐单邮寄地址。
properties.billingRelationshipType	BillingRelationshipType	标识计费对象信息支付哪些服务和购买。
properties.currency	string	计费对象信息计费的货币。
properties.displayName	string	计费配置文件的名称。
properties.enabledAzurePlans	AzurePlan[]	有关已启用的 Azure 计划的信息。
properties.indirectRelationshipInfo	IndirectRelationshipInfo	标识在间接购买动作中链接到另一个计费配置文件的计费配置文件。
properties.invoiceDay	integer	生成计费对象信息的发票的月份日期。
properties.invoiceEmailOptIn	boolean	控制是否通过电子邮件发送计费对象信息的发票的标志。
properties.invoiceSections	InvoiceSection[]	与计费对象信息关联的发票科目。
properties.poNumber	string	将为计费对象信息生成的发票上显示的采购订单名称。
properties.spendingLimit	SpendingLimit	计费对象信息支出限制。
properties.status	BillingProfileStatus	计费配置文件的状态。
properties.statusReasonCode	StatusReasonCode	指定计费配置文件状态的原因。
properties.targetClouds	targetCloud[]	标识与计费配置文件关联的云环境。 这是一个系统管理的可选字段，当计费配置文件与各种云中的帐户关联时会更新。
type	string	资源类型。

BillingProfileStatus

计费配置文件的状态。

名称	类型	说明
Active	string
Disabled	string
Warned	string

BillingRelationshipType

标识计费对象信息支付哪些服务和购买。

名称	类型	说明
CSPPartner	string
Direct	string
IndirectCustomer	string
IndirectPartner	string

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
details	ErrorSubDetails[]	错误的子详细信息。
message	string	指示操作失败原因的错误消息。
target	string	特定错误的目标。

ErrorResponse

错误响应指示服务无法处理传入请求。 错误消息中提供了原因。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

ErrorSubDetails

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败原因的错误消息。
target	string	特定错误的目标。

IndirectRelationshipInfo

间接动作的客户合作伙伴的计费配置文件详细信息。

名称	类型	说明
billingAccountName	string	间接移动的合作伙伴或客户的计费帐户名称。
billingProfileName	string	间接移动的合作伙伴或客户的计费配置文件名称。
displayName	string	间接动作的合作伙伴或客户的显示名称。

InvoiceSection

发票科目。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.displayName	string	发票科目的名称。
properties.state	InvoiceSectionState	标识发票科目的状态。
properties.targetCloud	targetCloud	标识与发票科目关联的云环境。 这是一个系统管理的可选字段，当发票科目与各种云中的帐户关联时会更新。
type	string	资源类型。

InvoiceSectionState

标识发票科目的状态。

名称	类型	说明
Active	string
Restricted	string

SpendingLimit

计费对象信息支出限制。

名称	类型	说明
Off	string
On	string

StatusReasonCode

指定计费配置文件状态的原因。

名称	类型	说明
PastDue	string
SpendingLimitExpired	string
SpendingLimitReached	string

targetCloud

标识与发票科目关联的云环境。 这是一个系统管理的可选字段，当发票科目与各种云中的帐户关联时会更新。

名称	类型	说明
USGov	string
USNat	string
USSec	string