Billing Accounts - Get

Lekér egy számlázási fiókot az azonosító alapján.

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}

URI-paraméterek

Name In Required Type Description
billingAccountName
path True
  • string

A számlázási fiókot egyedileg azonosító azonosító.

api-version
query True
  • string

Az ügyfélkérelemhez használni kívánt API verziója. A jelenlegi verzió: 2020.05.01.

$expand
query
  • string

A soldTo, a számlaszakaszok és a számlázási profilok kibontására használható.

Válaszok

Name Type Description
200 OK

OK gombra. A kérés sikeres volt.

Other Status Codes

Hibaválasz, amely leírja, hogy miért hiúsult meg a művelet.

Biztonság

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 felhasználói fiók megszemélyesítése

Példák

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

Definíciók

AccountStatus

A számlázási fiók aktuális állapota.

AccountType

Az ügyfél típusa.

AddressDetails

Címadatok.

AgreementType

A szerződés típusa.

AzurePlan

Az Azure-csomag részletei.

BillingAccount

Egy számlázási fiók.

BillingProfile

Egy számlázási profil.

BillingProfilesOnExpand

A számlázási fiókhoz társított számlázási profilok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

BillingProfileStatus

A számlázási profil állapota.

BillingRelationshipType

Azonosítja, hogy mely szolgáltatásokat és vásárlásokat fizeti ki egy számlázási profil.

Department

Egy részleg.

Enrollment

A regisztráció tulajdonságai.

EnrollmentAccount

Egy regisztrációs fiók.

EnrollmentPolicies

A regisztrációk Nagyvállalati Szerződés szabályzatai.

ErrorDetails

A hiba részletei.

ErrorResponse

A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

ErrorSubDetails
IndirectRelationshipInfo

Az ügyfél partnerének számlázási profiladatai közvetett mozgás céljából.

InvoiceSection

Egy számlaszakasz.

InvoiceSectionsOnExpand

A számlázási profilhoz társított számlaszakaszok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

InvoiceSectionState

Egy számlaszakasz állapotát azonosítja.

SpendingLimit

A számlázási profil költségkerete.

StatusReasonCode

A megadott számlázási profil állapotának oka.

targetCloud

Azonosítja a számlázási szakaszhoz társított felhőkörnyezeteket. Ez egy rendszer által felügyelt választható mező, és frissül, amint a számlázási szakasz a különböző felhőkben lévő fiókokhoz lesz társítva.

AccountStatus

A számlázási fiók aktuális állapota.

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

AccountType

Az ügyfél típusa.

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

AddressDetails

Címadatok.

Name Type Description
addressLine1
  • string

Címsor 1.

addressLine2
  • string

2. címsor.

addressLine3
  • string

Cím 3. sora.

city
  • string

Cím város.

companyName
  • string

Cégnév.

country
  • string

Az országkód ISO2, kétjegyű formátumot használ.

district
  • string

Címtartomány.

email
  • string

E-mail-cím.

firstName
  • string

Utónév.

lastName
  • string

Vezetéknév.

middleName
  • string

Középső név.

phoneNumber
  • string

Telefonszám.

postalCode
  • string

Irányítószám.

region
  • string

Címterület.

AgreementType

A szerződés típusa.

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

AzurePlan

Az Azure-csomag részletei.

Name Type Description
skuDescription
  • string

A termékváltozat leírása.

skuId
  • string

A termékváltozat azonosítója.

BillingAccount

Egy számlázási fiók.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.accountStatus

A számlázási fiók aktuális állapota.

properties.accountType

Az ügyfél típusa.

properties.agreementType

A szerződés típusa.

properties.billingProfiles

A számlázási fiókhoz társított számlázási profilok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

properties.departments

A regisztrációhoz társított részlegek.

properties.displayName
  • string

A számlázási fiók neve.

properties.enrollmentAccounts

A regisztrációhoz társított fiókok.

properties.enrollmentDetails

A kapcsolódó örökölt regisztráció részletei. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

properties.hasReadAccess
  • boolean

Azt jelzi, hogy a felhasználó rendelkezik-e olvasási hozzáféréssel a számlázási fiókhoz.

properties.notificationEmailAddress
  • string

