Automazione per i partner

  • Articolo

Gestione costi Microsoft è disponibile in modo nativo per i partner diretti che hanno eseguito l'onboarding dei clienti in un Contratto del cliente Microsoft e acquistato un piano di Azure. I partner e i loro clienti possono usare le API di Gestione dei costi per le attività comuni. Per altre informazioni sugli scenari di nonautomation, vedere Gestione costi per i partner.

Nota

Anche se le versioni api specifiche sono illustrate negli esempi di questo articolo, è consigliabile usare la versione più recente dell'API disponibile. Le versioni più recenti dell'API potrebbero avere funzionalità migliorate. Le versioni successive dell'API supportano le versioni precedenti.

API di Gestione costi Microsoft - Provider diretti e indiretti

I partner con accesso agli ambiti di fatturazione in un tenant partner possono usare le API seguenti per visualizzare i costi fatturati.

I partner possono chiamare API nell'ambito della sottoscrizione indipendentemente dai criteri di costo, purché abbiano accesso alla sottoscrizione. Gli altri utenti con accesso alla sottoscrizione, ad esempio il cliente o il rivenditore, possono chiamare le API solo dopo che il partner ha abilitato i criteri di costo per il tenant cliente.

Per ottenere un elenco di account di fatturazione

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

Per ottenere un elenco di clienti

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview

Per ottenere un elenco di sottoscrizioni

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview

Per ottenere un elenco di fatture per un periodo specifico

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate}

La chiamata API restituisce una matrice di fatture con elementi simili al codice JSON seguente.

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    }

Per eseguire una query sui dettagli di utilizzo, usare il valore del campo ID restituito precedente e sostituirlo nell'esempio seguente come ambito.

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01

L'esempio restituisce i record di utilizzo associati alla fattura specifica.

Per ottenere i criteri per la visualizzazione dei costi da parte dei clienti

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview

Per impostare i criteri per la visualizzazione dei costi da parte dei clienti

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview

Per ottenere l'utilizzo dei servizi di Azure per un account di fatturazione

È consigliabile configurare un'esportazione per questi scenari. Per altre informazioni, vedere Recuperare set di dati di utilizzo di grandi dimensioni con le esportazioni.

Per scaricare l'utilizzo dei servizi di Azure di un cliente

È consigliabile configurare un'esportazione anche per questo scenario. Se è necessario scaricare i dati su richiesta, tuttavia, è possibile usare l'API Dettagli dei costi. Per altre informazioni, leggere Ottenere set di dati di costi ridotti su richiesta.

Per ottenere o scaricare l'elenco prezzi per i servizi di Azure consumati

Per prima cosa usare il post seguente.

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose

Chiamare quindi il valore della proprietà dell'operazione asincrona. Ad esempio:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview

La chiamata Get precedente restituisce il collegamento di download contenente l'elenco prezzi.

Per ottenere i costi aggregati

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01

Creare un budget per un partner

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01

Creare un budget per un cliente

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01

Eliminare un budget

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01

Contenuto correlato