Abrufen des Abonnementbereitstellungsstatus
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.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für