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

Billing Accounts - Get

按其 ID 获取计费帐户。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}?api-version=2019-10-01-preview
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}?api-version=2019-10-01-preview&$expand={$expand}

URI 参数

Name In Required Type Description
billingAccountName
path True
  • string

唯一标识计费帐户的 ID。

api-version
query True
  • string

要用于客户端请求的 API 版本。 当前版本为 2019-10-01-preview。

$expand
query
  • string

可用于扩展地址、发票科目和计费配置文件。

响应

Name Type Description
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

Name Description
user_impersonation 模拟用户帐户

示例

BillingAccounts
BillingAccountWithExpand

BillingAccounts

Sample Request

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

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}",
  "name": "{billingAccountName}",
  "type": "Microsoft.Billing/billingAccounts",
  "properties": {
    "displayName": "Test Account",
    "agreementType": "MicrosoftCustomerAgreement",
    "customerType": "Enterprise",
    "accountType": "Enterprise",
    "organizationId": "00000000-0000-0000-0000-000000000000"
  }
}

BillingAccountWithExpand

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}?api-version=2019-10-01-preview&$expand=address, invoiceSections, billingProfiles

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}",
  "name": "{billingAccountName}",
  "type": "Microsoft.Billing/billingAccounts",
  "properties": {
    "displayName": "Test Account 1",
    "agreementType": "MicrosoftCustomerAgreement",
    "address": {
      "companyName": "Contoso",
      "firstName": "Test",
      "lastName": "User",
      "addressLine1": "Test Address",
      "addressLine2": "Test Address",
      "addressLine3": "Test Address",
      "city": "City",
      "postalCode": "00000",
      "region": "WA",
      "country": "US"
    },
    "customerType": "Enterprise",
    "accountType": "Enterprise",
    "organizationId": "00000000-0000-0000-0000-000000000000",
    "billingProfiles": [
      {
        "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",
          "address": {
            "companyName": "Contoso",
            "firstName": "Test",
            "lastName": "User",
            "addressLine1": "Test Address1",
            "addressLine2": "Test Address2",
            "addressLine3": "Test Address3",
            "city": "City",
            "postalCode": "00000",
            "region": "WA",
            "country": "US"
          },
          "billingRelationshipType": "Direct",
          "currency": "USD",
          "enabledAzurePlans": [
            {
              "skuId": "0001",
              "skuDescription": "Microsoft Azure Dev/Test"
            },
            {
              "skuId": "0002",
              "skuDescription": "Microsoft Azure Standard"
            }
          ],
          "invoiceDay": 5,
          "invoiceEmailOptIn": true,
          "poNumber": "ABC12345",
          "status": "Warned",
          "statusReasonCode": "PastDue",
          "spendingLimit": "On",
          "invoiceSections": [
            {
              "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",
                "state": "Active"
              }
            }
          ]
        }
      },
      {
        "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",
          "address": {
            "companyName": "Contoso",
            "firstName": "Test",
            "lastName": "User",
            "addressLine1": "Test Address1",
            "addressLine2": "Test Address2",
            "addressLine3": "Test Address3",
            "city": "City",
            "postalCode": "00000",
            "region": "WA",
            "country": "US"
          },
          "billingRelationshipType": "IndirectCustomer",
          "currency": "USD",
          "enabledAzurePlans": [
            {
              "skuId": "0001",
              "skuDescription": "Microsoft Azure Dev/Test"
            },
            {
              "skuId": "0002",
              "skuDescription": "Microsoft Azure Standard"
            }
          ],
          "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",
          "status": "Active",
          "spendingLimit": "Off",
          "invoiceSections": [
            {
              "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",
                "state": "Active"
              }
            }
          ]
        }
      }
    ]
  }
}

定义

AccountType

客户类型。

AddressDetails

地址详细信息。

AgreementType

协议的类型。

AzurePlan

Azure 计划的详细信息。

BillingAccount

计费帐户。

BillingProfile

计费配置文件。

BillingProfileStatus

计费配置文件的状态。

BillingRelationshipType

标识计费配置文件支付哪些服务和购买费用。

CustomerType

客户类型。

Department

部门。

Enrollment

注册的属性。

EnrollmentAccount

注册帐户。

EnrollmentPolicies

企业协议注册的策略。

ErrorDetails

错误的详细信息。

ErrorResponse

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

ErrorSubDetails
IndirectRelationshipInfo

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

InvoiceSection

发票部分。

InvoiceSectionState

标识发票科目的状态。

SpendingLimit

计费配置文件支出限制。

StatusReasonCode

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

targetCloud

标识与发票科目关联的云环境。 这是一个系统管理的可选字段,随着发票部分与各种云中的帐户相关联而更新。

AccountType

客户类型。

Name Type Description
Enterprise
  • string
Individual
  • string
Partner
  • string

AddressDetails

地址详细信息。

Name Type Description
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

地址区域。

AgreementType

协议的类型。

Name Type Description
EnterpriseAgreement
  • string
MicrosoftCustomerAgreement
  • string
MicrosoftOnlineServicesProgram
  • string
MicrosoftPartnerAgreement
  • string

AzurePlan

Azure 计划的详细信息。

