Eliminare un account utente per un cliente

Articolo
09/11/2024

Questo articolo illustra come eliminare un account utente esistente per un cliente.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
ID utente. Se non si ha l'ID utente, vedere Ottenere un elenco di tutti gli account utente per un cliente.

Eliminazione di un account utente

Quando si elimina un account utente, lo stato utente è impostato su inattivo per 30 giorni. Dopo trenta 30 giorni, l'account utente e i relativi dati associati vengono eliminati e resi irreversibili.

È possibile ripristinare un account utente eliminato per un cliente se l'account inattivo si trova nella finestra di 30 giorni. Tuttavia, quando si ripristina un account eliminato e contrassegnato come inattivo, l'account non viene più restituito come membro della raccolta di utenti, ad esempio quando si ottiene un elenco di tutti gli account utente per un cliente.

Ruoli GDAP

È necessario il ruolo GDAP seguente:

Amministratore utenti

C#

Per eliminare un account utente cliente esistente:

Usare il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente.
Chiamare il metodo Users.ById per identificare l'utente.
Chiamare il metodo Delete per eliminare l'utente e impostare lo stato dell'utente come inattivo.

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

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

Esempio: App di test della console. Progetto: Classe di esempi dell'SDK del Centro per i partner: DeleteCustomerUser.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
DELETE	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

Parametri URI

Usare i parametri di query seguenti per identificare il cliente e l'utente.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	GUID	Y	Il valore è un ID cliente-tenant formattato con GUID che consente al rivenditore di filtrare i risultati per un determinato cliente.
user-id	GUID	Y	Il valore è un ID utente in formato GUID che appartiene a un singolo account utente.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce un codice di stato 204 Nessun contenuto .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedere Codici di errore REST del Centro per i partner.

Risposta di esempio

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

Condividi tramite