请求参数
4.1.4 查询边缘节点详情
功能介绍
该API用于查询边缘节点详情。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/{project_id}/edgemgr/nodes/{node_id}
表4-52 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID
node_id 是 String 边缘节点ID
请求参数
表4-53 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
ief-instance-id 否 String 铂金版实例ID，专业版实例为空 值
响应参数
状态码： 200
表4-54 响应 Body 参数
参数 参数类型 描述
node EdgeNodeRe
sp object 边缘节点参数
表4-55 EdgeNodeResp
参数 参数类型 描述
id String 边缘节点ID
name String 边缘节点名称，只允许中文字符、英文字母、数
字、下划线、中划线，最大长度64 Name为必填 字段，且本帐号中唯一。
description String 边缘节点描述，最大长度255，不允许^ ~ # $ %
& * < > ( ) [ ] { } ' " \ created_at String 创建时间
updated_at String 更新时间 project_id String 项目ID private_key String 私钥 certificate String 证书
ca String 根证书
state String 边缘节点状态
● UNCONNECTED（未注册）
● RUNNING（运行中）
● FAIL（故障）
● STOPPED（停用）
● UPGRADING（升级中）
● FREEZE（冻结）
package String 将证书文件certificate/ca/private_key打成.tar.gz 包后用base64编码的字符串。 使用时请使用 base64解码成.tar.gz包。
master_addr String 云端服务URL
cpu Integer 边缘节点CPU核心数
memory Integer 边缘节点内存大小，单位M os_name String 边缘节点操作系统名称 os_version String 边缘节点操作系统版本
参数 参数类型 描述 pause_docker
_image String pause容器镜像URL
arch String 边缘节点架构
os_type String 边缘节点操作系统类型 deployment_n
um Integer 部署在该边缘节点上的应用实例个数
enable_gpu Boolean 边缘节点是否开启GPU，默认为false log_configs Array of
LogConfigs objects
边缘节点日志配置
device_infos Array of DeviceInfos objects
关联设备信息
edged_version String edged版本 gpu_num Integer gpu个数 host_ips Array of
strings 主机IP，默认返回eth0网卡的IP。
relation String 与device绑定关系名称（通过device id查询node 时有值）
comment String 与device绑定关系描述（通过device id查询node 时有值）
gpu_info Array of GpuInfo objects
gpu型号和gpu memory大小
device_num Integer 关联设备数量
enable_npu Boolean 边缘节点是否开启NPU，true表示开启，false表 示不开启，默认为false
npu_type String npu类型，支持D310类型和D910类型。
● D310表示D310类型。
● D910表示D910类型。
● 不填表示为D310类型。
nics Array of Nics
objects 节点网卡和对应IP地址信息 host_name String 边缘节点主机名
ief_node_versi
on String 边缘节点版本
参数 参数类型 描述
upgrade_flag Boolean 是否能升级的标志
● true：需要升级
● false：不需要升级
product_id String 产品ID（通过产品证书方式纳管）
group_ids Array of
strings 节点组ID（一个节点属于多个节点组）
upgrade_histo
ry Array of UpgradeHist ory objects
节点安装或升级记录
attributes Array of Attributes objects
边缘节点属性，关联属性个数最多为32个
docker_enable Boolean 节点是否开启Docker mqtt_mode String mqtt集成模式
● internal：edgecore内置mqtt
● external：外置开源mqtt mqtt_external String 外置开源mqtt地址
mqtt_internal String edgecore内置的mqtt地址
node_type String 节点类型，默认为空，非空时为小站节点 ntp_configs NtpConfigs
object ntp配置 error_reason String 节点故障原因 tags Array of
ResourceTag objects
边缘节点标签，标签个数最多为20个
npu_num Integer NPU数量 npu_info Array of
NpuInfo objects
NPU型号和NPU Memory大小
container_run
time_version String 容器运行时版本
表4-56 LogConfigs
参数 参数类型 描述
id String 数据库保存的主键，不需要关注此字段。
参数 参数类型 描述
size Integer 应用日志文件大小限制，单位MB，默认50，取值 范围10-1000。
level String ● 当type为LTS时，应用级日志可配置为On或 Off；系统级日志可配置为Off/Error/Warning/
Info/Debug；
● 当type为local时，无需配置level。
rotate_num Integer 应用日志rotate个数，默认5，取值范围1-10。
rotate_period String 应用日志rotate周期，可选项：
● daily
● monthly
● weekly
● yearly
type String ● LTS：将日志发送到AOM
● local：本地日志
component String ● app：部署到边缘节点上的应用的日志
● system：边缘节点上系统的日志
表4-57 DeviceInfos
参数 参数类型 描述
relation String 设备和节点关系的名称，只允许中文字符、英文 字母、数字、下划线、中划线，最大长度64 comment String 设备和节点关系的描述，最大长度64，不允许^ ~
# $ % & * < > ( ) [ ] { } ' " \ device_ids Array of
strings 设备ID列表
表4-58 GpuInfo
参数 参数类型 描述
name String GPU名称
type String GPU类型
capacity String GPU memory大小，单位MB
表4-59 Nics
参数 参数类型 描述
interface String 边缘节点网卡名称
ip String 上述网卡对应的IPv4地址
表4-60 UpgradeHistory
参数 参数类型 描述
id Integer 节点升级或安装历史版本id
from_version String 节点升级前节点上edgecore版本号，形式如 2.1.0，其中每一位都是整数
to_version String 节点升级或安装后节点行edgecore版本号，形式 如2.1.0，其中每一位都是整数
upgrade_time Integer 节点升级或安装的十位时间戳 result String 节点升级或安装状态，包含
● install_success：边缘节点安装成功
● upgrade_success：边缘节点升级成功
● install_failed：边缘节点安装失败
● upgrade_failed：边缘节点升级失败
● upgrade_failed_rollback_success：边缘节点 升级失败回滚成功
● upgrade_failed_rollback_failed：边缘节点升 级失败回滚失败
dur_time Integer 节点升级所消耗的时间
表4-61 Attributes
参数 参数类型 描述
key String 节点属性的key值，长度取值范围为1~128， 仅 允许大小写英文字母、数字、下划线、中划线 value String 节点属性的value值，长度取值范围为1~256， 仅
允许大小写英文字母、数字、下划线、中划线
表4-62 NtpConfigs
参数 参数类型 描述
ntp_enabled Boolean ntp服务是否开启 ntpservers Array of
strings ntp server地址
表4-63 ResourceTag
参数 参数类型 描述
key String 键。最大长度36个unicode字符。 不能为空，只 能包含大小写字母，数字，中划线“-”，下划线
“_”。
value String 值。每个值最大长度43个unicode字符，删除时 如果value有值按照key/value删除，如果value没 值，则按照key删除。 不能为空，只能包含大小 写字母，数字，中划线“-”，下划线“_”。
表4-64 NpuInfo
参数 参数类型 描述
name String NPU名称
type String NPU类型
capacity String NPU memory大小 driver_version String NPU驱动版本
请求示例
无
响应示例
状态码： 200 查询成功
{ "node" : {
"edged_version" : "2.6.0",
"mqtt_internal" : "tls://0.0.0.0:8883", "ca" : null,
"updated_at" : "2019-07-24T06:11:54.649516+08:00", "node_type" : null,
"docker_enable" : true, "device_infos" : [ ],
"upgrade_history" : [ { "to_version" : "2.3.0", "upgrade_time" : 1557987888, "result" : "install_success", "id" : 0
}, {
"from_version" : "2.3.0", "to_version" : "2.3.0", "result" : "install_success", "dur_time" : 2248264, "result" : "install_success", "dur_time" : 87129, "result" : "install_success", "dur_time" : 158246, "result" : "install_success", "dur_time" : 1466742, "result" : "install_success", "dur_time" : 884941, "result" : "install_success", "dur_time" : 1106868, "upgrade_time" : 1563940078, "id" : 6
} ],
"pause_docker_image" : null, "ntp_configs" : {
"ntp_servers" : [ "10.127.1.0", "ntp.myhuaweicloud.com" ], "ntp_enabled" : true
},
"ief_node_version" : "2.6.0",
"id" : "699de693-8493-4912-89dc-882134c5bf13", "device_num" : 0,
"os_version" : "3.10.0-957.21.3.el7.x86_64", "state" : "RUNNING",
"error_reason" : null, "memory" : 990, "mqtt_mode" : "internal", "project_id" : "",
"private_key" : null,
"os_name" : "CentOS Linux 7 (Core)", "description" : "",
"gpu_info" : [ ], "mqtt_external" : null, "arch" : "x86_64",
"container_runtime_version" : "docker://19.03.0", "created_at" : "2019-05-16T06:19:10.303502+08:00", "cpu" : 1,
"product_id" : null, "host_name" : "iefnode", "attributes" : [ ],
"id" : "ccc1080e-e156-48d2-b2d0-20044900d6ac", "size" : 50
"id" : "e42f9c75-e010-4320-ad2d-a7501a3aa543", "size" : 50
}, {
"level" : "off", "rotate_num" : 5, "component" : "system", "rotate_period" : "yearly", "type" : "LTS",
"id" : "b29659b5-364a-4d7e-8447-b5525b6b46d0", "size" : 50
}, {
"level" : "off", "rotate_num" : 5, "component" : "app", "rotate_period" : "yearly", "type" : "LTS",
"id" : "c4ac8c83-64f5-4b84-b163-33581f08b1a8", "size" : 50