Obtenir l’état de provisionnement d’un abonnement

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Comment obtenir l’état d’approvisionnement de l’abonnement pour un abonnement client.

Prerequisites

  • 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 de l’application et de l’utilisateur uniquement.

  • 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 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).

  • Identificateur d’abonnement.

  • Les autorisations d’administrateur déléguées sur l’abonnement sont requises pour effectuer cette opération.

Rôles GDAP

Vous aurez besoin d’au moins l’un des rôles GDAP suivants :

  • Lecteur de répertoire
  • Lecteur général

C#

Pour obtenir l’état d’approvisionnement 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 Subscriptions.ById avec l’ID d’abonnement. Ensuite, utilisez la propriété ProvisioningStatus pour obtenir une interface des opérations d’état d’approvisionnement de l’abonnement actuel, puis appelez la méthode Get ou GetAsync pour récupérer l’objet SubscriptionProvisioningStatus.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

Demande REST

Syntaxe de la requête

Method URI de demande
GET {URL-base}/v1/customers/{id-client}/subscriptions/{id-abonnement}/provisioningstatus 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 Obligatoire 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.

En-têtes de demande

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

Corps de la demande

Aucun.

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Réponse REST

Si elle réussit, le corps de la réponse contient une ressource SubscriptionProvisioningStatus .

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 REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

Remarques

  • Lors d’une attribution de modification de licence, le champ d’état dans SubscriptionProvisioningStatus est défini sur « en attente ».

  • Le champ d’état est mis à jour toutes les 15 minutes.