Hämta en lista över enheter för den angivna batchen och kunden

Artikel
09/11/2024

Gäller för: Partnercenter

Den här artikeln beskriver hur du hämtar en samling enheter i en angiven enhetsbatch för en angiven kund. Varje enhetsresurs innehåller information om enheten.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och app+användarautentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
En enhetsbatchidentifierare.

C#

Så här hämtar du en samling enheter i en angiven enhetsbatch för den angivna kunden:

Anropa metoden IAggregatePartner.Customers.ById med kund-ID:t för att hämta ett gränssnitt för åtgärder på den angivna kunden.
Anropa metoden DeviceBatches.ById för att hämta ett gränssnitt till batchsamlingsåtgärder för enheten för den angivna batchen.
Hämta egenskapen Enheter för att hämta ett gränssnitt för enhetsinsamlingsåtgärder för batchen.
Anropa metoden Get eller GetAsync för att hämta samlingen med enheter.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

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

Ett exempel finns i följande:

Exempel: Konsoltestapp
Projekt: SDK-exempel för Partnercenter
Klass: GetDevices.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

URI-parametrar

Använd följande sökvägsparametrar när du skapar begäran.

Namn	Typ	Obligatorisk	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
devicebatch-id	sträng	Ja	En strängidentifierare som identifierar enhetsbatchen.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen

Exempel på begäran

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-svar

Om det lyckas innehåller svarstexten en växlingsad samling enhetsresurser . Samlingen innehåller 100 enheter på en sida. Om du vill hämta nästa sida med 100 enheter måste continuationToken i svarstexten inkluderas i den efterföljande begäran som ett MS-ContinuationToken-huvud.

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. En fullständig lista finns i Partnercenter REST-felkoder.

Exempel på svar

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"
    }
}

Dela via