Delen via


Een abonnement registreren

Registreer een bestaand -abonnement zodat het is ingeschakeld voor het bestellen van Azure-reserveringen.

Als u een Azure-reservering wilt aanschaffen, moet u ten minste één bestaand CSP Azure-abonnement hebben. Met deze methode kunt u uw bestaande CSP Azure-abonnement registreren, zodat u dit kunt inschakelen voor het aanschaffen van Azure-reserveringen.

Voorwaarden

  • Referenties zoals beschreven in Partner Center-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

  • Een abonnements-id.

C#

Als u het abonnement van een klant wilt registreren, haalt u een interface op voor abonnementsbewerkingen door de IAggregatePartner.Customers.ById-methode aan te roepen met de klant-id om de klant te identificeren. Roep vervolgens de Subscription.ById() methode aan met de abonnements-id om het abonnement te identificeren dat u registreert.

Roep tot slot de methode Registration.Register() aan om het abonnement te registreren en een URI op te halen die kan worden gebruikt om de registratiestatus van het abonnement op te halen. Voor meer informatie, zie Abonnementregistratiestatus.

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

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

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
POST {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations HTTP/1.1

URI-parameters

Gebruik de volgende padparameters om de klant en het abonnement te identificeren.

Naam Type Vereist Beschrijving
klant-id snaar Ja Een GUID-formaat tekenreeks die de klant identificeert.
subscription-id snaar Ja Een tekenreeks met GUID-indeling die het abonnement identificeert. Partners moeten de Azure-plan-id gebruiken voor nieuwe commercecases.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraaginhoud

Geen.

Voorbeeld aanvraag

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: 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-antwoord

Als dit lukt, bevat het antwoord een Location header met een URI die kan worden gebruikt om de registratiestatus van het abonnement op te halen. Sla deze URI op voor gebruik met andere gerelateerde REST API's. Zie Registratiestatus van het abonnement ophalenvoor een voorbeeld van hoe u de status ophaalt.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of de actie succesvol was of is mislukt, en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525