Inscrire un abonnement

  • Article

Inscrivez un abonnement existant afin qu’il soit activé pour commander des réservations Azure.

Pour acheter une réservation Azure, vous devez disposer d’au moins un abonnement Azure CSP existant. Cette méthode vous permet d’inscrire votre abonnement Azure CSP existant, ce qui lui permet d’acheter des réservations Azure.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

  • ID d’abonnement.

C#

Pour inscrire l’abonnement d’un client, récupérez une interface aux opérations d’abonnement en appelant la méthode IAggregatePartner.Customers.ById avec l’ID client pour identifier le client. Ensuite, appelez la méthode Subscription.ById() avec l’ID d’abonnement pour identifier l’abonnement que vous inscrivez.

Enfin, appelez la méthode Registration.Register() pour inscrire l’abonnement et récupérer un URI qui peut être utilisé pour obtenir l’état d’inscription de l’abonnement. Pour plus d’informations, consultez Obtenir l’état de l’inscription d’abonnement.

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

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

Demande REST

Syntaxe de la requête

Méthode URI de demande
POST {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations HTTP/1.1

Paramètres d’URI

Utilisez les paramètres de chemin d’accès suivants pour identifier le client et l’abonnement.

Nom Type Requise Description
id-client string Oui Chaîne au format GUID qui identifie le client.
subscription-id string Oui Chaîne au format GUID qui identifie l’abonnement. Les partenaires doivent utiliser l’ID de plan Azure pour les nouveaux cas de commerce.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucun.

Exemple de requête

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

Réponse REST

Si elle réussit, la réponse contient un en-tête Location avec un URI qui peut être utilisé pour récupérer l’état d’inscription de l’abonnement. Enregistrez cet URI à utiliser avec d’autres API REST associées. Pour obtenir un exemple de récupération de l’état, consultez Obtenir l’état d’inscription de l’abonnement.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

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