為客戶還原已刪除的使用者

文章
03/06/2024

如何依客戶識別碼和使用者識別碼還原已刪除的使用者。

必要條件

認證，如合作夥伴中心驗證所述。此案例僅支援使用「應用程式+使用者」認證來進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的識別碼，您可以在合作夥伴中心中選取 [客戶 ] 工作區，然後從客戶清單中查看客戶，然後 從 [帳戶 ]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft 識別碼 。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。
使用者識別碼。如果您沒有使用者識別碼，請參閱檢視客戶已刪除的使用者。

GDAP 角色

您至少需要下列其中一個 GDAP 角色：

使用者管理員
目錄寫入器

還原已刪除的使用者帳戶

當您刪除使用者帳戶時，使用者狀態會設定為「非使用中」。 30 天內，使用者帳戶及其相關聯的資料會清除並無法復原。您只能在此 30 天期間還原已刪除的使用者帳戶。一旦刪除並標示為「非使用中」，使用者帳戶就不會再傳回為使用者集合的成員（例如，使用取得客戶所有使用者帳戶的清單）。

C#

若要還原使用者，請建立 CustomerUser 類別的新實例 ，並將 User.State 屬性的值 設定為 UserState.Active。

您可以將使用者的狀態設定為作用中，以還原已刪除的使用者。您不需要重新填入使用者資源中的其餘欄位。這些值會自動從已刪除的非使用中使用者資源還原。接下來，使用 IAggregatePartner.Customers.ById 方法搭配客戶識別碼來識別客戶，並使用 Users.ById 方法來識別使用者。

最後，呼叫 Patch 方法，並傳遞 CustomerUser 實例以傳送要求以還原使用者。

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

範例：主控台測試應用程式。專案：合作夥伴中心 SDK 範例類別：CustomerUserRestore.cs

REST 要求

要求語法

方法	要求 URI
PATCH	{baseURL} /v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

URI 參數

使用下列查詢參數來指定客戶識別碼和使用者識別碼。

名稱	類型	必填	描述
customer-tenant-id	guid	Y	此值是 GUID 格式的客戶租使用者識別碼，可讓轉銷商將結果篩選給指定的客戶。
user-id	guid	Y	值是 GUID 格式的使用者識別碼，屬於單一使用者帳戶。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

下表描述要求本文中的必要屬性。

名稱	類型	必填	描述
州 (縣/市)	字串	Y	使用者狀態。若要還原已刪除的使用者，此字串必須包含「active」。
屬性	object	否	包含「ObjectType」：「CustomerUser」。

要求範例

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: 32be760f-8282-4e01-a37b-829c8a700e8a
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 回應

如果成功，回應會在回應本文中傳回還原的使用者資訊。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心 REST 錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 465
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 32be760f-8282-4e01-a37b-829c8a700e8a
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"
    }
}

分享方式：