Automazione per i partner

  • Articolo

Gestione costi di Azure è disponibile in modo nativo per i partner diretti che hanno eseguito l'onboarding dei propri clienti a un contratto del cliente Microsoft e hanno 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 non di automazione, vedere Gestione dei costi per i partner.

API di Gestione costi di Azure - 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.

Le API nell'ambito della sottoscrizione possono essere chiamate da un partner indipendentemente dai criteri di costo, purché il partner abbia 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 di tempo

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

Usare il valore del campo ID restituito in precedenza e sostituirlo nell'esempio seguente come ambito di esecuzione di una query sui dettagli dell'utilizzo.

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

Passaggi successivi