Een lijst met de batches van een apparaat voor de opgegeven klant ophalen
Van toepassing op: Partnercentrum
Een verzameling apparaatbatches ophalen voor de opgegeven klant.
Elke apparaatbatch bevat samenvattingsstatusinformatie over apparaten die zijn ingeschreven bij zero-touch-implementatie.
Juiste rollen: Beheerdersagent | Verkoopagent
Vereisten
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (
customer-tenant-id
). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id
).
C#
Als u de verzameling apparaatbatches voor de opgegeven klant wilt ophalen, roept u eerst de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant. Haal vervolgens de waarde van de eigenschap DeviceBatches op om een interface op te halen voor batchverzamelingsbewerkingen voor apparaten. Roep ten slotte de methode Get of GetAsync aan om de verzameling op te halen.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var devicesBatches =
partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Get();
Voorbeeld: consoletest-app. Project: Voorbeeldklasse partnercentrum-SDK: GetDevicesBatches.cs
REST-aanvraag
Aanvraagsyntaxis
Wijze | Aanvraag-URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1 |
URI-parameter
Gebruik de volgende padparameters bij het maken van de aanvraag.
Name | Type | Vereist | Beschrijving |
---|---|---|---|
klant-id | tekenreeks | Ja | Een tekenreeks met GUID-indeling die de klant identificeert. |
Aanvraagheaders
Zie Rest-headers in Partnercentrum voor meer informatie.
Aanvraagtekst
Geen
Aanvraagvoorbeeld
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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST-antwoord
Als dit lukt, bevat de hoofdtekst van het antwoord de verzameling DeviceBatch-resources .
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.
Responsvoorbeeld
HTTP/1.1 200 OK
Content-Length: 339
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
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"
}
}