Excluir uma conta de usuário para um clienteDelete a user account for a customer

Aplica-se a:Applies to:

  • Partner CenterPartner Center

Este artigo explica como excluir uma conta de usuário existente para um cliente.This article explains how to delete an existing user account for a customer.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.This scenario supports authentication with App+User credentials only.

  • Uma ID do cliente (customer-tenant-id).A customer ID (customer-tenant-id). Se você não souber a ID do cliente, poderá procurar no painel do Partner Center.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecione CSP no menu do Partner Center e, em seguida, Clientes.Select CSP from the Partner Center menu, followed by Customers. Selecione o cliente na lista de clientes e selecione Conta.Select the customer from the customer list, then select Account. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Uma ID de usuário.A user ID. Se você não tiver a ID de usuário, consulte obter uma lista de todas as contas de usuário para um cliente.If you do not have the user ID, see Get a list of all user accounts for a customer.

Excluindo uma conta de usuárioDeleting a user account

Quando você exclui uma conta de usuário, o estado do usuário é definido como inativo por trinta dias.When you delete a user account, the user state is set to inactive for thirty days. Após trinta dias, a conta de usuário e seus dados associados são limpos e tornam-se irrecuperáveis.After thirty days, the user account and its associated data are purged and made unrecoverable.

Você pode restaurar uma conta de usuário excluída para um cliente se a conta inativa estiver dentro da janela de trinta dias.You can restore a deleted user account for a customer if the inactive account is within the thirty day window. 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).However, when you restore an account that was deleted and marked as inactive, the account is no longer returned as a member of the user collection (for example, when you get a list of all user accounts for a customer).

C#C#

Para excluir uma conta de usuário do cliente existente:To delete an existing customer user account:

  1. Use o método IAggregatePartner. Customers. ById com a ID do cliente para identificar o cliente.Use the IAggregatePartner.Customers.ById method with the customer ID to identify the customer.

  2. Chame o método users. ById para identificar o usuário.Call the Users.ById method to identify the user.

  3. Chame o método delete para excluir o usuário e definir o estado do usuário como inativo.Call the Delete method to delete the user and set the user state to inactive.

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

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

Exemplo: aplicativo de teste do console.Sample: Console test app. Projeto: classede exemplos do SDK do Partner Center: DeleteCustomerUser.csProject: Partner Center SDK Samples Class: DeleteCustomerUser.cs

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
Delete (excluir)DELETE {baseURL}/v1/Customers/{Customer-Tenant-ID}/Users/{User-ID} http/1.1{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Parâmetros do URIURI parameters

Use os parâmetros de consulta a seguir para identificar o cliente e o usuário.Use the following query parameters to identify the customer and user.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
customer-tenant-idcustomer-tenant-id GUIDGUID YY O valor é um Customer-Tenant-ID formatado por GUID que permite ao revendedor filtrar os resultados de um determinado cliente.The value is a GUID-formatted customer-tenant-id that allows the reseller to filter the results for a given customer.
user-iduser-id GUIDGUID YY O valor é uma ID de usuário formatada como GUID que pertence a uma única conta de usuário.The value is a GUID-formatted user-id that belongs to a single user account.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

nenhuma.None.

Exemplo de solicitaçãoRequest example

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

Resposta RESTREST response

Se for bem-sucedido, esse método retornará um código de status de 204 sem conteúdo .If successful, this method returns a 204 No Content status code.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, consulte códigos de erro REST do Partner Center.For the full list, see Partner Center REST Error Codes.

Exemplo de respostaResponse example

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