Een apparaat voor de opgegeven klant verwijderen

Artikel
03/06/2024

Van toepassing op: Partnercentrum

In dit artikel wordt uitgelegd hoe u een apparaat verwijdert dat deel uitmaakt van een opgegeven klant.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De batch-id van het apparaat.
De apparaat-id.

C#

Een apparaat verwijderen voor de opgegeven klant:

Roep de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface voor bewerkingen op de klant op te halen.
Roep de methode DeviceBatches.ById aan met de batch-id van het apparaat om een interface voor bewerkingen voor de opgegeven batch op te halen.
Roep de methode Devices.ById aan om een interface voor bewerking op het opgegeven apparaat op te halen.
Roep de methode Delete of DeleteAsync aan om het apparaat uit de batch te verwijderen.

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

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

Voorbeeld: Console-test-app. Project: Partner Center SDK-voorbeeldklasse: DeleteDevice.cs

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

Gebruik de volgende padparameters bij het maken van de aanvraag.

Naam	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een tekenreeks in GUID-indeling die de klant identificeert.
devicebatch-id	tekenreeks	Ja	De apparaatbatch-id van de batch die het apparaat bevat.
device-id	tekenreeks	Ja	De apparaat-id.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen

Voorbeeld van aanvraag

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

REST-antwoord

Als dit lukt, retourneert het antwoord de statuscode 204 Geen inhoud .

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

Voorbeeld van antwoord

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

Delen via