Delen via


Billing Accounts - List

Geeft een lijst weer van de factureringsaccounts waartoe een gebruiker toegang heeft.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?includeAll={includeAll}&includeAllWithoutBillingProfiles={includeAllWithoutBillingProfiles}&includeDeleted={includeDeleted}&includePendingAgreement={includePendingAgreement}&includeResellee={includeResellee}&legalOwnerTID={legalOwnerTID}&legalOwnerOID={legalOwnerOID}&api-version=2024-04-01&filter={filter}&expand={expand}&top={top}&skip={skip}&search={search}

URI-parameters

Name In Vereist Type Description
api-version
query True

string

De versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2024-04-01.

expand
query

string

Expand is toegestaan voor SoldTo en EnrollmentDetails/PONumber.

filter
query

string

Met de filterqueryoptie kunnen clients een verzameling resources filteren die worden geadresseerd door een aanvraag-URL.

includeAll
query

boolean

Als waar is, bevatten de resultaten factureringsaccounts waarvoor de gebruiker geen directe roltoewijzing heeft als de gebruiker een van de volgende AAD-rollen heeft: Globale beheerder, Globale lezer, Factureringsbeheerder.

includeAllWithoutBillingProfiles
query

boolean

Wanneer waar, bevatten de resultaten factureringsaccounts die niet volledig zijn gemaakt als de gebruiker een van de volgende AAD-rollen heeft: Globale beheerder, Globale lezer, Factureringsbeheerder.

includeDeleted
query

boolean

Wanneer waar, bevatten de resultaten alle factureringsaccounts in een verwijderde status.

includePendingAgreement
query

boolean

Bevat factureringsaccounts met een overeenkomst die in behandeling zijn met de handtekening waartoe de gebruiker toegang heeft.

includeResellee
query

boolean

Bevat de factureringsrekening van de klant van de Microsoft Partner-overeenkomst waartoe de gebruiker toegang heeft.

legalOwnerOID
query

string

De resultaten moeten worden gecombineerd met legalOwnerTID. De resultaten omvatten alleen factureringsrekeningen voor wie wettelijk verantwoordelijk is voor de factureringsrekeningen. Facultatief.

legalOwnerTID
query

string

Moet worden gecombineerd met legalOwnerOID, de resultaten omvatten alleen factureringsrekeningen voor wie wettelijk verantwoordelijk is voor de factureringsrekeningen. Facultatief.

search
query

string

Met de zoekqueryoptie kunnen clients items binnen een verzameling aanvragen die overeenkomen met een zoekexpressie in vrije tekst. zoeken wordt alleen ondersteund voor tekenreeksvelden.

skip
query

integer

int64

De optie voor het overslaan van query's vraagt het aantal items in de opgevraagde verzameling op die moeten worden overgeslagen en niet in het resultaat worden opgenomen.

top
query

integer

int64

De bovenste queryoptie vraagt het aantal items in de opgevraagde verzameling op om in het resultaat te worden opgenomen. De maximaal ondersteunde waarde voor top is 50.

Antwoorden

Name Type Description
200 OK

BillingAccountListResult

De lijst met factureringsrekeningen.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

BillingAccountForLegacyAccountDetails
BillingAccountsList
BillingAccountsListWithExpandForPONumber

BillingAccountForLegacyAccountDetails

Voorbeeldaanvraag

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01

Voorbeeldrespons

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/20000000-0000-0000-0000-000000000001",
      "name": "20000000-0000-0000-0000-000000000001",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Individual",
        "agreementType": "MicrosoftOnlineServicesProgram",
        "displayName": "Individual Account 2",
        "hasReadAccess": true,
        "notificationEmailAddress": "individual@domain.com"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

BillingAccountsList

Voorbeeldaanvraag

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01

Voorbeeldrespons

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "10000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Business",
        "accountSubType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Premier Business Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/20000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "20000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Business",
        "accountSubType": "Professional",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Standard Business Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/30000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "30000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Individual",
        "accountSubType": "Individual",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Individual Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/40000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "name": "40000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Business",
        "accountSubType": "Enterprise",
        "agreementType": "MicrosoftPartnerAgreement",
        "displayName": "Premier Business Account",
        "hasReadAccess": true,
        "primaryBillingTenantId": "20000000-0000-0000-0000-000000000001"
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    }
  ]
}

