Billing Accounts - Get

Mendapatkan akun penagihan dengan ID-nya.

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

Parameter URI

Name In Required Type Description
billingAccountName
path True
  • string

ID yang secara unik mengidentifikasi akun penagihan.

api-version
query True
  • string

Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2020-05-01.

$expand
query
  • string

Dapat digunakan untuk memperluas soldTo, bagian faktur, dan profil penagihan.

Respons

Name Type Description
200 OK

OK. Permintaan telah berhasil.

Other Status Codes

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2.

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

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

BillingAccounts
BillingAccountWithExpand

BillingAccounts

Sample Request

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

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}",
  "name": "{billingAccountName}",
  "type": "Microsoft.Billing/billingAccounts",
  "properties": {
    "displayName": "Test Account",
    "agreementType": "MicrosoftCustomerAgreement",
    "accountStatus": "Active",
    "accountType": "Enterprise",
    "hasReadAccess": true
  }
}

BillingAccountWithExpand

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}?api-version=2020-05-01&$expand=soldTo,billingProfiles,billingProfiles/invoiceSections

Sample Response

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}",
  "name": "{billingAccountName}",
  "type": "Microsoft.Billing/billingAccounts",
  "properties": {
    "displayName": "Test Account 1",
    "agreementType": "MicrosoftCustomerAgreement",
    "accountStatus": "Active",
    "soldTo": {
      "companyName": "Contoso",
      "firstName": "Test",
      "lastName": "User",
      "addressLine1": "Test Address",
      "addressLine2": "Test Address",
      "addressLine3": "Test Address",
      "city": "City",
      "postalCode": "00000",
      "region": "WA",
      "country": "US",
      "email": "abc@contoso.com",
      "phoneNumber": "000-000-0000"
    },
    "accountType": "Enterprise",
    "billingProfiles": {
      "hasMoreResults": true,
      "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",
            "invoiceSections": {
              "hasMoreResults": true,
              "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": "Active",
            "spendingLimit": "Off",
            "invoiceSections": {
              "hasMoreResults": true,
              "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"
                  }
                }
              ]
            }
          }
        }
      ]
    },
    "hasReadAccess": true
  }
}

Definisi

AccountStatus

Status akun penagihan saat ini.

AccountType

Jenis pelanggan.

AddressDetails

Detail alamat.

AgreementType

Jenis perjanjian.

AzurePlan

Detail paket Azure.

BillingAccount

Akun penagihan.

BillingProfile

Profil penagihan.

BillingProfilesOnExpand

Profil penagihan yang terkait dengan akun penagihan. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

BillingProfileStatus

Status profil penagihan.

BillingRelationshipType

Mengidentifikasi layanan dan pembelian mana yang dibayarkan oleh profil penagihan.

Department

Sebuah departemen.

Enrollment

Properti pendaftaran.

EnrollmentAccount

Akun pendaftaran.

EnrollmentPolicies

Kebijakan untuk pendaftaran Perjanjian Enterprise.

ErrorDetails

Detail kesalahan.

ErrorResponse

Respons kesalahan menunjukkan bahwa layanan tidak dapat memproses permintaan masuk. Alasannya disediakan dalam pesan kesalahan.

ErrorSubDetails
IndirectRelationshipInfo

Detail profil penagihan mitra pelanggan untuk gerakan tidak langsung.

InvoiceSection

Bagian faktur.

InvoiceSectionsOnExpand

Bagian faktur yang terkait dengan profil penagihan. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

InvoiceSectionState

Mengidentifikasi status bagian faktur.

SpendingLimit

Batas pengeluaran profil penagihan.

StatusReasonCode

Alasan status profil penagihan yang ditentukan.

targetCloud

Mengidentifikasi lingkungan cloud yang terkait dengan bagian faktur. Ini adalah bidang opsional yang dikelola sistem dan diperbarui saat bagian faktur dikaitkan dengan akun di berbagai cloud.

AccountStatus

Status akun penagihan saat ini.

Name Type Description
Active
  • string
Deleted
  • string
Disabled
  • string
Expired
  • string
Extended
  • string
Terminated
  • string
Transferred
  • string

AccountType

Jenis pelanggan.

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

AddressDetails

Detail alamat.

Name Type Description
addressLine1
  • string

Baris alamat 1.

addressLine2
  • string

Baris alamat 2.

addressLine3
  • string

Baris alamat 3.

city
  • string

Kota alamat.

companyName
  • string

Nama perusahaan.

country
  • string

Kode negara menggunakan format ISO2, 2 digit.

district
  • string

Distrik alamat.

email
  • string

Alamat Email.

firstName
  • string

Nama depan.

lastName
  • string

Nama belakang.

middleName
  • string

Nama tengah.

phoneNumber
  • string

Nomor telepon.

postalCode
  • string

Kode pos.

