Excluir um dispositivo do cliente especificado

  • Artigo

Aplica-se a: Partner Center

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

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

  • Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá pesquisá-la no Partner Center selecionando o workspace Clientes , o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).

  • O identificador de lote do dispositivo.

  • O identificador do dispositivo.

C#

Para excluir um dispositivo para o cliente especificado:

  1. Chame o método IAggregatePartner.Customers.ById com o identificador do cliente para recuperar uma interface para operações no cliente.

  2. Chame o método DeviceBatches.ById com o identificador de lote do dispositivo para obter uma interface para operações para o lote especificado.

  3. Chame o método Devices.ById para obter uma interface para a operação no dispositivo especificado.

  4. Chame o método Delete ou DeleteAsync para excluir o dispositivo do lote.

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

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

Exemplo: aplicativo de teste do console. Project: Classe de exemplos do SDK do Partner Center: DeleteDevice.cs

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
DELETE {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

Parâmetros do URI

Use os seguintes parâmetros de caminho ao criar a solicitação.

Nome Type Obrigatório Descrição
id do cliente string Sim Uma cadeia com formato de GUID que identifica o cliente.
devicebatch-id string Sim O identificador de lote do dispositivo do lote que contém o dispositivo.
device-id string Sim O identificador do dispositivo.

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum

Exemplo de solicitação

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

Resposta REST

Se tiver êxito, a resposta retornará um código 204 Sem Conteúdo status.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

Exemplo de resposta

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