Abrufen des Abonnementregistrierungsstatus

Artikel
02/05/2024

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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

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

Freigeben über