如何通过异步任务完成通知_视觉智能开放平台(VIAPI)-阿里云帮助中心

本文介绍异步任务完成通知的使用方式和示例。

功能描述

在您成功提交异步任务以后，可以通过订阅EventBridge事件总线来获取任务执行完成的通知。

重要

阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
本功能依赖于EventBridge事件总线，使用前需要开通。

开通事件总线EventBridge

什么是事件总线EventBridge

事件总线EventBridge是阿里云提供的一款无服务器事件总线服务，支持阿里云服务、自定义应用、SaaS应用以标准化、中心化的方式接入，并能够以标准化的CloudEvents 1.0协议在这些应用之间路由事件，帮助您轻松构建松耦合、分布式的事件驱动架构。

更多信息，请参见什么是事件总线EventBridge。

开通及授权等具体操作，请参见开通事件总线EventBridge并授权。

计费说明

用户投递事件到事件总线EventBridge不收取任何费用。

消费事件总线EventBridge中的消息，需要接入对应的消费服务，具体费用请参考相关服务的官方文档。

接入viapi事件源

登录事件总线EventBridge控制台。
在左侧导航栏单击事件总线。
在顶部菜单栏选择地域为华东2（上海）。
在事件总线页面，单击云服务专用事件总线default。
在事件规则页面，单击创建规则。
在创建规则页面，完成以下操作。
1. 在配置基本信息页面，填写名称和描述（可选），然后单击下一步。
2. 在配置事件模式页面，事件源选择acs.viapi，事件类型选择viapi:system:AsyncJobFinish，然后单击下一步。
3. 在配置事件目标页面，您可以根据实际需求配置服务类型、地址和密钥等信息，然后单击创建。

事件模式匹配

事件模式是事件总线EventBridge用来过滤相关事件的模式定义。事件总线EventBridge通过事件模式过滤事件并将事件路由到事件目标，事件模式必须和匹配的事件具有相同的结构。

您可以通过事件模式匹配来自定义接收指定的pop产品的事件。例如，您希望只接收pop产品为orc，popApi为RecognizeCharacter的产品，可以在事件模式中自定义事件规则。

操作步骤

登录事件总线EventBridge控制台。
在左侧导航栏单击事件总线。
在顶部菜单栏选择地域为华东2（上海）。
在事件总线页面，单击云服务专用事件总线default。
在事件规则页面，单击上文已创建的事件规则右侧的编辑事件模式。

在编辑规则页面，完成以下操作。

选择自定义事件源。

在模式内容中输入以下筛选规则。

{
    "source": [
        "acs.viapi"
    ],
    "type": [
        "viapi:system:AsyncJobFinish"
    ],
    "data": {
        "popApiName": [
            "RecognizeCharacter"
        ],
        "popProduct": [
            "ocr"
        ]
    }
}

单击确认，完成配置。

常用消费服务类型

事件通知支持以下几种常用的服务类型：

轻量消息队列

阿里云轻量消息队列（Message Service）是一种高效、可靠、安全、便捷、可弹性扩展的分布式消息服务，能够帮助应用开发者在他们应用的分布式组件上自由地传递数据、通知消息，构建松耦合系统。

更多信息，请参见轻量消息队列。

消息队列RocketMQ

消息队列RocketMQ版是阿里云基于Apache RocketMQ构建的低延迟、高并发、高可用、高可靠的分布式“消息、事件、流”统一处理平台，面向互联网分布式应用场景提供微服务异步解耦、流式数据处理、事件驱动处理等核心能力。

更多信息，请参见什么是消息队列RocketMQ版。

钉钉

钉钉，让进步发生！阿里巴巴出品，5亿人都在用的数字化组织运营平台。含PC版，IPad和手机版。远程视频会议，消息已读未读，DING消息任务管理，让沟通更高效；移动办公考勤，审批，钉闪会，钉钉文档，钉钉教育解决方案。

更多信息，请参见钉钉。

短信服务

短信服务（Short Message Service）是阿里云为用户提供的一种通信服务的能力，分为国内短信服务和国际/港澳台短信服务。通过API/SDK、控制台调用短信发送能力，将指定信息发送至国内或境外手机号码。

更多信息，请参见短信服务。