Device Update - List Names

服务:

Device Update

API 版本:

2022-10-01

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

GET https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names?api-version=2022-10-01

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string (url)	IoT 中心帐户终结点的设备更新（仅主机名，无协议）。
instanceId	path	True	string	IoT 中心帐户实例标识符的设备更新。
provider	path	True	string	更新提供程序。
api-version	query	True	string	要用于客户端请求的 API 的版本。

响应

名称	类型	说明
200 OK	StringsList	与指定提供程序匹配的所有更新名称，如果没有，则为空列表。
Other Status Codes	ErrorResponse	默认响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

作用域

名称	说明
https://api.adu.microsoft.com/.default	默认授权范围。

示例

DeviceUpdate_ListNames

示例请求

HTTP

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

示例响应

状态代码:

200

{
  "value": [
    "adu"
  ]
}

定义

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

Error

Object

错误详细信息。

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

ErrorResponse

Object

常见的错误响应。

名称	类型	说明
error	Error	错误详细信息。

InnerError

Object

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

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

StringsList

Object

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

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