Obtenir la liste des commandes par client et le type de cycle de facturation
S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government
Obtient une collection de ressources Order qui correspondent à un client donné et cycle de facturation type. Il y a un délai allant jusqu’à 15 minutes entre le moment où une commande est envoyée et lorsqu’elle apparaît dans une collection de commandes 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 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).
C#
Pour obtenir une collection de commandes d’un client :
Utilisez votre collection IAggregatePartner.Customers et appelez la méthode ById() avec l’ID client sélectionné.
Appelez la propriété Orders et la méthode ByBillingCycleType() avec votre BillingCycleType spécifié.
Appelez la méthode Get() ou GetAsync().
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// BillingCycleType selectedBillingCycleType;
var orders = partnerOperations.Customers.ById(selectedCustomerId).Orders.ByBillingCycleType(selectedBillingCycleType).Get();
Demande REST
Syntaxe de la requête
| Méthode | URI de demande |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/orders ?billingType={billing-cycle-type} HTTP/1.1 |
Paramètres d’URI
Ce tableau répertorie les paramètres de requête requis pour obtenir une collection de commandes par ID client et cycle de facturation type.
| Nom | Type | Requise | Description |
|---|---|---|---|
| customer-tenant-id | string | Oui | Chaîne au format GUID correspondant au client. |
| billing-cycle-type | string | Non | Chaîne correspondant au type cycle de facturation. |
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/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders?billingType=onetime HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0e5fc923-8e3c-4560-9100-ce7283c3e081
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
Connection: Keep-Alive
Réponse REST
Si elle réussit, cette méthode retourne une collection de ressources Order dans le corps de la réponse.
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.
Exemple de réponse
HTTP/1.1 200 OK
Content-Length: 22463
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 97fa8b4f-6576-4cd9-dd19-ac7c97a023a7
MS-RequestId: 3c6a034c-82ee-4095-d50f-9b530a415f1f
MS-CV: nb4/b3Yl2keY0eYR.0
MS-ServerId: 202010607
Date: Thu, 15 Mar 2018 20:44:40 GMT
{
"totalCount": 2,
"items": [
{
"id": "9qg-ErcO-4MPbPqq_3MIQaS7bn8W6HfG1",
"referenceCustomerId": "b0d70a69-4c42-4b27-b17b-91a835d8686a",
"billingCycle": "one_time",
"currencyCode": "USD",
"lineItems": [
{
"lineItemNumber": 0,
"offerId": "DZH318Z0BQ4B:000Z:DZH318Z0DSPL",
"friendlyName": "Reserved_VM_Instance_Standard_D1_AP_East_1_Year",
"quantity": 1,
"links": {
"sku": {
"uri": "/products/DZH318Z0BQ4B/skus/000Z?country=US",
"method": "GET",
"headers": []
}
}
}
],
"creationDate": "2018-03-15T02:17:15.6455674Z",
"status": "pending",
"links": {
"provisioningStatus": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/9qg-ErcO-4MPbPqq_3MIQaS7bn8W6HfG1/provisioningstatus",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/9qg-ErcO-4MPbPqq_3MIQaS7bn8W6HfG1",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Order"
}
},
{
"id": "s-BZlr_TeGksPNT61SsWRL-sqMaKbyVa1",
"referenceCustomerId": "b0d70a69-4c42-4b27-b17b-91a835d8686a",
"billingCycle": "one_time",
"currencyCode": "USD",
"lineItems": [
{
"lineItemNumber": 0,
"offerId": "DZH318Z0BQ4Z:002P:DZH318Z0CL2D",
"friendlyName": "Reserved_VM_Instance_Standard_NC12_AU_East_3_Years",
"quantity": 1,
"links": {
"sku": {
"uri": "/products/DZH318Z0BQ4Z/skus/002P?country=US",
"method": "GET",
"headers": []
}
}
}
],
"creationDate": "2018-03-15T01:42:36.8440279Z",
"status": "pending",
"links": {
"provisioningStatus": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/s-BZlr_TeGksPNT61SsWRL-sqMaKbyVa1/provisioningstatus",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/s-BZlr_TeGksPNT61SsWRL-sqMaKbyVa1",
"method": "GET",
"headers": []
}
},
"attributes": { "objectType": "Order" }
}
],
"links": {
"self": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType":
"Collection"
}
}