文档首页/ 智能边缘平台 IEF/ API参考/ API/ 边缘节点管理/ 更新边缘节点 - UpdateEdgeNode
更新时间：2026-02-03 GMT+08:00
查看PDF
分享

更新边缘节点 - UpdateEdgeNode

功能介绍

该API用于更新边缘节点。

授权信息

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

URI

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

表1 Path参数

参数

是否必选

描述

project_id

是

项目ID，获取方法请参见获取项目ID。

node_id

是

边缘节点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参数

参数

是否必选

类型

描述

description

否

String

边缘节点描述，最大长度255，不允许^ ~ # $ % & * < > ( ) [ ] { } ' " \

log_configs

否

表2 object

边缘节点日志配置

ntp_servers

否

Array of String

ntp服务器地址，每个节点最多仅能配置两个

attributes

否

Array of 表26 object

边缘节点属性，关联属性个数最多为32个

请求示例

{
    "node": {
        "description": "This is a new test node"
    }
}

响应消息

响应参数
表4 响应Body参数

参数

类型

描述

node

表1 object

边缘节点详细信息

响应示例

{ 
       "node":{
               "edged_version":null, 
               "ca":null, 
               "updated_at":"2018-11-08T04:11:02.138839+08:00", 
               "device_infos":[ ], 
               "upgrade_history":[ ], 
               "pause_docker_image":null, 
               "ief_node_version":null, 
               "id":"59710cd5-2ade-4b87-b2f8-5752f308a25b", 
               "device_num":1, 
               "certificate":null, 
               "gpu_num":null, 
               "os_version":null, 
               "state":"UNCONNECTED", 
               "memory":null, 
               "project_id":"", 
               "private_key":null, 
               "os_name":null, 
               "description":"This is a new test node.", 
               "gpu_info":[ ], 
               "arch":null, 
               "host_ips":[ ], 
               "enable_gpu":false, 
               "name":"node_test7",
               "deployment_num":0, 
               "package":null, 
               "container_runtime_version":null, 
               "created_at":"2018-11-08T04:03:43.215561+08:00", 
               "cpu":null, 
               "host_name":null, 
               "os_type":null, 
               "log_configs":[ {
                            "level":"off", 
                            "rotate_num":null, 
                            "component":"app", 
                            "rotate_period":null, 
                            "type":"LTS", 
                            "id":"79a1d6fb-4411-4e7e-8d15-b3d5c1b8612b", 
                            "size":null 
                        }, 
                        { 
                            "level":null, 
                            "rotate_num":5, 
                            "component":"system", 
                            "rotate_period":"daily", 
                            "type":"local", 
                            "id":"7e6419ac-05e8-4264-a082-f0824cbcd3bb", 
                            "size":50 
                        }, 
                       { 
                            "level":"off", 
                            "rotate_num":null, 
                            "component":"system", 
                            "rotate_period":null, 
                            "type":"LTS", 
                            "id":"b5150a39-325a-4872-8b1c-d4585424875e", 
                            "size":null 
                       }, 
                       { 
                            "level":"on", 
                            "rotate_num":5, 
                            "component":"app", 
                            "rotate_period":"daily", 
                            "type":"local", 
                            "id":"4a19d570-05b6-49e5-9851-cc25f33eb1c3", 
                            "size":100 
                        }
                   ] 
               } 
           }

错误码

请参见错误码。

父主题： 边缘节点管理