Återställ en borttagen användare för en kund

Artikel
09/11/2024

Så här återställer du en borttagen användare efter kund-ID och användar-ID.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Användar-ID:t. Om du inte har användar-ID kan du läsa Visa borttagna användare för en kund.

GDAP-roller

Du behöver minst en av följande GDAP-roller:

Användaradministratör
Katalogskrivare

Återställa ett borttaget användarkonto

Användartillståndet är inställt på "inaktivt" när du tar bort ett användarkonto. Det är fortfarande så i 30 dagar, varefter användarkontot och dess associerade data rensas och görs oåterkalleliga. Du kan bara återställa ett borttaget användarkonto under det här 30-dagarsfönstret. När användarkontot har tagits bort och markerats som "inaktivt" returneras det inte längre som medlem i användarsamlingen (till exempel genom att använda Hämta en lista över alla användarkonton för en kund).

C#

Om du vill återställa en användare skapar du en ny instans av klassen CustomerUser och anger värdet för egenskapen User.State till UserState.Active.

Du återställer en borttagen användare genom att ange användarens tillstånd som aktivt. Du behöver inte fylla i de återstående fälten i användarresursen igen. Dessa värden återställs automatiskt från den borttagna, inaktiva användarresursen. Använd sedan metoden IAggregatePartner.Customers.ById med kund-ID:t för att identifiera kunden och metoden Users.ById för att identifiera användaren.

Anropa slutligen metoden Patch och skicka CustomerUser-instansen för att skicka begäran för att återställa användaren.

// 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);

Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: CustomerUserRestore.cs

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

URI-parameter

Använd följande frågeparametrar för att ange kund-ID och användar-ID.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	Guid	Y	Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet till en viss kund.
användar-ID	Guid	Y	Värdet är ett GUID-formaterat användar-ID som tillhör ett enda användarkonto.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

I den här tabellen beskrivs de nödvändiga egenskaperna i begärandetexten.

Namn	Typ	Obligatoriskt	Beskrivning
State	sträng	Y	Användartillståndet. Om du vill återställa en borttagen användare måste strängen innehålla "aktiv".
Attribut	objekt	N	Innehåller "ObjectType": "CustomerUser".

Exempel på begäran

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"
    }
}

REST-svar

Om det lyckas returnerar svaret den återställda användarinformationen i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

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"
    }
}

Dela via