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

Billing Profiles - Get

按其 ID 获取计费配置文件。 协议类型Microsoft客户协议和Microsoft合作伙伴协议的计费帐户支持此操作。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}?api-version=2024-04-01

URI 参数

名称 必需 类型 说明
billingAccountName
path True

string

唯一标识计费帐户的 ID。

正则表达式模式: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

billingProfileName
path True

string

唯一标识计费配置文件的 ID。

正则表达式模式: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

要用于客户端请求的 API 的版本。 当前版本为 2024-04-01。

响应

名称 类型 说明
200 OK

BillingProfile

计费配置文件。

Other Status Codes

ErrorResponse

描述操作失败的原因的错误响应。

示例

BillingProfilesGet

示例请求

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx?api-version=2024-04-01

示例响应

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
  "name": "xxxx-xxxx-xxx-xxx",
  "properties": {
    "billTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "currency": "USD",
    "displayName": "Billing Profile 1",
    "hasReadAccess": true,
    "invoiceDay": 5,
    "invoiceEmailOptIn": true,
    "invoiceRecipients": [
      "abc@contoso.com",
      "xyz@contoso.com"
    ],
    "poNumber": "ABC12345",
    "shipTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "soldTo": {
      "addressLine1": "Test Address1",
      "addressLine2": "Test Address2",
      "addressLine3": "Test Address3",
      "city": "City",
      "companyName": "Contoso",
      "country": "US",
      "email": "abc@contoso.com",
      "firstName": "Test",
      "lastName": "User",
      "phoneNumber": "000-000-0000",
      "postalCode": "00000",
      "region": "WA",
      "isValidAddress": true
    },
    "spendingLimit": "On",
    "spendingLimitDetails": [
      {
        "amount": 200,
        "currency": "USD",
        "startDate": "2018-01-01T00:00:00.0000000Z",
        "endDate": "2019-01-01T00:00:00.0000000Z",
        "type": "FreeAccount",
        "status": "Active"
      }
    ],
    "status": "Warned",
    "statusReasonCode": "PastDue",
    "systemId": "11111111-1111-1111-1111-111111111111"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles"
}

定义

名称 说明
AzurePlan

Azure 计划的详细信息。

BillingProfile

计费配置文件。

BillingProfileProperties

计费配置文件。

BillingProfileStatus

计费配置文件的状态。

BillingProfileStatusReasonCode

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

BillingRelationshipType

标识由计费配置文件表示的计费关系。 计费关系可能介于Microsoft、客户和第三方之间。

BillTo

帐单地址。

createdByType

创建资源的标识的类型。

CurrentPaymentTerm

计费配置文件的当前付款期限。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

IndirectRelationshipInfo

标识与间接购买运动中的另一个计费配置文件关联的计费配置文件。

PaymentTerm

付款期限的属性。

ProvisioningState

长时间运行的操作期间资源的预配状态。

ShipTo

产品寄送位置的默认地址,或者正在使用服务。 如果未为产品或订阅指定发货,则将使用此地址。

SoldTo

负责计费帐户的个人或组织的地址。

SpendingLimit

计费配置文件支出限制。

SpendingLimitDetails

计费配置文件支出限制。

SpendingLimitStatus

当前支出限制的状态。

SpendingLimitType

支出限制的类型。

systemData

与创建和上次修改资源相关的元数据。

TargetCloud

标识与计费配置文件关联的云环境。 这是一个系统托管的可选字段,在计费配置文件与各种云中的帐户关联时更新。

AzurePlan

Azure 计划的详细信息。

名称 类型 说明
productId

string

唯一标识产品的 ID。

skuDescription

string

SKU 说明。

skuId

string

唯一标识 SKU 的 ID。

BillingProfile

计费配置文件。

名称 类型 说明
id

string

资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

资源的名称

properties

BillingProfileProperties

计费配置文件。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

tags

object

与资源关联的元数据字典。 它可能不会针对所有资源类型进行填充。 支持的最大键/值长度为 256 个字符。 键/值不应为空值,也不应为 null。 键不能包含 <> % & \ ? /

