Condividi tramite


Billing Accounts - List

Elenca gli account di fatturazione a cui un utente può accedere.

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}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
api-version
query True

string

Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01.

expand
query

string

L'espansione è consentita per SoldTo e EnrollmentDetails/PONumber.

filter
query

string

L'opzione di query di filtro consente ai client di filtrare una raccolta di risorse indirizzate da un URL di richiesta.

includeAll
query

boolean

Se true, i risultati includono gli account di fatturazione per cui l'utente non ha un'assegnazione di ruolo diretta se l'utente ha uno dei ruoli AAD seguenti: Amministratore globale, Lettore globale, Amministratore fatturazione.

includeAllWithoutBillingProfiles
query

boolean

Se true, i risultati includono gli account di fatturazione che non vengono creati completamente se l'utente ha uno dei ruoli di AAD seguenti: Amministratore globale, Lettore globale, Amministratore fatturazione.

includeDeleted
query

boolean

Se true, i risultati includeranno tutti gli account di fatturazione in uno stato eliminato.

includePendingAgreement
query

boolean

Include gli account di fatturazione con firma in sospeso del contratto a cui l'utente può accedere.

includeResellee
query

boolean

Include l'account di fatturazione del cliente del Contratto Microsoft Partner a cui l'utente ha accesso.

legalOwnerOID
query

string

Deve essere combinato con legalOwnerTID, i risultati includono solo gli account di fatturazione per i quali è legalmente responsabile per gli account di fatturazione. Opzionale.

legalOwnerTID
query

string

Deve essere combinato con legalOwnerOID, i risultati includono solo gli account di fatturazione per i quali è legalmente responsabile per gli account di fatturazione. Opzionale.

search
query

string

L'opzione di query di ricerca consente ai client di richiedere elementi all'interno di una raccolta corrispondente a un'espressione di ricerca senza testo. la ricerca è supportata solo per i campi stringa.

skip
query

integer

int64

L'opzione ignora query richiede il numero di elementi nella raccolta di query che devono essere ignorati e non inclusi nel risultato.

top
query

integer

int64

L'opzione query principale richiede che il numero di elementi nella raccolta di query venga incluso nel risultato. Il valore massimo supportato per top è 50.

Risposte

Nome Tipo Descrizione
200 OK

BillingAccountListResult

Elenco degli account di fatturazione.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

BillingAccountForLegacyAccountDetails
BillingAccountsList
BillingAccountsListWithExpandForPONumber

BillingAccountForLegacyAccountDetails

Esempio di richiesta

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

Risposta di esempio

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

Esempio di richiesta

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

Risposta di esempio

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

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AccountStatus

Stato corrente dell'account di fatturazione.

AccountSubType

Livello dell'account.

AccountType

Tipo di cliente.

AgreementType

Tipo di contratto.

BillingAccount

Un account di fatturazione.

BillingAccountListResult

Contenitore per un elenco di risorse

BillingAccountProperties

Un account di fatturazione.

BillingAccountStatusReasonCode

Motivo dello stato dell'account di fatturazione specificato.

BillingRelationshipType

Identifica le relazioni di fatturazione rappresentate da un account di fatturazione. La relazione di fatturazione può essere tra Microsoft, il cliente e/o una terza parte.

createdByType

Tipo di identità che ha creato la risorsa.

EnrollmentDetails

Proprietà di una registrazione.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ExtendedTermOption

L'estensione dell'account di fatturazione è stata scelta dall'azienda.

IndirectRelationshipInfo

Identifica il profilo di fatturazione collegato a un altro profilo di fatturazione nel movimento di acquisto indiretto.

MarkupStatus

Stato di markup della registrazione, applicabile solo per le registrazioni indirette.

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

RegistrationNumber

Descrive il numero di registrazione dell'organizzazione collegata all'account di fatturazione.

SoldTo

Indirizzo dell'utente o dell'organizzazione responsabile dell'account di fatturazione.

SupportLevel

Offerta a livello di supporto associata a una registrazione.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

TaxIdentifier

Identificatore fiscale per l'account di fatturazione.

TaxIdentifierStatus

