Dela via


Billing Accounts - List

Visar en lista över de faktureringskonton som en användare har åtkomst till.

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

Name I Obligatorisk Typ Description
api-version
query True

string

Den version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2024-04-01.

expand
query

string

Expandera tillåts för SoldTo och EnrollmentDetails/PONumber.

filter
query

string

Med alternativet filterfråga kan klienter filtrera en samling resurser som adresseras av en begärande-URL.

includeAll
query

boolean

När det är sant innehåller resultatet faktureringskonton som användaren inte har någon direkt rolltilldelning på om användaren har någon av följande AAD-roller: Global administratör, Global läsare, Faktureringsadministratör.

includeAllWithoutBillingProfiles
query

boolean

När det är sant innehåller resultatet faktureringskonton som inte har skapats helt om användaren har någon av följande AAD-roller: Global administratör, global läsare och faktureringsadministratör.

includeDeleted
query

boolean

När det är sant innehåller resultatet alla faktureringskonton i ett borttaget tillstånd.

includePendingAgreement
query

boolean

Innehåller faktureringskonton med avtal väntar på signatur som användaren har åtkomst till.

includeResellee
query

boolean

Innehåller kundens faktureringskonto för Microsoft-partneravtal som användaren har åtkomst till.

legalOwnerOID
query

string

Måste kombineras med legalOwnerTID, resultatet inkluderar endast faktureringskonton som är juridiskt ansvariga för faktureringskontona. Valfri.

legalOwnerTID
query

string

Måste kombineras med legalOwnerOID, resultatet inkluderar endast faktureringskonton som är juridiskt ansvariga för faktureringskontona. Valfri.

search
query

string

Med sökfrågealternativet kan klienter begära objekt i en samling som matchar ett fritextsökningsuttryck. sökning stöds endast för strängfält.

skip
query

integer

int64

Alternativet Hoppa över fråga begär antalet objekt i den efterfrågade samlingen som ska hoppas över och inte inkluderas i resultatet.

top
query

integer

int64

Det översta frågealternativet begär att antalet objekt i den efterfrågade samlingen inkluderas i resultatet. Det maximala värdet som stöds för top är 50.

Svar

Name Typ Description
200 OK

BillingAccountListResult

Listan över faktureringskonton.

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

BillingAccountForLegacyAccountDetails
BillingAccountsList
BillingAccountsListWithExpandForPONumber

BillingAccountForLegacyAccountDetails

Exempelbegäran

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

Exempelsvar

{
  "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

Exempelbegäran

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

Exempelsvar

{
  "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

Exempelbegäran

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

Exempelsvar

{
  "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"
      }
    }
  ]
}

Definitioner

Name Description
AccountStatus

Aktuell status för faktureringskontot.

AccountSubType

Nivån för kontot.

AccountType

Typen av kund.

AgreementType

Typ av avtal.

BillingAccount

Ett faktureringskonto.

BillingAccountListResult

En container för en lista över resurser

BillingAccountProperties

Ett faktureringskonto.

BillingAccountStatusReasonCode

Orsak till den angivna faktureringskontostatusen.

BillingRelationshipType

Identifierar de faktureringsrelationer som representeras av ett faktureringskonto. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part.

createdByType

Den typ av identitet som skapade resursen.

EnrollmentDetails

Egenskaperna för en registrering.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ExtendedTermOption

Faktureringskontotillägget som valts av företaget.

IndirectRelationshipInfo

Identifierar faktureringsprofilen som är länkad till en annan faktureringsprofil i indirekt inköpsrörelse.

MarkupStatus

Markeringsstatus för registrering, gäller endast för indirekta registreringar.

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

RegistrationNumber

Beskriver registreringsnumret för den organisation som är länkad till faktureringskontot.

SoldTo

Adressen till den person eller organisation som ansvarar för faktureringskontot.

SupportLevel

Supportnivåerbjudandet som är associerat med en registrering.

systemData

Metadata som rör skapande och senaste ändring av resursen.

TaxIdentifier

En skatteidentifierare för faktureringskontot.

TaxIdentifierStatus

Status för skatteidentifieraren.

TaxIdentifierType

Typ av skatteidentifierare.

AccountStatus

Aktuell status för faktureringskontot.

Name Typ Description
Active

string

Deleted

string

Disabled

string

Expired

string

Extended

string

New

string

Other

string

Pending

string

Terminated

string

Transferred

string

UnderReview

string

AccountSubType

Nivån för kontot.

Name Typ Description
Enterprise

string

Individual

string

None

string

Other

string

Professional

string

AccountType

Typen av kund.

Name Typ Description
Business

string

ClassicPartner

string

Enterprise

string

Individual

string

Internal

string

Other

string

Partner

string

Reseller

string

Tenant

string

AgreementType

Typ av avtal.

Name Typ Description
EnterpriseAgreement

string

MicrosoftCustomerAgreement

string

MicrosoftOnlineServicesProgram

string

MicrosoftPartnerAgreement

string

Other

string

BillingAccount

Ett faktureringskonto.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties

BillingAccountProperties

Ett faktureringskonto.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

tags

object

Ordlista med metadata som är associerade med resursen. Den kanske inte fylls i för alla resurstyper. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

BillingAccountListResult

En container för en lista över resurser

Name Typ Description
nextLink

string

Länken (url) till nästa resultatsida.

value

BillingAccount[]

Listan över resurser.

BillingAccountProperties

Ett faktureringskonto.

Name Typ Description
accountStatus

AccountStatus

Aktuell status för faktureringskontot.

accountStatusReasonCode

BillingAccountStatusReasonCode

Orsak till den angivna faktureringskontostatusen.

accountSubType

AccountSubType

Nivån för kontot.

accountType

AccountType

Typen av kund.

agreementType

