Billing Accounts - Get

Ruft ein Abrechnungskonto anhand seiner ID ab.

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

Name In Required Type Description
billingAccountName
path True
  • string

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

api-version
query True
  • string

Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2020-05-01.

$expand
query
  • string

Kann verwendet werden, um die verkauftTo-, Rechnungsabschnitte und Abrechnungsprofile zu erweitern.

Antworten

Name Type Description
200 OK

OK. Die Anforderung ist erfolgreich.

Other Status Codes

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

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 Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

AccountStatus

Der aktuelle Status des Abrechnungskontos.

AccountType

Der Typ des Kunden.

AddressDetails

Adressdetails.

AgreementType

Die Art der Vereinbarung.

AzurePlan

Details des Azure-Plans.

BillingAccount

Ein Abrechnungskonto.

BillingProfile

Ein Abrechnungsprofil.

BillingProfilesOnExpand

Die Abrechnungsprofile, die dem Abrechnungskonto zugeordnet sind. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

BillingProfileStatus

Der Status des Abrechnungsprofils.

BillingRelationshipType

Gibt an, welche Dienste und Einkäufe durch ein Abrechnungsprofil bezahlt werden.

Department

Eine Abteilung.

Enrollment

Die Eigenschaften einer Registrierung.

EnrollmentAccount

Ein Registrierungskonto.

EnrollmentPolicies

Die Richtlinien für Enterprise Agreement Registrierungen.

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

ErrorSubDetails
IndirectRelationshipInfo

Die Abrechnungsprofildetails des Partners des Kunden für eine indirekte Bewegung.

InvoiceSection

Ein Rechnungsabschnitt.

InvoiceSectionsOnExpand

Die Rechnungsabschnitte, die dem Abrechnungsprofil zugeordnet sind. Standardmäßig wird dies nicht ausgefüllt, es sei denn, es wird in $expand angegeben.

InvoiceSectionState

Gibt den Status eines Rechnungsabschnitts an.

SpendingLimit

Das Ausgabenlimit für Abrechnungsprofil.

StatusReasonCode

Grund für den angegebenen Abrechnungsprofilstatus.

targetCloud

Identifiziert die Cloudumgebungen, die einem Rechnungsabschnitt zugeordnet sind. Dies ist ein vom System verwaltetes optionales Feld und wird aktualisiert, da der Rechnungsabschnitt Konten in verschiedenen Clouds zugeordnet wird.

AccountStatus

Der aktuelle Status des Abrechnungskontos.

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

AccountType

Der Typ des Kunden.

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

AddressDetails

Adressdetails.

Name Type Description
addressLine1
  • string

Adresszeile 1.

addressLine2
  • string

Adresszeile 2.

addressLine3
  • string

Adresszeile 3.

city
  • string

Adressstadt.

companyName
  • string

Firmenname.

country
  • string

Der Ländercode verwendet ISO2, 2-stelliges Format.

district
  • string

Adressbezirk.

email
  • string

E-Mail-Adresse.

firstName
  • string

Vorname.

lastName
  • string

Nachname.

middleName
  • string

Zweitname.

phoneNumber
  • string

Telefonnummer

postalCode
  • string

Plz.

region
  • string

Adressbereich.

AgreementType

Die Art der Vereinbarung.

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

AzurePlan

Details des Azure-Plans.

Name Type Description
skuDescription
  • string

Die Sku-Beschreibung.

skuId
  • string

Die Sku-ID.

BillingAccount

Ein Abrechnungskonto.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.accountStatus

Der aktuelle Status des Abrechnungskontos.

properties.accountType

Der Typ des Kunden.

properties.agreementType

Die Art der Vereinbarung.

properties.billingProfiles

Die Abrechnungsprofile, die dem Abrechnungskonto zugeordnet sind. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

properties.departments

Die Abteilungen, die der Registrierung zugeordnet sind.

properties.displayName
  • string

Der Name des Abrechnungskontos.

properties.enrollmentAccounts

Die Konten, die der Registrierung zugeordnet sind.

properties.enrollmentDetails

Die Details zur zugehörigen Legacyregistrierung. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

properties.hasReadAccess
  • boolean

Gibt an, ob der Benutzer Lesezugriff auf das Abrechnungskonto hat.

properties.notificationEmailAddress
  • string

Benachrichtigungs-E-Mail-Adresse nur für ältere Konten

properties.soldTo

Die Adresse der Person oder Organisation, die für das Abrechnungskonto verantwortlich ist.

