Eliminar um dispositivo para o cliente especificado

Artigo
09/11/2024

Aplica-se a: Centro de Parceiros

Este artigo explica como eliminar um dispositivo que pertence a um cliente especificado.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais de Aplicação e Aplicação+Utilizador autónomas.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Centro de Parceiros ao selecionar a área de trabalho Clientes e, em seguida, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure o ID Microsoft na secção Informações da Conta de Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).
O identificador do lote do dispositivo.
O identificador do dispositivo.

C#

Para eliminar um dispositivo para o cliente especificado:

Chame o método IAggregatePartner.Customers.ById com o identificador do cliente para obter uma interface para operações no cliente.
Chame o método DeviceBatches.ById com o identificador de lote do dispositivo para obter uma interface para operações para o lote especificado.
Chame o método Devices.ById para obter uma interface para funcionar no dispositivo especificado.
Chame o método Delete ou DeleteAsync para eliminar o dispositivo do lote.

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

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

Exemplo: aplicação de teste da consola. Projeto: Classe de Exemplos do SDK do Centro de Parceiros: DeleteDevice.cs

Pedido REST

Sintaxe do pedido

Método	URI do pedido
DELETE	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

Parâmetros do URI

Utilize os seguintes parâmetros de caminho ao criar o pedido.

Nome	Tipo	Necessário	Descrição
customer-id	string	Yes	Uma cadeia formatada por GUID que identifica o cliente.
devicebatch-id	string	Yes	O identificador do lote do dispositivo que contém o dispositivo.
device-id	string	Yes	O identificador do dispositivo.

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

Nenhuma

Exemplo de pedido

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

Resposta do REST

Se for bem-sucedida, a resposta devolve um código de estado 204 Sem Conteúdo .

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro REST do Centro de Parceiros.

Exemplo de resposta

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

Partilhar via