Nahrání seznamu zařízení do stávající dávky pro konkrétního zákazníka

Článek
09/11/2024

Platí pro: Partnerské centrum

Postup nahrání seznamu informací o zařízeních do existující dávky pro zadaného zákazníka Tím se zařízení přidruží k již vytvořené dávce zařízení.

Požadavky

Přihlašovací údaje popsané v 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 neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Identifikátor dávky zařízení.
Seznam prostředků zařízení, které poskytují informace o jednotlivých zařízeních.

C#

Pokud chcete nahrát seznam zařízení do existující dávky zařízení, nejprve vytvořte novou instanci [List/dotnet/api/system.collections.generic.list-1) typu Zařízení a naplňte seznam zařízeními. Pro identifikaci jednotlivých zařízení se vyžadují minimálně následující kombinace naplněných vlastností:

HardwareHash + ProductKey.
HardwareHash + SerialNumber.
HardwareHash + ProductKey + SerialNumber.
Pouze HardwareHash .
Pouze ProductKey .
SerialNumber + OemManufacturerName + ModelName.

Potom zavolejte metodu IAggregatePartner.Customers.ById s identifikátorem zákazníka, která načte rozhraní pro operace se zadaným zákazníkem. Dále zavolejte metodu DeviceBatches.ById s identifikátorem dávky zařízení, abyste získali rozhraní pro operace pro zadanou dávku. Nakonec zavolejte metodu Devices.Create nebo CreateAsync se seznamem zařízení pro přidání zařízení do dávky zařízení.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;

List<Device> devicesToBeUploaded = new List<Device>
{
    new Device
    {
        HardwareHash = "DummyHash1234",
        ProductKey = "00329-00000-0003-AA606",
        SerialNumber = "2R9-ZNP67"
    },

    new Device
    {
        HardwareHash = "DummyHash12345",
        ProductKey = "00329-00000-0003-AA606",
        SerialNumber = "2R9-ZNP67"
    }
};

var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.Create(devicesToBeUploaded);

Ukázka: Konzolová testovací aplikace Projekt: Třída ukázek sady SDK v Partnerském centru: CreateDevices.cs

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

Parametr identifikátoru URI

Při vytváření požadavku použijte následující cestu a parametry dotazu.

Name	Type	Požadováno	Popis
ID zákazníka	string	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.
devicebatch-id	string	Ano	Identifikátor řetězce, který identifikuje dávku zařízení.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tělo požadavku musí obsahovat pole objektů zařízení . Akceptují se následující kombinace polí pro identifikaci zařízení:

hardwareHash + productKey.
hardwareHash + serialNumber.
hardwareHash + productKey + serialNumber.
pouze hardwareHash.
pouze productKey.
serialNumber + oemManufacturerName + modelName.

Příklad požadavku

POST https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/deviceBatches/Test/devices HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 482
Expect: 100-continue

[{
        "Id": null,
        "SerialNumber": "2R9-ZNP67",
        "ProductKey": "00329-00000-0003-AA606",
        "HardwareHash": "DummyHash1234",
        "Policies": null,
        "CreatedBy": null,
        "UploadedDate": "0001-01-01T00:00:00",
        "AllowedOperations": null,
        "Attributes": {
            "ObjectType": "Device"
        }
    }, {
        "Id": null,
        "SerialNumber": "2R9-ZNP67",
        "ProductKey": "00329-00000-0003-AA606",
        "HardwareHash": "DummyHash12345",
        "Policies": null,
        "CreatedBy": null,
        "UploadedDate": "0001-01-01T00:00:00",
        "AllowedOperations": null,
        "Attributes": {
            "ObjectType": "Device"
        }
    }
]

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Odpověď REST

V případě úspěchu odpověď obsahuje hlavičku umístění s identifikátorem URI, který lze použít k načtení stavu nahrávání zařízení. Uložte tento identifikátor URI pro použití s jinými souvisejícími rozhraními REST API.

Kódy úspěšnosti a chyb odpovědi

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 pro 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 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/16c00110-e79a-433d-aa28-f69dd60df671
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CV: OBkGN9pSN0a5xvua.0
MS-ServerId: 101112012
Date: Thu, 28 Sep 2017 20:08:46 GMT

Sdílet prostřednictvím