Billing Accounts - Get

Ottiene un account di fatturazione in base al relativo ID.

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}

Parametri dell'URI

Name In Required Type Description
billingAccountName
path True
  • string

ID che identifica in modo univoco un account di fatturazione.

api-version
query True
  • string

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

$expand
query
  • string

Può essere usato per espandere le sezioni soldTo, le sezioni della fattura e i profili di fatturazione.

Risposte

Name Type Description
200 OK

OK. La richiesta ha avuto esito positivo.

Other Status Codes

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

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

AccountStatus

Stato corrente dell'account di fatturazione.

AccountType

Tipo di cliente.

AddressDetails

Dettagli indirizzo.

AgreementType

Tipo di contratto.

AzurePlan

Dettagli del piano di Azure.

BillingAccount

Un account di fatturazione.

BillingProfile

Profilo di fatturazione.

BillingProfilesOnExpand

Profili di fatturazione associati all'account di fatturazione. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

BillingProfileStatus

Stato del profilo di fatturazione.

BillingRelationshipType

Identifica i servizi e gli acquisti pagati da un profilo di fatturazione.

Department

Un reparto.

Enrollment

Proprietà di una registrazione.

EnrollmentAccount

Un account di registrazione.

EnrollmentPolicies

Criteri per Enterprise Agreement registrazioni.

ErrorDetails

Dettagli dell'errore.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

ErrorSubDetails
IndirectRelationshipInfo

Dettagli del profilo di fatturazione del partner del cliente per un movimento indiretto.

InvoiceSection

Sezione della fattura.

InvoiceSectionsOnExpand

Sezioni della fattura associate al profilo di fatturazione. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

InvoiceSectionState

Identifica lo stato di una sezione della fattura.

SpendingLimit

Limite di spesa del profilo di fatturazione.

StatusReasonCode

Motivo dello stato del profilo di fatturazione specificato.

targetCloud

Identifica gli ambienti cloud associati a una sezione della fattura. Si tratta di un campo facoltativo gestito dal sistema e viene aggiornato quando la sezione della fattura viene associata agli account in vari cloud.

AccountStatus

Stato corrente dell'account di fatturazione.

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

AccountType

Tipo di cliente.

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

AddressDetails

Dettagli indirizzo.

Name Type Description
addressLine1
  • string

Riga indirizzo 1.

addressLine2
  • string

Riga indirizzo 2.

addressLine3
  • string

Riga indirizzo 3.

city
  • string

Città dell'indirizzo.

companyName
  • string

Nome della società.

country
  • string

Il codice paese usa il formato ISO2, a 2 cifre.

district
  • string

Distretto dell'indirizzo.

email
  • string

Indirizzo di posta elettronica.

firstName
  • string

Nome.

lastName
  • string

Cognome.

middleName
  • string

Secondo nome.

phoneNumber
  • string

Numero di telefono.

postalCode
  • string

Codice postale.

region
  • string

Area dell'indirizzo.

AgreementType

Tipo di contratto.

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

AzurePlan

Dettagli del piano di Azure.

Name Type Description
skuDescription
  • string

Descrizione dello SKU.

skuId
  • string

ID sku.

BillingAccount

Un account di fatturazione.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.accountStatus

Stato corrente dell'account di fatturazione.

properties.accountType

Tipo di cliente.

properties.agreementType

Tipo di contratto.

properties.billingProfiles

Profili di fatturazione associati all'account di fatturazione. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

properties.departments

Reparti associati alla registrazione.

properties.displayName
  • string

Nome dell'account di fatturazione.

properties.enrollmentAccounts

Account associati alla registrazione.

properties.enrollmentDetails

Dettagli sulla registrazione legacy associata. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

properties.hasReadAccess
  • boolean

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

properties.notificationEmailAddress
  • string

Indirizzo di posta elettronica di notifica, solo per gli account legacy

properties.soldTo

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

type
  • string

Tipo di risorsa.

BillingProfile

Profilo di fatturazione.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.billTo

Indirizzo di fatturazione.

properties.billingRelationshipType

Identifica i servizi e gli acquisti pagati da un profilo di fatturazione.

properties.currency
  • string

Valuta in cui vengono fatturati gli addebiti per il profilo di fatturazione.

properties.displayName
  • string

Nome del profilo di fatturazione.

properties.enabledAzurePlans

Informazioni sui piani di Azure abilitati.

properties.hasReadAccess
  • boolean

Indica se l'utente ha accesso in lettura al profilo di fatturazione.

properties.indirectRelationshipInfo

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

properties.invoiceDay
  • integer

Giorno del mese in cui viene generata la fattura per il profilo di fatturazione.

properties.invoiceEmailOptIn
  • boolean

Flag che controlla se le fatture per il profilo di fatturazione vengono inviate tramite posta elettronica.

properties.invoiceSections

Sezioni della fattura associate al profilo di fatturazione. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

properties.poNumber
  • string

Nome dell'ordine di acquisto che verrà visualizzato nelle fatture generate per il profilo di fatturazione.

properties.spendingLimit

Limite di spesa del profilo di fatturazione.

properties.status

Stato del profilo di fatturazione.

properties.statusReasonCode

Motivo dello stato del profilo di fatturazione specificato.

properties.systemId
  • string

Identificatore univoco generato dal sistema per un profilo di fatturazione.

properties.tags
  • object

Tag dei profili di fatturazione.

