Cihaz toplu karşıya yükleme durumu alma

  • Makale
  • Okumak için 2 dakika

Uygulama hedefi: Iş Ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi

Belirli bir müşteri için bir cihaz toplu karşıya yükleme işleminin durumunu alma.

Önkoşullar

  • Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, hem tek başına uygulama hem de uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. 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ĞI () ile aynıdır customer-tenant-id .

  • Cihaz toplu işi gönderildiğinde konum üstbilgisinde döndürülen toplu iş izleme tanımlayıcısı. daha fazla bilgi için, bkz. belirtilen müşteri için cihazların listesini Upload.

C#

Bir cihaz toplu karşıya yükleme işleminin durumunu almak için, önce belirtilen müşterideki işlemlere bir arabirim almak üzere müşteri KIMLIĞIYLE ıaggregatepartner. Customers. byıd yöntemini çağırın. Ardından, toplu karşıya yükleme durum işlemlerine bir arabirim almak için toplu izleme KIMLIĞIYLE Batchuploadstatus. Byıd metodunu çağırı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ı. Project: iş ortağı merkezi SDK örnekleri sınıfı: getbatchuploadstatus. cs

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
AL {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 Açıklama
müşteri kimliği string Yes Müşteriyi tanımlayan GUID biçimli bir dize.
batchtracking kimliği string Yes Bir cihaz toplu karşıya yükleme durumunu almak için kullanılan GUID biçimli bir tanımlayıcı. Bu KIMLIK, cihaz toplu işi başarıyla gönderildiğinde konum üst bilgisinde döndürülür.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

Yok

İ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ı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Iş 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"
    }
}