All Products
Search
Document Center

Intelligent Media Services:Configure callback events

Last Updated:Oct 17, 2024

Intelligent Media Services (IMS) supports the callback methods of HTTP requests and Simple Message Queue (SMQ) queues. You can configure callback events to obtain the task progress and status. This topic describes how to configure callback events.

Background information

When you use features of IMS such as media asset upload, media processing, and online editing, you can configure callback events to obtain the task progress and status at the earliest opportunity. This way, you can perform other business operations based on the events. For more information about callback methods and callback events, see Overview.

Prerequisites

IMS is authorized to access SMQ if the SMQ queue method is used. For more information, see Activate SMQ and authorize RAM users to access SMQ.

Configure callback events in the IMS console

  1. Log on to the IMS console.

  2. In the left-side navigation pane, choose Configurations > Callback Settings.

  3. In the upper-left corner, select a region based on your business requirements.

  4. On the Callback Settings page, click Modify Configurations and configure the parameters.

    Parameter

    Description

    Callback Method

    The callback method. You can set this parameter to HTTP Request or MNS Queue. The HTTP request method is compatible with HTTPS requests.

    Callback URL

    The callback URL. This parameter is required if the Callback Method parameter is set to HTTP Request.

    The callback URL is the URL for receiving message notifications. If a callback event that you selected is triggered, the server sends an HTTP POST request to the URL.

    Queue Name

    The queue name. This parameter is required if the Callback Method parameter is set to MNS Queue.

    The queue name is the name of the SMQ queue that receives message notifications. Select a queue whose name starts with ice-callback. If no such queue is available, create one in the SMQ console. For more information, see Create a queue.

    Callback Events

    The callback events that you want to enable.

    Callback Authentication

    Specifies whether to enable callback authentication. Enable callback authentication if the Callback Method parameter is set to HTTP Request. This way, the server that receives callback messages can authenticate the signature to prevent illegal or invalid callback requests. For more information, see Callback authentication.