Belirtilen müşteri için yeni bir toplu iş oluşturmak üzere cihaz listesini karşıya yükleme

Makale
03/04/2024

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

Belirtilen müşteri için yeni bir toplu iş oluşturmak üzere cihazlar hakkındaki bilgilerin listesini karşıya yükleme. Bu, sıfır dokunmalı dağıtımda kayıt için bir cihaz toplu işlemi oluşturur ve cihazları ve cihaz toplu işlemini belirtilen müşteriyle ilişkilendirir.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo, App+User kimlik bilgileriyle kimlik doğrulamayı destekler. İş Ortağı Merkezi API'leriyle App+User kimlik doğrulamasını kullanırken güvenli uygulama modelini izleyin.
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.
Tek tek cihazlar hakkında bilgi sağlayan cihaz kaynaklarının listesi.

C#

Yeni bir cihaz toplu işlemi oluşturmak üzere cihazların listesini karşıya yüklemek için:

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:
- HardwareHash + ProductKey.
- HardwareHash + SerialNumber.
- HardwareHash + ProductKey + SerialNumber.
- Yalnızca HardwareHash .
- Yalnızca ProductKey .
- SerialNumber + OemManufacturerName ModelName. +
DeviceBatchCreationRequest nesnesinin örneğini oluşturun ve BatchId özelliğini seçtiğiniz benzersiz bir ada, Devices özelliğini ise karşıya yüklenecek cihazlar listesine ayarlayın.
Belirtilen müşterideki işlemlere arabirim almak için IAggregatePartner.Customers.ById yöntemini müşteri tanımlayıcısıyla çağırarak cihaz toplu oluşturma isteğini işleyin.
Toplu işlemi oluşturmak için cihaz toplu oluşturma isteğiyle DeviceBatches.Create veya CreateAsync yöntemini çağırın.

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

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

REST isteği

İstek söz dizimi

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

URI parametresi

İsteği oluştururken aşağıdaki yol parametrelerini kullanın.

Adı	Tür	Zorunlu	Açıklama
customer-id	string	Yes	Müşteriyi tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

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

Request body

İstek gövdesi bir DeviceBatchCreationRequest kaynağı içermelidir.

İstek örneği

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: e3f26e6a-044f-4371-ad52-0d91ce4200be
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"
    }
}

Ö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/beba2053-5401-46ff-9223-7e841ed78fbf
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2017 20:35:35 GMT

Aracılığıyla paylaş