Értesítési e-mail-cím, csak örökölt fiókok esetén

properties.soldTo

A számlázási fiókért felelős személy vagy szervezet címe.

type
  • string

Erőforrástípus.

BillingProfile

Egy számlázási profil.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.billTo

Számlázási cím.

properties.billingRelationshipType

Azonosítja, hogy mely szolgáltatásokat és vásárlásokat fizeti ki egy számlázási profil.

properties.currency
  • string

Az a pénznem, amelyben a számlázási profil díjai ki vannak számlázva.

properties.displayName
  • string

A számlázási profil neve.

properties.enabledAzurePlans

Információk az engedélyezett Azure-csomagokról.

properties.hasReadAccess
  • boolean

Azt jelzi, hogy a felhasználó rendelkezik-e olvasási hozzáféréssel a számlázási profilhoz.

properties.indirectRelationshipInfo

Azonosítja azt a számlázási profilt, amely egy másik számlázási profilhoz kapcsolódik közvetett vásárlási mozgásban.

properties.invoiceDay
  • integer

A számlázási profilhoz tartozó számla létrehozásának napja.

properties.invoiceEmailOptIn
  • boolean

Annak megjelölése, hogy a számlázási profilhoz tartozó számlák e-mailben legyenek-e elküldve.

properties.invoiceSections

A számlázási profilhoz társított számlaszakaszok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

properties.poNumber
  • string

A számlázási profilhoz létrehozott számlákon megjelenő beszerzési rendelés neve.

properties.spendingLimit

A számlázási profil költségkerete.

properties.status

A számlázási profil állapota.

properties.statusReasonCode

A megadott számlázási profil állapotának oka.

properties.systemId
  • string

A rendszer egyedi azonosítót hozott létre egy számlázási profilhoz.

properties.tags
  • object

A számlázási profilok címkéi.

properties.targetClouds
  • string[]

Azonosítja a számlázási profilhoz társított felhőkörnyezeteket. Ez egy rendszer által felügyelt választható mező, és frissül, amint a számlázási profil a különböző felhőkben lévő fiókokhoz lesz társítva.

type
  • string

Erőforrástípus.

BillingProfilesOnExpand

A számlázási fiókhoz társított számlázási profilok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

Name Type Description
hasMoreResults
  • boolean

Azt jelzi, hogy több számlázási profil van-e, mint a gyűjteményben felsoroltak. A gyűjtemény legfeljebb 50 számlázási profilt sorol fel. Az összes számlázási profil lekéréséhez használja a listázási profilok API-t.

value

A számlázási fiókhoz társított számlázási profilok.

BillingProfileStatus

A számlázási profil állapota.

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

BillingRelationshipType

Azonosítja, hogy mely szolgáltatásokat és vásárlásokat fizeti ki egy számlázási profil.

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

Department

Egy részleg.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.costCenter
  • string

A részleghez társított költséghely.

properties.departmentName
  • string

A részleg neve.

properties.enrollmentAccounts

Társított regisztrációs fiókok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

properties.status
  • string

A részleg állapota.

type
  • string

Erőforrástípus.

Enrollment

A regisztráció tulajdonságai.

Name Type Description
billingCycle
  • string

A regisztráció számlázási ciklusa.

channel
  • string

A regisztráció csatornatípusa.

countryCode
  • string

A regisztráció országkódja.

currency
  • string

A regisztráció számlázási pénzneme.

endDate
  • string

A regisztráció záró dátuma.

language
  • string

A regisztráció nyelve.

policies

A regisztrációk Nagyvállalati Szerződés szabályzatai.

startDate
  • string

A regisztráció kezdő dátuma.

status
  • string

A regisztráció aktuális állapota.

EnrollmentAccount

Egy regisztrációs fiók.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.accountName
  • string

A regisztrációs fiók neve.

properties.accountOwner
  • string

A regisztrációs fiók tulajdonosa.

properties.accountOwnerEmail
  • string

A regisztrációs fiók tulajdonosának e-mail-címe.

properties.costCenter
  • string

A regisztrációs fiókhoz társított költséghely.

properties.department

Társított részleg. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

properties.endDate
  • string

