文档首页/华为HiLens/API参考/API（专业版控制台）/设备管理/注册设备
更新时间：2025-07-24 GMT+08:00
查看PDF
分享

注册设备

功能介绍

填写设备信息，将设备注册到HiLens专业版控制台上。

URI

POST /v3/{project_id}/ai-mgr/nodes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

表2 Query参数

参数

是否必选

参数类型

描述

provider

否

String

服务提供者：ief或hilens，选择设备纳管到不同的平台。不填默认为hilens平台

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token。获取方法请参见获取Token

表4 请求Body参数

参数

是否必选

参数类型

描述

node

是

NodeReqDetail object

注册设备信息请求体

表5 NodeReqDetail

参数

是否必选

参数类型

描述

batch

否

Integer

批量注册数量。默认为单设备注册，即batch=1，如果大于1即为批量注册的最大数量。最大上限数量为100000

description

否

String

设备描述，最大长度255，不允许^, ~, ＃, $, %, &, *, <, >, (, ), [, ], {, }, ', ", \

enable_gpu

否

Boolean

是否开启GPU，true表示开启，false表示不开启，默认为false

enable_npu

否

Boolean

是否开启NPU，true表示开启，false表示不开启，默认为false

iam_user_id

否

String

子账号ID。当主账号注册设备时，可以指定将设备注册到指定的子账号下面。不填默认为该发起注册行为用户的user_id

log_configs

否

Array of LogConfig objects

设备日志配置

name

是

String

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

npu_type

否

String

NPU类型，D310/D910。不填表示为D310类型。

tags

否

Array of TagObject objects

设备标签，标签个数最多为20个

workspace_id

否

String

工作空间ID，不填为主账号/子账号的默认工作空间

event_validity_period

否

Integer

事件有效时间（单位：分钟）

表6 LogConfig

参数

是否必选

参数类型

描述

component

是

String

app：应用日志。 system：系统的日志

level

否

String

系统级日志可配置为/error/warning/info/debug ; 不传会默认为info。

rotate_num

否

Integer

日志rotate个数，默认5，hilens取值范围1-30，ief取值范围1-10

rotate_period

否

String

日志rotate周期，可选项，只支持ief：daily monthly weekly yearly.

size

否

Integer

应用日志文件大小限制，单位MB，默认50，取值范围10-1000。

type

是

String

  • LTS 将日志发送到云日志服务（Log Tank Service，简称LTS）

  • local 本地日志

表7 TagObject

参数

是否必选

参数类型

描述

key

否

String

标签键，最大长度36个字符。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_”

value

否

String

标签值，每个值最大长度43个字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_”

响应参数

状态码： 200

表8 响应Body参数

参数

参数类型

描述

id

String

设备ID

name

String

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

package

String

将设备配置和证书文件node.conf/certificate/private_key打成.tar.gz包后用base64编码的字符串。node.conf包含节点信息配置

请求示例

注册设备到HiLens专业版控制台

POST https://{endpoint}/v3/{project_id}/ai-mgr/nodes?provider=hilens

{
  "node" : {
    "name" : "gg11112344",
    "description" : "",
    "tags" : [ ],
    "iam_user_id" : "19a1ef99f8ed4d4ab38be5085adaf84a",
    "batch" : 1,
    "enable_npu" : false,
    "enable_gpu" : false,
    "log_configs" : [ {
      "size" : "50",
      "rotate_num" : 10,
      "type" : "LTS",
      "component" : "app"
    } ]
  }
}

响应示例

状态码： 200

请求成功

{
  "name" : "hc_node_1",
  "id" : "hilens-ff2e579f627549cda552a0b2098ef025",
  "package" : "H4sIAAAAAPOV6......bEnACAAAA=="
}

状态码

状态码

描述

200

请求成功

201

创建成功

401

认证不通过

403

拒绝执行请求

404

请求的资源不存在

500

服务器内部错误

错误码

请参见错误码。

父主题：设备管理

相关文档