Aracılığıyla paylaş

Belirtilen müşteri için mevcut bir toplu işe ait cihaz listesini karşıya yükleme

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi

Belirtilen müşteri için mevcut bir toplu işe cihazlar hakkında bilgi listesi yükleme. Bu, cihazları önceden oluşturulmuş bir cihaz toplu işlemiyle ilişkilendirir.

Önkoşullar

  • İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni arayın. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

  • Cihaz toplu iş tanımlayıcısı.

  • Tek tek cihazlar hakkında bilgi sağlayan cihaz kaynaklarının listesi.

C#

Cihazların listesini mevcut bir cihaz toplu işlemine yüklemek için önce Cihaz türünde yeni bir [List/dotnet/api/system.collections.generic.list-1) örneği oluşturun ve listeyi cihazlarla doldurun. Her cihazı tanımlamak için en az aşağıdaki doldurulmuş özellikler bileşimi gerekir:

Ardından, belirtilen müşterideki işlemler için bir arabirim almak için müşteri tanımlayıcısı ile IAggregatePartner.Customers.ById yöntemini çağırın. Ardından cihaz toplu iş tanımlayıcısı ile DeviceBatches.ById yöntemini çağırarak belirtilen toplu iş için işlemlere yönelik bir arabirim alın. Son olarak, cihazları cihaz toplu işlemine eklemek için cihazlar listesiyle Devices.Create veya CreateAsync yöntemini çağırın.

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

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: CreateDevices.cs

REST isteği

İstek söz dizimi

Metot İstek URI'si
POST {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices HTTP/1.1

URI parametresi

İsteği oluştururken aşağıdaki yolu ve sorgu parametrelerini kullanın.

Adı Tür Zorunlu Açıklama
customer-id string Yes Müşteriyi tanımlayan GUID biçimli bir dize.
devicebatch-id string Yes Cihaz toplu işlemini tanımlayan bir dize tanımlayıcısı.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

İstek gövdesi bir Cihaz nesneleri dizisi içermelidir. Bir cihazı tanımlamak için aşağıdaki alan bileşimleri kabul edilir:

  • hardwareHash + productKey.
  • hardwareHash + serialNumber.
  • hardwareHash + productKey + serialNumber.
  • hardwareHash only.
  • yalnızca productKey.
  • serialNumber + oemManufacturerName + modelName.

İstek örneği

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

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

REST yanıtı

Başarılı olursa, yanıt, cihaz karşıya yükleme durumunu almak için kullanılabilecek bir URI'ye sahip bir Konum üst bilgisi içerir. Bu URI'yi diğer ilgili REST API'leriyle kullanmak üzere kaydedin.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

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