type

string

资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

BillingProfileProperties

计费配置文件。

名称 类型 说明
billTo

BillTo

帐单地址。

billingRelationshipType

BillingRelationshipType

标识由计费配置文件表示的计费关系。 计费关系可能介于Microsoft、客户和第三方之间。

currency

string

计费配置文件费用的货币。

currentPaymentTerm

CurrentPaymentTerm

计费配置文件的当前付款期限。

displayName

string

计费配置文件的名称。

enabledAzurePlans

AzurePlan[]

有关已启用的 Azure 计划的信息。

hasReadAccess

boolean

指示用户是否具有对计费配置文件的读取访问权限。

indirectRelationshipInfo

IndirectRelationshipInfo

标识与间接购买运动中的另一个计费配置文件关联的计费配置文件。

invoiceDay

integer

生成计费配置文件发票的月份日期。

invoiceEmailOptIn

boolean

用于控制是否通过电子邮件发送计费配置文件发票的标志。

invoiceRecipients

string[]

要通过电子邮件接收计费配置文件发票的电子邮件地址列表。

otherPaymentTerms

PaymentTerm[]

计费配置文件的其他付款条款。

poNumber

string

将在为计费配置文件生成的发票上显示的默认采购订单编号。

provisioningState

ProvisioningState

长时间运行的操作期间资源的预配状态。

shipTo

ShipTo

产品寄送位置的默认地址,或者正在使用服务。 如果未为产品或订阅指定发货,则将使用此地址。

soldTo

SoldTo

负责计费帐户的个人或组织的地址。

spendingLimit

SpendingLimit

计费配置文件支出限制。

spendingLimitDetails

SpendingLimitDetails[]

计费配置文件支出限制的详细信息。

status

BillingProfileStatus

计费配置文件的状态。

statusReasonCode

BillingProfileStatusReasonCode

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

systemId

string

系统为计费配置文件生成了唯一标识符。

tags

object

与资源关联的元数据字典。 支持的最大键/值长度为 256 个字符。 键/值不应为空值,也不应为 null。 键不能包含 <> % & \ ? /

targetClouds

TargetCloud[]

标识与计费配置文件关联的云环境。 这是一个系统托管的可选字段,在计费配置文件与各种云中的帐户关联时更新。

BillingProfileStatus

计费配置文件的状态。

名称 类型 说明
Active

string

Deleted

string

Disabled

string

Other

string

UnderReview

string

Warned

string

BillingProfileStatusReasonCode

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

名称 类型 说明
Other

string

PastDue

string

SpendingLimitExpired

string

SpendingLimitReached

string

UnusualActivity

string

BillingRelationshipType

标识由计费配置文件表示的计费关系。 计费关系可能介于Microsoft、客户和第三方之间。

名称 类型 说明
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

BillTo

帐单地址。

名称 类型 说明
addressLine1

string

地址行 1。

addressLine2

string

地址行 2。

addressLine3

string

地址行 3。

city

string

地址城市。

companyName

string

公司名称。 MCA 个人版(即用即付)可选。

country

string

国家/地区代码使用 ISO 3166-1 Alpha-2 格式。

district

string

地址区域。

email

string

电子邮件地址。

firstName

string

名字。 MCA Enterprise 可选。

isValidAddress

boolean

指示地址是否不完整。

lastName

string

姓。 MCA Enterprise 可选。

middleName

string

中间名称。

phoneNumber

string

电话号码。

postalCode

string

邮政编码。

region

string

地址区域。

createdByType

创建资源的标识的类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

CurrentPaymentTerm

计费配置文件的当前付款期限。

名称 类型 说明
endDate

string

定义的“付款期限”将结束且始终采用 UTC 的日期。

isDefault

boolean

指示付款期限是标准付款期限。

startDate

string

定义的“付款期限”生效的日期,并且始终采用 UTC 格式。

term

string

表示 netXX 格式的持续时间。 始终以天为单位。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

