Eszköz kötegelt feltöltési állapotának lekérése
A következőre vonatkozik: Partnerközpont
Eszközköteg-feltöltés állapotának lekérése egy adott ügyfélhez.
Megfelelő szerepkörök: globális rendszergazda | Rendszergazdai ügynök | Értékesítési ügynök
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Ügyfélazonosító (
customer-tenant-id
). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id
).Az eszköz kötegének elküldésekor a Hely fejlécben visszaadott kötegkövetési azonosító. További információ: Eszközök feltöltése a megadott ügyfélhez.
C#
Az eszközköteg-feltöltés állapotának lekéréséhez először hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval, hogy lekérjen egy felületet a megadott ügyfél műveleteihez. Ezután hívja meg a BatchUploadStatus.ById metódust a kötegkövetési azonosítóval, hogy lekérjen egy felületet a kötegelt feltöltés állapotműveleteihez. Végül hívja meg a Get vagy a GetAsync metódust az állapot lekéréséhez.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedTrackingId;
var status =
partnerOperations.Customers.ById(selectedCustomerId).BatchUploadStatus.ById(selectedTrackingId).Get();
Példa: Konzoltesztelő alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: GetBatchUploadStatus.cs
REST-kérés
Kérés szintaxisa
Módszer | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/batchJobStatus/{batchtracking-id} HTTP/1.1 |
URI-paraméter
A kérés létrehozásakor használja az alábbi elérésiút-paramétereket.
Név | Típus | Kötelező | Leírás |
---|---|---|---|
ügyfél-azonosító | karakterlánc | Igen | Egy GUID formátumú sztring, amely azonosítja az ügyfelet. |
batchtracking-id | karakterlánc | Igen | Egy GUID formátumú azonosító, amely az eszköz kötegfeltöltési állapotának lekérésére szolgál. Ezt az azonosítót a Rendszer a Hely fejlécben adja vissza az eszköz kötegének sikeres elküldésekor. |
Kérelemfejlécek
További információ: Partnerközpont – REST fejlécek.
A kérés törzse
Egyikre sem.
Példa kérése
GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/batchjobstatus/0127ed8e-ff72-4983-a3d8-e8d8bd378932 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST-válasz
Ha sikeres, a válasz egy BatchUploadDetails erőforrást tartalmaz.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.
Példa válaszra
HTTP/1.1 200 OK
Content-Length: 400
MS-CorrelationId: 4a5002a2-0c1b-4e57-b491-dbcf19c0e7b8
MS-RequestId: 7b3e2e00-b330-4480-9d84-59ace713427f
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:52:41 GMT
{
"batchTrackingId": "0127ed8e-ff72-4983-a3d8-e8d8bd378932",
"status": "finished",
"startedTime": "2017-07-25T10:00:00",
"completedTime": "2017-07-25T10:10:00",
"devicesStatus": [{
"serialNumber": "1234567890",
"productKey": "12345-67890-09876-54321-13579",
"status": "finished_with_errors",
"errorCode": "808",
"errorDescription": "ZtdDeviceAssignedToOtherTenant",
"attributes": {
"objectType": "DeviceUploadDetails"
}
}
],
"attributes": {
"objectType": "BatchUploadDetails"
}
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: