更新时间:2023-11-29 GMT+08:00
分享

注册终端设备

功能介绍

注册终端设备。

调试

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

URI

POST /v2/{project_id}/edgemgr/devices

表1 路径参数

参数

是否必选

参数类型

描述

project_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参数

参数

是否必选

参数类型

描述

device

EdgemgrDevicesDetail object

终端设备属性

表4 EdgemgrDevicesDetail

参数

是否必选

参数类型

描述

id

String

终端设备ID,只允许英文字母、数字、下划线、中划线,必须以英文字母和数字开头,长度限制为24~64之间

name

String

终端设备名称,只允许中文字符、英文字母、数字、下划线、中划线,长度限制为1~64

description

String

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

attributes

Map<String,ValueInAttributes>

终端设备静态属性

connection_type

String

连接类型,默认为edge

access_protocol

String

访问协议,有如下选项:

  • userdefine:自定义协议

  • modbus:modbus协议

  • opc-ua:opc-ua协议 默认为userdefine

twin

Map<String,ValueInTwin>

终端设备动态属性

access_config

AccessConfig object

访问配置,与access_protocol直接关联

property_visitors

Map<String,ValueInPropertyVisitors>

孪生属性配置

表5 ValueInTwin

参数

是否必选

参数类型

描述

excepted

Excepted object

动态属性的期望信息

optional

Boolean

动态属性的实际信息

metadata

metadata object

动态属性的元数据信息

表6 Excepted

参数

是否必选

参数类型

描述

value

String

动态属性的初始值,最大长度512,value允许英文字母、数字、下划线、中划线、点、逗号、冒号、/、@、+、?、^、=、%、&、~、#、!、*

metadata

metadata object

期望值设置的时间信息

表7 metadata

参数

是否必选

参数类型

描述

type

String

属性类型标识,string|int|float|boolean(boolean类型为true或false),默认为string

表8 AccessConfig

参数

是否必选

参数类型

描述

protocol_type

ValueInAttributes object

设备访问类型,包含:

  • userdefine:自定义访问协议

  • TCP:modbus访问协议中的一种访问形式

  • RTU:modbus访问协议中的一种访问形式

  • opc-ua:opc-ua访问协议

protocol_name

ValueInAttributes object

设备访问名称

slave_id

ValueInAttributes object

Modbus设备访问id(0-255)

ip

ValueInAttributes object

TCP传输模式下访问ip地址(标准ipv4地址)

port

ValueInAttributes object

TCP传输模式下访问端口(0-65535)

serial_port

ValueInAttributes object

RTU传输模式下串口配置

baud_rate

ValueInAttributes object

RTU传输模式下波特率配置,value值字段可选50、75、110、150、200、300、1200、1800、2400、9600、19200、38400、57600、115200

data_bits

ValueInAttributes object

RTU传输模式下数据位配置,value值字段包括5、6、7、8

stop_bits

ValueInAttributes object

RTU传输模式下停止位配置,value值字段包含1、2

parity_bits

ValueInAttributes object

RTU传输模式下校验位配置,value值字段可选为none、odd、even

url

ValueInAttributes object

OPC-UA协议下访问url地址

sec_mode

ValueInAttributes object

OPC-UA协议下访问安全模式

sec_policy

ValueInAttributes object

OPC-UA协议下访问安全策略

auth_type

ValueInAttributes object

OPC-UA协议下访问认证类型,value值字段可选为0、1、2、3

username

ValueInAttributes object

OPC-UA协议下,采用密码认证时用户名字段

password

ValueInAttributes object

OPC-UA协议下,采用密码认证时密码字段

private_key

ValueInAttributes object

OPC-UA协议下,采用证书认证时私钥字段,value字段为base64格式

certificate

ValueInAttributes object

OPC-UA协议下,采用证书认证时证书字段,value字段为base64格式

timeout

ValueInAttributes object

OPC-UA协议下访问超时配置,默认为5s

表9 ValueInPropertyVisitors

参数

是否必选

参数类型

描述

register_type

ValueInAttributes object

寄存器类型,value值字段可选为CoilsRegisters、HoldingRegisters、DiscreteInputsRegisters、InputRegisters

access_mode

ValueInAttributes object

访问模式,value值字段可选为r和r/w

register_index

ValueInAttributes object

寄存器偏移地址,value值字段取值范围0-65535

register_num

ValueInAttributes object

寄存器个数

scale_index

ValueInAttributes object

缩放因子

original_datatype

ValueInAttributes object

原始数据类型

expected_datatype

ValueInAttributes object

期望数据类型

is_registerswap

ValueInAttributes object

是否交换寄存器顺序

is_swap

ValueInAttributes object

是否交换高低字节

sample_interval

ValueInAttributes object

数据采集间隔,取值范围为1-3600

data_min

ValueInAttributes object

原始数据值区间最小值,与原始数据类型关联

data_max

ValueInAttributes object

原始数据值区间最大值,与原始数据类型关联

node_id

ValueInAttributes object

节点id

browse_name

ValueInAttributes object

节点名称

表10 ValueInAttributes

参数

是否必选

参数类型

描述

value

String

value 最大长度512,value允许英文字母、数字、下划线、中划线、点、逗号、冒号、/、@、+、?、^、=、%、&、~、#、!、*

optional

Boolean

标识属性是否可选,默认为true

metadata

Metadata object

静态属性的元数据信息,默认为{"type": "string"}

表11 Metadata

参数

是否必选

参数类型

描述

type

String

属性类型标识,string|int|float|boolean(boolean类型为true或false),默认为string

响应参数

状态码: 201

表12 响应Body参数

参数

参数类型

描述

device

Device object

终端设备属性

表13 Device

参数

参数类型

描述

id

String