BillingAccountsListWithExpandForPONumber

Voorbeeldaanvraag

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2024-04-01&expand=soldTo,enrollmentDetails/poNumber

Voorbeeldrespons

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/6564892",
      "name": "6564892",
      "properties": {
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "accountSubType": "None",
        "agreementType": "EnterpriseAgreement",
        "displayName": "Enterprise Account",
        "enrollmentDetails": {
          "startDate": "2018-05-01T17:32:28Z",
          "endDate": "2019-05-31T17:32:28Z",
          "currency": "USD",
          "channel": "EaDirect",
          "language": "en",
          "countryCode": "US",
          "billingCycle": "Monthly",
          "extendedTermOption": "Opted-Out",
          "supportLevel": "Standard",
          "supportCoverage": "1/26/2021 - 6/30/2021",
          "cloud": "Azure Commercial",
          "poNumber": "poNumber123"
        },
        "hasReadAccess": true,
        "soldTo": {
          "addressLine1": "Test Address",
          "city": "City",
          "companyName": "Enterprise Company",
          "country": "US",
          "postalCode": "00000-1111",
          "region": "WA"
        }
      },
      "type": "Microsoft.Billing/billingAccounts",
      "systemData": {
        "createdAt": "2023-01-04T22:39:34.2606750Z",
        "lastModifiedAt": "2023-01-05T22:39:34.2606750Z"
      }
    }
  ]
}

Definities

Name Description
AccountStatus

De huidige status van de factureringsrekening.

AccountSubType

De laag van het account.

AccountType

Het type klant.

AgreementType

Het type overeenkomst.

BillingAccount

Een factureringsrekening.

BillingAccountListResult

Een container voor een lijst met resources

BillingAccountProperties

Een factureringsrekening.

BillingAccountStatusReasonCode

Reden voor de opgegeven factureringsrekeningstatus.

BillingRelationshipType

Identificeert de factureringsrelaties die worden vertegenwoordigd door een factureringsrekening. De factureringsrelatie kan tussen Microsoft, de klant en/of een derde partij zijn.

createdByType

Het type identiteit waarmee de resource is gemaakt.

EnrollmentDetails

De eigenschappen van een inschrijving.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

ExtendedTermOption

De extensie van het factureringsaccount die is gekozen door het bedrijf.

IndirectRelationshipInfo

Identificeert het factureringsprofiel dat is gekoppeld aan een ander factureringsprofiel in indirecte aankoopbeweging.

MarkupStatus

Markeringsstatus van inschrijving, alleen van toepassing op indirecte inschrijvingen.

ProvisioningState

De inrichtingsstatus van de resource tijdens een langdurige bewerking.

RegistrationNumber

Beschrijft het registratienummer van de organisatie die is gekoppeld aan de factureringsrekening.

SoldTo

Het adres van de persoon of organisatie die verantwoordelijk is voor de factureringsrekening.

SupportLevel

De aanbieding op ondersteuningsniveau die is gekoppeld aan een inschrijving.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

TaxIdentifier

Een btw-id voor de factureringsrekening.

TaxIdentifierStatus

De status van de belasting-id.

TaxIdentifierType

Het type belasting-id.

AccountStatus

De huidige status van de factureringsrekening.

Name Type Description
Active

string

Deleted

string

Disabled

string

Expired

string

Extended

string

New

string

Other

string

Pending

string

Terminated

string

Transferred

string

UnderReview

string

AccountSubType

De laag van het account.

Name Type Description
Enterprise

string

Individual

string

None

string

Other

string

Professional

string

AccountType

Het type klant.

Name Type Description
Business

string

ClassicPartner

string

Enterprise

string

Individual

string

Internal

string

Other

string

Partner

string

Reseller

string

Tenant

string

AgreementType

Het type overeenkomst.

Name Type Description
EnterpriseAgreement

string

MicrosoftCustomerAgreement

string

MicrosoftOnlineServicesProgram

