Megosztás a következőn keresztül:

Eszköz törlése a megadott ügyfélnél

  • Cikk

A következőre vonatkozik: Partnerközpont

Ez a cikk azt ismerteti, hogyan törölhet egy adott ügyfélhez tartozó eszközt.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a hitelesítést önálló alkalmazással és app+felhasználói hitelesítő adatokkal is.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület, majd az ügyféllista ügyféllistájából, majd a Fiók lehetőség kiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

  • Az eszköz kötegazonosítója.

  • Az eszköz azonosítója.

C#

A megadott ügyfél eszközének törlése:

  1. Hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval, hogy lekérjen egy felületet az ügyfél műveleteihez.

  2. Hívja meg a DeviceBatches.ById metódust az eszköz kötegazonosítójával, hogy egy felületet kapjon a megadott köteg műveleteihez.

  3. Hívja meg az Devices.ById metódust, hogy lekérjen egy felületet a megadott eszközön való működéshez.

  4. Hívja meg a Delete vagy a DeleteAsync metódust, hogy törölje az eszközt a kötegből.

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

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

Minta: Konzolteszt alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: DeleteDevice.cs

REST-kérelem

Kérés szintaxisa

Metódus Kérés URI-ja
DELETE {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

URI-paraméterek

A kérés létrehozásakor használja az alábbi elérésiút-paramétereket.

Név Típus Kötelező Leírás
ügyfél-azonosító sztring Igen Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
devicebatch-id sztring Igen Az eszközt tartalmazó köteg eszközköteg-azonosítója.
eszközazonosító sztring Igen Az eszköz azonosítója.

Kérésfejlécek

További információt a Partnerközpont REST-fejlécei című témakörben talál.

A kérés törzse

None

Példa kérésre

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

REST-válasz

Ha sikeres, a válasz egy 204 No Content állapotkódot ad vissza.

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Partnerközpont REST-hibakódjai című témakörben találja.

Példa válaszra

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 8b3e6f78-220b-4177-861b-33d6f38f7b97
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:58:53 GMT