# 获取设备固件升级进度
#### 功能介绍
获取设备固件升级进度。
#### URI
GET /v3/{project_id}/node-manager/node/{node_id}/firmware/upgrade-progress
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                 |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-hilens/hilens_07_0020.html)               |
| node_id    | 是    | String | 设备ID，从专业版HiLens控制台设备管理[查询设备列表](https://support.huaweicloud.com/api-hilens/ListNodeUsingGeT.html)获取 |
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                          |
|:---|:---|:---|:---|
| offset | 否    | Integer | 查询的起始位置，取值范围为非负整数，默认为0      |
| limit  | 否    | Integer | 每页显示的条目数量，取值范围1\~100，默认为100 |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 租户Token。获取方法请参见[获取Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html) |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数       | 参数类型    | 描述                         |
|:---|:---|:---|
| version  | String  | 升级的固件版本                    |
| status   | Integer | 固件升级状态，1:升级中 2:升级失败 3:升级成功 |
| progress | String  | 固件升级进度，用数字0-100表示          |
| cause    | String  | 固件升级失败原因                   |
   
#### 请求示例
获取固件升级进度
```
GET  https://{endpoint}/v3/{project_id}/node-manager/node/{node_id}/firmware/upgrade-progress
Request Header:  Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
```
#### 响应示例
**状态码： 200**
请求成功
```
{
  "version" : "string",
  "status" : "string",
  "progress" : "string",
  "cause" : "string"
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 请求成功     |
| 401 | 认证不通过    |
| 403 | 拒绝执行请求   |
| 404 | 请求的资源不存在 |
| 500 | 服务器内部错误  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-hilens/ErrorCode.html)。