Devices - Get Group Best Updates
获取组的最佳可用更新,以及每个更新需要多少台设备的计数。
GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/groups/{groupId}/bestUpdates
GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/groups/{groupId}/bestUpdates?$filter={$filter}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
account
|
path | True |
string |
帐户终结点。 |
group
|
path | True |
string |
组标识符。 |
instance
|
path | True |
string |
帐户实例标识符。 |
$filter
|
query |
string |
限制返回的 bestUpdates 集。 可以筛选更新提供程序、名称和版本属性。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
组的最佳可用更新,以及每个更新需要多少台设备的计数。 |
|
404 Not Found |
找不到。 |
安全性
azure_auth_implicit
Azure Active Directory OAuth2 隐式流
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
azure_auth_code
Azure Active Directory OAuth2 AccessCode Flow
类型:
oauth2
流向:
accessCode
授权 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
令牌 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/token
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
azure_auth_application
Azure Active Directory OAuth2 应用程序流
类型:
oauth2
流向:
application
令牌 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/token
作用域
名称 | 说明 |
---|---|
.default | 客户端凭据范围 |
azure_auth_password
Azure Active Directory OAuth2 密码流
类型:
oauth2
流向:
password
令牌 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/token
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Devices_GetGroupBestUpdates
示例请求
GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/management/groups/group1/bestUpdates
示例响应
{
"value": [
{
"updateId": {
"provider": "provider1",
"name": "name1",
"version": "1.0.0.0"
},
"deviceCount": 100
},
{
"updateId": {
"provider": "provider2",
"name": "name2",
"version": "2.0.0.0"
},
"deviceCount": 200
}
]
}
定义
名称 | 说明 |
---|---|
Pageable |
可更新设备的列表。 |
Updatable |
更新标识符和更新适用的设备数。 |
Update |
更新标识符。 |
PageableListOfUpdatableDevices
可更新设备的列表。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
指向下一页项的链接。 |
value |
可分页项的集合。 |
UpdatableDevices
更新标识符和更新适用的设备数。
名称 | 类型 | 说明 |
---|---|---|
deviceCount |
integer |
更新适用的设备总数。 |
updateId |
更新标识。 |
UpdateId
更新标识符。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
更新名称。 |
provider |
string |
更新提供程序。 |
version |
string |
更新版本。 |