IndirectRelationshipInfo

标识与间接购买运动中的另一个计费配置文件关联的计费配置文件。

名称 类型 说明
billingAccountName

string

用于间接运动的合作伙伴或客户的计费帐户名称。

billingProfileName

string

合作伙伴或客户的计费配置文件名称,用于间接动议。

displayName

string

间接运动的合作伙伴或客户的显示名称。

PaymentTerm

付款期限的属性。

名称 类型 说明
endDate

string

定义的“付款期限”将结束且始终采用 UTC 的日期。

isDefault

boolean

指示付款期限是标准付款期限。

startDate

string

定义的“付款期限”生效的日期,并且始终采用 UTC 格式。

term

string

表示 netXX 格式的持续时间。 始终以天为单位。

ProvisioningState

长时间运行的操作期间资源的预配状态。

名称 类型 说明
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

ShipTo

产品寄送位置的默认地址,或者正在使用服务。 如果未为产品或订阅指定发货,则将使用此地址。

名称 类型 说明
addressLine1

string

地址行 1。

addressLine2

string

地址行 2。

addressLine3

string

地址行 3。

city

string

地址城市。

companyName

string

公司名称。 MCA 个人版(即用即付)可选。

country

string

国家/地区代码使用 ISO 3166-1 Alpha-2 格式。

district

string

地址区域。

email

string

电子邮件地址。

firstName

string

名字。 MCA Enterprise 可选。

isValidAddress

boolean

指示地址是否不完整。

lastName

string

姓。 MCA Enterprise 可选。

middleName

string

中间名称。

phoneNumber

string

电话号码。

postalCode

string

邮政编码。

region

string

地址区域。

SoldTo

负责计费帐户的个人或组织的地址。

名称 类型 说明
addressLine1

string

地址行 1。

addressLine2

string

地址行 2。

addressLine3

string

地址行 3。

city

string

地址城市。

companyName

string

公司名称。 MCA 个人版(即用即付)可选。

country

string

国家/地区代码使用 ISO 3166-1 Alpha-2 格式。

district

string

地址区域。

email

string

电子邮件地址。

firstName

string

名字。 MCA Enterprise 可选。

isValidAddress

boolean

指示地址是否不完整。

lastName

string

姓。 MCA Enterprise 可选。

middleName

string

中间名称。

phoneNumber

string

电话号码。

postalCode

string

邮政编码。

region

string

地址区域。

SpendingLimit

计费配置文件支出限制。

名称 类型 说明
Off

string

On

string

SpendingLimitDetails

计费配置文件支出限制。

名称 类型 说明
amount

number

计费配置文件的初始金额。

currency

string

计费配置文件费用的货币。

endDate

string

此支出限制不再生效的日期。

startDate

string

此支出限制生效的日期。

status

SpendingLimitStatus

当前支出限制的状态。

type

SpendingLimitType

支出限制的类型。

SpendingLimitStatus

当前支出限制的状态。

名称 类型 说明
Active

string

Expired

string

LimitReached

string

LimitRemoved

string

None

string

Other

string

SpendingLimitType

支出限制的类型。

名称 类型 说明
AcademicSponsorship

string

AzureConsumptionCredit

string

AzureForStudents

string

AzureForStudentsStarter

string

AzurePassSponsorship

string

FreeAccount

string

MSDN

string

MpnSponsorship

string

NonProfitSponsorship

string

None

string

Other

string

Sandbox

string

Sponsorship

string

StartupSponsorship

string

VisualStudio

string

systemData

与创建和上次修改资源相关的元数据。

名称 类型 说明
createdAt

string

资源创建时间戳(UTC)。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识的类型。

lastModifiedAt

string

上次修改的资源时间戳(UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识的类型。

TargetCloud

标识与计费配置文件关联的云环境。 这是一个系统托管的可选字段,在计费配置文件与各种云中的帐户关联时更新。

名称 类型 说明
Internal

string

Other

string

USGov

string

USNat

string

USSec

string