智能边缘平台 IEF智能边缘平台 IEF

文档首页> 智能边缘平台 IEF> API参考> API> 终端设备管理> 查询终端设备列表

更新时间：2021-12-27 GMT+08:00

查看PDF

查询终端设备列表

功能介绍

该API用于查询终端设备列表。

调试

您可以在API Explorer中调试该接口。

URI

GET /v2/{project_id}/edgemgr/devices

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID

表2 Query参数
参数	是否必选	参数类型	描述
name	否	String	终端设备名称，模糊匹配
node_id	否	String	节点ID, 精确匹配
limit	否	String	每页显示的条目数量，取值范围1~1000，默认为1000
offset	否	String	查询的起始位置，取值范围为非负整数，默认为0
is_binding	否	String	是否绑定到边缘节点，为“true”时返回所有已绑定到节点的设备列表，为“false”则返回未绑定节点的设备列表
tags	否	String	标签的key和value通过点连接，多个标签通过逗号连接，如：tags=key1.value1,key2.value2

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
ief-instance-id	否	String	铂金版实例ID，专业版实例为空值

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
devices	Array of Device objects	终端设备属性
count	Integer	满足条件的终端设备个数

表5 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>	孪生属性配置

表6 ValueInAttributes
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

表7 metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

表8 ValueInTwinResponse
参数	参数类型	描述
excepted	excepted object	动态属性的期望信息
actual	actual object	动态属性的实际信息
metadata	metadata object	动态属性的元数据信息
optional	Boolean	标识属性是否可选，默认为true，继承模板的属性默认为false

表9 excepted
参数	参数类型	描述
value	String	动态属性的初始值，最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、冒号、/、@、#

**表10** actual
参数	参数类型	描述
value	String	动态属性的初始值，最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、冒号、/、@、#

**表11** metadata
参数	参数类型	描述
timestamp	String	修改时间，UNIX timestamp格式

**表12** AccessConfig
参数	参数类型	描述
protocol_type	protocol_type object	设备访问类型，包含： userdefine：自定义访问协议； TCP：modbus访问协议中的一种访问形式； RTU：modbus访问协议中的一种访问形式； opc-ua：opc-ua访问协议；
protocol_name	protocol_name object	设备访问名称
slave_id	slave_id object	Modbus设备访问id(0-255)
ip	ip object	TCP传输模式下访问ip地址（标准ipv4地址）
port	port object	TCP传输模式下访问端口（0-65535）
serial_port	serial_port object	RTU传输模式下串口配置
baud_rate	baud_rate object	RTU传输模式下波特率配置，value值字段可选50、75、110、150、200、300、1200、1800、2400、9600、19200、38400、57600、115200
data_bits	data_bits object	RTU传输模式下数据位配置，value值字段包括5、6、7、8
stop_bits	stop_bits object	RTU传输模式下停止位配置，value值字段包含1、2
parity_bits	parity_bits object	RTU传输模式下校验位配置，value值字段可选为none、odd、even
url	url object	OPC-UA协议下访问url地址
sec_mode	sec_mode object	OPC-UA协议下访问安全模式
sec_policy	sec_policy object	OPC-UA协议下访问安全策略
auth_type	auth_type object	OPC-UA协议下访问认证类型，value值字段可选为0、1、2、3
username	username object	OPC-UA协议下，采用密码认证时用户名字段
password	password object	OPC-UA协议下，采用密码认证时密码字段
private_key	private_key object	OPC-UA协议下，采用证书认证时私钥字段，value字段为base64格式
certificate	certificate object	OPC-UA协议下，采用证书认证时证书字段，value字段为base64格式
timeout	timeout object	OPC-UA协议下访问超时配置，默认为5s

**表13** protocol_type
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表14** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表15** protocol_name
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表16** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表17** slave_id
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表18** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表19** ip
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表20** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表21** port
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表22** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表23** serial_port
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表24** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表25** baud_rate
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表26** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表27** data_bits
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表28** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表29** stop_bits
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表30** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表31** parity_bits
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表32** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表33** url
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表34** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表35** sec_mode
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表36** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表37** sec_policy
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表38** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表39** auth_type
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表40** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表41** username
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表42** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表43** password
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表44** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表45** private_key
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表46** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表47** certificate
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表48** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表49** timeout
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表50** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表51** ValueInPropertyVisitors
参数	参数类型	描述
register_type	register_type object	寄存器类型，value值字段可选为CoilsRegisters、HoldingRegisters、DiscreteInputsRegisters、InputRegisters
access_mode	access_mode object	访问模式，value值字段可选为r和r/w
register_index	register_index object	寄存器偏移地址，value值字段取值范围0-65535
register_num	register_num object	寄存器个数
scale_index	scale_index object	缩放因子
original_datatype	original_datatype object	原始数据类型
expected_datatype	expected_datatype object	期望数据类型
is_registerswap	is_registerswap object	是否交换寄存器顺序
is_swap	is_swap object	是否交换高低字节
sample_interval	sample_interval object	数据采集间隔，取值范围为1-3600
data_min	data_min object	原始数据值区间最小值，与原始数据类型关联
data_max	data_max object	原始数据值区间最大值，与原始数据类型关联
node_id	node_id object	节点id
browse_name	browse_name object	节点名称

**表52** register_type
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表53** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表54** access_mode
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表55** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表56** register_index
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表57** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表58** register_num
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表59** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表60** scale_index
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表61** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表62** original_datatype
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表63** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表64** expected_datatype
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表65** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表66** is_registerswap
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表67** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表68** is_swap
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表69** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表70** sample_interval
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表71** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表72** data_min
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表73** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表74** data_max
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表75** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表76** node_id
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表77** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

**表78** browse_name
参数	参数类型	描述
value	String	value 最大长度512， value允许英文字母、数字、下划线、中划线、点、逗号、@、#、+、\、/、？、^、=、%、&、:、~
optional	Boolean	标识属性是否可选，默认为true
metadata	metadata object	静态属性的元数据信息，默认为{"type": "string"}

**表79** metadata
参数	参数类型	描述
type	String	属性类型标识，string\|int\|float\|boolean（boolean类型为true或false），默认为string

请求示例

无

响应示例

状态码： 200

查询成功

{
  "devices" : [ {
    "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"
  } ],
  "count" : 1
}

状态码

状态码	描述
200	查询成功

错误码

请参见错误码。

父主题： 终端设备管理

上一篇：注册终端设备

下一篇：更新终端设备

查询终端设备列表

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

7*24

0元

专业服务

退订

建议反馈

售前咨询热线