Een lijst met de batches van een apparaat voor de opgegeven klant ophalen

Artikel
03/08/2025

Van toepassing op: Partnercentrum

Hoe een verzameling apparaatbatches voor de opgegeven klant op te halen.

Elke apparaatbatch bevat samenvattingsstatusinformatie over apparaten die zijn ingeschreven bij zero-touch-implementatie.

Juiste rollen: Beheerdersagent | Verkoopagent

Vereisten

Referenties zoals beschreven in Partnercentrum-authenticatie. 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: Partnercentrum-SDK-voorbeelden Class: 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 GUID-geformatteerde tekenreeks die een unieke identificatie van de klant biedt.

Aanvraagheaders

Zie voor meer informatie Partnercentrum REST-headers.

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 of de aanvraag is geslaagd of mislukt, samen met aanvullende informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum REST-foutcodes 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"
    }
}

Delen via