更新终端设备的边缘节点 - 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"
]
}
}
}
错误码
请参见错误码。
