文档

集成概览

更新时间:

通过编程的方式在业务系统中集成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 版本号

说明

2022-01-19

推荐使用

在线调试

MNS在OpenAPI门户提供API调试等功能。在调用前,您需要了解MNS提供的版本、接入点、接口风格、调用方式等信息。image

调试入口

调试入口为: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