通过编程的方式在业务系统中集成MNS的能力,做到根据业务的实际需要自动化进行消息收发,简化运营、管理成本。本文为您介绍MNS的两种资源类型及其各自的使用方法。
资源类型
MNS提供以下两种维度的开发资源:
控制台SDK:控制台资源包括队列资源(Queue)、主题资源(Topic)、主题订阅(Subscription), 控制台SDK涉及资源的增删改查相关内容。
客户端SDK:涉及Queue的消息发送、接收、删除、Topic的消息发送、下游订阅消费消息等内容,以及实际消息的收发处理。
控制台SDK
OpenAPI介绍
在对队列资源(Queue)、主题资源(Topic)、主题订阅(Subscription)等资源进行管理时,你可以使用阿里云提供的OpenAPI网站,它是一款集OpenAPI智能搜索、文档、在线调试、SDK获取、CodeSample、调用出错诊断、调用统计为一体的产品。您可以在OpenAPI门户中调用阿里云各云产品开放的OpenAPI,查看OpenAPI请求和返回结果。此外,OpenAPI门户会自动生成相应的SDK调用示例,帮助您快速使用阿里云产品。更多信息,请参见什么是 OpenAPI。
版本说明
MNS提供主题管理、队列管理、订阅管理等多种OpenAPI,满足您在业务系统中集成的需求。
阿里云OpenAPI通过版本号管控各时期云产品大版本的API列表。
例如:MNS目前支持2022-01-19
版本的API列表,2022-01-19
代表的是API版本号而非时间概念,所展示的都是最新的API公开数据,并非自2022-01-19
之后就未更新。
API 版本号 | 说明 |
推荐使用 |
在线调试
MNS在OpenAPI门户提供API调试等功能。在调用前,您需要了解MNS提供的版本、接入点、接口风格、调用方式等信息。
调试入口
调试入口为:https://api.aliyun.com/api/Mns-open/2022-01-19/
接入点说明
接入点的详细地址,请参见服务接入点。
支持的调用身份
您阿里云账号登录OpenAPI网站后,OpenAPI默认使用您的阿里云账号进行在线OpenAPI调试。阿里云账号拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。请根据业务的实际情况按需分配权限后进行接口调用。RAM用户需具备操作权限,详情请参见使用RAM进行访问控制。
用户身份 | 支持情况 |
支持 | |
RAM用户(推荐) | 支持 |
RAM角色(推荐) | 支持 |
集成方式
MNS提供SDK等多种集成方式,您可以根据业务的实际需要进行选择。
集成方式 | 支持情况 | 备注 |
阿里云SDK | 支持 | MNS SDK支持的语言及其依赖的安装方法,请参见SDK参考 说明 阿里云SDK的集成说明,请参见阿里云 SDK。 |
阿里云CLI | 支持 | 阿里云CLI的调用说明,请参见阿里云 CLI。 |
资源编排 | 支持 | 阿里云资源编排的调用说明,请参见资源编排。 |
Terraform | 支持 | Terraform编排调用说明,请参见Terraform。 |
如果以上方案均无法满足您的业务需求,您可以自行封装请求调用OpenAPI。更多信息,请参见自定义HTTP封装。
客户端SDK
当进行实际消息的收发处理时,例如使用Queue进行消息收发、删除、Topic的消息发送、下游订阅消费消息等内容,MNS使用自建网关维护的API和SDK实现,详情请参见客户端SDK。