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. |
|
include
|
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. |
|
include
|
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. |
|
include
|
query |
boolean |
Wanneer waar, bevatten de resultaten alle factureringsaccounts in een verwijderde status. |
|
include
|
query |
boolean |
Bevat factureringsaccounts met een overeenkomst die in behandeling zijn met de handtekening waartoe de gebruiker toegang heeft. |
|
include
|
query |
boolean |
Bevat de factureringsrekening van de klant van de Microsoft Partner-overeenkomst waartoe de gebruiker toegang heeft. |
|
legal
|
query |
string |
De resultaten moeten worden gecombineerd met legalOwnerTID. De resultaten omvatten alleen factureringsrekeningen voor wie wettelijk verantwoordelijk is voor de factureringsrekeningen. Facultatief. |
|
legal
|
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 |
De lijst met factureringsrekeningen. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Voorbeelden
Billing |
Billing |
Billing |
BillingAccountForLegacyAccountDetails
Voorbeeldaanvraag
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
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
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 |
---|---|
Account |
De huidige status van de factureringsrekening. |
Account |
De laag van het account. |
Account |
Het type klant. |
Agreement |
Het type overeenkomst. |
Billing |
Een factureringsrekening. |
Billing |
Een container voor een lijst met resources |
Billing |
Een factureringsrekening. |
Billing |
Reden voor de opgegeven factureringsrekeningstatus. |
Billing |
Identificeert de factureringsrelaties die worden vertegenwoordigd door een factureringsrekening. De factureringsrelatie kan tussen Microsoft, de klant en/of een derde partij zijn. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Enrollment |
De eigenschappen van een inschrijving. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Extended |
De extensie van het factureringsaccount die is gekozen door het bedrijf. |
Indirect |
Identificeert het factureringsprofiel dat is gekoppeld aan een ander factureringsprofiel in indirecte aankoopbeweging. |
Markup |
Markeringsstatus van inschrijving, alleen van toepassing op indirecte inschrijvingen. |
Provisioning |
De inrichtingsstatus van de resource tijdens een langdurige bewerking. |
Registration |
Beschrijft het registratienummer van de organisatie die is gekoppeld aan de factureringsrekening. |
Sold |
Het adres van de persoon of organisatie die verantwoordelijk is voor de factureringsrekening. |
Support |
De aanbieding op ondersteuningsniveau die is gekoppeld aan een inschrijving. |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
Tax |
Een btw-id voor de factureringsrekening. |
Tax |
De status van de belasting-id. |
Tax |
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 |
Een factureringsrekening. |
|
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 |
De lijst met resources. |
BillingAccountProperties
Een factureringsrekening.
Name | Type | Description |
---|---|---|
accountStatus |
De huidige status van de factureringsrekening. |
|
accountStatusReasonCode |
Reden voor de opgegeven factureringsrekeningstatus. |
|
accountSubType |
De laag van het account. |
|
accountType |
Het type klant. |
|
agreementType |
Het type overeenkomst. |
|
billingRelationshipTypes |
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 |
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 |
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 |
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. |
|
taxIds |
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 |
De extensie van het factureringsaccount die is gekozen door het bedrijf. |
|
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 |
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 |
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 |
De fout bevat aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
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. |
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 |
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 |
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 |
De status van de belasting-id. |
|
type |
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 |