Remover um usuário do cliente de uma função

Artigo
09/11/2024

Como remover um usuário de uma função de diretório dentro de uma conta de cliente.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.
Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o espaço de trabalho 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).

Funções GDAP

Você precisará da seguinte função GDAP:

Administrador de Função Privilegiada

C#

Para remover um usuário de uma função de diretório, selecione o cliente com o usuário a ser modificado com uma chamada para o método IAggregatePartner.Customers.ById, A partir daí, especifique a função usando o método DirectoryRoles.ById com a ID da função de diretório. Em seguida, acesse o método UserMembers.ById para identificar o usuário a ser removido e o método Delete para remover o usuário da função.

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

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

Exemplo: Aplicativo de teste de console. Projeto: Exemplos de SDK do Partner Center Classe: RemoveCustomerUserMemberFromDirectoryRole.cs

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
DELETE	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers/{user-ID} HTTP/1.1

Parâmetro do URI

Use os seguintes parâmetros de URI para identificar o cliente, a função e o usuário corretos.

Nome	Type	Obrigatório	Descrição
id de locatário do cliente	guid	S	O valor é um ID de cliente-locatário formatado por GUID que identifica o cliente.
ID de função	guid	S	O valor é um ID de função formatado por GUID que identifica a função.
id de usuário	guid	S	O valor é um ID de usuário formatado por GUID que identifica uma única conta de usuário.

Cabeçalhos de solicitação

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

Corpo da solicitação

None.

Exemplo de solicitação

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0
Connection: Keep-Alive

Resposta REST

Se o usuário for removido da função com êxito, o corpo da resposta estará vazio.

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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: e784d7aa-8c8d-45ee-8f97-9e09823d7338
MS-CV: es01VX8do0u2aTXw.0
MS-ServerId: 101112616
Date: Tue, 20 Dec 2016 23:16:35 GMT

Compartilhar via