Ottenere un riepilogo dell'utilizzo per tutte le sottoscrizioni di un cliente
Si applica a: Centro per i partner | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti
È possibile usare la risorsa CustomerUsageSummary per ottenere l'utilizzo di un cliente di un servizio o di una risorsa di Azure specifico durante il periodo di fatturazione corrente.
Nota
In genere, i dati di utilizzo non fatturati giornalieri sono disponibili tramite l'API o il portale del Centro per i partner dopo 24 ore. A seconda della posizione e quando i contatori segnalano l'utilizzo, potrebbero verificarsi ritardi aggiuntivi.
In alcuni casi, è possibile che non vengano visualizzati i dati di utilizzo non fatturati più recenti dall'inizio del mese fino a quando non vengono recapitati i dati di utilizzo fatturati del mese precedente. Ciò consente di assicurarsi che i dati di utilizzo fatturati vengano distribuiti in modo efficiente all'interno del contratto di servizio. Dopo aver ricevuto i dati di utilizzo fatturati, è possibile iniziare a recuperare tutti i dati di utilizzo non fatturati aggiornati dall'inizio del mese.
Prerequisiti
Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (
customer-tenant-id
). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id
).
C#
Per ottenere un riepilogo dell'utilizzo per tutte le sottoscrizioni di un cliente:
Usare la raccolta IAggregatePartner.Customers per chiamare il metodo ById().
Chiamare la proprietà UsageSummary, seguita dai metodi Get() o GetAsync():
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();
Per un esempio, vedere quanto segue:
- Esempio: App di test della console
- Progetto: PartnerSDK.FeatureSamples
- Classe: GetCustomerUsageSummary.cs
Richiesta REST
Sintassi della richiesta
metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1 |
Parametro URI
Questa tabella elenca il parametro di query necessario per ottenere le informazioni sull'utilizzo valutato del cliente.
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
customer-tenant-id | guid | Y | GUID corrispondente al cliente. |
Intestazioni delle richieste
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Corpo della richiesta
Nessuno.
Esempio di richiesta
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
Risposta REST
In caso di esito positivo, questo metodo restituisce una risorsa CustomerUsageSummary nel corpo della risposta.
Codici di errore e di esito della risposta
Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per un elenco completo, vedere Codici di errore.
Esempio di risposta per la sottoscrizione di Microsoft Azure (MS-AZR-0145P)
In questo esempio, il cliente ha acquistato un'offerta con pagamento in base al consumo di Azure 145P.
Per i clienti con sottoscrizioni di Microsoft Azure (MS-AZR-0145P), non verrà apportata alcuna modifica alla risposta dell'API.
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"budget":{
"ammount":300.000000,
"attributes":{
"objectType":"SpendingBudget"
}
},
"id":"65726577-C208-40FD-9735-8C85AC9CAC68",
"name":"600 test",
"billingStartDate":"2016-02-06T00:00:00-08:00",
"billingEndDate":"2016-03-05T00:00:00-08:00",
"totalCost":0.0,
"currencyLocale":"en-US",
"lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
"links":{
"self":{
"uri":"/customers/{customer-tenant-id}/usagesummary",
"method":"GET",
"headers":[]
}
},
"attributes":{
"objectType":"CustomerUsageSummary"
}
}
Esempio di risposta per il piano di Azure
In questo esempio il cliente ha acquistato un piano di Azure.
Per i clienti con piani di Azure, sono state apportate le modifiche seguenti alla risposta dell'API:
- currencyLocale viene sostituito con currencyCode
- usdTotalCost è un nuovo campo
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"budget": {
"amount": 97,
"attributes": {
"objectType": "SpendingBudget"
}
},
"resourceId": "44908a11-641b-4c53-b7fc-0f2bfca8a581",
"resourceName": "Modern Azure Customer UK",
"billingStartDate": "2019-09-01T00:00:00+00:00",
"billingEndDate": "2019-10-01T00:00:00+00:00",
"totalCost": 28.82860766744404945074,
"currencyCode": "GBP",
"usdTotalCost": 35.23000000000000362337,
"lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
"attributes": {
"objectType": "CustomerUsageSummary"
}
}