Eliminar un dispositivo para el cliente especificado

Se aplica a: Centro de partners

En este artículo se explica cómo eliminar un dispositivo que pertenece a un cliente especificado.

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+user.

  • Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , el cliente de la lista de clientes y, a continuación, Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Identificador de lote del dispositivo.

  • Identificador del dispositivo.

C#

Para eliminar un dispositivo para el cliente especificado:

  1. Llame al método IAggregatePartner.Customers.ById con el identificador de cliente para recuperar una interfaz a las operaciones del cliente.

  2. Llame al método DeviceBatches.ById con el identificador de lote del dispositivo para obtener una interfaz a las operaciones del lote especificado.

  3. Llame al método Devices.ById para obtener una interfaz para funcionar en el dispositivo especificado.

  4. Llame al método Delete o DeleteAsync para eliminar el dispositivo del lote.

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

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

Ejemplo: aplicación de prueba de consola. Project: Clase de ejemplos del SDK del Centro de partners: DeleteDevice.cs

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
Delete {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

Parámetros del identificador URI

Use los siguientes parámetros de ruta de acceso al crear la solicitud.

Nombre Tipo Obligatorio Descripción
customer-id string Cadena con formato de GUID que identifica al cliente.
devicebatch-id string Identificador de lote de dispositivo del lote que contiene el dispositivo.
device-id string Identificador del dispositivo.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

None

Ejemplo de solicitud

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

Respuesta REST

Si se ejecuta correctamente, la respuesta devuelve un código de estado 204 Sin contenido .

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplo de respuesta

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