AgreementType

Typ av avtal.

billingRelationshipTypes

BillingRelationshipType[]

Identifierar de faktureringsrelationer som representeras av ett faktureringskonto. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part.

displayName

string

Namnet på faktureringskontot.

enrollmentDetails

EnrollmentDetails

Egenskaperna för en registrering.

hasNoBillingProfiles

boolean

Anger om faktureringskontot har några faktureringsprofiler eller inte.

hasReadAccess

boolean

Anger om användaren har läsbehörighet till faktureringskontot.

notificationEmailAddress

string

E-postadress för avisering för äldre konto. Tillgängligt för avtalstyp Microsoft Online Services Program.

primaryBillingTenantId

string

Den klientorganisation som användes för att konfigurera faktureringskontot. Som standard kan endast användare från den här klientorganisationen hämta rolltilldelningar på faktureringskontot och alla inköp etableras i den här klientorganisationen.

provisioningState

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

qualifications

string[]

Kvalifikationer för prissättning för ett faktureringskonto. Värden kan vara kommersiell, utbildning, välgörenhet eller myndigheter.

registrationNumber

RegistrationNumber

Beskriver registreringsnumret för den organisation som är länkad till faktureringskontot.

soldTo

SoldTo

Adressen till den person eller organisation som ansvarar för faktureringskontot.

taxIds

TaxIdentifier[]

En lista över skatteidentifierare för faktureringskontot.

BillingAccountStatusReasonCode

Orsak till den angivna faktureringskontostatusen.

Name Typ Description
Expired

string

ManuallyTerminated

string

Other

string

TerminateProcessing

string

Transferred

string

UnusualActivity

string

BillingRelationshipType

Identifierar de faktureringsrelationer som representeras av ett faktureringskonto. Faktureringsrelationen kan vara mellan Microsoft, kunden och/eller en tredje part.

Name Typ Description
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

EnrollmentDetails

Egenskaperna för en registrering.

Name Typ Description
billingCycle

string

Faktureringscykeln för registreringen.

channel

string

Kanaltypen för registreringen.

cloud

string

Molnet för registreringen.

countryCode

string

Landskoden för registreringen.

currency

string

Faktureringsvalutan för registreringen.

endDate

string

Slutdatumet för registreringen.

extendedTermOption

ExtendedTermOption

Faktureringskontotillägget som valts av företaget.

indirectRelationshipInfo

IndirectRelationshipInfo

Egenskaperna för en registrering som endast gäller för indirekta registreringar.

invoiceRecipient

string

Den kontakt som tar emot fakturor för registreringen.

language

string

Språket för registreringen.

markupStatus

MarkupStatus

Markeringsstatus för registrering, gäller endast för indirekta registreringar.

poNumber

string

Inköpsordernumret för registreringen.

startDate

string

Startdatumet för registreringen.

supportCoverage

string

Supporttäckningsperioden för registreringen.

supportLevel

SupportLevel

Supportnivåerbjudandet som är associerat med en registrering.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ExtendedTermOption

Faktureringskontotillägget som valts av företaget.

Name Typ Description
Opted-In

string

Opted-Out

string

Other

string

IndirectRelationshipInfo

Identifierar faktureringsprofilen som är länkad till en annan faktureringsprofil i indirekt inköpsrörelse.

Name Typ Description
billingAccountName

string

Faktureringskontonamnet för partnern eller kunden för en indirekt rörelse.

billingProfileName

string

Faktureringsprofilens namn på partnern eller kunden för en indirekt rörelse.

displayName

string

Partnerns eller kundens visningsnamn för en indirekt rörelse.

MarkupStatus

Markeringsstatus för registrering, gäller endast för indirekta registreringar.

Name Typ Description
Disabled

string

Locked

string

Other

string

Preview

string

Published

string

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

Name Typ Description
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

RegistrationNumber

Beskriver registreringsnumret för den organisation som är länkad till faktureringskontot.

Name Typ Description
id

string

Det unika identifieringsnumret för den organisation som är länkad till faktureringskontot.

required

boolean

Identifierar om registreringsnumret krävs för faktureringskontot.

type

string[]

De typer av registreringsnummer som tillåts baserat på faktureringskontots land.

SoldTo

Adressen till den person eller organisation som ansvarar för faktureringskontot.

Name Typ Description
addressLine1

string

Adressrad 1.

addressLine2

string

Adressrad 2.

addressLine3

string

Adressrad 3.

city

string

Adressort.

companyName

string

Företagsnamn. Valfritt för MCA Individual (Betala per användning).

country

string

Landskoden använder FORMATET ISO 3166-1 Alpha-2.

district

string

Adressområde.

email

string

E-postadress.

firstName

string

Förnamn. Valfritt för MCA Enterprise.

isValidAddress

boolean

Anger om adressen är ofullständig.

lastName

string

Efternamn. Valfritt för MCA Enterprise.

middleName

string

Mellannamn.

phoneNumber

string

Telefonnummer.

postalCode

string

Postnummer.

region

string

Adressregion.

SupportLevel

Supportnivåerbjudandet som är associerat med en registrering.

Name Typ Description
Developer

string

Other

string

Pro-Direct

string

Standard

string

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

TaxIdentifier

En skatteidentifierare för faktureringskontot.

Name Typ Description
country

string

Landet för skatteidentifieraren.

id

string

ID:t för skatteidentifieraren.

scope

string

Skatteidentifierarens omfång.

status

TaxIdentifierStatus

Status för skatteidentifieraren.

type

TaxIdentifierType

Typ av skatteidentifierare.

TaxIdentifierStatus

Status för skatteidentifieraren.

Name Typ Description
Invalid

string

Other

string

Valid

string

TaxIdentifierType

Typ av skatteidentifierare.

Name Typ 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