Získání seznamu dávek zařízení pro konkrétního zákazníka
Platí pro: Partnerské centrum
Jak načíst kolekci dávek zařízení pro zadaného zákazníka.
Každá dávka zařízení obsahuje souhrnné informace o stavu zařízení, která byla zaregistrovaná v bezdotykovém nasazení.
Požadavky
Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (
customer-tenant-id
). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id
).
C#
Pokud chcete získat kolekci dávek zařízení pro zadaného zákazníka, nejprve zavolejte metodu IAggregatePartner.Customers.ById s ID zákazníka a načtěte rozhraní pro operace s určeným zákazníkem. Potom načtěte hodnotu vlastnosti DeviceBatches a získejte rozhraní pro operace dávkového shromažďování zařízení. Nakonec zavolejte metodu Get nebo GetAsync , která kolekci načte.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var devicesBatches =
partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Get();
Ukázka: Testovací aplikace konzoly Project: Partner Center SDK Samples Class: GetDevicesBatches.cs
Požadavek REST
Syntaxe požadavku
Metoda | Identifikátor URI žádosti |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1 |
Parametr identifikátoru URI
Při vytváření požadavku použijte následující parametry cesty.
Název | Typ | Vyžadováno | Popis |
---|---|---|---|
customer-ID | řetězec | Yes | Řetězec ve formátu GUID, který identifikuje zákazníka. |
Hlavičky požadavku
Další informace najdete v tématu Hlavičky REST Partnerského centra.
Text požadavku
Žádné
Příklad požadavku
GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches 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
Odpověď REST
V případě úspěchu obsahuje text odpovědi kolekci prostředků DeviceBatch .
Kódy úspěšných odpovědí a chyb
Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.
Příklad odpovědi
HTTP/1.1 200 OK
Content-Length: 339
Content-Type: application/json; charset=utf-8
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
{
"totalCount": 1,
"items": [{
"id": "Test batch",
"status": "finished",
"creationDate": "2017-07-25T01:51:00",
"devicesCount": 5,
"devicesLink": {
"uri": "/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/Test batch/devices",
"method": "GET",
"headers": []
},
"attributes": {
"objectType": "DeviceBatch"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro