Obtenir l’état d’inscription d’un abonnementGet subscription registration status

S’applique àApplies To

  • Espace partenairesPartner Center

Comment obtenir l’état d’inscription d’un abonnement client qui a été activé pour l’achat de Azure Reserved VM Instances.How to get the subscription registration status for a customer subscription that has been enabled for purchasing Azure Reserved VM Instances.

Pour acheter une instance de machine virtuelle réservée Azure à l’aide de l’API espace partenaires, vous devez disposer d’au moins un abonnement Azure CSP existant.To purchase an Azure Reserved VM Instance using the Partner Center API, you must have at least one existing CSP Azure subscription. La méthode inscrire un abonnement vous permet d’inscrire votre abonnement Azure CSP existant et de l’activer pour l’achat de Azure reserved VM instances.The Register a subscription method allows you to register your existing CSP Azure subscription, enabling it for purchasing Azure Reserved VM Instances. Cette méthode vous permet de récupérer l’état de cette inscription.This method allows you to retrieve the status of that registration.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • ID d’abonnement.A subscription ID.

C#C#

Pour obtenir l’état d’inscription d’un abonnement, commencez par utiliser la méthode collection iaggregatepartner. Customers. méthode BYID avec l’ID client pour identifier le client.To get the registration status of a subscription, begin by using the IAggregatePartner.Customers.ById method with the customer ID to identify the customer. Ensuite, récupérez une interface pour les opérations d’abonnement en appelant la méthode subscription. méthode BYID () avec l’ID d’abonnement pour identifier l’abonnement.Then, get an interface to subscription operations by calling the Subscription.ById() method with the subscription ID to identify the subscription. Ensuite, utilisez la propriété RegistrationStatus pour obtenir une interface pour les opérations d’état d’inscription de l’abonnement actuel et appelez la méthode obtenir ou GetAsync pour récupérer l’objet SubscriptionRegistrationStatus .Next, use the RegistrationStatus property to obtain an interface to the current subscription's registration status operations, and call the Get or GetAsync method to retrieve the SubscriptionRegistrationStatus object.

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

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/Customers/{Customer-ID}/subscriptions/{subscription-ID}/RegistrationStatus http/1.1{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

Paramètres d’URIURI parameters

Utilisez les paramètres de chemin d’accès suivants pour identifier le client et l’abonnement.Use the following path parameters to identify the customer and subscription.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-idcustomer-id stringstring OuiYes Chaîne au format GUID qui identifie le client.A GUID formatted string that identifies the customer.
subscription-idsubscription-id stringstring OuiYes Chaîne au format GUID qui identifie l’abonnement.A GUID formatted string that identifies the subscription.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Aucun.None.

Exemple de requêteRequest example

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: 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 RESTREST response

En cas de réussite, le corps de la réponse contient une ressource SubscriptionRegistrationStatus .If successful, the response body contains a SubscriptionRegistrationStatus resource.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

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