为客户删除用户帐户
本文介绍如何删除客户的现有用户帐户。
先决条件
合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区,然后从客户列表中选择客户,然后选择“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上,在“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。用户 ID。 如果没有用户 ID,请参阅 获取客户的所有用户帐户的列表。
删除用户帐户
删除用户帐户时,用户状态将设置为 非活动 状态 30 天。 330 天后,用户帐户及其关联的数据将清除并使其不可恢复。
如果非活动帐户在 30 天窗口中,则可以 为客户 还原已删除的用户帐户。 但是,还原已删除并标记为非活动状态的帐户时,该帐户不再作为用户集合的成员返回(例如,获取 客户的所有用户帐户的列表时)。
GDAP 角色
需要以下 GDAP 角色:
- 用户管理员
C#
删除现有客户用户帐户:
将 IAggregatePartner.Customers.ById 方法与客户 ID 配合使用来标识客户。
调用 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 格式 的客户租户 ID ,允许经销商筛选给定客户的结果。 |
user-id | GUID | Y | 该值是属于单个用户帐户的 GUID 格式 的用户 ID 。 |
请求标头
有关详细信息,请参阅合作伙伴中心 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: 709c0b80-016c-4662-b29f-697fdf03e87a
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: 709c0b80-016c-4662-b29f-697fdf03e87a
MS-RequestId: f113b126-ec13-4baa-ab4d-67c245244971
MS-CV: 90KUJA7HKEaG8wHu.0
MS-ServerId: 101112616
Date: Tue, 24 Jan 2017 23:27:18 GMT