Hämta en kunds alla beställningar
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
Hämtar en samling av alla beställningar för en angiven kund. Det finns en fördröjning på upp till 15 minuter mellan den tid då en beställning skickas och när den visas i en samling av en kunds beställningar.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id
).
C#
Så här hämtar du en samling av alla en kunds beställningar:
Använd din IAggregatePartner.Customers-samling och anropa metoden ById().
Anropa egenskapen Orders följt av metoderna Get() eller GetAsync().
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var orders = partnerOperations.Customers.ById(selectedCustomerId).Orders.Get();
Exempel: Konsoltestapp. Projekt: PartnerSDK.FeatureSamples-klass: GetOrders.cs
REST-begäran
Syntax för begäran
Metod | URI för förfrågan |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/orders HTTP/1.1 |
URI-parameter
Använd följande frågeparameter för att hämta alla beställningar.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
customer-tenant-id | sträng | Ja | En GUID-formaterad sträng som motsvarar kunden. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Inga.
Exempel på begäran
GET https://api.partnercenter.microsoft.com/v1/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0e5fc923-8e3c-4560-9100-ce7283c3e081
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: Keep-Alive
REST-svar
Om det lyckas returnerar den här metoden en samling orderresurser i svarstexten.
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Felkoder.
Svarsexempel
HTTP/1.1 200 OK
Content-Length: 22463
Content-Type: application/json; charset=utf-8
MS-RequestId: 0e5fc923-8e3c-4560-9100-ce7283c3e081
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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": "eeba9d00-7b46-443a-917e-22887a8fc993",
"referenceCustomerId": "b0d70a69-4c42-4b27-b17b-91a835d8686a",
"billingCycle": "monthly",
"currencyCode": "USD",
"lineItems": [
{
"lineItemNumber": 0,
"offerId": "E59159FC-6F67-4599-B3CB-17FF4020F643",
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"friendlyName": "Azure Active Directory Premium P2",
"quantity": 1,
"links": {
"subscription": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/84A661C4-E949-4BD2-A560-ED7766FCAF2B/skus/E59159FC-6F67-4599-B3CB-17FF4020F643",
"method": "GET",
"headers": []
},
"provisioningStatus": {
"uri": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus",
"method": "GET",
"headers": []
}
}
],
"creationDate": "2018-03-06T17:37:05.253-08:00",
"status": "completed",
"links": {
"self": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/eeba9d00-7b46-443a-917e-22887a8fc993",
"method": "GET",
"headers": []
}
},
"attributes": {
"etag": "eyJpZCI6ImVlYmE5ZDAwLTdiNDYtNDQzYS05MTdlLTIyODg3YThmYzk5MyIsInZlcnNpb24iOjF9",
"objectType": "Order"
}
}
],
"links": {
"self": {
"uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}