你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Billing Profiles - List By Billing Account
列出用户有权访问的计费配置文件。 协议类型为 Microsoft 客户协议 或 Microsoft 合作伙伴协议 的计费帐户支持此操作。
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles?api-version=2020-05-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles?api-version=2020-05-01&$expand={$expand}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
billing
|
path | True |
string |
唯一标识计费帐户的 ID。 |
api-version
|
query | True |
string |
要与客户端请求一起使用的 API 版本。 当前版本为 2020-05-01。 |
$expand
|
query |
string |
可用于展开发票科目。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
没问题。 请求已成功。 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Billing |
Billing |
BillingProfilesListByBillingAccount
Sample Request
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles?api-version=2020-05-01
Sample Response
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
"name": "11000000-0000-0000-0000-000000000000",
"type": "Microsoft.Billing/billingAccounts/billingProfiles",
"properties": {
"displayName": "BillingProfile1",
"billingRelationshipType": "Direct",
"billTo": {
"companyName": "Contoso",
"firstName": "Test",
"lastName": "User",
"addressLine1": "Test Address1",
"addressLine2": "Test Address2",
"addressLine3": "Test Address3",
"city": "City",
"postalCode": "00000",
"region": "WA",
"country": "US",
"email": "abc@contoso.com",
"phoneNumber": "000-000-0000"
},
"currency": "USD",
"enabledAzurePlans": [
{
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
},
{
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}
],
"invoiceDay": 5,
"invoiceEmailOptIn": true,
"poNumber": "ABC12345",
"hasReadAccess": true,
"systemId": "1XXX-11XX-XX1-XXXX-XXX",
"status": "Warned",
"statusReasonCode": "PastDue",
"spendingLimit": "On"
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000001",
"name": "11000000-0000-0000-0000-000000000001",
"type": "Microsoft.Billing/billingAccounts/billingProfiles",
"properties": {
"displayName": "BillingProfile2",
"billingRelationshipType": "IndirectCustomer",
"billTo": {
"companyName": "Contoso",
"firstName": "Test",
"lastName": "User",
"addressLine1": "Test Address1",
"addressLine2": "Test Address2",
"addressLine3": "Test Address3",
"city": "City",
"postalCode": "00000",
"region": "WA",
"country": "US",
"email": "abc@contoso.com",
"phoneNumber": "000-000-0000"
},
"currency": "USD",
"enabledAzurePlans": [
{
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
},
{
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}
],
"indirectRelationshipInfo": {
"billingAccountName": "30000000-0000-0000-0000-000000000001_00000000-0000-0000-0000-000000000000",
"billingProfileName": "33000000-0000-0000-0000-000000000001",
"displayName": "Partner1"
},
"invoiceDay": 5,
"invoiceEmailOptIn": true,
"poNumber": "ABC12345",
"hasReadAccess": true,
"systemId": "2XXX-22XX-XX1-XXXX-XXX",
"status": "Active",
"spendingLimit": "Off",
"targetClouds": []
}
}
]
}
BillingProfilesListWithExpand
Sample Request
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles?api-version=2020-05-01&$expand=invoiceSections
Sample Response
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
"name": "11000000-0000-0000-0000-000000000000",
"type": "Microsoft.Billing/billingAccounts/billingProfiles",
"properties": {
"displayName": "BillingProfile1",
"billingRelationshipType": "Direct",
"billTo": {
"companyName": "Contoso",
"firstName": "Test",
"lastName": "User",
"addressLine1": "Test Address1",
"addressLine2": "Test Address2",
"addressLine3": "Test Address3",
"city": "City",
"postalCode": "00000",
"region": "WA",
"country": "US",
"email": "abc@contoso.com",
"phoneNumber": "000-000-0000"
},
"currency": "USD",
"enabledAzurePlans": [
{
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
},
{
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}
],
"invoiceDay": 5,
"invoiceEmailOptIn": true,
"poNumber": "ABC12345",
"hasReadAccess": true,
"systemId": "1XXX-11XX-XX1-XXXX-XXX",
"status": "Warned",
"statusReasonCode": "PastDue",
"spendingLimit": "On",
"targetClouds": [],
"invoiceSections": {
"hasMoreResults": false,
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000/invoiceSections/invoiceSectionId1",
"name": "invoiceSectionId1",
"type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections",
"properties": {
"displayName": "invoiceSectionName1",
"labels": {
"pcCode": "A123456",
"costCategory": "Support"
},
"state": "Active",
"systemId": "9XXX-11XX-XX1-XXXX-XXX"
}
}
]
}
}
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000001",
"name": "11000000-0000-0000-0000-000000000001",
"type": "Microsoft.Billing/billingAccounts/billingProfiles",
"properties": {
"displayName": "BillingProfile2",
"billingRelationshipType": "IndirectCustomer",
"billTo": {
"companyName": "Contoso",
"firstName": "Test",
"lastName": "User",
"addressLine1": "Test Address1",
"addressLine2": "Test Address2",
"addressLine3": "Test Address3",
"city": "City",
"postalCode": "00000",
"region": "WA",
"country": "US",
"email": "abc@contoso.com",
"phoneNumber": "000-000-0000"
},
"currency": "USD",
"enabledAzurePlans": [
{
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan"
},
{
"skuId": "0002",
"skuDescription": "Microsoft Azure Plan for DevTest"
}
],
"indirectRelationshipInfo": {
"billingAccountName": "30000000-0000-0000-0000-000000000001_00000000-0000-0000-0000-000000000000",
"billingProfileName": "33000000-0000-0000-0000-000000000001",
"displayName": "Partner1"
},
"invoiceDay": 5,
"invoiceEmailOptIn": true,
"poNumber": "ABC12345",
"hasReadAccess": true,
"systemId": "2XXX-22XX-XX1-XXXX-XXX",
"status": "Warned",
"statusReasonCode": "PastDue",
"spendingLimit": "On",
"targetClouds": [],
"invoiceSections": {
"hasMoreResults": false,
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000001/invoiceSections/invoiceSectionId2",
"name": "invoiceSectionId2",
"type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections",
"properties": {
"displayName": "invoiceSectionName2",
"labels": {
"pcCode": "Z223456",
"costCategory": "Marketing"
},
"state": "Active",
"systemId": "9XXX-22XX-XX1-XXXX-XXX"
}
}
]
}
}
}
]
}
定义
名称 | 说明 |
---|---|
Address |
地址详细信息。 |
Azure |
Azure 计划的详细信息。 |
Billing |
计费配置文件。 |
Billing |
计费配置文件列表。 |
Billing |
计费配置文件的状态。 |
Billing |
标识计费对象信息支付哪些服务和购买。 |
Error |
错误的详细信息。 |
Error |
错误响应指示服务无法处理传入请求。 错误消息中提供了原因。 |
Error |
|
Indirect |
间接动作的客户合作伙伴的计费配置文件详细信息。 |
Invoice |
发票科目。 |
Invoice |
与计费对象信息关联的发票科目。 默认情况下,除非在 $expand 中指定,否则不会填充它。 |
Invoice |
标识发票科目的状态。 |
Spending |
计费对象信息支出限制。 |
Status |
指定计费配置文件状态的原因。 |
target |
标识与发票科目关联的云环境。 这是一个系统管理的可选字段,当发票科目与各种云中的帐户关联时会更新。 |
AddressDetails
地址详细信息。
名称 | 类型 | 说明 |
---|---|---|
addressLine1 |
string |
地址行 1。 |
addressLine2 |
string |
地址行 2。 |
addressLine3 |
string |
地址行 3。 |
city |
string |
地址城市。 |
companyName |
string |
公司名称。 |
country |
string |
国家/地区代码使用 ISO2,2 位格式。 |
district |
string |
地址地区。 |
string |
电子邮件地址。 |
|
firstName |
string |
名字。 |
lastName |
string |
姓氏。 |
middleName |
string |
中间名。 |
phoneNumber |
string |
电话号码。 |
postalCode |
string |
邮政编码。 |
region |
string |
地址区域。 |
AzurePlan
Azure 计划的详细信息。
名称 | 类型 | 说明 |
---|---|---|
skuDescription |
string |
SKU 说明。 |
skuId |
string |
SKU ID。 |
BillingProfile
计费配置文件。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID。 |
name |
string |
资源名称。 |
properties.billTo |
帐单邮寄地址。 |
|
properties.billingRelationshipType |
标识计费对象信息支付哪些服务和购买。 |
|
properties.currency |
string |
计费对象信息计费的货币。 |
properties.displayName |
string |
计费配置文件的名称。 |
properties.enabledAzurePlans |
有关已启用的 Azure 计划的信息。 |
|
properties.hasReadAccess |
boolean |
指示用户是否具有对计费配置文件的读取访问权限。 |
properties.indirectRelationshipInfo |
标识在间接购买动作中链接到另一个计费配置文件的计费配置文件。 |
|
properties.invoiceDay |
integer |
生成计费对象信息的发票的月份日期。 |
properties.invoiceEmailOptIn |
boolean |
控制是否通过电子邮件发送计费对象信息的发票的标志。 |
properties.invoiceSections |
与计费对象信息关联的发票科目。 默认情况下,除非在 $expand 中指定,否则不会填充它。 |
|
properties.poNumber |
string |
将为计费对象信息生成的发票上显示的采购订单名称。 |
properties.spendingLimit |
计费对象信息支出限制。 |
|
properties.status |
计费配置文件的状态。 |
|
properties.statusReasonCode |
指定计费配置文件状态的原因。 |
|
properties.systemId |
string |
系统为计费配置文件生成了唯一标识符。 |
properties.tags |
object |
计费配置文件的标记。 |
properties.targetClouds |
标识与计费配置文件关联的云环境。 这是一个系统管理的可选字段,当计费配置文件与各种云中的帐户关联时会更新。 |
|
type |
string |
资源类型。 |
BillingProfileListResult
计费配置文件列表。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
链接 (url) 到结果的下一页。 |
totalCount |
number |
总记录数。 |
value |
计费配置文件列表。 |
BillingProfileStatus
计费配置文件的状态。
名称 | 类型 | 说明 |
---|---|---|
Active |
string |
|
Disabled |
string |
|
Warned |
string |
BillingRelationshipType
标识计费对象信息支付哪些服务和购买。
名称 | 类型 | 说明 |
---|---|---|
CSPPartner |
string |
|
Direct |
string |
|
IndirectCustomer |
string |
|
IndirectPartner |
string |
ErrorDetails
错误的详细信息。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
details |
错误的子详细信息。 |
|
message |
string |
指示操作失败原因的错误消息。 |
target |
string |
特定错误的目标。 |
ErrorResponse
错误响应指示服务无法处理传入请求。 错误消息中提供了原因。
名称 | 类型 | 说明 |
---|---|---|
error |
错误的详细信息。 |
ErrorSubDetails
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码。 |
message |
string |
指示操作失败原因的错误消息。 |
target |
string |
特定错误的目标。 |
IndirectRelationshipInfo
间接动作的客户合作伙伴的计费配置文件详细信息。
名称 | 类型 | 说明 |
---|---|---|
billingAccountName |
string |
间接移动的合作伙伴或客户的计费帐户名称。 |
billingProfileName |
string |
间接移动的合作伙伴或客户的计费配置文件名称。 |
displayName |
string |
间接动作的合作伙伴或客户的显示名称。 |
InvoiceSection
发票科目。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID。 |
name |
string |
资源名称。 |
properties.displayName |
string |
发票科目的名称。 |
properties.labels |
object |
与发票科目关联的元数据字典。 |
properties.state |
标识发票科目的状态。 |
|
properties.systemId |
string |
系统为发票科目生成了唯一标识符。 |
properties.tags |
object |
与发票科目关联的元数据字典。 支持的最大键/值长度为 256 个字符。 键/值不应为空值,也不应为 null。 键不能包含 <> % & \ ? / |
properties.targetCloud |
标识与发票科目关联的云环境。 这是一个系统管理的可选字段,当发票科目与各种云中的帐户关联时会更新。 |
|
type |
string |
资源类型。 |
InvoiceSectionsOnExpand
与计费对象信息关联的发票科目。 默认情况下,除非在 $expand 中指定,否则不会填充它。
名称 | 类型 | 说明 |
---|---|---|
hasMoreResults |
boolean |
指示发票科目是否多于此集合中列出的科目。 集合最多列出 50 个发票科目。 若要获取所有发票科目,请使用列出发票科目 API。 |
value |
与计费对象信息关联的发票科目。 |
InvoiceSectionState
标识发票科目的状态。
名称 | 类型 | 说明 |
---|---|---|
Active |
string |
|
Restricted |
string |
SpendingLimit
计费对象信息支出限制。
名称 | 类型 | 说明 |
---|---|---|
Off |
string |
|
On |
string |
StatusReasonCode
指定计费配置文件状态的原因。
名称 | 类型 | 说明 |
---|---|---|
PastDue |
string |
|
SpendingLimitExpired |
string |
|
SpendingLimitReached |
string |
targetCloud
标识与发票科目关联的云环境。 这是一个系统管理的可选字段,当发票科目与各种云中的帐户关联时会更新。
名称 | 类型 | 说明 |
---|---|---|
USGov |
string |
|
USNat |
string |
|
USSec |
string |