# 查询固件列表
#### 功能介绍
查看指定固件历史版本信息
#### URI
GET /v3/ai-mgr/firmwares
表1Query参数 
| 参数          | 是否必选 | 参数类型    | 描述                          |
|:---|:---|:---|:---|
| device_type | 是    | String  | 固件适用设备类型                    |
| arch        | 否    | String  | 边缘节点架构                      |
| os_name     | 否    | String  | 边缘设备操作系统名称                  |
| os_version  | 否    | String  | 边缘设备操作系统版本                  |
| offset      | 否    | Integer | 查询的起始位置，取值范围为非负整数，默认为0      |
| limit       | 否    | Integer | 每页显示的条目数量，取值范围1\~100，默认为100 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 租户Token。获取方法请参见[获取Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html) |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数        | 参数类型                                                                                             | 描述   |
|:---|:---|:---|
| count     | Integer                                                                                          | 固件数  |
| firmwares | Array of [ListFirmwaresResponseData] objects | 固件列表 |
   
 表4ListFirmwaresResponseData 
| 参数                 | 参数类型             | 描述              |
|:---|:---|:---|
| 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 | 服务器内部错误  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-hilens/ErrorCode.html)。