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.
Granulare delegierte Administratorrechte (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 | Type | Erforderlich | Beschreibung |
---|---|---|---|
Kunden-ID | Zeichenfolge | Ja | Eine guid formatierte Zeichenfolge, die den Kunden identifiziert. |
Abonnement-ID | Zeichenfolge | Ja | Eine guid formatierte Zeichenfolge, die das Abonnement identifiziert. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Anforderungsbeispiel
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 Erfolg oder Fehler und andere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere 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: aaaa0000-bb11-2222-33cc-444444dddddd
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
Das Statusfeld in SubscriptionProvisioningStatus wird während einer Lizenzänderungszuweisung auf "Ausstehend" festgelegt.
Das Statusfeld wird alle 15 Minuten aktualisiert.