Uzyskiwanie stanu aprowizacji zamówień
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Odpowiednie role: Agent administracyjny
Pobiera kolekcję stanu aprowizacji elementu zamówienia dla zamówienia.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id
). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id
).Identyfikator zamówienia.
C#
Aby uzyskać stan aprowizacji zamówienia, użyj następującego fragmentu kodu:
// Retrieve an order's provisioning status.
var customerOrder = partnerOperations.Customers.ById(customerId).Orders.ById(orderId).Get();
var provisioningStatusList = partnerOperations.Customers.ById(customerId).Orders.ById(customerOrder.Id).ProvisioningStatus.Get();
Żądanie REST
Składnia żądania
Method | Identyfikator URI żądania |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/orders/{order-id}/provisioningstatus HTTP/1.1 |
Parametry identyfikatora URI
Użyj następujących parametrów ścieżki, aby zidentyfikować klienta i subskrypcję.
Nazwisko | Type | Wymagania | opis |
---|---|---|---|
identyfikator klienta | string | Tak | Identyfikator GUID sformatowany ciąg identyfikujący klienta. |
order-id | string | Tak | Ciąg identyfikujący zamówienie. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak.
Przykład żądania
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/orders/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/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
Odpowiedź REST
W przypadku powodzenia treść odpowiedzi zawiera zasób OrderLineItemProvisioningStatus .
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.
Przykład odpowiedzi
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
{
"totalCount": 1,
"items": [
{
"orderLineItemId": 0,
"lineItemNumber": 0,
"status": "fulfilled",
"quantityProvisioningInformation": [
{
"quantity": 1,
"status": "fulfilled"
}
]
}
],
"attributes": {
"objectType": "Collection"
}
}