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
Log on to the IMS console.
In the left-side navigation pane, choose .
In the upper-left corner, select a region based on your business requirements.
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.