阿里云OpenAPI开发者门户

微消息队列 MQTT - OpenAPI 概览2020-04-20
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
Token
OpenAPI 名称描述操作
QueryTokenhotToken鉴权方式下,云消息队列 MQTT 版服务端会颁发Token(临时凭证)给客户端,客户端访问云消息队列 MQTT 版服务端时需要携带Token用于权限验证。 Token为临时访问凭证具有一定的时效性,您可以通过本接口查询Token是否失效查看文档去调试
ApplyTokenhotToken鉴权方式下,云消息队列 MQTT 版服务端会颁发Token(临时凭证)给客户端,客户端访问云消息队列 MQTT 版服务端时需要携带Token用于权限验证。 本接口用于向云消息队列 MQTT 版申请临时Token查看文档去调试
RevokeToken吊销Token查看文档去调试
Instance
OpenAPI 名称描述操作
ListInstances查询实例列表查看文档去调试
Group ID
OpenAPI 名称描述操作
CreateGroupIdhot消息生产者和消费者客户端接入云消息队列 MQTT 版服务端收发消息时,需要指定Client ID,用于唯一标识一个客户端。 Client ID由两部分组成,组织形式为<GroupID>@@@<DeviceID>,DeviceID由客户端自定义,GroupID需要提前在云消息队列 MQTT 版服务端创建查看文档去调试
ListGroupId查看某实例下的所有Group ID查看文档去调试
DeleteGroupId删除Group ID查看文档去调试
消息
OpenAPI 名称描述操作
SendMessagehot从服务端应用向云消息队列 MQTT 版发送单条消息查看文档去调试
客户端
OpenAPI 名称描述操作
QuerySessionByClientIdhot**QuerySessionByClientId**接口一般用于线上追踪单个设备的运行状态,再根据查询到的信息排查问题。输入Client ID即可查到对应设备是否在线、设备地址等信息查看文档去调试
BatchQuerySessionByClientIdshot根据 Client ID 批量查询客户端在线状态查看文档去调试
CloseConnection主动关闭在线连接,不过设备仍然可能会重连,取决于客户端重连机制查看文档去调试
一机一密
OpenAPI 名称描述操作
GetDeviceCredentialhot一机一密认证方式下,设备与云消息队列 MQTT 版建立连接时,需要携带提前申请的设备访问凭证信息向云消息队列 MQTT 版发起认证请求,请求通过则允许设备接入服务端。本接口用于查询指定设备的访问凭证查看文档去调试
RefreshDeviceCredentialhot更新设备的访问凭证查看文档去调试
RegisterDeviceCredentialhot一机一密认证方法,即预先为每个设备申请唯一的访问凭证(ClientId、DeviceAccessKeyId和DeviceAccessKeySecret)。当设备与云消息队列 MQTT 版建立连接时,需要将设备访问凭证中的信息按照约定的形式设置到Username和Password中,向云消息队列 MQTT 版发起认证请求,云消息队列 MQTT 版认证通过后激活设备,设备与云消息队列 MQTT 版间才可传输数据。 本接口用于为指定设备申请访问凭证查看文档去调试
UnRegisterDeviceCredential一机一密认证方法,即预先为每个设备申请唯一的访问凭证(ClientId、DeviceAccessKeyId和DeviceAccessKeySecret)。当设备与云消息队列 MQTT 版建立连接时,需要将设备访问凭证中的信息按照约定的形式设置到Username和Password中,向云消息队列 MQTT 版发起认证请求,云消息队列 MQTT 版认证通过后激活设备,设备与云消息队列 MQTT 版间才可传输数据。 若您不需要再使用某个设备访问凭证,您可以调用本接口注销指定的设备访问凭证查看文档去调试
ListDeviceCredentialClientId用于查询指定实例下有哪些设备申请了设备访问凭证(一机一密)查看文档去调试
轨迹
OpenAPI 名称描述操作
QueryMqttTraceDevicehot分页查询微消息队列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查询连接黑名单查看文档去调试
标签
OpenAPI 名称描述操作
TagResources为资源新增标签查看文档去调试
ListTagResources查询标签查看文档去调试
UntagResources删除标签查看文档去调试
其他
OpenAPI 名称描述操作
SetSniConfig配置多域名证书查看文档去调试
DisasterDowngrade多实例容灾降级,该接口作用是降级其中某个实例的公网VIP接入,目前只支持铂金版实例,需要提交工单申请查看文档去调试
DisasterRecovery多实例容灾降级恢复,该接口作用是恢复其中某个实例的公网VIP接入,目前只支持铂金版实例,需要提交工单申请查看文档去调试