Stato dell'identificatore fiscale.

TaxIdentifierType

Tipo dell'identificatore fiscale.

AccountStatus

Stato corrente dell'account di fatturazione.

Nome Tipo Descrizione
Active

string

Deleted

string

Disabled

string

Expired

string

Extended

string

New

string

Other

string

Pending

string

Terminated

string

Transferred

string

UnderReview

string

AccountSubType

Livello dell'account.

Nome Tipo Descrizione
Enterprise

string

Individual

string

None

string

Other

string

Professional

string

AccountType

Tipo di cliente.

Nome Tipo Descrizione
Business

string

ClassicPartner

string

Enterprise

string

Individual

string

Internal

string

Other

string

Partner

string

Reseller

string

Tenant

string

AgreementType

Tipo di contratto.

Nome Tipo Descrizione
EnterpriseAgreement

string

MicrosoftCustomerAgreement

string

MicrosoftOnlineServicesProgram

string

MicrosoftPartnerAgreement

string

Other

string

BillingAccount

Un account di fatturazione.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties

BillingAccountProperties

Un account di fatturazione.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.

tags

object

Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /

type

string

Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

BillingAccountListResult

Contenitore per un elenco di risorse

Nome Tipo Descrizione
nextLink

string

Collegamento (URL) alla pagina successiva dei risultati.

value

BillingAccount[]

Elenco di risorse.

BillingAccountProperties

Un account di fatturazione.

Nome Tipo Descrizione
accountStatus

AccountStatus

Stato corrente dell'account di fatturazione.

accountStatusReasonCode

BillingAccountStatusReasonCode

Motivo dello stato dell'account di fatturazione specificato.

accountSubType

AccountSubType

Livello dell'account.

accountType

AccountType

Tipo di cliente.

agreementType

AgreementType

Tipo di contratto.

billingRelationshipTypes

BillingRelationshipType[]

Identifica le relazioni di fatturazione rappresentate da un account di fatturazione. La relazione di fatturazione può essere tra Microsoft, il cliente e/o una terza parte.

displayName

string

Nome dell'account di fatturazione.

enrollmentDetails

EnrollmentDetails

Proprietà di una registrazione.

hasNoBillingProfiles

boolean

Indica se l'account di fatturazione ha o meno profili di fatturazione.

hasReadAccess

boolean

Indica se l'utente ha accesso in lettura all'account di fatturazione.

notificationEmailAddress

string

Indirizzo di posta elettronica di notifica per l'account legacy. Disponibile per il tipo di contratto Microsoft Online Services Program.

primaryBillingTenantId

string

Tenant usato per configurare l'account di fatturazione. Per impostazione predefinita, solo gli utenti di questo tenant possono ottenere assegnazioni di ruolo nell'account di fatturazione e viene effettuato il provisioning di tutti gli acquisti in questo tenant.

provisioningState

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

qualifications

string[]

Qualifiche per i prezzi per un account di fatturazione. I valori possono essere Commercial, Education, Charity o Government.

registrationNumber

RegistrationNumber

Descrive il numero di registrazione dell'organizzazione collegata all'account di fatturazione.

soldTo

SoldTo

Indirizzo dell'utente o dell'organizzazione responsabile dell'account di fatturazione.

taxIds

TaxIdentifier[]

Elenco di identificatori fiscali per l'account di fatturazione.

BillingAccountStatusReasonCode

Motivo dello stato dell'account di fatturazione specificato.

Nome Tipo Descrizione
Expired

string

ManuallyTerminated

string

Other

string

TerminateProcessing

string

Transferred

string

UnusualActivity

string

BillingRelationshipType

Identifica le relazioni di fatturazione rappresentate da un account di fatturazione. La relazione di fatturazione può essere tra Microsoft, il cliente e/o una terza parte.

Nome Tipo Descrizione
CSPCustomer

string

CSPPartner

string

Direct

string

IndirectCustomer

string

IndirectPartner

string

Other

string

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

EnrollmentDetails

Proprietà di una registrazione.

Nome Tipo Descrizione
billingCycle

string

Ciclo di fatturazione per la registrazione.

channel

