Ottenere tutti gli ordini di un cliente
si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti
Ottiene una raccolta di tutti gli ordini per un cliente specificato. Tra il momento in cui un ordine viene inviato e quando appare in una raccolta di ordini di un cliente c'è un ritardo fino a 15 minuti.
Prerequisiti
Credenziali come descritto in autenticazione del Centro per i Partner. Questo scenario supporta l'autenticazione con credenziali App autonome e App+Utente.
ID cliente (
customer-tenant-id
). Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente, cercare l'ID Microsoft nella sezione Informazioni sull'Account Cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id
).
C#
Per ottenere una raccolta di tutti gli ordini di un cliente:
Utilizza la raccolta IAggregatePartner.Customers e chiama il metodo ById().
Chiamare la proprietà Orders, seguita dai metodi Get() o GetAsync().
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var orders = partnerOperations.Customers.ById(selectedCustomerId).Orders.Get();
Esempio: Applicazione di test per console. Project: PartnerSDK.FeatureSamples Class: GetOrders.cs
Richiesta REST
Sintassi della richiesta
Metodo | URI della richiesta |
---|---|
OTTIENI | {baseURL}/v1/customers/{customer-tenant-id}/orders HTTP/1.1 |
Parametro URI
Usare il parametro di query seguente per ottenere tutti gli ordini.
Nome | Digitare | Obbligatorio | Descrizione |
---|---|---|---|
id-cliente-inquilino | corda | Sì | Stringa formattata come GUID corrispondente al cliente. |
Intestazioni della richiesta
Per ulteriori informazioni, vedere intestazioni REST Partner Center.
Corpo della richiesta
Nessuno.
Esempio di richiesta
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
Risposta REST
In caso di esito positivo, questo metodo restituisce una raccolta di risorse Order nel corpo della risposta.
Codici di errore e esito positivo della risposta
Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedere codici di errore .
Esempio di risposta
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"
}
}