Obtenir les abonnements d’un client
S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government
Comment obtenir une collection d’abonnements d’un 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 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 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).
C#
Pour obtenir la liste de tous les abonnements d’un client, utilisez d’abord la méthode IAggregatePartner.Customers.ById avec l’identificateur client pour identifier le client. Utilisez ensuite la propriété Subscriptions pour récupérer une interface aux opérations de collecte d’abonnements. Enfin, appelez les méthodes Get ou GetAsync pour récupérer la collection d’abonnements du client.
// IAggregatePartner partnerOperations;
// string customerId;
var customerSubscriptions = partnerOperations.Customers.ById(customerId).Subscriptions.Get();
Exemple : Application de test de console. Projet : Classe d’exemples sdk de l’Espace partenaires : GetSubscriptions.cs
Demande REST
Syntaxe de la requête
| Méthode | URI de demande |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions HTTP/1.1 |
Paramètre d’URI
Ce tableau répertorie le paramètre de requête requis pour obtenir tous les abonnements.
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| customer-tenant-id | string | Oui | Chaîne au format GUID qui identifie le client. |
En-têtes de demande
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/<customer-tenant-id>/subscriptions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b2d13828-2ca5-41d4-94fb-9946214f4244
MS-CorrelationId: c49004b1-224f-4d86-a607-6c8bcc52cfdd
Connection: Keep-Alive
Réponse REST
Si elle réussit, cette méthode retourne une collection de ressources d’abonnement dans le corps de la réponse.
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.
Exemples de réponse
Exemple de réponse pour un abonnement services en ligne hérité
HTTP/1.1 200 OK
Content-Length: 73754
Content-Type: application/json
MS-CorrelationId: c49004b1-224f-4d86-a607-6c8bcc52cfdd
MS-RequestId: b2d13828-2ca5-41d4-94fb-9946214f4244
Date: Wed, 25 Nov 2015 05:43:06 GMT
{
"totalCount": 1,
"items": [{
"id": "83ef9d05-4169-4ef9-9657-0e86b1eab1de",
"entitlementId": "a356ac8c-e310-44f4-bf85-C7f29044af99",
"friendlyName": "nickname",
"quantity": 1,
"unitType": "none",
"creationDate": "2015-11-25T06: 41: 12Z",
"effectiveStartDate": "2015-11-24T08: 00: 00Z",
"commitmentEndDate": "2016-12-12T08: 00: 00Z",
"status": "active",
"autoRenewEnabled": false,
"billingType": "none",
"contractType": "subscription",
"links": {
"offer": {
"uri": "/v1/offers/0CCA44D6-68E9-4762-94EE-31ECE98783B9",
"method": "GET",
"headers": []
},
"self": {
"uri": "/subscriptions?key=<key>",
"method": "GET",
"headers": []
}
},
"orderId": "6183db3d-6318-4e52-877e-25806e4971be",
"attributes": {
"etag": "<etag>",
"objectType": "Subscription"
}
}],
"attributes": {
"objectType": "Collection"
}
}
Exemple de réponse pour les nouveaux abonnements commerciaux avec des services en ligne et des logiciels
{
"totalCount": 2,
"items": [
{
"id": "e669812a-8920-452e-dd39-d5f20d61a1b1",
"offerId": "CFQ7TTC0LFLZ:0002:CFQ7TTC0MKD5",
"offerName": "Microsoft 365 E5",
"friendlyName": "Microsoft 365 E5",
"productType": {
"id": "OnlineServicesNCE",
"displayName": "OnlineServicesNCE"
},
"quantity": 1,
"unitType": "Licenses",
"hasPurchasableAddons": false,
"consumptionType": "overage",
"creationDate": "2023-11-28T22:28:50.7842638Z",
"effectiveStartDate": "2023-11-28T00:00:00Z",
"commitmentEndDate": "2023-12-27T00:00:00Z",
"commitmentEndDateTime": "2023-12-27T23:59:59Z",
"cancellationAllowedUntilDate": "2023-12-05T22:29:25.9967858Z",
"billingCycleEndDate": "2023-12-27T00:00:00Z",
"billingCycleEndDateTime": "2023-12-27T23:59:59Z",
"status": "active",
"autoRenewEnabled": true,
"isTrial": false,
"billingType": "license",
"billingCycle": "monthly",
"termDuration": "P1M",
"renewalTermDuration": "",
"refundOptions": [
{
"type": "Full",
"expiresAt": "2023-11-29T22:29:25.9967858Z"
}
],
"isMicrosoftProduct": true,
"partnerId": "",
"attentionNeeded": false,
"actionTaken": false,
"contractType": "subscription",
"links": {
"product": {
"uri": "/products/CFQ7TTC0LFLZ?country=US",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/CFQ7TTC0LFLZ/skus/0002?country=US",
"method": "GET",
"headers": []
},
"availability": {
"uri": "/products/CFQ7TTC0LFLZ/skus/0002/availabilities/CFQ7TTC0MKD5?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/bfb6b398-c7f5-40f0-aa75-a1f1adf81374/subscriptions/e669812a-8920-452e-dd39-d5f20d61a1b1",
"method": "GET",
"headers": []
}
},
"publisherName": "Microsoft Corporation",
"orderId": "f9a896ba4686",
"attributes": {
"objectType": "Subscription"
}
},
{
"id": "71e8b7b6-ce70-4901-cc72-15042a3230a1",
"offerId": "DG7GMGF0GJC2:0003:DG7GMGF0CFC5",
"offerName": "Azure SQL Edge - 1 year",
"friendlyName": "Azure SQL Edge",
"productType": {
"id": "Software",
"displayName": "Software"
},
"quantity": 1,
"unitType": "Licenses",
"hasPurchasableAddons": false,
"creationDate": "2023-11-28T22:21:15.015299Z",
"effectiveStartDate": "2023-11-28T22:21:12.5336906Z",
"commitmentEndDate": "2024-11-27T00:00:00Z",
"commitmentEndDateTime": "2024-11-27T23:59:59Z",
"cancellationAllowedUntilDate": "2023-12-05T22:21:37.7730547Z",
"billingCycleEndDate": "2024-11-27T00:00:00Z",
"billingCycleEndDateTime": "2024-11-27T23:59:59Z",
"status": "active",
"autoRenewEnabled": true,
"isTrial": false,
"billingType": "license",
"billingCycle": "annual",
"termDuration": "P1Y",
"renewalTermDuration": "",
"isMicrosoftProduct": true,
"partnerId": "",
"attentionNeeded": false,
"actionTaken": false,
"contractType": "subscription",
"links": {
"product": {
"uri": "/products/DG7GMGF0GJC2?country=US",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/DG7GMGF0GJC2/skus/0003?country=US",
"method": "GET",
"headers": []
},
"availability": {
"uri": "/products/DG7GMGF0GJC2/skus/0003/availabilities/DG7GMGF0CFC5?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/bfb6b398-c7f5-40f0-aa75-a1f1adf81374/subscriptions/71e8b7b6-ce70-4901-cc72-15042a3230a1",
"method": "GET",
"headers": []
}
},
"publisherName": "Microsoft",
"orderId": "be34ac49aefb",
"attributes": {
"objectType": "Subscription"
}
}
]
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour