你当前正在访问 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 参数

名称 必需 类型 说明
billingAccountName
path True

string

唯一标识计费帐户的 ID。

api-version
query True

string

要与客户端请求一起使用的 API 版本。 当前版本为 2020-05-01。

$expand
query

string

可用于展开发票科目。

响应

名称 类型 说明
200 OK

BillingProfileListResult

没问题。 请求已成功。

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 模拟用户帐户

示例

BillingProfilesListByBillingAccount
BillingProfilesListWithExpand

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"
              }
            }
          ]
        }
      }
    }
  ]
}

定义

名称 说明
AddressDetails

地址详细信息。

AzurePlan

Azure 计划的详细信息。

BillingProfile

计费配置文件。

BillingProfileListResult

计费配置文件列表。

BillingProfileStatus

计费配置文件的状态。

BillingRelationshipType

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

ErrorDetails

错误的详细信息。

ErrorResponse

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

ErrorSubDetails
IndirectRelationshipInfo

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

InvoiceSection

发票科目。

InvoiceSectionsOnExpand

与计费对象信息关联的发票科目。 默认情况下,除非在 $expand 中指定,否则不会填充它。

InvoiceSectionState

标识发票科目的状态。

SpendingLimit

计费对象信息支出限制。

StatusReasonCode

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

targetCloud

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

AddressDetails

地址详细信息。

名称 类型 说明
addressLine1

string

地址行 1。

addressLine2

string

地址行 2。

addressLine3

string

地址行 3。

city

string

地址城市。

companyName

string

公司名称。

country

string

国家/地区代码使用 ISO2,2 位格式。

district

string

地址地区。

email

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

AddressDetails

帐单邮寄地址。

properties.billingRelationshipType

BillingRelationshipType

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

properties.currency

string

计费对象信息计费的货币。

properties.displayName

string

计费配置文件的名称。

properties.enabledAzurePlans

AzurePlan[]

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

properties.hasReadAccess

boolean

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

properties.indirectRelationshipInfo

IndirectRelationshipInfo

标识在间接购买动作中链接到另一个计费配置文件的计费配置文件。

properties.invoiceDay

integer

生成计费对象信息的发票的月份日期。

properties.invoiceEmailOptIn

boolean

控制是否通过电子邮件发送计费对象信息的发票的标志。

properties.invoiceSections

InvoiceSectionsOnExpand

与计费对象信息关联的发票科目。 默认情况下,除非在 $expand 中指定,否则不会填充它。

properties.poNumber

string

将为计费对象信息生成的发票上显示的采购订单名称。

properties.spendingLimit

SpendingLimit

计费对象信息支出限制。

properties.status

BillingProfileStatus

计费配置文件的状态。

properties.statusReasonCode

StatusReasonCode

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

properties.systemId

string

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

properties.tags

object

计费配置文件的标记。

properties.targetClouds

targetCloud[]

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

type

string

资源类型。

BillingProfileListResult

计费配置文件列表。

名称 类型 说明
nextLink

string

链接 (url) 到结果的下一页。

totalCount

number

总记录数。

value

BillingProfile[]

计费配置文件列表。

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

object

与发票科目关联的元数据字典。

properties.state

InvoiceSectionState

标识发票科目的状态。

properties.systemId

string

系统为发票科目生成了唯一标识符。

properties.tags

object

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

properties.targetCloud

targetCloud

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

type

string

资源类型。

InvoiceSectionsOnExpand

与计费对象信息关联的发票科目。 默认情况下,除非在 $expand 中指定,否则不会填充它。

名称 类型 说明
hasMoreResults

boolean

指示发票科目是否多于此集合中列出的科目。 集合最多列出 50 个发票科目。 若要获取所有发票科目,请使用列出发票科目 API。

value

InvoiceSection[]

与计费对象信息关联的发票科目。

InvoiceSectionState

标识发票科目的状态。

名称 类型 说明
Active

string

Restricted

string

SpendingLimit

计费对象信息支出限制。

名称 类型 说明
Off

string

On

string

StatusReasonCode

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

名称 类型 说明
PastDue

string

SpendingLimitExpired

string

SpendingLimitReached

string

targetCloud

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

名称 类型 说明
USGov

string

USNat

string

USSec

string