Ottenere un riepilogo dell'utilizzo per tutte le sottoscrizioni di un cliente

Articolo
03/07/2025

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 specifica 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 in 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 il ID Microsoft nella sezione informazioni sull'account cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

C#

Per ottenere un riepilogo dell'utilizzo per tutte le sottoscrizioni di un cliente:

Utilizza 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: l'app di test 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	Digitare	Obbligatorio	Descrizione
ID cliente-locatario	guid	Y	GUID corrispondente al cliente.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST del Centro 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: aaaa0000-bb11-2222-33cc-444444dddddd

Risposta REST

In caso di esito positivo, questo metodo restituisce un risorsa CustomerUsageSummary nel corpo della risposta.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo 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 145P Azure PayG.

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: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "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"
    }
}

Condividi tramite