Freigeben über


Abrufen einer Nutzungszusammenfassung für alle Abonnements eines Kunden

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

Sie können die CustomerUsageSummary-Ressource verwenden, um die Nutzung eines bestimmten Azure-Diensts oder einer bestimmten Ressource eines Kunden während des aktuellen Abrechnungszeitraums abzurufen.

Hinweis

Im Allgemeinen sind die täglich bewerteten nicht berechneten Nutzungsdaten über die API oder das Partner Center-Portal nach 24 Stunden verfügbar. Abhängig von Ihrem Standort und dem Zeitpunkt, an dem der Meter die Nutzung meldet, können zusätzliche Verzögerungen auftreten.

Manchmal werden die neuesten nicht abgerechneten Nutzungsdaten vom Anfang des Monats bis zu den in Rechnung gestellten Nutzungsdaten des vorherigen Monats nicht angezeigt. Dadurch wird sichergestellt, dass die in Rechnung gestellten Nutzungsdaten effizient innerhalb der SLA bereitgestellt werden. Sobald Sie die in Rechnung gestellten Nutzungsdaten erhalten haben, können Sie mit dem Abrufen aller aktualisierten nicht berechneten Nutzungsdaten am Anfang des Monats beginnen.

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 Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

C#

So erhalten Sie eine Nutzungszusammenfassung für alle Abonnements eines Kunden:

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

  2. Rufen Sie die UsageSummary-Eigenschaft auf, gefolgt von den Methoden "Get()" oder "GetAsync()":

    // IAggregatePartner partnerOperations;
    // var selectedCustomerId as string;
    
    var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();
    

Ein Beispiel finden Sie in den folgenden Themen:

  • Beispiel: Konsolentest-App
  • Projekt: PartnerSDK.FeatureSamples
  • Klasse: GetCustomerUsageSummary.cs

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt, um die vom Kunden bewerteten Nutzungsinformationen abzurufen.

Name Type Erforderlich Beschreibung
customer-tenant-id guid J Eine GUID, die dem Kunden entspricht.

Anforderungsheader

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

Anforderungstext

Keine.

Beispiel für eine Anfrage

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

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode eine CustomerUsageSummary-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 (MS-AZR-0145P)-Abonnement

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

Für Kunden mit Microsoft Azure-Abonnements (MS-AZR-0145P) gibt es keine Änderung an der API-Antwort.

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

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 Änderungen an der API-Antwort:

  • currencyLocale wird durch currencyCode ersetzt
  • usdTotalCost ist ein neues Feld.
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"
    }
}