string

MicrosoftPartnerAgreement

string

Other

string

BillingAccount

Een factureringsrekening.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"

name

string

De naam van de resource

properties

BillingAccountProperties

Een factureringsrekening.

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

tags

object

Woordenlijst met metagegevens die zijn gekoppeld aan de resource. Deze kan niet worden ingevuld voor alle resourcetypen. Maximale lengte van sleutel/waarde die wordt ondersteund door 256 tekens. Sleutels/waarde mogen geen lege waarde of null zijn. Sleutels kunnen geen <> % & \ bevatten? /

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

BillingAccountListResult

Een container voor een lijst met resources

Name Type Description
nextLink

string

De koppeling (URL) naar de volgende pagina met resultaten.

value

BillingAccount[]

De lijst met resources.

BillingAccountProperties

Een factureringsrekening.

Name Type Description
accountStatus

AccountStatus

De huidige status van de factureringsrekening.

accountStatusReasonCode

BillingAccountStatusReasonCode

Reden voor de opgegeven factureringsrekeningstatus.

accountSubType

AccountSubType

De laag van het account.

accountType

AccountType

Het type klant.

agreementType

AgreementType

Het type overeenkomst.

billingRelationshipTypes

BillingRelationshipType[]

Identificeert de factureringsrelaties die worden vertegenwoordigd door een factureringsrekening. De factureringsrelatie kan tussen Microsoft, de klant en/of een derde partij zijn.

displayName

string

De naam van het factureringsaccount.

enrollmentDetails

EnrollmentDetails

De eigenschappen van een inschrijving.

hasNoBillingProfiles

boolean

Hiermee wordt aangegeven of de factureringsrekening al dan niet factureringsprofielen heeft.

hasReadAccess

boolean

Geeft aan of de gebruiker leestoegang heeft tot het factureringsaccount.

notificationEmailAddress

string

E-mailadres voor meldingen voor een verouderd account. Beschikbaar voor overeenkomsttype Microsoft Online Services Program.

primaryBillingTenantId

string

De tenant die is gebruikt voor het instellen van het factureringsaccount. Standaard kunnen alleen gebruikers van deze tenant roltoewijzingen ophalen op het factureringsaccount en worden alle aankopen in deze tenant ingericht.

provisioningState

ProvisioningState

De inrichtingsstatus van de resource tijdens een langdurige bewerking.

qualifications

string[]

Kwalificaties voor prijzen op een factureringsrekening. Waarden kunnen commercieel, onderwijs, liefdadigheid of overheid zijn.

registrationNumber

RegistrationNumber

Beschrijft het registratienummer van de organisatie die is gekoppeld aan de factureringsrekening.

soldTo

SoldTo

Het adres van de persoon of organisatie die verantwoordelijk is voor de factureringsrekening.

taxIds

TaxIdentifier[]

Een lijst met btw-id's voor de factureringsrekening.

BillingAccountStatusReasonCode

Reden voor de opgegeven factureringsrekeningstatus.

Name Type Description
Expired

string

ManuallyTerminated

string

Other

string

TerminateProcessing

string

Transferred

string

UnusualActivity

string

BillingRelationshipType

Identificeert de factureringsrelaties die worden vertegenwoordigd door een factureringsrekening. De factureringsrelatie kan tussen Microsoft, de klant en/of een derde partij zijn.

Name Type Description
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

EnrollmentDetails

De eigenschappen van een inschrijving.

Name Type Description
billingCycle

string

De factureringscyclus voor de inschrijving.

channel

string

Het kanaaltype van de inschrijving.

cloud

string

De cloud van de inschrijving.

countryCode

string

De landcode van de inschrijving.

currency

string

De factureringsvaluta voor de inschrijving.

endDate

string

De einddatum van de inschrijving.

extendedTermOption

ExtendedTermOption

De extensie van het factureringsaccount die is gekozen door het bedrijf.

indirectRelationshipInfo

IndirectRelationshipInfo

De eigenschappen van een inschrijving die alleen van toepassing zijn op indirecte inschrijvingen.

invoiceRecipient

string

