Obtenir l’état d’inscription d’un abonnement

  • Article

Comment obtenir le status d’inscription d’abonnement pour un abonnement client qui a été activé pour l’achat d’instances de machines virtuelles réservées Azure.

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. La méthode Inscrire un abonnement vous permet d’inscrire votre abonnement Azure CSP existant, ce qui vous permet d’acheter des instances de machine virtuelle réservée Azure. Cette méthode vous permet de récupérer les status de cette inscription.

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 des informations d’identification d’application autonome et d’application+utilisateur.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace 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 obtenir la status d’inscription d’un abonnement, commencez par utiliser la méthode IAggregatePartner.Customers.ById avec l’ID client pour identifier le client. Ensuite, obtenez une interface pour les opérations d’abonnement en appelant la méthode Subscription.ById() avec l’ID d’abonnement pour identifier l’abonnement. Ensuite, utilisez la propriété RegistrationStatus pour obtenir une interface vers les opérations d’inscription status de l’abonnement actuel, puis appelez la méthode Get ou GetAsync pour récupérer l’objet SubscriptionRegistrationStatus.

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

Syntaxe de la requête

Méthode URI de requête
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus HTTP/1.1

Paramètres URI

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

Nom Type Obligatoire Description
customer-id string Oui Chaîne au format GUID qui identifie le client.
subscription-id string Oui Chaîne au format GUID qui identifie l’abonnement.

En-têtes de requête

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

Corps de demande

Aucun.

Exemple de requête

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 REST

En cas de réussite, le corps de la réponse contient une ressource SubscriptionRegistrationStatus .

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 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"
    }
}