本文介绍如何通过轻量消息队列(原 MNS)获取IMM异步任务的执行状态消息。
创建轻量消息队列(原 MNS)相关资源
步骤一:创建轻量消息队列主题
- 在左侧导航栏选择主题列表,并单击创建主题。 
- 在创建主题面板设置主题的相关信息,如下以创建名称为tf-test-mns-topic的主题为例。  
- 单击确定。 
步骤二:创建轻量消息队列(原 MNS)队列
- 在左侧导航栏选择队列列表,并单击创建队列。 
- 在创建队列面板设置队列的相关信息,如下以创建名称为tf-test-mns-queue的列队为例。  
- 单击确定。 
步骤三:关联轻量消息队列(原 MNS)主题与队列
- 在左侧导航栏选择主题列表,并单击步骤一:创建轻量消息队列(原 MNS)主题中创建的主题名称,即tf-test-mns-topic,如下图所示。  
- 选择订阅列表,并单击创建订阅。 
- 在创建订阅面板,创建名称为tf-test-mns-subscription的订阅,如下图所示。  - 订阅类型:选择队列。 
- 接收端地址:选择tf-test-mns-queue,即步骤二:创建轻量消息队列(原 MNS)队列中创建的队列名称。 
- 消息格式:选择JSON。 
 
- 单击确定。 
可选:创建OSS资源
如果阿里云OSS中已有相关资源,可以跳过此步骤,自行发起IMM调用。
步骤一:创建Bucket
- 登录OSS管理控制台。 
- 在左侧导航栏选择Bucket列表,并单击创建Bucket。 
- 在创建Bucket面板,创建名称为tf-test-oss-bucket的Bucket。 
步骤二:上传文件
- 登录OSS管理控制台。 
- 在左侧导航栏选择Bucket列表,并单击tf-test-oss-bucket,即步骤一:创建Bucket中创建的Bucket名称。 
- 单击上传文件,根据页面提示上传文件1.docx,文件上传完成后如下图所示。  
发起IMM调用
步骤一:创建Project
步骤二:发起IMM调用
- 登录OpenAPI平台。 
- 在左侧API列表选择文档处理>CreateOfficeConversionTask接口。 
- 填写如下图所示的参数信息。   - ProjectName:填写tf-test-imm-project,即步骤一:创建Project中创建的项目名称。 
- SourceURI:填写oss://tf-test-oss-bucket/1.docx,即步骤二:上传文件中上传或已经存在的OSS源文件的存储地址。 
- TargetURIPrefix:填写oss://tf-test-oss-bucket/output,即文档转换后输出文件的存储地址前缀。 
- TargetType:填写png,即转换输出的目标文件类型。 
- TopicName:填写tf-test-mns-topic,即步骤一:创建轻量消息队列(原 MNS)主题中创建的轻量消息队列(原 MNS)主题名称。 
 
- 单击发起调用。 
接收轻量消息队列(原 MNS)消息
- 在左侧导航栏选择队列列表,单击tf-test-mns-queue,即步骤二:创建轻量消息队列(原 MNS)队列中创建的列队名称,如下图所示。  
- 在队列详情页面右上方单击收发消息,如下图所示。  
- 在收发消息页面,单击接收消息,页面会新增一条消息,如下图所示。  
- 在消息所在行的操作列,单击详情,查看消息详情,如下图所示。  
常见问题
为什么收不到轻量消息队列(原 MNS)消息?
无法收到轻量消息队列(原 MNS)消息时,请确认以下信息:
- 检查轻量消息队列(原 MNS)主题和IMM项目是否在同一个地域。 
- 检查轻量消息队列(原 MNS)主题和队列是否绑定成功且消息推送格式为JSON。 
- 检查是否有多个消费者在同时消费队列。 
- 检查IMM项目授权角色是否有发送轻量消息队列(原 MNS)权限,关于授权角色,请参见为项目配置授权角色。 
