Abrufen des Abonnementregistrierungsstatus

  • Artikel

Hier erfahren Sie, wie Sie die Abonnementregistrierung status für ein Kundenabonnement abrufen, das für den Kauf von reservierten Azure-VM-Instanzen aktiviert wurde.

Um eine reservierte Azure-VM-Instanz mithilfe der Partner Center-API zu erwerben, benötigen Sie mindestens ein vorhandenes CSP-Azure-Abonnement. Mit der Methode Abonnement registrieren können Sie Ihr vorhandenes CSP-Azure-Abonnement registrieren und es für den Kauf reservierter Azure-VM-Instanzen aktivieren. Mit dieser Methode können Sie die status dieser Registrierung abrufen.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung sowohl mit eigenständigen App- als auch mit App+Benutzeranmeldeinformationen.

  • Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden 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 Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

  • Eine Abonnement-ID.

C#

Um die Registrierung status 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 Subscription.ById()- Methode mit der Abonnement-ID aufrufen, um das Abonnement zu identifizieren. Verwenden Sie als Nächstes die RegistrationStatus-Eigenschaft, um eine Schnittstelle für die Registrierungs- status Vorgänge des aktuellen Abonnements abzurufen, und rufen Sie die Get- oder GetAsync-Methode auf, um das SubscriptionRegistrationStatus-Objekt abzurufen.

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus 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.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

REST-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext eine SubscriptionRegistrationStatus-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 findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}