本文提供事件通知的功能介绍、回调设置和机制以及对应的事件列表。

功能介绍

视频点播中的各种操作，例如视频上传完成、工作流执行完成等，都可以称为一个事件。由于这些任务都需要一定的时间来完成，为了确保在任务完成后能及时通知您，视频点播提供回调事件通知功能。当一个事件完成后，视频点播会向您发送一条回调消息，以便您能够及时进行下一步的业务处理。视频点播目前支持 HTTP 回调，是指您被动接收视频点播服务事件通知的模式。您可以以空间的粒度来配置回调事件通知功能。

HTTP 回调机制

您需要部署一个 HTTP/HTTPS 服务来接收回调消息，并在视频点播控制台中配置回调地址。视频点播的回调机制具体如下：

• 当事件发生时，视频点播服务会向您配置的回调地址发起 POST 请求。
• 您的 HTTP/HTTPS 服务器需返回 200 状态码表示成功，其他状态码表示失败。
• 如果回调失败，视频点播服务会将默认进行 48 小时的重试。重试的时间间隔依次为：1 秒、5 秒、10 秒、30 秒、1 分钟、2 分钟、3 分钟、4 分钟、5 分钟、6 分钟、7 分钟、8 分钟、9 分钟、10 分钟、20 分钟、30 分钟、1 小时。如果仍然未成功，视频点播服务会以 1 小时的频率重试，直至重试累计时长达到 48 小时。

配置方式

• 控制台方式：详见回调设置。
• OpenAPI 方式：
  • 调用 SetCallbackEvent 设置回调事件。
  • 调用 AddCallbackSubscription 添加回调订阅地址。
• 服务端 SDK 方式：
  • Java SDK - 其他配置
  • Python SDK - 其他配置
  • PHP SDK - 其他配置
  • Go SDK - 其他配置

事件列表

视频点播支持的事件类型如下表所示：