Abrufen einer Nutzungszusammenfassung für einen Partner

  • Artikel

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

Sie können die PartnerUsageSummary-Ressource verwenden, um eine Partnernutzungszusammenfassung aller Kunden abzurufen, die während des aktuellen Abrechnungszeitraums einen bestimmten Azure-Dienst oder eine bestimmte Ressource erworben haben.

Der von dieser API zurückgegebene Gesamtbetrag gibt keine Nutzung für Kunden zurück, die über einen Azure-Plan verfügen. Für die Zukunft als veraltet geplant.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.

C#

So rufen Sie eine Nutzungszusammenfassung für alle Kunden ab, die einen bestimmten Azure-Dienst oder eine bestimmte Azure-Ressource während des aktuellen Abrechnungszeitraums erworben haben:

  1. Verwenden Sie Ihren IAggregatePartner.

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

    // IAggregatePartner partnerOperations;

var usageSummary = partnerOperations.UsageSummary.Get();

Ein Beispiel finden Sie im Folgenden:

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

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/v1/usagesummary HTTP/1.1

Anforderungsheader

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

Anforderungstext

Keine.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/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-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine PartnerUsageSummary-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

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

{
    "customersOverBudget": 1,
    "customersTrendingOver": 0,
    "customersWithUsageBasedSubscription": 11,
    "resourceId": "11111111-4574-4539-bc42-0e539b9684c0",
    "id": "11111111-4574-4539-bc42-0e539b9684c0",
    "resourceName": "PLAMUATT2NETNEW",
    "name": "PLAMUATT2NETNEW",
    "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": "/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "PartnerUsageSummary"
    }
}