region
  • string

Wilayah alamat.

AgreementType

Jenis perjanjian.

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

AzurePlan

Detail paket Azure.

Name Type Description
skuDescription
  • string

Deskripsi sku.

skuId
  • string

Id sku.

BillingAccount

Akun penagihan.

Name Type Description
id
  • string

Id Sumber Daya.

name
  • string

Nama sumber daya.

properties.accountStatus

Status akun penagihan saat ini.

properties.accountType

Jenis pelanggan.

properties.agreementType

Jenis perjanjian.

properties.billingProfiles

Profil penagihan yang terkait dengan akun penagihan. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

properties.departments

Departemen yang terkait dengan pendaftaran.

properties.displayName
  • string

Nama akun penagihan.

properties.enrollmentAccounts

Akun yang terkait dengan pendaftaran.

properties.enrollmentDetails

Detail tentang pendaftaran warisan terkait. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

properties.hasReadAccess
  • boolean

Menunjukkan apakah pengguna memiliki akses baca ke akun penagihan.

properties.notificationEmailAddress
  • string

Alamat email pemberitahuan, hanya untuk akun warisan

properties.soldTo

Alamat individu atau organisasi yang bertanggung jawab atas akun penagihan.

type
  • string

Jenis sumber daya

BillingProfile

Profil penagihan.

Name Type Description
id
  • string

Id Sumber Daya.

name
  • string

Nama sumber daya.

properties.billTo

Alamat penagihan.

properties.billingRelationshipType

Mengidentifikasi layanan dan pembelian mana yang dibayarkan oleh profil penagihan.

properties.currency
  • string

Mata uang di mana biaya untuk profil penagihan ditagih.

properties.displayName
  • string

Nama profil penagihan.

properties.enabledAzurePlans

Informasi tentang paket azure yang diaktifkan.

properties.hasReadAccess
  • boolean

Menunjukkan apakah pengguna memiliki akses baca ke profil penagihan.

properties.indirectRelationshipInfo

Mengidentifikasi profil penagihan yang ditautkan ke profil penagihan lain dalam gerakan pembelian tidak langsung.

properties.invoiceDay
  • integer

Hari dalam sebulan ketika faktur untuk profil penagihan dibuat.

properties.invoiceEmailOptIn
  • boolean

Bendera yang mengontrol apakah faktur untuk profil penagihan dikirim melalui email.

properties.invoiceSections

Bagian faktur yang terkait dengan profil penagihan. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

properties.poNumber
  • string

Nama pesanan pembelian yang akan muncul pada faktur yang dihasilkan untuk profil penagihan.

properties.spendingLimit

Batas pengeluaran profil penagihan.

properties.status

Status profil penagihan.

properties.statusReasonCode

Alasan status profil penagihan yang ditentukan.

properties.systemId
  • string

Sistem menghasilkan pengidentifikasi unik untuk profil penagihan.

properties.tags
  • object

Tag profil penagihan.

properties.targetClouds
  • string[]

Mengidentifikasi lingkungan cloud yang terkait dengan profil penagihan. Ini adalah bidang opsional yang dikelola sistem dan diperbarui saat profil penagihan dikaitkan dengan akun di berbagai cloud.

type
  • string

Jenis sumber daya

BillingProfilesOnExpand

Profil penagihan yang terkait dengan akun penagihan. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

Name Type Description
hasMoreResults
  • boolean

Menunjukkan apakah ada lebih banyak profil penagihan daripada yang tercantum dalam koleksi ini. Koleksi mencantumkan maksimum 50 profil penagihan. Untuk mendapatkan semua profil penagihan, gunakan API profil penagihan daftar.

value

Profil penagihan yang terkait dengan akun penagihan.

BillingProfileStatus

Status profil penagihan.

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

BillingRelationshipType

Mengidentifikasi layanan dan pembelian mana yang dibayarkan oleh profil penagihan.

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

Department

Sebuah departemen.

Name Type Description
id
  • string

Id Sumber Daya.

name
  • string

Nama sumber daya.

properties.costCenter
  • string

Pusat biaya yang terkait dengan departemen.

properties.departmentName
  • string

Nama departemen.

properties.enrollmentAccounts

Akun pendaftaran terkait. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

properties.status
  • string

Status departemen.

type
  • string

Jenis sumber daya

Enrollment

Properti pendaftaran.

Name Type Description
billingCycle
  • string

Siklus penagihan untuk pendaftaran.

channel
  • string

Jenis saluran pendaftaran.

countryCode
  • string

Kode negara pendaftaran.

currency
  • string

Mata uang penagihan untuk pendaftaran.

endDate
  • string

Tanggal akhir pendaftaran.

language
  • string

Bahasa untuk pendaftaran.

policies

Kebijakan untuk pendaftaran Perjanjian Enterprise.

