Quitar un usuario de cliente de un rol

  • Artículo

Cómo quitar un usuario de un rol de directorio dentro de una cuenta de 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).

Roles de GDAP

Necesitará el siguiente rol de GDAP:

  • Administrador de roles con privilegios

C#

Para quitar un usuario de un rol de directorio, seleccione el cliente con el usuario que desea modificar con una llamada al método IAggregatePartner.Customers.ById, Desde allí, especifique el rol mediante el método DirectoryRoles.ById con el identificador de rol de directorio. A continuación, acceda al método UserMembers.ById para identificar al usuario que se va a quitar y el método Delete para quitar al usuario del rol.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedRoleId;
// string selectedUserMemberId;

partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedRoleId).UserMembers.ById(selectedUserMemberId).Delete();

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

Solicitud REST

Sintaxis de la solicitud

Method URI de solicitud
DELETE {baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers/{user-ID} HTTP/1.1

Parámetro de URI

Use los siguientes parámetros de URI para identificar el cliente, el rol y el usuario correctos.

Nombre Tipo Obligatorio Descripción
customer-tenant-id guid Y El valor es un GUID con formato customer-tenant-id que identifica al cliente.
role-id guid Y El valor es un identificador de rol con formato GUID que identifica el rol.
user-id guid Y El valor es un identificador de usuario con formato GUID que identifica 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%20/directoryroles/729827e3-9c14-49f7-bb1b-9608f156bbb8/usermembers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04%20 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0a00ec08-6273-46bb-ab6f-14a13959b381
MS-CorrelationId: 87d18a45-81fc-40cf-921a-b91cb82d67fe
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0
Connection: Keep-Alive

Respuesta REST

Si el usuario se quita del rol correctamente, el cuerpo de la respuesta está vacío.

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: 90bda268-7929-4ad6-be01-89c5af5fc504
MS-RequestId: e784d7aa-8c8d-45ee-8f97-9e09823d7338
MS-CV: es01VX8do0u2aTXw.0
MS-ServerId: 101112616
Date: Tue, 20 Dec 2016 23:16:35 GMT