Name Type Description
skuDescription
  • string

SKU 说明。

skuId
  • string

SKU ID。

BillingAccount

计费帐户。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.accountType

客户类型。

properties.address

与计费帐户关联的地址。

properties.agreementType

协议的类型。

properties.billingProfiles

与计费帐户关联的计费配置文件。 默认情况下,除非在$expand中指定,否则不会填充此填充。

properties.customerType

客户类型。

properties.departments

与注册关联的部门。

properties.displayName
  • string

计费帐户名称。

properties.enrollmentAccounts

与注册关联的帐户。

properties.enrollmentDetails

有关关联旧版注册的详细信息。 默认情况下,除非在$expand中指定,否则不会填充此填充。

properties.organizationId
  • string

组织 ID。

type
  • string

资源类型。

BillingProfile

计费配置文件。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.address

计费地址。

properties.billingRelationshipType

标识计费配置文件支付哪些服务和购买费用。

properties.currency
  • string

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

properties.displayName
  • string

计费配置文件的名称。

properties.enabledAzurePlans

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

properties.indirectRelationshipInfo

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

properties.invoiceDay
  • integer

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

properties.invoiceEmailOptIn
  • boolean

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

properties.invoiceSections

与计费配置文件关联的发票科目。

properties.poNumber
  • string

将在为计费配置文件生成的发票上显示的采购订单名称。

properties.spendingLimit

计费配置文件支出限制。

properties.status

计费配置文件的状态。

properties.statusReasonCode

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

properties.targetClouds
  • string[]

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

type
  • string

资源类型。

BillingProfileStatus

计费配置文件的状态。

Name Type Description
Active
  • string
Disabled
  • string
Warned
  • string

BillingRelationshipType

标识计费配置文件支付哪些服务和购买费用。

Name Type Description
CSPPartner
  • string
Direct
  • string
IndirectCustomer
  • string
IndirectPartner
  • string

CustomerType

客户类型。

Name Type Description
Enterprise
  • string
Individual
  • string
Partner
  • string

Department

部门。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.costCenter
  • string

与部门关联的成本中心。

properties.departmentName
  • string

部门的名称。

properties.enrollmentAccounts

关联的注册帐户。 默认情况下,除非在$expand中指定,否则不会填充此填充。

properties.status
  • string

部门的状态。

type
  • string

资源类型。

Enrollment

注册的属性。

Name Type Description
billingCycle
  • string

注册的计费周期。

channel
  • string

注册的通道类型。

countryCode
  • string

注册的国家/地区代码。

currency
  • string

注册的计费货币。

endDate
  • string

注册的结束日期。

language
  • string

注册的语言。

policies

企业协议注册的策略。

startDate
  • string

注册的开始日期。

status
  • string

注册的当前状态。

EnrollmentAccount

注册帐户。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.accountName
  • string

注册帐户的名称。

properties.accountOwner
  • string

注册帐户的所有者。

properties.costCenter
  • string

与注册帐户关联的成本中心。

properties.department

关联部门。 默认情况下,除非在$expand中指定,否则不会填充此填充。

properties.endDate
  • string

注册帐户的结束日期。

properties.startDate
  • string

注册帐户的开始日期。

properties.status
  • string

注册帐户的状态。

type
  • string

资源类型。

EnrollmentPolicies

企业协议注册的策略。

Name Type Description
accountOwnerViewCharges
  • boolean

控制帐户所有者是否可以查看费用的策略。

departmentAdminViewCharges
  • boolean

控制部门管理员是否可以查看费用的策略。

marketplacesEnabled
  • boolean

用于控制是否允许在注册中购买 Azure 市场的策略。

reservedInstancesEnabled
  • boolean

用于控制注册中是否允许 Azure 预留购买的策略。

ErrorDetails

错误的详细信息。

Name Type Description
code
  • string

错误代码。

details

错误的子详细信息。

message
  • string

指示操作失败的原因的错误消息。

target
  • string

特定错误的目标。

ErrorResponse

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

Name Type Description
error

错误的详细信息。

ErrorSubDetails

Name Type Description
code
  • string

错误代码。

message
  • string

指示操作失败的原因的错误消息。

target
  • string

特定错误的目标。

IndirectRelationshipInfo

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

Name Type Description
billingAccountName
  • string

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

billingProfileName
  • string

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

displayName
  • string

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

InvoiceSection

发票部分。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.displayName
  • string

发票部分的名称。

properties.state

标识发票科目的状态。

properties.targetCloud

标识与发票科目关联的云环境。 这是一个系统管理的可选字段,随着发票部分与各种云中的帐户相关联而更新。

type
  • string

资源类型。

InvoiceSectionState

标识发票科目的状态。

Name Type Description
Active
  • string
Restricted
  • string

SpendingLimit

计费配置文件支出限制。

Name Type Description
Off
  • string
On
  • string

StatusReasonCode

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

Name Type Description
PastDue
  • string
SpendingLimitExpired
  • string
SpendingLimitReached
  • string

targetCloud

标识与发票科目关联的云环境。 这是一个系统管理的可选字段,随着发票部分与各种云中的帐户相关联而更新。

Name Type Description
USGov
  • string
USNat
  • string
USSec
  • string