Nahrání seznamu zařízení pro vytvoření nové dávky pro konkrétního zákazníka

Článek
09/11/2024

Platí pro: Partnerské centrum

Jak nahrát seznam informací o zařízeních k vytvoření nové dávky pro zadaného zákazníka Tím se vytvoří dávka zařízení pro registraci v nasazení s nulovým dotykem a přidruží zařízení a dávku zařízení k zadanému zákazníkovi.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí přihlašovacích údajů aplikace a uživatele. Při použití ověřování aplikací a uživatelů s rozhraními API Partnerského centra postupujte podle modelu zabezpečené aplikace.
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).
Seznam prostředků zařízení, které poskytují informace o jednotlivých zařízeních.

C#

Nahrání seznamu zařízení pro vytvoření nové dávky zařízení:

Vytvořte instanci nového typu [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.
Vytvořte instanci objektu DeviceBatchCreationRequest a nastavte vlastnost BatchId na jedinečný název vašeho výběru a vlastnost Devices na seznam zařízení k nahrání.
Žádost o vytvoření dávky zařízení zpracujete voláním metody IAggregatePartner.Customers.ById s identifikátorem zákazníka a načtěte rozhraní pro operace se zadaným zákazníkem.
Volejte metodu DeviceBatches.Create nebo CreateAsync s požadavkem na vytvoření dávky zařízení.

IAggregatePartner partnerOperations;
string selectedCustomerId;

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

DeviceBatchCreationRequest
    newDeviceBatch = new DeviceBatchCreationRequest
{
    BatchId = "SDKTestDeviceBatch",
    Devices = devicesToBeUploaded
};

var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Create(newDeviceBatch);

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

Požadavek REST

Syntaxe požadavku

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

Parametr identifikátoru URI

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

Name	Type	Požadováno	Popis
ID zákazníka	string	Ano	Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.

Záhlaví žádosti

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

Text požadavku

Tělo požadavku musí obsahovat prostředek DeviceBatchCreationRequest .

Příklad požadavku

POST https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/deviceBatches HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
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: 340
Expect: 100-continue
Connection: Keep-Alive
{
    "BatchId": "SDKTestDeviceBatch",
    "Devices": [{
            "Id": null,
            "SerialNumber": "1R9-ZNP67",
            "ProductKey": "00329-00000-0003-AA606",
            "HardwareHash": "DummyHash123",
            "Policies": null,
            "CreatedBy": null,
            "UploadedDate": "0001-01-01T00:00:00",
            "AllowedOperations": null,
            "Attributes": {
                "ObjectType": "Device"
            }
        }
    ],
    "Attributes": {
        "ObjectType": "DeviceBatchCreationRequest"
    }
}

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/beba2053-5401-46ff-9223-7e841ed78fbf
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2017 20:35:35 GMT

Sdílet prostřednictvím