Supprimer un appareil pour le client spécifié

Article
09/11/2024

S’applique à : Espace partenaires

Cet article explique comment supprimer un appareil qui appartient à un client spécifié.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec des informations d’identification d’application et d’utilisateur autonomes.
ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires en sélectionnant l’espace de travail Clients , puis le client dans la liste des clients, puis Compte. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).
Identificateur de lot de l’appareil.
Identificateur de l’appareil.

C#

Pour supprimer un appareil pour le client spécifié :

Appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client pour récupérer une interface aux opérations sur le client.
Appelez la méthode DeviceBatches.ById avec l’identificateur de lot d’appareil pour obtenir une interface pour les opérations pour le lot spécifié.
Appelez la méthode Devices.ById pour obtenir une interface de fonctionnement sur l’appareil spécifié.
Appelez la méthode Delete ou DeleteAsync pour supprimer l’appareil du lot.

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

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

Exemple : Application de test console. Project: Partner Center SDK Samples Class: DeleteDevice.cs

Demande REST

Syntaxe de la requête

Méthode	URI de demande
Suppression	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

Paramètres URI

Utilisez les paramètres de chemin d’accès suivants lors de la création de la demande.

Nom	Type	Obligatoire	Description
customer-id	string	Oui	Chaîne au format GUID qui identifie le client.
devicebatch-id	string	Oui	Identificateur de lot d’appareil du lot qui contient l’appareil.
device-id	string	Oui	Identificateur de l’appareil.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

None

Exemple de requête

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

Réponse REST

Si elle réussit, la réponse renvoie un code 204 No Content status.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

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

Partager via