Een abonnement registreren

Artikel
01/11/2024

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.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. 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 het 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 methode IAggregatePartner.Customers.ById aan te roepen met de klant-id om de klant te identificeren. Roep vervolgens de methode Subscription.ById() 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. Zie Registratiestatus van abonnement ophalen voor meer informatie.

// 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

Wijze	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.

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

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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 locatieheader 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 Status van abonnementsregistratie ophalen voor een voorbeeld van hoe u de status ophaalt.

Geslaagde antwoorden en foutcodes

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

Responsvoorbeeld

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

Delen via