startDate
  • string

Tanggal mulai pendaftaran.

status
  • string

Status pendaftaran saat ini.

EnrollmentAccount

Akun pendaftaran.

Name Type Description
id
  • string

Id Sumber Daya.

name
  • string

Nama sumber daya.

properties.accountName
  • string

Nama akun pendaftaran.

properties.accountOwner
  • string

Pemilik akun pendaftaran.

properties.accountOwnerEmail
  • string

Alamat email pemilik akun pendaftaran.

properties.costCenter
  • string

Pusat biaya yang terkait dengan akun pendaftaran.

properties.department

Departemen terkait. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

properties.endDate
  • string

Tanggal akhir akun pendaftaran.

properties.startDate
  • string

Tanggal mulai akun pendaftaran.

properties.status
  • string

Status akun pendaftaran.

type
  • string

Jenis sumber daya

EnrollmentPolicies

Kebijakan untuk pendaftaran Perjanjian Enterprise.

Name Type Description
accountOwnerViewCharges
  • boolean

Kebijakan yang mengontrol apakah Pemilik Akun dapat melihat biaya.

departmentAdminViewCharges
  • boolean

Kebijakan yang mengontrol apakah Administrator Departemen dapat melihat biaya.

marketplaceEnabled
  • boolean

Kebijakan yang mengontrol apakah pembelian marketplace Azure diizinkan dalam pendaftaran.

reservedInstancesEnabled
  • boolean

Kebijakan yang mengontrol apakah pembelian reservasi Azure diizinkan dalam pendaftaran.

ErrorDetails

Detail kesalahan.

Name Type Description
code
  • string

Kode Kesalahan.

details

Subdetail kesalahan.

message
  • string

Pesan kesalahan yang menunjukkan mengapa operasi gagal.

target
  • string

Target kesalahan tertentu.

ErrorResponse

Respons kesalahan menunjukkan bahwa layanan tidak dapat memproses permintaan masuk. Alasannya disediakan dalam pesan kesalahan.

Name Type Description
error

Detail kesalahan.

ErrorSubDetails

Name Type Description
code
  • string

Kode Kesalahan.

message
  • string

Pesan kesalahan yang menunjukkan mengapa operasi gagal.

target
  • string

Target kesalahan tertentu.

IndirectRelationshipInfo

Detail profil penagihan mitra pelanggan untuk gerakan tidak langsung.

Name Type Description
billingAccountName
  • string

Nama akun penagihan mitra atau pelanggan untuk gerakan tidak langsung.

billingProfileName
  • string

Nama profil penagihan mitra atau pelanggan untuk gerakan tidak langsung.

displayName
  • string

Nama tampilan mitra atau pelanggan untuk gerakan tidak langsung.

InvoiceSection

Bagian faktur.

Name Type Description
id
  • string

Id Sumber Daya.

name
  • string

Nama sumber daya.

properties.displayName
  • string

Nama bagian faktur.

properties.labels
  • object

Kamus metadata yang terkait dengan bagian faktur.

properties.state

Mengidentifikasi status bagian faktur.

properties.systemId
  • string

Sistem menghasilkan pengidentifikasi unik untuk bagian faktur.

properties.tags
  • object

Kamus metadata yang terkait dengan bagian faktur. Panjang kunci/nilai maksimum didukung 256 karakter. Kunci/nilai tidak boleh kosong atau null. Kunci tidak boleh berisi <> % & \ ? /

properties.targetCloud

Mengidentifikasi lingkungan cloud yang terkait dengan bagian faktur. Ini adalah bidang opsional yang dikelola sistem dan diperbarui saat bagian faktur dikaitkan dengan akun di berbagai cloud.

type
  • string

Jenis sumber daya

InvoiceSectionsOnExpand

Bagian faktur yang terkait dengan profil penagihan. Secara default ini tidak diisi, kecuali ditentukan dalam $expand.

Name Type Description
hasMoreResults
  • boolean

Menunjukkan apakah ada lebih banyak bagian faktur daripada yang tercantum dalam koleksi ini. Koleksi mencantumkan maksimal 50 bagian faktur. Untuk mendapatkan semua bagian faktur, gunakan API bagian faktur daftar.

value

Bagian faktur yang terkait dengan profil penagihan.

InvoiceSectionState

Mengidentifikasi status bagian faktur.

Name Type Description
Active
  • string
Restricted
  • string

SpendingLimit

Batas pengeluaran profil penagihan.

Name Type Description
Off
  • string
On
  • string

StatusReasonCode

Alasan status profil penagihan yang ditentukan.

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

targetCloud

Mengidentifikasi lingkungan cloud yang terkait dengan bagian faktur. Ini adalah bidang opsional yang dikelola sistem dan diperbarui saat bagian faktur dikaitkan dengan akun di berbagai cloud.

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