properties.targetClouds
  • string[]

Identifica gli ambienti cloud associati a un profilo di fatturazione. Si tratta di un campo facoltativo gestito dal sistema e viene aggiornato quando il profilo di fatturazione viene associato agli account in vari cloud.

type
  • string

Tipo di risorsa.

BillingProfilesOnExpand

Profili di fatturazione associati all'account di fatturazione. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

Name Type Description
hasMoreResults
  • boolean

Indica se sono presenti più profili di fatturazione rispetto a quelli elencati in questa raccolta. La raccolta elenca un massimo di 50 profili di fatturazione. Per ottenere tutti i profili di fatturazione, usare l'API dei profili di fatturazione elenco.

value

Profili di fatturazione associati all'account di fatturazione.

BillingProfileStatus

Stato del profilo di fatturazione.

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

BillingRelationshipType

Identifica i servizi e gli acquisti pagati da un profilo di fatturazione.

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

Department

Un reparto.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.costCenter
  • string

Centro di costo associato al reparto.

properties.departmentName
  • string

Nome del reparto.

properties.enrollmentAccounts

Account di registrazione associati. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

properties.status
  • string

Stato del reparto.

type
  • string

Tipo di risorsa.

Enrollment

Proprietà di una registrazione.

Name Type Description
billingCycle
  • string

Ciclo di fatturazione per la registrazione.

channel
  • string

Tipo di canale della registrazione.

countryCode
  • string

Codice paese della registrazione.

currency
  • string

Valuta di fatturazione per la registrazione.

endDate
  • string

Data di fine della registrazione.

language
  • string

Lingua per la registrazione.

policies

Criteri per Enterprise Agreement registrazioni.

startDate
  • string

Data di inizio della registrazione.

status
  • string

Stato corrente della registrazione.

EnrollmentAccount

Un account di registrazione.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.accountName
  • string

Nome dell'account di registrazione.

properties.accountOwner
  • string

Proprietario dell'account di registrazione.

properties.accountOwnerEmail
  • string

Indirizzo di posta elettronica del proprietario dell'account di registrazione.

properties.costCenter
  • string

Centro di costo associato all'account di registrazione.

properties.department

Reparto associato. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

properties.endDate
  • string

Data di fine dell'account di registrazione.

properties.startDate
  • string

Data di inizio dell'account di registrazione.

properties.status
  • string

Stato dell'account di registrazione.

type
  • string

Tipo di risorsa.

EnrollmentPolicies

Criteri per Enterprise Agreement registrazioni.

Name Type Description
accountOwnerViewCharges
  • boolean

Criterio che controlla se i proprietari dell'account possono visualizzare gli addebiti.

departmentAdminViewCharges
  • boolean

Criterio che controlla se gli amministratori del reparto possono visualizzare gli addebiti.

marketplaceEnabled
  • boolean

Criteri che controllano se gli acquisti di Azure Marketplace sono consentiti nella registrazione.

reservedInstancesEnabled
  • boolean

Criteri che controllano se gli acquisti di prenotazioni di Azure sono consentiti nella registrazione.

ErrorDetails

Dettagli dell'errore.

Name Type Description
code
  • string

Codice di errore.

details

Dettagli secondari dell'errore.

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

target
  • string

Destinazione dell'errore specifico.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Name Type Description
error

Dettagli dell'errore.

ErrorSubDetails

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

target
  • string

Destinazione dell'errore specifico.

IndirectRelationshipInfo

Dettagli del profilo di fatturazione del partner del cliente per un movimento indiretto.

Name Type Description
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.

InvoiceSection

Sezione della fattura.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.displayName
  • string

Nome della sezione della fattura.

properties.labels
  • object

Dizionario dei metadati associati alla sezione della fattura.

properties.state

Identifica lo stato di una sezione della fattura.

properties.systemId
  • string

Identificatore univoco generato dal sistema per una sezione della fattura.

properties.tags
  • object

Dizionario dei metadati associati alla sezione della fattura. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non devono essere vuoti né null. Le chiavi non possono contenere <> % & \ ? /

properties.targetCloud

Identifica gli ambienti cloud associati a una sezione della fattura. Si tratta di un campo facoltativo gestito dal sistema e viene aggiornato quando la sezione della fattura viene associata agli account in vari cloud.

type
  • string

Tipo di risorsa.

InvoiceSectionsOnExpand

Sezioni della fattura associate al profilo di fatturazione. Per impostazione predefinita, questa impostazione non viene popolata, a meno che non sia specificata in $expand.

Name Type Description
hasMoreResults
  • boolean

Indica se sono presenti più sezioni della fattura rispetto a quelle elencate in questa raccolta. La raccolta elenca un massimo di 50 sezioni della fattura. Per ottenere tutte le sezioni della fattura, usare l'API sezioni della fattura elenco.

value

Sezioni della fattura associate al profilo di fatturazione.

InvoiceSectionState

Identifica lo stato di una sezione della fattura.

Name Type Description
Active
  • string
Restricted
  • string

SpendingLimit

Limite di spesa del profilo di fatturazione.

Name Type Description
Off
  • string
On
  • string

StatusReasonCode

Motivo dello stato del profilo di fatturazione specificato.

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

targetCloud

Identifica gli ambienti cloud associati a una sezione della fattura. Si tratta di un campo facoltativo gestito dal sistema e viene aggiornato quando la sezione della fattura viene associata agli account in vari cloud.

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