string

Tipo di canale della registrazione.

cloud

string

Cloud della registrazione.

countryCode

string

Codice paese della registrazione.

currency

string

Valuta di fatturazione per la registrazione.

endDate

string

Data di fine della registrazione.

extendedTermOption

ExtendedTermOption

L'estensione dell'account di fatturazione è stata scelta dall'azienda.

indirectRelationshipInfo

IndirectRelationshipInfo

Proprietà di una registrazione applicabili solo per le registrazioni indirette.

invoiceRecipient

string

Contatto che riceve le fatture della registrazione.

language

string

Lingua per la registrazione.

markupStatus

MarkupStatus

Stato di markup della registrazione, applicabile solo per le registrazioni indirette.

poNumber

string

Numero di ordine di acquisto della registrazione.

startDate

string

Data di inizio della registrazione.

supportCoverage

string

Periodo di copertura del supporto per la registrazione.

supportLevel

SupportLevel

Offerta a livello di supporto associata a una registrazione.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExtendedTermOption

L'estensione dell'account di fatturazione è stata scelta dall'azienda.

Nome Tipo Descrizione
Opted-In

string

Opted-Out

string

Other

string

IndirectRelationshipInfo

Identifica il profilo di fatturazione collegato a un altro profilo di fatturazione nel movimento di acquisto indiretto.

Nome Tipo Descrizione
billingAccountName

string

Nome dell'account di fatturazione del partner o del cliente per un movimento indiretto.

billingProfileName

string

Nome del profilo di fatturazione del partner o del cliente per un movimento indiretto.

displayName

string

Nome visualizzato del partner o del cliente per un movimento indiretto.

MarkupStatus

Stato di markup della registrazione, applicabile solo per le registrazioni indirette.

Nome Tipo Descrizione
Disabled

string

Locked

string

Other

string

Preview

string

Published

string

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

Nome Tipo Descrizione
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

RegistrationNumber

Descrive il numero di registrazione dell'organizzazione collegata all'account di fatturazione.

Nome Tipo Descrizione
id

string

Numero di identificazione univoco dell'organizzazione collegato all'account di fatturazione.

required

boolean

Identifica se il numero di registrazione è necessario per l'account di fatturazione.

type

string[]

Tipi di numero di registrazione consentiti in base al paese dell'account di fatturazione.

SoldTo

Indirizzo dell'utente o dell'organizzazione responsabile dell'account di fatturazione.

Nome Tipo Descrizione
addressLine1

string

Riga indirizzo 1.

addressLine2

string

Riga indirizzo 2.

addressLine3

string

Riga indirizzo 3.

city

string

Indirizzo città.

companyName

string

Nome società. Facoltativo per mca individuale (con pagamento in base al consumo).

country

string

Il codice paese usa il formato ISO 3166-1 Alpha-2.

district

string

Distretto dell'indirizzo.

email

string

Indirizzo email.

firstName

string

Nome di battesimo. Facoltativo per MCA Enterprise.

isValidAddress

boolean

Indica se l'indirizzo è incompleto.

lastName

string

Cognome. Facoltativo per MCA Enterprise.

middleName

string

Secondo nome.

phoneNumber

string

Numero di telefono.

postalCode

string

Codice postale.

region

string

Area dell'indirizzo.

SupportLevel

Offerta a livello di supporto associata a una registrazione.

Nome Tipo Descrizione
Developer

string

Other

string

Pro-Direct

string

Standard

string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

TaxIdentifier

Identificatore fiscale per l'account di fatturazione.

Nome Tipo Descrizione
country

string

Paese dell'identificatore fiscale.

id

string

ID dell'identificatore fiscale.

scope

string

Ambito dell'identificatore fiscale.

status

TaxIdentifierStatus

Stato dell'identificatore fiscale.

type

TaxIdentifierType

Tipo dell'identificatore fiscale.

TaxIdentifierStatus

Stato dell'identificatore fiscale.

Nome Tipo Descrizione
Invalid

string

Other

string

Valid

string

TaxIdentifierType

Tipo dell'identificatore fiscale.

Nome Tipo Descrizione
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