Abrufen des Abonnementbereitstellungsstatus

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

So erhalten Sie den Bereitstellungsstatus des Abonnements für ein Kundenabonnement.

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).

  • Ein Abonnementbezeichner.

  • Zum Ausführen dieses Vorgangs sind delegierte Administratorberechtigungen für das Abonnement erforderlich.

GDAP-Rollen

Sie benötigen mindestens eine der folgenden GDAP-Rollen:

  • Verzeichnis lesen
  • Globaler Leser

C#

Um den Bereitstellungsstatus eines Abonnements abzurufen, verwenden Sie zunächst die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID, um den Kunden zu identifizieren. Rufen Sie dann eine Schnittstelle zu Abonnementvorgängen ab, indem Sie die Subscriptions.ById-Methode mit der Abonnement-ID aufrufen. Verwenden Sie als Nächstes die ProvisioningStatus-Eigenschaft, um eine Schnittstelle zu den Bereitstellungsstatusvorgängen des aktuellen Abonnements abzurufen, und rufen Sie dann die Get- oder GetAsync-Methode auf, um das SubscriptionProvisioningStatus-Objekt abzurufen.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {Basis-URL}/v1/customers/{Kunden-ID}/subscriptions/{Abonnement-ID}/provisioningstatus HTTP/1.1

URI-Parameter

Verwenden Sie die folgenden Pfadparameter, um den Kunden und das Abonnement zu identifizieren.

Name Typ Erforderlich Beschreibung
Kunden-ID Zeichenfolge Ja Eine guid formatierte Zeichenfolge, die den Kunden identifiziert.
subscription-id Zeichenfolge Ja Eine guid formatierte Zeichenfolge, die das Abonnement identifiziert.

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/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext eine SubscriptionProvisioningStatus-Ressource .

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. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

Hinweise

  • Während einer Lizenzänderungszuweisung wird das Statusfeld in SubscriptionProvisioningStatus auf "Ausstehend" festgelegt.

  • Das Statusfeld wird alle 15 Minuten aktualisiert.