获取指定客户的设备批列表
适用于:合作伙伴中心
如何检索指定客户的设备批集合。
每个设备批都包含有关已在零接触部署中注册的设备的摘要状态信息。
必备条件
合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和应用+用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区、客户列表中的客户和“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息” 部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。
C#
若要获取指定客户的设备批集合,请先使用客户 ID 调用 IAggregatePartner.Customers.ById 方法,以检索指定客户操作的接口。 然后,检索 DeviceBatches 属性的值,以获取设备批处理收集操作的接口。 最后,调用 Get 或 GetAsync 方法来检索集合。
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
var devicesBatches =
partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.Get();
示例: 控制台测试应用。 项目:合作伙伴中心 SDK 示例 类:GetDevicesBatches.cs
REST 请求
请求语法
方法 | 请求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/deviceBatches HTTP/1.1 |
URI 参数
创建请求时,请使用以下路径参数。
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
customer-id | string | 是 | 一个 GUID 格式的字符串,用于标识客户。 |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无
请求示例
GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST 响应
如果成功,响应正文将包含 DeviceBatch 资源的集合。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表,请参阅合作伙伴中心 REST 错误代码。
响应示例
HTTP/1.1 200 OK
Content-Length: 339
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 4a5002a2-0c1b-4e57-b491-dbcf19c0e7b8
MS-RequestId: 7b3e2e00-b330-4480-9d84-59ace713427f
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:52:41 GMT
{
"totalCount": 1,
"items": [{
"id": "Test batch",
"status": "finished",
"creationDate": "2017-07-25T01:51:00",
"devicesCount": 5,
"devicesLink": {
"uri": "/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/Test batch/devices",
"method": "GET",
"headers": []
},
"attributes": {
"objectType": "DeviceBatch"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