Ripristinare un utente eliminato per un cliente

Articolo
09/11/2024

Come ripristinare un utente eliminato in base all'ID cliente e all'ID utente.

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 dell'utente. Se non si ha l'ID utente, vedere Visualizzare gli utenti eliminati per un cliente.

Ruoli GDAP

Sono necessari almeno uno dei ruoli GDAP seguenti:

Amministratore utenti
Ruolo con autorizzazioni di scrittura nella directory

Ripristinare un account utente eliminato

Lo stato utente è impostato su "inattivo" quando si elimina un account utente. Rimane così per 30 giorni, dopo i quali l'account utente e i relativi dati associati vengono eliminati e resi irreversibili. È possibile ripristinare un account utente eliminato solo durante questa finestra di 30 giorni. Una volta eliminato e contrassegnato come "inattivo" l'account utente non viene più restituito come membro della raccolta di utenti( ad esempio, usando Ottieni un elenco di tutti gli account utente per un cliente).

C#

Per ripristinare un utente, creare una nuova istanza della classe CustomerUser e impostare il valore della proprietà User.State su UserState.Active.

Per ripristinare un utente eliminato, impostare lo stato dell'utente su attivo. Non è necessario ripopolare i campi rimanenti nella risorsa utente. Questi valori verranno ripristinati automaticamente dalla risorsa utente inattiva eliminata. Usare quindi il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente e il metodo Users.ById per identificare l'utente.

Infine, chiamare il metodo Patch e passare l'istanza CustomerUser per inviare la richiesta per ripristinare l'utente.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedCustomerUserId;

var updatedCustomerUser = new CustomerUser()
{
    State = UserState.Active
};

// Restore customer user information.
var restoredCustomerUserInfo = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Patch(updatedCustomerUser);

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

Richiesta REST

Sintassi della richiesta

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

Parametro URI

Usare i parametri di query seguenti per specificare l'ID cliente e l'ID utente.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	guid	Y	Il valore è un GUID formattato customer-tenant-id che consente al rivenditore di filtrare i risultati in base a un determinato cliente.
user-id	guid	Y	Il valore è un ID utente formattato con 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

Questa tabella descrive le proprietà necessarie nel corpo della richiesta.

Nome	Digita	Obbligatorio	Descrizione
Stato	string	Y	Stato dell'utente. Per ripristinare un utente eliminato, questa stringa deve contenere "attivo".
Attributi	oggetto	N	Contiene "ObjectType": "CustomerUser".

Esempio di richiesta

PATCH 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: 6e668bc0-5bd7-44d6-b6fa-529d41ce9659
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 269
Expect: 100-continue

{
    "State": "active",
    "Attributes": {
        "ObjectType": "CustomerUser"
    }
}

Risposta REST

In caso di esito positivo, la risposta restituisce le informazioni utente ripristinate nel corpo della risposta.

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 200 OK
Content-Length: 465
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 6e668bc0-5bd7-44d6-b6fa-529d41ce9659
MS-CV: ZTeBriO7mEaiM13+.0
MS-ServerId: 101112616
Date: Fri, 20 Jan 2017 22:24:55 GMT

{
    "usageLocation": "US",
    "id": "a45f1416-3300-4f65-9e8d-f123b397a4ea",
    "userPrincipalName": "e83763f7f2204ac384cfcd49f79f2749@dtdemocspcustomer005.onmicrosoft.com",
    "firstName": "Ferdinand",
    "lastName": "Filibuster",
    "displayName": "Ferdinand",
    "userDomainType": "none",
    "state": "active",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a45f1416-3300-4f65-9e8d-f123b397a4ea",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerUser"
    }
}

Condividi tramite