Cihaz toplu karşıya yükleme durumu alma

  • Makale

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

Belirtilen müşteri için bir cihaz toplu yüklemesinin durumunu alma.

Uygun roller: Genel yönetici | Yönetici aracısı | Satış temsilcisi

Ö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şlemi gönderildiğinde Konum üst bilgisinde döndürülen toplu iş izleme tanımlayıcısı. Daha fazla bilgi için bkz . Belirtilen müşteri için cihaz listesini karşıya yükleme.

C#

Bir cihaz toplu yüklemesinin durumunu almak için, belirtilen müşterideki işlemlere arabirim almak için önce müşteri kimliğiyle IAggregatePartner.Customers.ById yöntemini çağırın. Ardından batchuploadStatus.ById yöntemini toplu iş izleme kimliğiyle çağırarak toplu karşıya yükleme durum işlemlerinin arabirimini alın. Son olarak, durumu almak için Get veya GetAsync yöntemini çağırın.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedTrackingId;

var status =
    partnerOperations.Customers.ById(selectedCustomerId).BatchUploadStatus.ById(selectedTrackingId).Get();

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

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
GET {baseURL}/v1/customers/{customer-id}/batchJobStatus/{batchtracking-id} HTTP/1.1

URI parametresi

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

Adı Tür Gerekli Description
customer-id Dize Evet Müşteriyi tanımlayan GUID biçimli bir dize.
batchtracking-id Dize Evet Cihaz toplu karşıya yükleme durumunu almak için kullanılan GUID biçimli tanımlayıcı. Bu kimlik, cihaz toplu işlemi başarıyla gönderildiğinde Konum üst bilgisinde döndürülür.

İstek üst bilgileri

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

Request body

Hiçbiri

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/batchjobstatus/0127ed8e-ff72-4983-a3d8-e8d8bd378932 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST yanıtı

Başarılı olursa, yanıt bir BatchUploadDetails kaynağı içerir.

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 200 OK
Content-Length: 400
MS-CorrelationId: 4a5002a2-0c1b-4e57-b491-dbcf19c0e7b8
MS-RequestId: 7b3e2e00-b330-4480-9d84-59ace713427f
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:52:41 GMT

{
    "batchTrackingId": "0127ed8e-ff72-4983-a3d8-e8d8bd378932",
    "status": "finished",
    "startedTime": "2017-07-25T10:00:00",
    "completedTime": "2017-07-25T10:10:00",
    "devicesStatus": [{
            "serialNumber": "1234567890",
            "productKey": "12345-67890-09876-54321-13579",
            "status": "finished_with_errors",
            "errorCode": "808",
            "errorDescription": "ZtdDeviceAssignedToOtherTenant",
            "attributes": {
                "objectType": "DeviceUploadDetails"
            }
        }
    ],
    "attributes": {
        "objectType": "BatchUploadDetails"
    }
}