Löschen eines Geräts für den angegebenen Kunden

Artikel
09/11/2024

Gilt für: Partner Center

In diesem Artikel wird erläutert, wie Sie ein Gerät löschen, das zu einem angegebenen Kunden gehört.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Der Gerätebatchbezeichner.
Der Gerätebezeichner.

C#

So löschen Sie ein Gerät für den angegebenen Kunden:

Rufen Sie die IAggregatePartner.Customers.ById-Methode mit dem Kundenbezeichner auf, um eine Schnittstelle für Vorgänge für den Kunden abzurufen.
Rufen Sie die DeviceBatches.ById-Methode mit dem Gerätebatchbezeichner auf, um eine Schnittstelle zu Vorgängen für den angegebenen Batch abzurufen.
Rufen Sie die Devices.ById-Methode auf, um eine Schnittstelle für den Betrieb auf dem angegebenen Gerät abzurufen.
Rufen Sie die Delete- oder DeleteAsync-Methode auf, um das Gerät aus dem Batch zu löschen.

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

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

Beispiel: Konsolentest-App. Projekt: Partner Center SDK-Beispielklasse: DeleteDevice.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
Delete	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

URI-Parameter

Verwenden Sie beim Erstellen der Anforderung die folgenden Pfadparameter.

Name	Typ	Erforderlich	BESCHREIBUNG
Kunden-ID	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.
devicebatch-id	Zeichenfolge	Ja	Der Gerätebatchbezeichner des Batches, der das Gerät enthält.
device-id	Zeichenfolge	Ja	Der Gerätebezeichner.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Anforderungsbeispiel

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

Bei erfolgreicher Ausführung gibt die Antwort den Code 204 No Content status zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortbeispiel

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

Freigeben über