A regisztrációs fiók záró dátuma.

properties.startDate
  • string

A regisztrációs fiók kezdő dátuma.

properties.status
  • string

A regisztrációs fiók állapota.

type
  • string

Erőforrástípus.

EnrollmentPolicies

A regisztrációk Nagyvállalati Szerződés szabályzatai.

Name Type Description
accountOwnerViewCharges
  • boolean

Az a szabályzat, amely azt szabályozza, hogy a fióktulajdonosok megtekinthetik-e a díjakat.

departmentAdminViewCharges
  • boolean

Az a szabályzat, amely azt szabályozza, hogy a részlegszintű rendszergazdák megtekinthetik-e a díjakat.

marketplaceEnabled
  • boolean

A szabályzat, amely azt szabályozza, hogy engedélyezettek-e az Azure Marketplace-vásárlások a regisztrációban.

reservedInstancesEnabled
  • boolean

Az a szabályzat, amely azt szabályozza, hogy engedélyezettek-e az Azure-foglalások vásárlásai a regisztrációban.

ErrorDetails

A hiba részletei.

Name Type Description
code
  • string

Hibakód.

details

A hiba aladatai.

message
  • string

Hibaüzenet, amely jelzi, hogy a művelet miért hiúsult meg.

target
  • string

Az adott hiba célja.

ErrorResponse

A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

Name Type Description
error

A hiba részletei.

ErrorSubDetails

Name Type Description
code
  • string

Hibakód.

message
  • string

Hibaüzenet, amely jelzi, hogy a művelet miért hiúsult meg.

target
  • string

Az adott hiba célja.

IndirectRelationshipInfo

Az ügyfél partnerének számlázási profiladatai közvetett mozgás céljából.

Name Type Description
billingAccountName
  • string

A partner vagy az ügyfél számlázási fiókneve közvetett mozgás esetén.

billingProfileName
  • string

A partner vagy az ügyfél számlázási profilneve egy közvetett mozgáshoz.

displayName
  • string

A partner vagy ügyfél megjelenített neve egy közvetett mozgáshoz.

InvoiceSection

Egy számlaszakasz.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.displayName
  • string

A számlaszakasz neve.

properties.labels
  • object

A számlaszakaszhoz társított metaadatok szótára.

properties.state

Egy számlaszakasz állapotát azonosítja.

properties.systemId
  • string

A rendszer egyedi azonosítót hozott létre egy számlaszakaszhoz.

properties.tags
  • object

A számlaszakaszhoz társított metaadatok szótára. A kulcs/érték maximális hossza legfeljebb 256 karakter lehet. A kulcsok/értékek nem üresek és nem lehet null értékűek. A kulcsok nem tartalmazhatnak <> % & \ ? /

properties.targetCloud

Azonosítja a számlázási szakaszhoz társított felhőkörnyezeteket. Ez egy rendszer által felügyelt választható mező, és frissül, amint a számlázási szakasz a különböző felhőkben lévő fiókokhoz lesz társítva.

type
  • string

Erőforrástípus.

InvoiceSectionsOnExpand

A számlázási profilhoz társított számlaszakaszok. Alapértelmezés szerint ez nem lesz kitöltve, kivéve, ha az $expand van megadva.

Name Type Description
hasMoreResults
  • boolean

Azt jelzi, hogy a gyűjteményben felsoroltaknál több számlaszakasz van-e. A gyűjtemény legfeljebb 50 számlaszakaszt sorol fel. Az összes számlaszakasz lekéréséhez használja a számlaszakaszok listáját tartalmazó API-t.

value

A számlázási profilhoz társított számlaszakaszok.

InvoiceSectionState

Egy számlaszakasz állapotát azonosítja.

Name Type Description
Active
  • string
Restricted
  • string

SpendingLimit

A számlázási profil költségkerete.

Name Type Description
Off
  • string
On
  • string

StatusReasonCode

A megadott számlázási profil állapotának oka.

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

targetCloud

Azonosítja a számlázási szakaszhoz társított felhőkörnyezeteket. Ez egy rendszer által felügyelt választható mező, és frissül, amint a számlázási szakasz a különböző felhőkben lévő fiókokhoz lesz társítva.

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