Belirtilen müşteri için bir cihazı silme

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

Bu makalede, belirtilen bir müşteriye ait olan bir cihazın nasıl silinip silinip siline silinenin nasıl olduğu açıklanmıştır.

Ö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'den 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ı.

  • Cihaz tanımlayıcısı.

C#

Belirtilen müşteri için bir cihazı silmek için:

  1. Müşteri üzerinde işlemlere bir arabirim almak için müşteri tanımlayıcısıyla IAggregatePartner.Customers.ById yöntemini çağırma.

  2. Belirtilen toplu iş için işlemlere arabirim almak üzere cihaz toplu iş tanımlayıcısıyla DeviceBatches.ById yöntemini çağırma.

  3. Belirtilen cihazda işlem için arabirim almak üzere Devices.ById yöntemini çağırma.

  4. Cihazı toplu işten silmek için Delete veya DeleteAsync yöntemini çağırma.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;
string selectedDeviceId;

partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.ById(selectedDeviceId).Delete();

Örnek:Konsol test uygulaması. Project:İş Ortağı Merkezi SDK'sı Samples Sınıfı:DeleteDevice.cs

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
DELETE {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

URI parametreleri

İsteği oluştururken aşağıdaki yol 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ı içeren toplu iş için cihaz toplu iş tanımlayıcısı.
device-id string Yes Cihaz tanımlayıcısı.

İstek üst bilgileri

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

İstek gövdesi

Yok

İstek örneği

DELETE https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/testbatch/devices/7b11cd8b-dd1e-4840-8c4a-84215e4de782 HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

REST yanıtı

Başarılı olursa yanıt 204 İçerik Yok durum kodu döndürür.

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 204 No Content
Content-Length: 0
MS-CorrelationId: 394d96d0-05b2-4b02-b907-0697632ee3bb
MS-RequestId: 8b3e6f78-220b-4177-861b-33d6f38f7b97
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:58:53 GMT