获取客户所有用户帐户的列表
本文介绍如何获取属于客户之一的所有用户帐户的列表。
若要按 ID 查找单个用户帐户,请参阅 按 ID 获取用户帐户。
先决条件
合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区,然后从客户列表中选择客户,然后选择“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上,在“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。
GDAP 角色
至少需要以下 GDAP 角色之一:
- 目录读取者
- 全局读取者
- 用户管理员
C#
检索指定客户的所有用户帐户的集合:
使用 指定的客户 ID 调用 IAggregatePartner.Customers.ById 方法以标识客户。
调用 Users.Get 或 GetAsync 方法以检索集合。
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// Get customer users collection.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.Get();
有关示例,请参阅以下内容:
- 示例: 控制台测试应用
- 项目: 合作伙伴中心 SDK 示例
- 类: GetCustomerUserCollection.cs
REST 请求
请求语法
方法 | 请求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
URI 参数
使用以下 URI 参数标识正确的客户。
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
customer-tenant-id | guid | Y | 该值是 GUID 格式 的客户租户 ID ,允许经销商筛选属于经销商的给定客户的结果。 |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无。
请求示例
GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 5d845377-5b7d-4cd4-98f6-19e5ae3faa81
MS-CorrelationId: 5a3d64d4-4490-4932-bf5e-0dc9a58f27ca
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST 响应
如果成功,此方法将返回客户的用户帐户集合。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表,请参阅合作伙伴中心 REST 错误代码。
响应示例
HTTP/1.1 200 OK
Content-Length: 1030
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 5a3d64d4-4490-4932-bf5e-0dc9a58f27ca
MS-RequestId: 5d845377-5b7d-4cd4-98f6-19e5ae3faa81
MS-CV: 6zmKqrSFB0+t7m3y.0
MS-ServerId: 101112616
Date: Wed, 21 Dec 2016 21:13:24 GMT
{
"totalCount": 2,
"items": [{
"usageLocation": "US",
"id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
"userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
"firstName": "Daniel",
"lastName": "Tsai",
"displayName": "Daniel Tsai",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "CustomerUser"
}
}, {
"id": "6e668259-1f09-479d-bcb8-d9b03e826b8d",
"userPrincipalName": "admin@dtdemocspcustomer005.onmicrosoft.com",
"firstName": "Daniel",
"lastName": "Tsai",
"displayName": "DT Demo CSP Customer 005",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/6e668259-1f09-479d-bcb8-d9b03e826b8d",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "CustomerUser"
}
}
],
"links": {
"self": {
"uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}