查询固件列表
功能介绍
查看指定固件历史版本信息
URI
GET /v3/ai-mgr/firmwares
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| device_type | 是 | String | 固件适用设备类型 |
| arch | 否 | String | 边缘节点架构 |
| os_name | 否 | String | 边缘设备操作系统名称 |
| os_version | 否 | String | 边缘设备操作系统版本 |
| offset | 否 | Integer | 查询的起始位置,取值范围为非负整数,默认为0 |
| limit | 否 | Integer | 每页显示的条目数量,取值范围1~100,默认为100 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 租户Token。获取方法请参见获取Token |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 固件数 |
| firmwares | Array of ListFirmwaresResponseData objects | 固件列表 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 固件id |
| name | String | 固件名称 |
| description | String | 固件描述 |
| version | String | 固件版本 |
| version_type | String | 固件版本类型 |
| expire_time | String | 固件到期时间 |
| firmware_whitelist | Array of strings | 固件白名单 |
| type | String | 固件类型 |
| series | String | 产品系列 |
| device_type | String | 固件适用设备类型 |
| arch | String | 边缘节点架构 |
| os_name | String | 边缘设备操作系统名称 |
| os_type | String | 边缘节点操作系统类型 |
| os_version | String | 边缘设备操作系统版本 |
| size | Long | 当前固件大小(单位:byte) |
| create_time | Long | 创建时间毫秒数 |
| update_time | Long | 更新时间毫秒数 |
请求示例
查看指定固件历史版本信息
GET https://{endpoint}/v3/ai-mgr/firmwares
Request Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... 响应示例
状态码: 200
请求成功
{
"count" : 1,
"firmwares" : [ {
"id" : "a91e80c5f3174a6ba8b07b1bd5b0f01a",
"name" : "HiLens_Device_Agent",
"description" : "firmware description.",
"version" : "1.0.0",
"series" : "Atlas",
"device_type" : "Atlas 500",
"type" : "incremental",
"arch" : "aarch64",
"os_name" : "Linux",
"os_type" : "Linux",
"os_version" : "#1 SMP Mon Mar 16 00:02:15 UTC 2020",
"size" : 46301864,
"create_time" : 1627302463397,
"update_time" : 1627302463397
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 401 | 认证不通过 |
| 403 | 拒绝执行请求 |
| 404 | 请求的资源不存在 |
| 500 | 服务器内部错误 |
错误码
请参见错误码。