Excluir uma conta de usuário para um cliente

Artigo
09/11/2024

Este artigo explica como excluir uma conta de usuário existente para um 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).
Uma ID de usuário. Se você não tiver o ID do usuário, consulte Obter uma lista de todas as contas de usuário de um cliente.

Excluindo uma conta de usuário

Quando você exclui uma conta de usuário, o estado do usuário é definido como inativo por 30 dias. Após trinta e 30 dias, a conta de usuário e seus dados associados são limpos e tornados irrecuperáveis.

Você pode restaurar uma conta de usuário excluída de um cliente se a conta inativa estiver dentro da janela de 30 dias. No entanto, quando você restaura uma conta que foi excluída e marcada como inativa, a conta não é mais retornada como membro da coleção de usuários (por exemplo, quando você obtém uma lista de todas as contas de usuário de um cliente).

Funções GDAP

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

Administrador de usuários

C#

Para excluir uma conta de usuário de cliente existente:

Para identificar o cliente, chame o método IAggregatePartner.Customers.ById.
Chame o método Users.ById para identificar o usuário.
Chame o método excluir para excluir o usuário e definir o estado do usuário como inativo.

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

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

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

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
Delete (excluir)	{baseURL} /v1/clientes / {id de locatário cliente} /users/ {id de usuário} HTTP/1.1

Parâmetros do URI

Use os seguintes parâmetros de consulta para identificar o cliente e o usuário.

Nome	Type	Obrigatório	Descrição
id de locatário do cliente	GUID	S	O valor é um ID de locatário de cliente formatado por GUID que permite ao revendedor filtrar os resultados de um determinado cliente.
user-id	GUID	S	O valor é um ID de usuário formatado em GUID que pertence a 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/users/a45f1416-3300-4f65-9e8d-f123b397a4ea HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0

Resposta REST

Se bem-sucedido, esse método retorna um código de status 204 No Content .

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, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CV: 90KUJA7HKEaG8wHu.0
MS-ServerId: 101112616
Date: Tue, 24 Jan 2017 23:27:18 GMT

Compartilhar via