Abrufen der Nutzungszusammenfassung für das Kundenabonnement

Artikel
10/07/2024

Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government

Sie können die SubscriptionUsageSummary-Ressource verwenden, um eine Abonnementnutzungszusammenfassung für einen Kunden abzurufen. Diese Ressource stellt die Zusammenfassung der Abonnementnutzung eines bestimmten Azure-Diensts oder einer bestimmten Ressource während des aktuellen Abrechnungszeitraums dar.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Ein Abonnementbezeichner

C#

So rufen Sie eine Abonnementnutzungszusammenfassung für das Abonnement eines Kunden ab:

Verwenden Sie Ihre IAggregatePartner.Customers-Auflistung , um die ById() -Methode aufzurufen.

Rufen Sie dann die Subscriptions-Eigenschaft und die UsageSummary-Eigenschaft auf. Abschließend rufen Sie die Methoden Get() oder GetAsync() auf.

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

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

Ein Beispiel finden Sie im Folgenden:

„Beispiel: Konsolentest der App
Projekt: PartnerSDK.FeatureSamples
Klasse: GetSubscriptionUsageSummary.cs

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

In dieser Tabelle werden die erforderlichen Abfrageparameter aufgelistet, um die bewerteten Nutzungsinformationen des Kunden abzurufen.

Name	Typ	Erforderlich	BESCHREIBUNG
customer-tenant-id	guid	J	Eine GUID, die dem Kunden entspricht.
abonnement-id	guid	J	Eine GUID, die dem Bezeichner eines Abonnements entspricht. Bei einem Azure-Plan ist dies der Bezeichner der entsprechenden Partner Center-Abonnementressource, die den Azure-Plan darstellt. Geben Sie für Azure Plan-Abonnementressourcen die Plan-ID* als Abonnement-ID in dieser Route an.*

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

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

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine SubscriptionUsageSummary-Ressource im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Eine vollständige Liste finden Sie unter Fehlercodes.

Antwortbeispiel für Microsoft Azure-Abonnements (MS-AZR-0145P)

In diesem Beispiel hat der Kunde ein 145P Azure PayG-Angebot erworben.

Für Kunden mit Microsoft Azure-Abonnements (MS-AZR-0145P) wird die API-Antwort nicht geändert.

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"
    }
}

REST-Antwortbeispiel für Azure-Plan

In diesem Beispiel hat der Kunde einen Azure-Plan erworben.

Für Kunden mit Azure-Plänen gibt es die folgenden API-Antwortänderungen:

currencyLocale wird durch currencyCode ersetzt.
usdTotalCost ist ein neues Feld

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"
    }
}

Teilen über