De contactpersoon die facturen van de inschrijving ontvangt.

language

string

De taal voor de inschrijving.

markupStatus

MarkupStatus

Markeringsstatus van inschrijving, alleen van toepassing op indirecte inschrijvingen.

poNumber

string

Het inkoopordernummer van de inschrijving.

startDate

string

De begindatum van de inschrijving.

supportCoverage

string

De ondersteuningsdekkingsperiode voor de inschrijving.

supportLevel

SupportLevel

De aanbieding op ondersteuningsniveau die is gekoppeld aan een inschrijving.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ExtendedTermOption

De extensie van het factureringsaccount die is gekozen door het bedrijf.

Name Type Description
Opted-In

string

Opted-Out

string

Other

string

IndirectRelationshipInfo

Identificeert het factureringsprofiel dat is gekoppeld aan een ander factureringsprofiel in indirecte aankoopbeweging.

Name Type Description
billingAccountName

string

De naam van de factureringsrekening van de partner of de klant voor een indirecte beweging.

billingProfileName

string

De naam van het factureringsprofiel van de partner of de klant voor een indirecte beweging.

displayName

string

De weergavenaam van de partner of klant voor een indirecte beweging.

MarkupStatus

Markeringsstatus van inschrijving, alleen van toepassing op indirecte inschrijvingen.

Name Type Description
Disabled

string

Locked

string

Other

string

Preview

string

Published

string

ProvisioningState

De inrichtingsstatus van de resource tijdens een langdurige bewerking.

Name Type Description
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

RegistrationNumber

Beschrijft het registratienummer van de organisatie die is gekoppeld aan de factureringsrekening.

Name Type Description
id

string

Het unieke identificatienummer van de organisatie die is gekoppeld aan de factureringsrekening.

required

boolean

Hiermee wordt aangegeven of het registratienummer vereist is voor de factureringsrekening.

type

string[]

De typen registratienummers die zijn toegestaan op basis van het land van de factureringsrekening.

SoldTo

Het adres van de persoon of organisatie die verantwoordelijk is voor de factureringsrekening.

Name Type Description
addressLine1

string

Adresregel 1.

addressLine2

string

Adresregel 2.

addressLine3

string

Adresregel 3.

city

string

Plaats van adres.

companyName

string

Bedrijfsnaam. Optioneel voor MCA Individual (betalen per gebruik).

country

string

Landcode maakt gebruik van ISO 3166-1 Alpha-2-indeling.

district

string

Adresdistrict.

email

string

E-mailadres.

firstName

string

Voornaam. Optioneel voor MCA Enterprise.

isValidAddress

boolean

Geeft aan of het adres onvolledig is.

lastName

string

Achternaam. Optioneel voor MCA Enterprise.

middleName

string

Middelste naam.

phoneNumber

string

Telefoonnummer.

postalCode

string

Postcode.

region

string

Adresregio.

SupportLevel

De aanbieding op ondersteuningsniveau die is gekoppeld aan een inschrijving.

Name Type Description
Developer

string

Other

string

Pro-Direct

string

Standard

string

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

TaxIdentifier

Een btw-id voor de factureringsrekening.

Name Type Description
country

string

Het land van de belasting-id.

id

string

De id van de belasting-id.

scope

string

Het bereik van de belasting-id.

status

TaxIdentifierStatus

De status van de belasting-id.

type

TaxIdentifierType

Het type belasting-id.

TaxIdentifierStatus

De status van de belasting-id.

Name Type Description
Invalid

string

Other

string

Valid

string

TaxIdentifierType

Het type belasting-id.

Name Type Description
BrazilCcmId

string

BrazilCnpjId

string

BrazilCpfId

string

CanadianFederalExempt

string

CanadianProvinceExempt

string

ExternalTaxation

string

IndiaFederalServiceTaxId

string

IndiaFederalTanId

string

IndiaPanId

string

IndiaStateCstId

string

IndiaStateGstINId

string

IndiaStateVatId

string

IntlExempt

string

LoveCode

string

MobileBarCode

string

NationalIdentificationNumber

string

Other

string

PublicSectorId

string

USExempt

string

VatId

string