
# 更新设备信息
#### 功能介绍
更新设备日志配置，标签以及描述。
#### URI
PUT /v3/{project_id}/ai-mgr/nodes/{node_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                 |
|:---|:---|:---|:---|
| node_id    | 是    | String | 设备ID，从专业版HiLens控制台设备管理[查询设备列表](https://support.huaweicloud.com/api-hilens/ListNodeUsingGeT.html)获取 |
| project_id | 是    | String | 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-hilens/hilens_07_0020.html)               |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 租户Token。获取方法请参见[获取Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html) |
   
表3请求Body参数 
| 参数   | 是否必选 | 参数类型                                                                           | 描述        |
|:---|:---|:---|:---|
| node | 是    | [UpdateNodeReqDetail] object | 更新设备信息请求体 |
   
 表4UpdateNodeReqDetail 
| 参数                    | 是否必选 | 参数类型                                                                 | 描述                                                                            |
|:---|:---|:---|:---|
| description           | 否    | String                                                               | 设备描述，最大长度255，不允许\^, \~, ＃, $, %, \&, \*, \<, \>, (, ), \[, \], {, }, ', ", \\ |
| log_configs           | 否    | Array of [LogConfig] objects | 设备日志配置                                                                        |
| tags                  | 否    | Array of [TagObject] objects | 设备标签，标签个数最多为20个                                                               |
| event_validity_period | 否    | Integer                                                              | 事件有效时间(单位：分钟)                                                                 |
| enable_gpu            | 否    | Boolean                                                              | 是否开启gpu                                                                       |
| enable_npu            | 否    | Boolean                                                              | 是否开启npu                                                                       |
| npu_type              | 否    | String                                                               | npu类型，如果选择开启npu, 可设置类型Ascend 310/ Ascend 710, 如果选择开启gpu，请设置值为null。            |
   
 表5LogConfig 
| 参数            | 是否必选 | 参数类型    | 描述                                                     |
|:---|:---|:---|:---|
| component     | 是    | String  | app：应用日志。 system：系统的日志                                 |
| level         | 否    | String  | 系统级日志可配置为/error/warning/info/debug ; 不传会默认为info。       |
| rotate_num    | 否    | Integer | 日志rotate个数，默认5，hilens取值范围1-30，ief取值范围1-10              |
| rotate_period | 否    | String  | 日志rotate周期，可选项，只支持ief：daily monthly weekly yearly.     |
| size          | 否    | Integer | 应用日志文件大小限制，单位MB，默认50，取值范围10-1000。                      |
| type          | 是    | String  | - LTS 将日志发送到云日志服务（Log Tank Service，简称LTS） - local 本地日志 |
   
 表6TagObject 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                            |
|:---|:---|:---|:---|
| key   | 否    | String | 标签键，最大长度36个字符。不能为空，只能包含大小写字母，数字，中划线"-"，下划线"_"                                                 |
| value | 否    | String | 标签值，每个值最大长度43个字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。不能为空，只能包含大小写字母，数字，中划线"-"，下划线"_" |
   
#### 响应参数
无
#### 请求示例
更新设备的描述和标签
```
POST https://{endpoint}/v3/{project_id}/ai-mgr/nodes/{node_id}
{
  "node" : {
    "enable_gpu" : false,
    "enable_npu" : false,
    "npu_type" : "null",
    "description" : "HiLens节点",
    "tags" : [ {
      "key" : "lI",
      "value" : "ss"
    } ]
  }
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 请求成功     |
| 201 | 创建成功     |
| 401 | 认证不通过    |
| 403 | 拒绝执行请求   |
| 404 | 请求的资源不存在 |
| 500 | 服务器内部错误  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-hilens/ErrorCode.html)。
