你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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 参数

名称 必需 类型 说明
accountEndpoint
path True

string

帐户终结点。

groupId
path True

string

组标识符。

instanceId
path True

string

帐户实例标识符。

$filter
query

string

限制返回的 bestUpdates 集。 可以筛选更新提供程序、名称和版本属性。

响应

名称 类型 说明
200 OK

PageableListOfUpdatableDevices

组的最佳可用更新,以及每个更新需要多少台设备的计数。

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
    }
  ]
}

定义

名称 说明
PageableListOfUpdatableDevices

可更新设备的列表。

UpdatableDevices

更新标识符和更新适用的设备数。

UpdateId

更新标识符。

PageableListOfUpdatableDevices

可更新设备的列表。

名称 类型 说明
nextLink

string

指向下一页项的链接。

value

UpdatableDevices[]

可分页项的集合。

UpdatableDevices

更新标识符和更新适用的设备数。

名称 类型 说明
deviceCount

integer

更新适用的设备总数。

updateId

UpdateId

更新标识。

UpdateId

更新标识符。

名称 类型 说明
name

string

更新名称。

provider

string

更新提供程序。

version

string

更新版本。