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

  • Makale
  • Okumak için 2 dakika

Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi Microsoft Bulut Almanya için destek

Belirtilen müşteri için mevcut bir toplu iş için cihazlarla ilgili bilgilerin listesini karşıya yükleme. Bu, cihazları önceden oluşturulmuş bir cihaz toplu işiyle ilişkilendirmektedir.

Önkoşullar

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

  • Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi menüsünden CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile 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#

Cihaz listesini mevcut bir cihaz toplu iş parçasına yüklemek için, önce Cihaz türünde yeni bir [List/dotnet/api/system.collections.generic.list-1) örneği açın ve listeyi cihazlarla doldurmak. Aşağıdaki doldurulmuş özellik birleşimleri, her cihazı tanımlamak için en azından gereklidir:

Ardından, belirtilen müşteri üzerinde işlemlere bir arabirim almak için müşteri tanımlayıcısıyla IAggregatePartner.Customers.ById yöntemini çağırabilirsiniz. Ardından, belirtilen toplu iş için işlemlere bir arabirim almak üzere cihaz toplu iş tanımlayıcısıyla DeviceBatches.ById yöntemini çağırabilirsiniz. Son olarak, cihazları cihaz toplu işine eklemek için cihazların listesiyle Devices.Create veya CreateAsync yöntemini çağırabilirsiniz.

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ı. Project:İş Ortağı Merkezi SDK'sı Örnekleri Sınıfı:CreateDevices.cs

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
YAYINLA {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 Gerekli 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.

İstek gövdesi

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

  • hardwareHash + productKey.
  • hardwareHash + serialNumber.
  • hardwareHash + productKey + serialNumber.
  • yalnızca hardwareHash.
  • 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"
        }
    }
]

REST yanıtı

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

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren 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