Eliminar una cuenta de usuario para un cliente

  • Artículo

En este artículo se explica cómo eliminar una cuenta de usuario existente para un cliente.

Requisitos previos

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

  • 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 , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Identificador de usuario. Si no tiene el identificador de usuario, consulte Obtener una lista de todas las cuentas de usuario de un cliente.

Eliminación de una cuenta de usuario

Al eliminar una cuenta de usuario, el estado de usuario se establece en inactivo durante 30 días. Después de treinta 30 días, la cuenta de usuario y sus datos asociados se purgan y hacen irrecuperables.

Puede restaurar una cuenta de usuario eliminada para un cliente si la cuenta inactiva está dentro de la ventana de 30 días. Sin embargo, al restaurar una cuenta que se eliminó y se marcó como inactiva, la cuenta ya no se devuelve como miembro de la colección de usuarios (por ejemplo, cuando se obtiene una lista de todas las cuentas de usuario para un cliente).

Roles de GDAP

Necesitará el siguiente rol de GDAP:

  • Administrador de usuarios

C#

Para eliminar una cuenta de usuario de cliente existente:

  1. Use el método IAggregatePartner.Customers.ById con el id. de cliente para identificar el cliente.

  2. Llame al método Users.ById para identificar el usuario.

  3. Llame al método Delete para eliminar el usuario y establecer el estado del usuario en inactivo.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string customerUserIdToDelete;

partnerOperations.Customers.ById(selectedCustomerId).Users.ById(customerUserIdToDelete).Delete();

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

Solicitud REST

Sintaxis de la solicitud

Method URI de solicitud
Delete {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Parámetros del identificador URI

Use los siguientes parámetros de consulta para identificar al cliente y al usuario.

Nombre Tipo Obligatorio Descripción
customer-tenant-id GUID Y El valor es un identificador customer-tenant-id con formato GUID que permite al revendedor filtrar los resultados de un cliente determinado.
user-id GUID Y El valor es un identificador de usuario con formato GUID que pertenece a una sola cuenta de usuario.

Encabezados de solicitud

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

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

DELETE https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CorrelationId: 709c0b80-016c-4662-b29f-697fdf03e87a
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0

Respuesta REST

Si se ejecuta correctamente, este método 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, consulte Códigos de error rest del Centro de partners.

Ejemplo de respuesta

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: 709c0b80-016c-4662-b29f-697fdf03e87a
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CV: 90KUJA7HKEaG8wHu.0
MS-ServerId: 101112616
Date: Tue, 24 Jan 2017 23:27:18 GMT