Ta bort en enhet för den angivna kunden

Artikel
09/11/2024

Gäller för: Partnercenter

Den här artikeln beskriver hur du tar bort en enhet som tillhör en angiven kund.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och app+användarautentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
Enhetens batchidentifierare.
Enhetsidentifieraren.

C#

Så här tar du bort en enhet för den angivna kunden:

Anropa metoden IAggregatePartner.Customers.ById med kundidentifieraren för att hämta ett gränssnitt för åtgärder på kunden.
Anropa metoden DeviceBatches.ById med enhetsbatchidentifieraren för att hämta ett gränssnitt för åtgärder för den angivna batchen.
Anropa metoden Devices.ById för att få ett gränssnitt som ska fungera på den angivna enheten.
Anropa metoden Delete eller DeleteAsync för att ta bort enheten från batchen.

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

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

Exempel: Konsoltestapp. Projekt: Exempelklass för Partnercenter SDK: DeleteDevice.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
DELETE	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

URI-parametrar

Använd följande sökvägsparametrar när du skapar begäran.

Namn	Typ	Obligatorisk	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
devicebatch-id	sträng	Ja	Enhetsbatchidentifieraren för batchen som innehåller enheten.
enhets-ID	sträng	Ja	Enhetsidentifieraren.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen

Exempel på begäran

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-svar

Om det lyckas returnerar svaret statuskoden 204 Inget innehåll .

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Exempel på svar

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

Dela via