从角色中删除客户用户
如何从客户帐户中的目录角色中删除用户。
先决条件
合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区,然后从客户列表中选择客户,然后选择“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上,在“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。
GDAP 角色
需要以下 GDAP 角色:
- 特权角色管理员
C#
若要从目录角色中删除用户,请选择具有用户的用户以调用 IAggregatePartner.Customers.ById 方法进行修改的客户。从那里,使用目录角色 ID 的 DirectoryRoles.ById 方法指定角色。 然后,访问 UserMembers.ById 方法以标识要删除的用户,以及 要从角色中删除用户的 Delete 方法。
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedRoleId;
// string selectedUserMemberId;
partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedRoleId).UserMembers.ById(selectedUserMemberId).Delete();
示例: 控制台测试应用。 项目:合作伙伴中心 SDK 示例 类:RemoveCustomerUserMemberFromDirectoryRole.cs
REST 请求
请求语法
方法 | 请求 URI |
---|---|
DELETE | {baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers/{user-ID} HTTP/1.1 |
URI 参数
使用以下 URI 参数标识正确的客户、角色和用户。
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
customer-tenant-id | Guid | Y | 该值是标识客户的 GUID 格式 的客户租户 ID 。 |
role-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%20/directoryroles/729827e3-9c14-49f7-bb1b-9608f156bbb8/usermembers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04%20 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0a00ec08-6273-46bb-ab6f-14a13959b381
MS-CorrelationId: 87d18a45-81fc-40cf-921a-b91cb82d67fe
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Content-Length: 0
Connection: Keep-Alive
REST 响应
如果已成功从角色中删除用户,则响应正文为空。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表,请参阅合作伙伴中心 REST 错误代码。
响应示例
HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: 90bda268-7929-4ad6-be01-89c5af5fc504
MS-RequestId: e784d7aa-8c8d-45ee-8f97-9e09823d7338
MS-CV: es01VX8do0u2aTXw.0
MS-ServerId: 101112616
Date: Tue, 20 Dec 2016 23:16:35 GMT