文档首页/ 智能边缘平台 IEF/ API参考/ API/ 边缘节点管理/ 更新边缘节点的终端设备 - UpdateEdgeNodeDevice
更新时间：2025-10-30 GMT+08:00
查看PDF
分享

更新边缘节点的终端设备 - UpdateEdgeNodeDevice

功能介绍

添加或删除边缘节点的终端设备

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v2/{project_id}/edgemgr/nodes/{node_id}/devices

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

node_id

是

String

节点ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），默认取值为“application/json”。

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

ief-instance-id

否

String

企业版实例ID，专业版实例为空值。
表3 请求Body参数

参数

是否必选

参数类型

描述

devices

是

devices object

终端设备信息
表4 devices

参数

是否必选

参数类型

描述

added

否

added object

要加入的终端设备详情

removed

否

Array of strings

要解绑的终端设备ID
表5 added

参数

是否必选

参数类型

描述

relation

否

String

终端设备和节点关系的名称，只允许中文字符、英文字母、数字、下划线、中划线，最大长度64

comment

否

String

终端设备和节点关系的描述，最大长度64，不允许^ ~ # $ % & * < > ( ) [ ] { } ' " \

device_ids

是

Array of strings

终端设备ID列表

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

delete_connector

Boolean

工业终端设备预留字段

deploy_connector

Boolean

工业终端设备预留字段

deployment_id

String

工业终端设备预留字段

update_devices

NodeDevice object

边缘节点的终端设备信息
表7 NodeDevice

参数

参数类型

描述

added

DeviceInfos object

要加入的终端设备详情

removed

Array of strings

要解绑的终端设备ID
表8 DeviceInfos

参数

参数类型

描述

relation

String

设备和节点关系的名称，只允许中文字符、英文字母、数字、下划线、中划线，最大长度64

comment

String

设备和节点关系的描述，最大长度64，不允许^ ~ # $ % & * < > ( ) [ ] { } ' " \

device_ids

Array of strings

设备ID列表

请求示例

添加边缘节点的终端设备，输入设备ID。

{
  "devices" : {
    "added" : {
      "relation" : "This_is_a_test_relation",
      "comment" : "This is a test comment",
      "device_ids" : [ "c59d8205-e786-4455-8883-12578a34ae90" ]
    }
  }
}

响应示例

状态码：200

更新成功

{
  "delete_connector" : false,
  "deploy_connector" : false,
  "deployment_id" : "",
  "update_devices" : {
    "added" : {
      "comment" : "This is a test comment",
      "device_ids" : [ "114a9718-052d-4152-a4f5-cd7ab84e6fad" ],
      "relation" : "This_is_a_test_relation"
    }
  }
}

状态码

状态码

描述

200

更新成功

错误码

请参见错误码。

父主题： 边缘节点管理

相关文档