终端设备ID,只允许英文字母、数字、下划线、中划线,必须以英文字母和数字开头,长度限制为24~64之间

name

String

终端设备名称,只允许中文字符、英文字母、数字、下划线、中划线,长度限制为1~64

access_protocol

String

访问协议,有如下选项:

  • userdefine:自定义协议

  • modbus:modbus协议

  • opc-ua:opc-ua协议 默认为userdefine

description

String

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

project_id

String

项目ID

created_at

String

创建时间

updated_at

String

更新时间

attributes

Map<String,ValueInAttributes>

终端设备静态属性信息

connection_type

String

连接类型,默认为edge

twin

Map<String,ValueInTwinResponse>

终端设备孪生属性信息

access_config

AccessConfig object

访问配置,与access_protocol直接关联

property_visitors

Map<String,ValueInPropertyVisitors>

孪生属性配置

表14 ValueInTwinResponse

参数

参数类型

描述

excepted

ExceptedActual object

动态属性的期望信息

actual

ExceptedActual object

动态属性的实际信息

metadata

Metadata object

动态属性的元数据信息

optional

Boolean

标识属性是否可选,默认为true,继承模板的属性默认为false

表15 ExceptedActual

参数

参数类型

描述

value

String

动态属性的初始值,最大长度512,value允许英文字母、数字、下划线、中划线、点、逗号、冒号、/、@、+、?、^、=、%、&、~、#、!、*

表16 AccessConfig

参数

参数类型

描述

protocol_type

ValueInAttributes object

设备访问类型,包含:

  • userdefine:自定义访问协议

  • TCP:modbus访问协议中的一种访问形式

  • RTU:modbus访问协议中的一种访问形式

  • opc-ua:opc-ua访问协议

protocol_name

ValueInAttributes object

设备访问名称

slave_id

ValueInAttributes object

Modbus设备访问id(0-255)

ip

ValueInAttributes object

TCP传输模式下访问ip地址(标准ipv4地址)

port

ValueInAttributes object

TCP传输模式下访问端口(0-65535)

serial_port

ValueInAttributes object

RTU传输模式下串口配置

baud_rate

ValueInAttributes object

RTU传输模式下波特率配置,value值字段可选50、75、110、150、200、300、1200、1800、2400、9600、19200、38400、57600、115200

data_bits

ValueInAttributes object

RTU传输模式下数据位配置,value值字段包括5、6、7、8

stop_bits

ValueInAttributes object

RTU传输模式下停止位配置,value值字段包含1、2

parity_bits

ValueInAttributes object

RTU传输模式下校验位配置,value值字段可选为none、odd、even

url

ValueInAttributes object

OPC-UA协议下访问url地址

sec_mode

ValueInAttributes object

OPC-UA协议下访问安全模式

sec_policy

ValueInAttributes object

OPC-UA协议下访问安全策略

auth_type

ValueInAttributes object

OPC-UA协议下访问认证类型,value值字段可选为0、1、2、3

username

ValueInAttributes object

OPC-UA协议下,采用密码认证时用户名字段

password

ValueInAttributes object

OPC-UA协议下,采用密码认证时密码字段

private_key

ValueInAttributes object

OPC-UA协议下,采用证书认证时私钥字段,value字段为base64格式

certificate

ValueInAttributes object

OPC-UA协议下,采用证书认证时证书字段,value字段为base64格式

timeout

ValueInAttributes object

OPC-UA协议下访问超时配置,默认为5s

表17 ValueInPropertyVisitors

参数

参数类型

描述

register_type

ValueInAttributes object

寄存器类型,value值字段可选为CoilsRegisters、HoldingRegisters、DiscreteInputsRegisters、InputRegisters

access_mode

ValueInAttributes object

访问模式,value值字段可选为r和r/w

register_index

ValueInAttributes object

寄存器偏移地址,value值字段取值范围0-65535

register_num

ValueInAttributes object

寄存器个数

scale_index

ValueInAttributes object

缩放因子

original_datatype

ValueInAttributes object

原始数据类型

expected_datatype

ValueInAttributes object

期望数据类型

is_registerswap

ValueInAttributes object

是否交换寄存器顺序

is_swap

ValueInAttributes object

是否交换高低字节

sample_interval

ValueInAttributes object

数据采集间隔,取值范围为1-3600

data_min

ValueInAttributes object

原始数据值区间最小值,与原始数据类型关联

data_max

ValueInAttributes object

原始数据值区间最大值,与原始数据类型关联

node_id

ValueInAttributes object

节点id

browse_name

ValueInAttributes object

节点名称

表18 ValueInAttributes

参数

参数类型

描述

value

String

value 最大长度512,value允许英文字母、数字、下划线、中划线、点、逗号、冒号、/、@、+、?、^、=、%、&、~、#、!、*

optional

Boolean

标识属性是否可选,默认为true

metadata

Metadata object

静态属性的元数据信息,默认为{"type": "string"}

表19 Metadata

参数

参数类型

描述

type

String

属性类型标识,string|int|float|boolean(boolean类型为true或false),默认为string

请求示例

注册终端设备,自定义访问协议,连接类型为“edge”。

{
  "device" : {
    "access_protocol" : "userdefine",
    "name" : "device",
    "connection_type" : "edge",
    "description" : ""
  }
}

响应示例

状态码: 201

ok

{
  "device" : {
    "id" : "1398f13d-f24d-4de4-8cd3-5905db1d6d9f",
    "name" : "device",
    "access_protocol" : "",
    "project_id" : "05e1aef9040010e22fccc009adecb056",
    "description" : "",
    "created_at" : "2020-09-23T02:00:22.858736Z",
    "updated_at" : "",
    "access_config" : { },
    "connection_type" : "edge"
  }
}

状态码

状态码

描述

201

ok

错误码

请参见错误码

相关文档