Device Update - List Versions

服务:

Device Update

API 版本:

2026-06-01

获取与指定提供程序和名称匹配的所有更新版本的列表。

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions?api-version=2026-06-01

具有可选参数:

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions?api-version=2026-06-01&filter={filter}

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string (url)	IoT 中心帐户终结点的设备更新（仅主机名，无协议）。
instanceId	path	True	string	IoT 中心帐户实例标识符的设备更新。
name	path	True	string	更新名称。
provider	path	True	string	更新提供程序。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。
filter	query		string	（可选）按 isDeployable 属性筛选更新。

响应

名称	类型	说明
200 OK	StringsList	请求已成功。
Other Status Codes	ErrorResponse	未预期的错误响应。

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://api.adu.microsoft.com/.default

示例

DeviceUpdate_ListVersions

示例请求

HTTP

GET https://contoso.api.adu.microsoft.com/deviceUpdate/blue/updates/providers/microsoft/names/adu/versions?api-version=2026-06-01

示例响应

状态代码:

200

{
  "value": [
    "1.0.0.0",
    "1.0.0.1"
  ]
}

定义

名称	说明
Error	错误详细信息。
ErrorResponse	常见的错误响应。
InnerError	包含与当前对象有关错误的更具体信息的对象。
StringsList	支持服务器分页的字符串列表。

Error

对象

错误详细信息。

名称	类型	说明
code	string	服务器定义的错误代码。
details	Error[]	导致报告错误的错误的数组。
innererror	InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	错误的人工可读表示形式。
occurredDateTime	string (date-time)	发生错误的日期和时间（UTC）。
target	string	错误的目标。

ErrorResponse

对象

常见的错误响应。

名称	类型	说明
error	Error	错误详情。

InnerError

对象

包含与当前对象有关错误的更具体信息的对象。

名称	类型	说明
code	string	比包含的错误提供的错误代码更具体。
errorDetail	string	内部错误或异常消息。
innerError	InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	错误的人工可读表示形式。

StringsList

对象

支持服务器分页的字符串列表。

名称	类型	说明
nextLink	string	指向下一页项的链接。
value	string[]	可分页项的集合。