IoT边缘 IoTEdge-在指定节点上创建外部实体:请求参数

时间:2025-02-12 14:54:51

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证

最小长度:0

最大长度:20000

表3 请求Body参数

参数

是否必选

参数类型

描述

external_id

String

外部实体Id,节点下唯一

最小长度:1

最大长度:64

protocol

String

连接外部实体的协议类型

connection_type

String

连接类型

mqtt_connection_info

MqttConnectionInfo object

mqtt连接信息

space_id

String

资源空间ID。此参数为非必选参数,存在多资源空间的用户需要使用该接口时,建议携带该参数指定创建的外部实体归属到IoDA哪个资源空间下的边缘节点设备下,否则创建的外部实体将会归属到默认资源空间下对应的边缘节点下,对应于IoDA的app_id.

最小长度:1

最大长度:36

表4 MqttConnectionInfo

参数

是否必选

参数类型

描述

server_address

String

采用cleint方式连接时,mqtt服务器地址

最小长度:4

最大长度:128

client_id

String

mqtt连接时,client_id

最小长度:4

最大长度:256

auth_type

String

鉴权类型。支持密钥认证接入(SECRET)和证书认证接入(CERTIFICATES)两种方式。使用密钥认证接入方式(SECRET)填写user_name和user_name字段,使用证书认证接入方式(CERTIFICATES)填写privateKey和certificate字段

private_key

String

证书密钥

最小长度:4

最大长度:20000

certificate

String

证书

最小长度:4

最大长度:20000

user_name

String

用户名

最小长度:4

最大长度:256

password

String

密码

最小长度:4

最大长度:256

qos

Integer

服务质量,默认为0,表示最多一次的传输,1表示至少一次,2表示仅一次.

缺省值:0

最小长度:1

最大长度:1

support.huaweicloud.com/api-iotedge/CreateExternalEntity.html