Eliminare un dispositivo per il cliente specificato

Articolo
09/11/2024

Si applica a: Centro per i partner

Questo articolo illustra come eliminare un dispositivo che appartiene a un cliente specificato.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e app+utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
Identificatore batch del dispositivo.
Identificatore del dispositivo.

C#

Per eliminare un dispositivo per il cliente specificato:

Chiamare il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente per recuperare un'interfaccia per le operazioni sul cliente.
Chiamare il metodo DeviceBatches.ById con l'identificatore batch del dispositivo per ottenere un'interfaccia per le operazioni per il batch specificato.
Chiamare il metodo Devices.ById per ottenere un'interfaccia da eseguire nel dispositivo specificato.
Chiamare il metodo Delete o DeleteAsync per eliminare il dispositivo dal batch.

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

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

Esempio: app di test della console. Progetto: Classe di esempi dell'SDK del Centro per i partner: DeleteDevice.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
DOLETE	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

Parametri URI

Usare i parametri del percorso seguenti durante la creazione della richiesta.

Nome	Tipo	Obbligatoria	Descrizione
customer-id	string	Sì	Stringa in formato GUID che identifica il cliente.
devicebatch-id	string	Sì	Identificatore batch del dispositivo del batch contenente il dispositivo.
device-id	string	Sì	Identificatore del dispositivo.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno

Esempio di richiesta

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

Risposta REST

Se ha esito positivo, la risposta restituisce un codice di stato 204 Nessun contenuto .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempio di risposta

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

Condividi tramite