Een lijst met de apparaten voor de opgegeven batch en klant ophalen

Artikel
09/11/2024

Van toepassing op: Partnercentrum

In dit artikel wordt beschreven hoe u een verzameling apparaten in een opgegeven apparaatbatch voor een opgegeven klant ophaalt. Elke apparaatresource bevat details over het apparaat.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in 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).
Een batch-id van het apparaat.

C#

Een verzameling apparaten in een opgegeven apparaatbatch ophalen voor de opgegeven klant:

Roep de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant.
Roep de methode DeviceBatches.ById aan om een interface op te halen voor apparaatbatchverzamelingsbewerkingen voor de opgegeven batch.
Haal de eigenschap Apparaten op om een interface op te halen voor apparaatverzamelingsbewerkingen voor de batch.
Roep de methode Get of GetAsync aan om de verzameling apparaten op te halen.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

var devices =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.Get();

Zie het volgende voor een voorbeeld:

Voorbeeld: Console-test-app
Project: Voorbeelden van partnercentrum-SDK
Klasse: GetDevices.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

URI-parameters

Gebruik de volgende padparameters bij het maken van de aanvraag.

Naam	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een tekenreeks in GUID-indeling die de klant identificeert.
devicebatch-id	tekenreeks	Ja	Een tekenreeks-id die de apparaatbatch identificeert.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/testbatch/devices 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 antwoordtekst een gepaginade verzameling apparaatresources. De verzameling bevat 100 apparaten op een pagina. Als u de volgende pagina van 100 apparaten wilt ophalen, moet het continuationToken in de antwoordtekst worden opgenomen in de volgende aanvraag als een MS-ContinuationToken-header.

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor een volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 1742
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": 2,
    "items":
    [{
            "id": "7c141ea9-2816-4e15-a819-53f6856499ff",
            "serialNumber": "2R9-ZNP67",
            "productKey": "00329-00000-0003-AA6069",
            "modelName": "Precision WorkStation T7500",
            "oemManufacturerName":"Dell Inc.",
            "policies":[{
                    "key": "o_o_b_e",
                    "value": null
                }
            ],
            "uploadedDate":"2017-08-09T14:43:26.0092288-07:00",
            " attributes": {
                "objectType": "Device"
            }
        }, {
            "id": "e528a62f-5031-49f4-bea7-5fafe47388fd",
            "serialNumber": "1234567890",
            "productKey": "12345-67890-09876-54321-13579",
            "modelName": "HP Z420 Workstation",
            "oemManufacturerName": "Hewlett-Packard",
            "policies": [{
                    "key": "o_o_b_e",
                    "value": null
                }
            ],
            "uploadedDate": "2017-08-09T14:35:51.3126144-07:00",
            "attributes": {
                "objectType": "Device"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Delen via