為客戶刪除使用者帳戶

發行項
09/11/2024

本文說明如何為客戶刪除現有的使用者帳戶。

必要條件

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

刪除使用者帳戶

當您刪除使用者帳戶時，使用者狀態會設定為 非使用 中 30 天。 30 天后，使用者帳戶及其相關聯的資料會清除並無法復原。

如果非使用中的帳戶在 30 天視窗中，您可以為客戶還原已刪除的使用者帳戶。不過，當您還原已刪除並標示為非使用中的帳戶時，該帳戶將不再傳回為使用者集合的成員（例如，當您取得客戶所有使用者帳戶的清單時）。

GDAP 角色

您將需要下列 GDAP 角色：

使用者管理員

C#

若要刪除現有的客戶使用者帳戶：

使用 IAggregatePartner.Customers.ById 方法搭配客戶識別碼來識別客戶。
呼叫 Users.ById 方法來識別使用者。
呼叫 Delete 方法以刪除使用者，並將使用者狀態設定為非使用中。

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

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

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

REST 要求

要求語法

方法	要求 URI
DELETE	{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 標頭。

要求本文

無。

要求範例

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

REST 回應

如果成功，這個方法會傳 回 204 無內容 狀態碼。

回應成功和錯誤碼

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

回應範例

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

共用方式為