type
  • string

Der Ressourcentyp.

BillingProfile

Ein Abrechnungsprofil.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.billTo

Abrechnungsadresse.

properties.billingRelationshipType

Identifiziert, welche Dienste und Einkäufe durch ein Abrechnungsprofil bezahlt werden.

properties.currency
  • string

Die Währung, in der die Gebühren für das Abrechnungsprofil berechnet werden.

properties.displayName
  • string

Der Name des Abrechnungsprofils.

properties.enabledAzurePlans

Informationen zu den aktivierten Azure-Plänen.

properties.hasReadAccess
  • boolean

Gibt an, ob der Benutzer Lesezugriff auf das Abrechnungsprofil hat.

properties.indirectRelationshipInfo

Identifiziert das Abrechnungsprofil, das mit einem anderen Abrechnungsprofil in indirekter Kaufbewegung verknüpft ist.

properties.invoiceDay
  • integer

Der Monat, an dem die Rechnung für das Abrechnungsprofil generiert wird.

properties.invoiceEmailOptIn
  • boolean

Kennzeichnen Sie, ob die Rechnungen für das Abrechnungsprofil per E-Mail gesendet werden.

properties.invoiceSections

Die Rechnungsabschnitte, die dem Abrechnungsprofil zugeordnet sind. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

properties.poNumber
  • string

Der Bestellname, der auf den Rechnungen angezeigt wird, die für das Abrechnungsprofil generiert wurden.

properties.spendingLimit

Die Ausgabengrenze für das Abrechnungsprofil.

properties.status

Der Status des Abrechnungsprofils.

properties.statusReasonCode

Grund für den angegebenen Abrechnungsprofilstatus.

properties.systemId
  • string

Das System generierte eindeutigen Bezeichner für ein Abrechnungsprofil.

properties.tags
  • object

Kategorien von Abrechnungsprofilen.

properties.targetClouds
  • string[]

Identifiziert die Cloudumgebungen, die einem Abrechnungsprofil zugeordnet sind. Dies ist ein vom System verwaltetes optionales Feld und wird aktualisiert, da das Abrechnungsprofil konten in verschiedenen Clouds zugeordnet wird.

type
  • string

Der Ressourcentyp.

BillingProfilesOnExpand

Die Abrechnungsprofile, die dem Abrechnungskonto zugeordnet sind. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

Name Type Description
hasMoreResults
  • boolean

Gibt an, ob in dieser Auflistung mehr Abrechnungsprofile vorhanden sind als die in dieser Auflistung aufgeführten. Die Auflistung enthält maximal 50 Abrechnungsprofile. Um alle Abrechnungsprofile abzurufen, verwenden Sie die Listenabrechnungsprofile-API.

value

Die Abrechnungsprofile, die dem Abrechnungskonto zugeordnet sind.

BillingProfileStatus

Der Status des Abrechnungsprofils.

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

BillingRelationshipType

Gibt an, welche Dienste und Einkäufe durch ein Abrechnungsprofil bezahlt werden.

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

Department

Eine Abteilung.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.costCenter
  • string

Das Kostencenter, das der Abteilung zugeordnet ist.

properties.departmentName
  • string

Der Name der Abteilung.

properties.enrollmentAccounts

Zugeordnete Registrierungskonten. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

properties.status
  • string

Der Status der Abteilung.

type
  • string

Der Ressourcentyp.

Enrollment

Die Eigenschaften einer Registrierung.

Name Type Description
billingCycle
  • string

Der Abrechnungszyklus für die Registrierung.

channel
  • string

Der Kanaltyp der Registrierung.

countryCode
  • string

Der Ländercode der Registrierung.

currency
  • string

Die Abrechnungswährung für die Registrierung.

endDate
  • string

Das Enddatum der Registrierung.

language
  • string

Die Sprache für die Registrierung.

policies

Die Richtlinien für Enterprise Agreement Registrierungen.

startDate
  • string

Das Startdatum der Registrierung.

status
  • string

Der aktuelle Status der Registrierung.

EnrollmentAccount

Ein Registrierungskonto.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.accountName
  • string

Der Name des Registrierungskontos.

properties.accountOwner
  • string

Der Besitzer des Registrierungskontos.

properties.accountOwnerEmail
  • string

Die E-Mail-Adresse des Registrierungskontos.

properties.costCenter
  • string

Das Kostencenter, das dem Registrierungskonto zugeordnet ist.

properties.department

