Megosztás a következőn keresztül:

Eszközök listájának feltöltése a megadott ügyfél meglévő kötegére

  • Cikk

A következőre vonatkozik: Partnerközpont

Az eszközökkel kapcsolatos információk listájának feltöltése egy meglévő kötegbe a megadott ügyfél számára. Ez társítja az eszközöket egy már létrehozott eszközköteggel.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

  • Az eszköz kötegazonosítója.

  • Az egyes eszközökkel kapcsolatos információkat biztosító eszközerőforrások listája.

C#

Az eszközök listájának egy meglévő eszköz kötegbe való feltöltéséhez először példányosítjon egy új [List/dotnet/api/system.collections.generic.list-1) eszközt, és töltse ki a listát az eszközökkel. Az egyes eszközök azonosításához legalább a következő, feltöltött tulajdonságok kombinációjára van szükség:

Ezután hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval, hogy lekérjen egy felületet a megadott ügyfél műveleteihez. Ezután hívja meg a DeviceBatches.ById metódust az eszköz kötegazonosítójával, hogy egy interfészt kapjon a megadott köteg műveleteihez. Végül hívja meg a Devices.Create vagy a CreateAsync metódust az eszközök listájával, hogy hozzáadja az eszközöket az eszköz kötegéhez.

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);

Példa: Konzoltesztelő alkalmazás. Projekt: Partnerközpont SDK-mintaosztály: CreateDevices.cs

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
POST {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

URI-paraméter

A kérés létrehozásakor használja az alábbi elérési utat és lekérdezési paramétereket.

Név Típus Kötelező Leírás
ügyfél-azonosító sztring Igen Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
devicebatch-id sztring Igen Az eszköz kötegét azonosító sztringazonosító.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

A kérelem törzsének eszközobjektumok tömböt kell tartalmaznia. Az eszköz azonosítására szolgáló mezők alábbi kombinációit fogadjuk el:

  • hardwareHash + productKey.
  • hardwareHash + serialNumber.
  • hardwareHash + productKey + serialNumber.
  • csak hardwareHash.
  • Csak productKey.
  • serialNumber + oemManufacturerName + modelName.

Példa kérése

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: 772871a9-399b-4f3b-b8c7-38f550e4f22a
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"
        }
    }
]

Fontos

2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.

A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

REST-válasz

Ha a válasz sikeres, a válasz tartalmaz egy URI-val rendelkező helyfejlécet , amely az eszköz feltöltési állapotának lekérésére használható. Mentse ezt az URI-t más kapcsolódó REST API-khoz való használatra.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont REST-hibakódjaiban találja.

Példa válaszra

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/16c00110-e79a-433d-aa28-f69dd60df671
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: e286d69b-7f5f-4098-8999-21d3b54e4e47
MS-CV: OBkGN9pSN0a5xvua.0
MS-ServerId: 101112012
Date: Thu, 28 Sep 2017 20:08:46 GMT