Registrieren eines Abonnements

  • Artikel

Registrieren Sie ein vorhandenes Abonnement , damit es für die Bestellung von Azure Reservations aktiviert ist.

Um eine Azure-Reservierung zu erwerben, müssen Sie über mindestens ein vorhandenes CSP Azure-Abonnement verfügen. Mit dieser Methode können Sie Ihr vorhandenes CSP Azure-Abonnement registrieren und es für den Kauf von Azure Reservations aktivieren.

Voraussetzungen

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

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

  • Eine Abonnement-ID.

C#

Rufen Sie zum Registrieren des Abonnements eines Kunden eine Schnittstelle zu Abonnementvorgängen ab, indem Sie die Methode "IAggregatePartner.Customers.ById " mit der Kunden-ID aufrufen, um den Kunden zu identifizieren. Rufen Sie dann die Subscription.ById() -Methode mit der Abonnement-ID auf, um das Abonnement zu identifizieren, das Sie registrieren.

Rufen Sie schließlich die Registration.Register()- Methode auf, um das Abonnement zu registrieren und einen URI abzurufen, der zum Abrufen des Abonnementregistrierungsstatus verwendet werden kann. Weitere Informationen finden Sie unter "Abonnementregistrierungsstatus abrufen".

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

// Retrieve the subscription registration details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).Registration.Register();

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
POST {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations 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.
subscription-id Zeichenfolge Ja Eine guid formatierte Zeichenfolge, die das Abonnement identifiziert. Partner sollten die Azure-Plan-ID für neue Commerce-Fälle verwenden.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Beispiel für eine Anfrage

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrations 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

Wenn die Antwort erfolgreich verläuft, enthält die Antwort einen Location-Header mit einem URI, der zum Abrufen des Abonnementregistrierungsstatus verwendet werden kann. Speichern Sie diesen URI für die Verwendung mit anderen verwandten REST-APIs. Ein Beispiel zum Abrufen des Status finden Sie unter Abrufen des Abonnementregistrierungsstatus.

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.

Beispielantwort

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525