Zugeordnete Abteilung. Dies ist standardmäßig nicht gefüllt, es sei denn, es wird in $expand angegeben.

properties.endDate
  • string

Das Enddatum des Registrierungskontos.

properties.startDate
  • string

Das Startdatum des Registrierungskontos.

properties.status
  • string

Der Status des Registrierungskontos.

type
  • string

Der Ressourcentyp.

EnrollmentPolicies

Die Richtlinien für Enterprise Agreement Registrierungen.

Name Type Description
accountOwnerViewCharges
  • boolean

Die Richtlinie, die steuert, ob Kontobesitzer Gebühren anzeigen können.

departmentAdminViewCharges
  • boolean

Die Richtlinie, die steuert, ob Abteilungsadministratoren Gebühren anzeigen können.

marketplaceEnabled
  • boolean

Die Richtlinie, die steuert, ob Azure Marketplace-Einkäufe in der Registrierung zulässig sind.

reservedInstancesEnabled
  • boolean

Die Richtlinie, die steuert, ob Azure-Reservierungskäufe in der Registrierung zulässig sind.

ErrorDetails

Die Details des Fehlers.

Name Type Description
code
  • string

Fehlercode

details

Die Unterdetails des Fehlers.

message
  • string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target
  • string

Das Ziel des bestimmten Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Name Type Description
error

Die Details des Fehlers.

ErrorSubDetails

Name Type Description
code
  • string

Fehlercode

message
  • string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target
  • string

Das Ziel des bestimmten Fehlers.

IndirectRelationshipInfo

Die Abrechnungsprofildetails des Partners des Kunden für eine indirekte Bewegung.

Name Type Description
billingAccountName
  • string

Der Abrechnungskontoname des Partners oder des Kunden für eine indirekte Bewegung.

billingProfileName
  • string

Der Name des Abrechnungsprofils des Partners oder des Kunden für eine indirekte Bewegung.

displayName
  • string

Der Anzeigename des Partners oder Kunden für eine indirekte Bewegung.

InvoiceSection

Ein Rechnungsabschnitt.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.displayName
  • string

Der Name des Rechnungsabschnitts.

properties.labels
  • object

Wörterbuch der Metadaten, die dem Rechnungsabschnitt zugeordnet sind.

properties.state

Gibt den Status eines Rechnungsabschnitts an.

properties.systemId
  • string

Das System hat einen eindeutigen Bezeichner für einen Rechnungsabschnitt generiert.

properties.tags
  • object

Wörterbuch der Metadaten, die dem Rechnungsabschnitt zugeordnet sind. Maximale Schlüssel-/Wertlänge unterstützt von 256 Zeichen. Schlüssel/Wert sollten weder leerer Wert noch Null sein. Schlüssel können % & \ nicht enthalten?<> /

properties.targetCloud

Identifiziert die Cloudumgebungen, die einem Rechnungsabschnitt zugeordnet sind. Dies ist ein vom System verwaltetes optionales Feld und wird aktualisiert, da der Rechnungsabschnitt Konten in verschiedenen Clouds zugeordnet wird.

type
  • string

Der Ressourcentyp.

InvoiceSectionsOnExpand

Die Rechnungsabschnitte, die dem Abrechnungsprofil zugeordnet sind. Standardmäßig wird dies nicht ausgefüllt, es sei denn, es wird in $expand angegeben.

Name Type Description
hasMoreResults
  • boolean

Gibt an, ob in dieser Auflistung mehr Rechnungsabschnitte vorhanden sind als die in dieser Auflistung aufgeführten. Die Sammlung listet maximal 50 Rechnungsabschnitte auf. Um alle Rechnungsabschnitte abzurufen, verwenden Sie die API für Listenrechnungsabschnitte.

value

Die Rechnungsabschnitte, die dem Abrechnungsprofil zugeordnet sind.

InvoiceSectionState

Gibt den Status eines Rechnungsabschnitts an.

Name Type Description
Active
  • string
Restricted
  • string

SpendingLimit

Das Ausgabenlimit für Abrechnungsprofil.

Name Type Description
Off
  • string
On
  • string

StatusReasonCode

Grund für den angegebenen Abrechnungsprofilstatus.

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

targetCloud

Identifiziert die Cloudumgebungen, die einem Rechnungsabschnitt zugeordnet sind. Dies ist ein vom System verwaltetes optionales Feld und wird aktualisiert, da der Rechnungsabschnitt Konten in verschiedenen Clouds zugeordnet wird.

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