更新终端设备的边缘节点 - UpdateNodeByDeviceId
功能介绍
该API用于更新终端设备的边缘节点。
功能与更新边缘节点的终端设备 - UpdateEdgeNodeDevice相同，推荐使用更新边缘节点的终端设备 - UpdateEdgeNodeDevice。
URI
PUT /v2/{project_id}/edgemgr/devices/{device_id}/nodes
| 参数 | 是否必选 | 描述 |
|---|---|---|
| project_id | 是 | 项目ID，获取方法请参见获取项目ID。 |
| device_id | 是 | 设备ID |
请求消息
请求参数
| 参数 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 消息体的类型（格式） 推荐您使用默认值application/json。 |
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| ief-instance-id | 否 | String | 企业版实例ID，专业版实例为空值 |
| 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| nodes | 是 | 表4 object | 节点信息 |
| 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| relation | 否 | String | 设备和节点关系的名称，只允许中文字符、英文字母、数字、下划线、中划线，最大长度64 |
| comment | 否 | String | 设备和节点关系的描述，最大长度64，不允许^ ~ # $ % & * < > ( ) [ ] { } ' " \ |
| node_ids | 是 | Array of strings | 节点ID列表，一个设备只可以被绑定于一个边缘节点。 |
请求示例
{
"nodes": {
"added": {
"node_ids": [
"592ede18-d030-4cc1-afb8-34ac1bae47f6"
],
"relation": "abcd",
"comment": "hello world"
},
"removed": []
}
} 响应消息
响应参数
| 名称 | 参数类型 | 说明 |
|---|---|---|
| update_nodes | 表7 object | 节点信息 |
| 名称 | 参数类型 | 说明 |
|---|---|---|
| relation | String | 设备和节点关系的名称，只允许中文字符、英文字母、数字、下划线、中划线，最大长度64 |
| comment | String | 设备和节点关系的描述，最大长度64，不允许^ ~ # $ % & * < > ( ) [ ] { } ' " \ |
| node_ids | Array of strings | 节点ID列表，一个设备只可以被绑定于一个边缘节点。 |
响应示例
{
"update_nodes": {
"removed": [],
"added": {
"comment": "hello world",
"relation": "abcd",
"node_ids": [
"592ede18-d030-4cc1-afb8-34ac1bae47f6"
]
}
}
} 错误码
请参见错误码。
