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

Articolo
10/07/2024

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: aaaa0000-bb11-2222-33cc-444444dddddd

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