Eliminar uma conta de utilizador para um cliente
Este artigo explica como excluir uma conta de usuário existente para um cliente.
Pré-requisitos
Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais App+User.
Um ID de cliente (
customer-tenant-id
). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, 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 é a mesma que a ID do cliente (customer-tenant-id
).Um ID de utilizador. Se você não tiver a ID de usuário, consulte Obter uma lista de todas as contas de usuário de um cliente.
Eliminar uma conta de utilizador
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 Utilizadores
C#
Para excluir uma conta de usuário de cliente existente:
Use o método IAggregatePartner.Customers.ById com o ID do cliente para identificar o cliente.
Chame o método Users.ById para identificar o usuário.
Chame o método Delete para excluir o usuário e defina 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: Exemplo de SDK do Partner Center Classe: DeleteCustomerUser.cs
Pedido REST
Sintaxe da solicitação
Método | URI do pedido |
---|---|
DELETE | {baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1 |
Parâmetros de URI
Use os seguintes parâmetros de consulta para identificar o cliente e o usuário.
Nome | Type | Obrigatório | Descrição |
---|---|---|---|
ID do cliente-locatário | GUID | Y | O valor é um customer-tenant-id formatado em GUID que permite ao revendedor filtrar os resultados de um determinado cliente. |
ID de utilizador | GUID | Y | O valor é um ID de usuário formatado em GUID que pertence a uma única conta de usuário. |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Corpo do pedido
Nenhum.
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 do REST
Se for bem-sucedido, esse método retornará um código de status 204 No Content .
Códigos de sucesso e erro de resposta
Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e 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