Ottenere il riepilogo dell'utilizzo per la sottoscrizione del cliente

Articolo
10/07/2024

Si applica a: Centro per i partner | Centro per i partner per Microsoft Cloud for US Government

È possibile usare la risorsa SubscriptionUsageSummary per ottenere un riepilogo dell'utilizzo della sottoscrizione per un cliente. Questa risorsa rappresenta il riepilogo dell'utilizzo della sottoscrizione di un servizio o di una risorsa di Azure specifico durante il periodo di fatturazione corrente.

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 dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
Identificatore di sottoscrizione

C#

Per ottenere un riepilogo dell'utilizzo della sottoscrizione per la sottoscrizione di un cliente:

Usare la raccolta IAggregatePartner.Customers per chiamare il metodo ById().

Chiamare quindi la proprietà Subscriptions e la proprietà UsageSummary . Fine chiamando i metodi Get() o GetAsync().

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// var selectedSubscriptionId as string;

var subscriptionUsageSummary = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageSummary.Get();

Per un esempio, vedere quanto segue:

Esempio: App di test della console
Progetto: PartnerSDK.FeatureSamples
Classe: GetSubscriptionUsageSummary.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/usagesummary HTTP/1.1

Parametri URI

Questa tabella elenca i parametri di query necessari per ottenere le informazioni di utilizzo valutate del cliente.

Nome	Tipo	Obbligatoria	Descrizione
customer-tenant-id	guid	S	GUID corrispondente al cliente.
id sottoscrizione	guid	S	GUID corrispondente all'identificatore di una sottoscrizione. Per un piano di Azure, si tratta dell'identificatore della risorsa di sottoscrizione del Centro per i partner corrispondente, che rappresenta il piano di Azure. Per le risorse della sottoscrizione del piano di Azure, specificare l'ID piano* come id sottoscrizione in questa route.*

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-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 SubscriptionUsageSummary 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 le sottoscrizioni di Microsoft Azure (MS-AZR-0145P)

In questo esempio, il cliente ha acquistato un'offerta Azure PayG 145P .

Per i clienti con sottoscrizioni microsoft Azure (MS-AZR-0145P), non verrà apportata alcuna modifica alla risposta 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

{
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Microsoft Azure",
    "name": "Microsoft Azure",
    "billingStartDate": "2019-08-28T00:00:00-07:00",
    "billingEndDate": "2019-09-27T00:00:00-07:00",
    "totalCost": 22.861172,
    "currencyLocale": "fr-FR",
    "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Esempio di risposta REST per il piano di Azure

In questo esempio il cliente ha acquistato un piano di Azure.

Per i clienti con piani di Azure, sono disponibili le modifiche seguenti alla risposta api:

currencyLocale viene sostituito con currencyCode
usdTotalCost è un nuovo campo

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
    "resourceName": "Azure plan",
    "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",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Condividi tramite