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:
Llame al método IAggregatePartner.Customers.ById con el identificador de cliente para recuperar una interfaz a las operaciones del cliente.
Llame al método DeviceBatches.ById con el identificador de lote del dispositivo para obtener una interfaz a las operaciones del lote especificado.
Llame al método Devices.ById para obtener una interfaz para funcionar en el dispositivo especificado.
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 | Sí | Cadena con formato de GUID que identifica al cliente. |
| devicebatch-id | string | Sí | Identificador de lote de dispositivo del lote que contiene el dispositivo. |
| device-id | string | Sí | 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: aaaa0000-bb11-2222-33cc-444444dddddd
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: 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