Freigeben über


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.