Gebruiksoverzicht voor het abonnement van de klant ophalen

Artikel
01/29/2024

Van toepassing op: Partnercentrum | Partnercentrum voor Microsoft Cloud for US Government

U kunt de resource SubscriptionUsageSummary gebruiken om een samenvatting van het abonnementsgebruik voor een klant op te halen. Deze resource vertegenwoordigt het abonnementsgebruiksoverzicht van een specifieke Azure-service of -resource tijdens de huidige factureringsperiode.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met alleen App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de klantenlijst en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
Een abonnements-id

C#

Een samenvatting van het abonnementsgebruik voor het abonnement van een klant ophalen:

Gebruik uw verzameling IAggregatePartner.Customers om de methode ById() aan te roepen.

Roep vervolgens de eigenschap Subscriptions en de eigenschap UsageSummary aan . Voltooien door de methoden Get() of GetAsync() aan te roepen.

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

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

Zie het volgende voor een voorbeeld:

Voorbeeld: Consoletest-app
Project: PartnerSDk.featureSamples
Klasse: GetSubscriptionUsageSummary.cs

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

Deze tabel bevat de vereiste queryparameters om de geclassificeerde gebruiksgegevens van de klant op te halen.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	J	Een GUID die overeenkomt met de klant.
subscription-id	Guid	J	Een GUID die overeenkomt met de id van een abonnement. Voor een Azure-abonnement is dit de id van de bijbehorende Partner Center-abonnementsresource, die het Azure-plan vertegenwoordigt. Geef voor azure-abonnementsresources de plan-id* op als de abonnements-id in deze route.*

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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: 47c36033-af5d-4457-80a4-512c1626fac4

REST-antwoord

Als dit lukt, retourneert deze methode een SubscriptionUsageSummary-resource in de antwoordtekst.

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor een volledige lijst.

Antwoordvoorbeeld voor Microsoft Azure-abonnementen (MS-AZR-0145P)

In dit voorbeeld heeft de klant een 145P Azure PayG-aanbieding gekocht.

Voor klanten met Microsoft Azure-abonnementen (MS-AZR-0145P) wordt het API-antwoord niet gewijzigd.

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

{
    "resourceId": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "id": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "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"
    }
}

REST-antwoordvoorbeeld voor Azure-plan

In dit voorbeeld heeft de klant een Azure-abonnement gekocht.

Voor klanten met Azure-abonnementen zijn er de volgende API-antwoordwijzigingen:

currencyLocale is vervangen door currencyCode
usdTotalCost is een nieuw veld

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac1
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "11111111-dca5-6f31-d3a6-dbbfad9be0fc",
    "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"
    }
}

Delen via