Obtenir l’état de provisionnement d’un abonnement

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.

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 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 de privilèges d’administrateur délégué granulaires (GDAP)

Vous avez 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

Paramètres d’URI

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

En-têtes de requête

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

Corps de la demande

Aucune.

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. 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: aaaa0000-bb11-2222-33cc-444444dddddd
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"
    }
}

Notes

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

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