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:
VoláníM metody IAggregatePartner.Customers.ById s identifikátorem zákazníka načtěte rozhraní pro operace se zákazníkem.
Voláním metody DeviceBatches.ById s identifikátorem dávky zařízení získáte rozhraní pro operace pro zadanou dávku.
Voláním metody Devices.ById získáte rozhraní pro provoz na zadaném zařízení.
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: aaaa0000-bb11-2222-33cc-444444dddddd
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: 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