Sdílet prostřednictvím


Odstraní zařízení pro konkrétního zákazníka

Platí pro: Partnerské centrum

Tento článek vysvětluje, jak odstranit zařízení, které patří zadanému zákazníkovi.

Požadavky

  • Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

  • Identifikátor dávky zařízení.

  • Identifikátor zařízení.

C#

Odstranění zařízení pro zadaného zákazníka:

  1. VoláníM metody IAggregatePartner.Customers.ById s identifikátorem zákazníka načtěte rozhraní pro operace se zákazníkem.

  2. Voláním metody DeviceBatches.ById s identifikátorem dávky zařízení získáte rozhraní pro operace pro zadanou dávku.

  3. Voláním metody Devices.ById získáte rozhraní pro provoz na zadaném zařízení.

  4. Voláním metody Delete nebo DeleteAsync odstraňte zařízení z dávky.

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

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

Ukázka: Testovací aplikace konzoly Project: Partner Center SDK Samples Class: DeleteDevice.cs

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
DELETE {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

Parametry identifikátoru URI

Při vytváření požadavku použijte následující parametry cesty.

Název Typ Vyžadováno Popis
customer-ID řetězec Yes Řetězec ve formátu GUID, který identifikuje zákazníka.
devicebatch-id řetězec Yes Identifikátor dávky zařízení, která obsahuje zařízení.
device-ID řetězec Yes Identifikátor zařízení.

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Žádné

Příklad požadavku

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

Odpověď REST

V případě úspěchu vrátí odpověď stavový kód 204 Žádný obsah .

Kódy úspěšných odpovědí a chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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