Token
OpenAPI 名称 | 描述 | 操作 |
---|---|---|
QueryToken![]() | Token鉴权方式下,云消息队列 MQTT 版服务端会颁发Token(临时凭证)给客户端,客户端访问云消息队列 MQTT 版服务端时需要携带Token用于权限验证。 Token为临时访问凭证具有一定的时效性,您可以通过本接口查询Token是否失效 | 查看文档去调试 |
ApplyToken![]() | Token鉴权方式下,云消息队列 MQTT 版服务端会颁发Token(临时凭证)给客户端,客户端访问云消息队列 MQTT 版服务端时需要携带Token用于权限验证。 本接口用于向云消息队列 MQTT 版申请临时Token | 查看文档去调试 |
RevokeToken | 吊销Token | 查看文档去调试 |
一机一密
OpenAPI 名称 | 描述 | 操作 |
---|---|---|
GetDeviceCredential![]() | 一机一密认证方式下,设备与云消息队列 MQTT 版建立连接时,需要携带提前申请的设备访问凭证信息向云消息队列 MQTT 版发起认证请求,请求通过则允许设备接入服务端。本接口用于查询指定设备的访问凭证 | 查看文档去调试 |
RefreshDeviceCredential![]() | 更新设备的访问凭证 | 查看文档去调试 |
RegisterDeviceCredential![]() | 一机一密认证方法,即预先为每个设备申请唯一的访问凭证(ClientId、DeviceAccessKeyId和DeviceAccessKeySecret)。当设备与云消息队列 MQTT 版建立连接时,需要将设备访问凭证中的信息按照约定的形式设置到Username和Password中,向云消息队列 MQTT 版发起认证请求,云消息队列 MQTT 版认证通过后激活设备,设备与云消息队列 MQTT 版间才可传输数据。 本接口用于为指定设备申请访问凭证 | 查看文档去调试 |
UnRegisterDeviceCredential | 一机一密认证方法,即预先为每个设备申请唯一的访问凭证(ClientId、DeviceAccessKeyId和DeviceAccessKeySecret)。当设备与云消息队列 MQTT 版建立连接时,需要将设备访问凭证中的信息按照约定的形式设置到Username和Password中,向云消息队列 MQTT 版发起认证请求,云消息队列 MQTT 版认证通过后激活设备,设备与云消息队列 MQTT 版间才可传输数据。 若您不需要再使用某个设备访问凭证,您可以调用本接口注销指定的设备访问凭证 | 查看文档去调试 |
ListDeviceCredentialClientId | 用于查询指定实例下有哪些设备申请了设备访问凭证(一机一密) | 查看文档去调试 |
轨迹
OpenAPI 名称 | 描述 | 操作 |
---|---|---|
QueryMqttTraceDevice![]() | 分页查询微消息队列MQTT版客户端的设备轨迹。当设备的状态出现异常时,您可以通过该接口查询指定设备的连接历史,帮助您快速定位异常原因 | 查看文档去调试 |
QueryMqttTraceMessageOfClient | 查询指定设备在一定时间段内的消息列表。当消息的收发不符合预期时,您可以通过该接口查看消息的收发状态等轨迹信息,帮助您快速定位异常原因 | 查看文档去调试 |
QueryMqttTraceMessagePublish | 查询指定消息的发送轨迹。当消息的收发不符合预期时,您可以通过该接口查看消息的发布时间、发布客户端等详细信息,帮助您快速定位异常原因 | 查看文档去调试 |
QueryMqttTraceMessageSubscribe | 查询指定消息的投递轨迹。当消息的收发不符合预期时,您可以通过该接口查看订阅该消息的客户端、消息的投递时间等详细信息,帮助您快速定位异常原因 | 查看文档去调试 |
CA证书
OpenAPI 名称 | 描述 | 操作 |
---|---|---|
RegisterCaCertificate | 云消息队列 MQTT 版支持X.509证书认证,客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书,并验证设备证书的正确性,您需要先将申请的CA证书注册到云消息队列 MQTT 版的服务端上,才能用于认证设备证书。本接口用于将指定CA证书注册到云消息队列 MQTT 版服务端 | 查看文档去调试 |
ActiveCaCertificate | 云消息队列 MQTT 版支持X.509证书认证,客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书,并验证设备证书的正确性,需要在激活状态下使用。 CA证书注册后默认为激活状态,若您需要使用的CA证书被修改为未激活状态,您可以调用本接口将CA证书重新激活 | 查看文档去调试 |
InactivateCaCertificate | 微消息队列MQTT版支持X.509证书认证,客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书,并验证设备证书的正确性。 若您暂时不需要使用某个CA证书,可通过本接口注销CA证书,将CA证书状态变成未激活。当您需要继续使用该CA证书时,可通过ActiveCaCertificate接口将CA证书重新激活 | 查看文档去调试 |
ListCaCertificate | 云消息队列 MQTT 版支持X.509证书认证,客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书,并验证设备证书的正确性。 本接口用于查询指定实例下所有注册的CA证书 | 查看文档去调试 |
GetCaCertificate | 云消息队列 MQTT 版支持X.509证书认证,客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书,并验证设备证书的正确性。 您可以调用本接口查询指定CA证书的证书内容以及激活状态等详细信息 | 查看文档去调试 |
GetRegisterCode | 注册CA证书到云消息队列 MQTT 版服务端时,需要上传CA证书的验证证</span>书,用于验证用户是否有该CA证书的私钥。CA证书的验证证书需要通过CA证书的注册码生成,本接口用于获取指定CA证书的注册码 | 查看文档去调试 |
DeleteCaCertificate | 云消息队列 MQTT 版支持X.509证书认证,客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书,并验证设备证书的正确性。 使用CA证书需要先将证书注册到云消息队列 MQTT 版服务端,若您不再需要使用某个CA证书,您可以调用DeleteCaCertificate接口将该证书从服务端记录中删除 | 查看文档去调试 |
设备证书
OpenAPI 名称 | 描述 | 操作 |
---|---|---|
ActiveDeviceCertificate | 设备证书是由CA根证书签发给客户端设备使用的数字证书,用于客户端和服务端连接时,服务端对客户端进行安全认证。 客户端设备使用设备证书进行接入认证时,服务端会根据已注册的CA证书验证设备证书是否正确,若CA证书和设备证书匹配成功,则客户端认证通过,且系统会将该设备证书自动注册到服务端中。 设备证书在服务端注册后默认为激活状态,若您需要使用的设备证书被修改为未激活状态,您可以调用本接口将设备证书重新激活 | 查看文档去调试 |
InactivateDeviceCertificate | 设备证书是由CA根证书签发给客户端设备使用的数字证书,用于客户端和服务端连接时,服务端对客户端进行安全认证。认证通过后服务端和客户端可基于证书内的加密密钥进行安全通信,若认证不通过则服务端拒绝客户端接入。 若您暂时不需要使用某个设备证书,可通过该接口注销设备证书,将设备证书状态变成未激活 | 查看文档去调试 |
ListDeviceCertificate | 设备证书是由CA根证书签发给客户端设备使用的数字证书,用于客户端和服务端连接时,服务端对客户端进行安全认证。认证通过后服务端和客户端可基于证书内的加密密钥进行安全通信,若认证不通过则服务端拒绝客户端接入。 本接口用于查询指定实例下所有注册的设备证书 | 查看文档去调试 |
ListDeviceCertificateByCaSn | 设备证书是由CA根证书签发给客户端设备使用的数字证书,用于客户端和服务端连接时,服务端对客户端进行安全认证。认证通过后服务端和客户端可基于证书内的加密密钥进行安全通信,若认证不通过则服务端拒绝客户端接入。 本接口用于查询由指定CA证书签发且已在微消息队列MQTT版服务端注册的所有设备证书 | 查看文档去调试 |
GetDeviceCertificate | 设备证书是由CA根证书签发给客户端设备使用的数字证书,用于客户端和服务端连接时,服务端对客户端进行安全认证。认证通过后服务端和客户端可基于证书内的加密密钥进行安全通信,若认证不通过则服务端拒绝客户端接入。 您可以调用本接口获取设备证书的详细信息 | 查看文档去调试 |
DeleteDeviceCertificate | 设备证书是由CA根证书签发给客户端设备使用的数字证书,用于客户端和服务端连接时,服务端对客户端进行安全认证。认证通过后服务端和客户端可基于证书内的加密密钥进行安全通信,若认证不通过则服务端拒绝客户端接入。 若您不想需要使用某个设备证书,您可以调用本接口将指定设备证书的注册信息从服务端的存储记录中删除 | 查看文档去调试 |
自定义权限
OpenAPI 名称 | 描述 | 操作 |
---|---|---|
AddCustomAuthIdentity | 添加账号身份认证信息,可以具体到客户端 | 查看文档去调试 |
UpdateCustomAuthIdentity | 更新自定义身份认证 | 查看文档去调试 |
QueryCustomAuthIdentity | 查询自定义身份认证 | 查看文档去调试 |
DeleteCustomAuthIdentity | 删除自定义身份认证 | 查看文档去调试 |
AddCustomAuthPermission | 添加Topic资源授权信息,且需要在控制台提前创建一级Topic | 查看文档去调试 |
UpdateCustomAuthPermission | 更新Topic资源授权信息 | 查看文档去调试 |
QueryCustomAuthPermission | 查询Topic授权信息 | 查看文档去调试 |
DeleteCustomAuthPermission | 删除Topic授权 | 查看文档去调试 |
AddCustomAuthConnectBlack | 添加连接黑名单,禁用某个设备连接 | 查看文档去调试 |
DeleteCustomAuthConnectBlack | 删除连接黑名单 | 查看文档去调试 |
QueryCustomAuthConnectBlack | 查询连接黑名单 | 查看文档去调试 |