修改边缘节点
功能介绍
修改边缘节点
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/edge-nodes/{edge_node_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见 获取项目ID。 |
|
edge_node_id |
是 |
String |
节点id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
否 |
String |
边缘节点名称，只允许中、数字、英文大小写、中划线、下划线 |
|
storage_period |
否 |
Integer |
节点的存储周期，默认0天，取值范围0~7天，0天则不存储。 |
|
log_configs |
否 |
Array of LogConfigDTO objects |
边缘节点在IEF日志配置参数 |
|
ha_config |
否 |
HaConfigDTO object |
高可用配置参数 |
|
hardware_model |
否 |
String |
网关型号 |
|
npu_library_path |
否 |
String |
npu驱动动态库路径 |
|
automatic_upgrade |
否 |
String |
自动升级系统应用的节点开关，默认为关闭：OFF，IMMEDIATE表示节点开关打开 |
|
device_data_record |
否 |
DeviceDataRecord object |
边缘节点设备数据上报打印配置 |
|
metric_report |
否 |
String |
omagent监控运维工具是否上报指标 |
|
offline_cache_configs |
否 |
UpdateOfflineCacheConfigsDTO object |
边缘节点离线缓存配置 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
size |
否 |
Integer |
应用日志文件大小限制，单位MB，默认50，取值范围10-1000 |
|
level |
否 |
String |
应用日志级别，可选项：on/off/trace/debug/info/warn/error/fatal，当type为LTS时有效。当选择非on/off的选项时，将只采集大于等于指定级别的日志。 |
|
rotate_num |
否 |
Integer |
应用日志rotate个数，默认5，取值范围1-10 |
|
rotate_period |
否 |
String |
应用日志rotate周期，可选项： daily/monthly/weekly/yearly |
|
type |
否 |
String |
LTS:将日志发送到LTS, local 本地日志 |
|
component |
否 |
String |
app:部署到边缘设备上的应用的日志, system 边缘设备上系统的日志 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ha_type |
否 |
String |
节点高可用类型双活或者主备 |
|
active_standby_config |
否 |
ActiveStandbyConfigDTO object |
主备详细配置 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
work_node |
否 |
String |
当前的工作节点，主节点还是备节点在工作，初始创建时工作节点为DEFAULT节点，(DEFAULT|MASTER|SLAVE) |
|
master_interface_name |
否 |
String |
主节点网卡名称 |
|
slave_interface_name |
否 |
String |
备节点网卡名称 |
|
virtual_ip_address |
否 |
String |
网卡ip |
|
virtual_ipv6_address |
否 |
String |
网卡ipv6地址 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
log_configs |
Array of LogConfigDTO objects |
边缘节点在IEF的日志配置 |
|
ha_config |
HaConfigDTO object |
节点根目录配置 |
|
edge_node_id |
String |
边缘节点Id |
|
instance_id |
String |
实例ID。物理多租下各实例的唯一标识，一般华为云租户无需携带该参数，仅在物理多租场景下从管理面访问API时需要携带该参数。 |
|
product_id |
String |
边缘节点关联的产品ID，用于唯一标识一个产品模型。 |
|
product_name |
String |
边缘节点关联的产品名称。 |
|
space_id |
String |
资源空间id，对应IOTDA云服务接口参数中的app_id。 |
|
resource_spec_types |
Array of strings |
节点所购买的资源类型的列表 |
|
resource_ids |
Array of strings |
资源id列表，创建节点时需绑定已购买的资源包，可以叠加节点功能。 |
|
ips |
Array of strings |
边缘节点主机ip |
|
name |
String |
边缘节点名称 |
|
state |
String |
边缘节点状态 |
|
software_version |
String |
边缘应用id，只允许数字、英文小写、中划线，且必须以字母或数字结尾 |
|
create_time |
String |
边缘节点创建时间 |
|
update_time |
String |
边缘节点更新时间 |
|
os_name |
String |
边缘节点操作系统。例如：Ubuntu 20.04；CentOS 7.9。不同于os_type边缘节点系统类型。 |
|
arch |
String |
边缘节点系统架构。包括：arm64，arm32，x86_64。 |
|
host_name |
String |
边缘节点主机名 |
|
nics |
Array of Nic objects |
边缘节点网络网卡信息 |
|
specification |
String |
网络规格，如4 cores | 3867 MB |
|
ai_card_type |
String |
AI加速卡类型，如昇腾AI加速卡NPU、图像处理加速卡GPU。 |
|
npu_library_path |
String |
npu驱动动态库路径 |
|
container_version |
String |
容器运行时版本 |
|
type |
String |
边缘节点类型：lite|advanced|standard。lite表示基础版边缘节点，advanced或standard表示专业版边缘节点。 |
|
security_level |
String |
节点的安全等级，MEDIUM边缘节数据上报不进行加密，HIGH对数据上报进行加密。 |
|
reliability_level |
String |
节点的可靠性等级，LOW表示中级别，MEDIUM表示高级别。详细功能请参考“用户指南>管理边缘节点>注册节点”。 |
|
storage_period |
Integer |
节点的存储周期，默认0天，取值范围0~7天，0天则不存储。 |
|
base_path |
BasePathDTO object |
节点根目录配置 |
|
hardware_model |
String |
注册节点网关配置 |
|
offline_cache_configs |
OfflineCacheConfigsDTO object |
边缘节点离线缓存配置 |
|
device_auth_info |
DeviceAuthInfoDisplayDTO object |
边缘节点设备认证方式 |
|
device_data_format |
String |
节点使用的数据格式，默认为iotda物模型1.0格式，可以选择属性平铺数据格式flat_json |
|
automatic_upgrade |
String |
自动升级系统应用的节点开关，默认为关闭：OFF，IMMEDIATE表示节点开关打开 |
|
device_data_record |
DeviceDataRecord object |
边缘节点设备数据上报打印配置 |
|
metric_report |
String |
omagent监控运维工具是否上报指标 |
|
iotda_south_access |
String |
iotda南向接入地址 |
|
tpm_info |
TPMInfoDTO object |
TPM芯片信息 |
|
runtime_info |
RuntimeInfoDTO object |
边缘软件运行时信息 |
|
os_type |
String |
边缘节点系统类型。包括：generalLinux通用系统，openHarmony鸿蒙系统。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
size |
Integer |
应用日志文件大小限制，单位MB，默认50，取值范围10-1000 |
|
level |
String |
应用日志级别，可选项：on/off/trace/debug/info/warn/error/fatal，当type为LTS时有效。当选择非on/off的选项时，将只采集大于等于指定级别的日志。 |
|
rotate_num |
Integer |
应用日志rotate个数，默认5，取值范围1-10 |
|
rotate_period |
String |
应用日志rotate周期，可选项： daily/monthly/weekly/yearly |
|
type |
String |
LTS:将日志发送到LTS, local 本地日志 |
|
component |
String |
app:部署到边缘设备上的应用的日志, system 边缘设备上系统的日志 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ha_type |
String |
节点高可用类型双活或者主备 |
|
active_standby_config |
ActiveStandbyConfigDTO object |
主备详细配置 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
work_node |
String |
当前的工作节点，主节点还是备节点在工作，初始创建时工作节点为DEFAULT节点，(DEFAULT|MASTER|SLAVE) |
|
master_interface_name |
String |
主节点网卡名称 |
|
slave_interface_name |
String |
备节点网卡名称 |
|
virtual_ip_address |
String |
网卡ip |
|
virtual_ipv6_address |
String |
网卡ipv6地址 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
log_base_path |
String |
节点日志根目录 |
|
config_base_path |
String |
节点配置根目录 |
|
db_base_path |
String |
节点数据存储根目录 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
publish_order |
String |
数据上报优先级，可选项：realtime_first实时数据优先 sequential按时序上报，默认realtime_first |
|
period |
Integer |
节点离线缓存数据的储存天数，默认7，取值范围-1~14，-1表示存储天数没有限制 |
|
capacity |
Integer |
节点离线缓存容量，单位MB，默认2048，取值范围500-65536 |
|
channel_cache_state |
String |
路由转发开启离线缓存 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
auth_type |
String |
边缘节点认证方式。 |
|
local_path |
CertificateLocalPathDTO object |
证书文件的本地存储路径 |
请求示例
PUT https://{endpoint}/v2/{project_id}/edge-nodes/{edge_node_id}
{
"name" : "test-node",
"storage_period" : 0,
"log_configs" : [ {
"size" : 1000,
"level" : "string",
"rotate_num" : 10,
"rotate_period" : "string",
"type" : "LTS",
"component" : "string"
} ],
"ha_config" : {
"ha_type" : "ACTIVE_STANDBY",
"active_standby_config" : null,
"work_node" : "DEFAULT",
"master_interface_name" : "eth0",
"slave_interface_name" : "eth0",
"virtual_ip_address" : "127.0.0.1",
"virtual_ipv6_address" : "ABCD:EF01:2345:6789:ABCD:EF01:2345:6789"
},
"hardware_model" : "string",
"npu_library_path" : "/usr/local/Ascend/driver/lib64/",
"automatic_upgrade" : "OFF",
"device_data_record" : {
"disk_quota" : 512,
"age" : 7,
"state" : "off"
},
"metric_report" : "on",
"offline_cache_configs" : {
"publish_order" : "realtime_first",
"period" : 7,
"capacity" : 2048
}
}响应示例
状态码：200
Ok
-
示例 1
[ { "size" : 1000, "level" : "string", "rotate_num" : 10, "rotate_period" : "string", "type" : "LTS", "component" : "string" } ] -
示例 2
{ "ha_type" : "ACTIVE_STANDBY", "active_standby_config" : { "work_node" : "DEFAULT", "master_interface_name" : "eth0", "slave_interface_name" : "eth0", "virtual_ip_address" : "127.0.0.1", "virtual_ipv6_address" : "ABCD:EF01:2345:6789:ABCD:EF01:2345:6789" } } -
示例 3
"string" -
示例 4
"string" -
示例 5
"string" -
示例 6
"jeQDJQZltU8iKgFFoW060F5SGZka" -
示例 7
"jeQDJQZltU8iKgFFoW060F5SGZka" -
示例 8
[ "iotedge.campus.1000tps.10000device" ] -
示例 9
[ "jeQDJQZltU8iKgFFoW060F5SGZka" ] -
示例 10
[ "string" ] -
示例 11
"string" -
示例 12
"string" -
示例 13
"1.0.0" -
示例 14
"string" -
示例 15
"string" -
示例 16
"string" -
示例 17
"string" -
示例 18
"string" -
示例 19
[ { "eth" : "string", "ip" : "string", "mask_len" : 24 } ] -
示例 20
"string" -
示例 21
"string" -
示例 22
"/usr/local/Ascend/driver/lib64/" -
示例 23
"17.0.1" -
示例 24
"string" -
示例 25
"HIGH" -
示例 26
"LOW" -
示例 27
7
-
示例 28
{ "log_base_path" : "string", "config_base_path" : "string", "db_base_path" : "string" } -
示例 29
"string" -
示例 30
{ "publish_order" : "realtime_first", "period" : 7, "capacity" : 2048, "channel_cache_state" : "str" } -
示例 31
{ "auth_type" : "CERTIFICATES", "local_path" : { "cert_path" : "/opt/device-cert/cert.pem", "key_path" : "/opt/device-cert/key.pem" } } -
示例 32
"string" -
示例 33
"string" -
示例 34
{ "disk_quota" : 512, "age" : 1, "state" : "off" } -
示例 35
"string" -
示例 36
"100.94.18.123:8883" -
示例 37
{ "manufacture_id" : "string", "spec_version" : "string" } -
示例 38
{ "enable_tpm" : false } -
示例 39
"generalLinux"
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
Ok |
|
401 |
Bad Request |
|
500 |
Internal Server Error |
错误码
请参见错误码。
