Reacting to Media Services events

Media Services events allow applications to react to different events (for example, the job state change event) using modern serverless architectures. It does so without the need for complicated code or expensive and inefficient polling services. Instead, events are pushed through Azure Event Grid to event handlers such as Azure Functions, Azure Logic Apps, or even to your own Webhook, and you only pay for what you use. For information about pricing, see Event Grid pricing.

Availability for Media Services events is tied to Event Grid availability and will become available in other regions as Event Grid does.

Available Media Services events

Event grid uses event subscriptions to route event messages to subscribers. Currently, Media Services event subscriptions can include the following event type:

Event Name Description
Microsoft.Media.JobStateChange Raised when a state of the job changes.

Event Schema

Media Services events contain all the information you need to respond to changes in your data. You can identify a Media Services event because the eventType property starts with "Microsoft.Media.".

For more information, see Media Services event schemas.

Practices for consuming events

Applications that handle Media Services events should follow a few recommended practices:

  • As multiple subscriptions can be configured to route events to the same event handler, it is important not to assume events are from a particular source, but to check the topic of the message to ensure that it comes from the storage account you are expecting.
  • Similarly, check that the eventType is one you are prepared to process, and do not assume that all events you receive will be the types you expect.
  • Ignore fields you don’t understand. This practice will help keep you resilient to new features that might be added in the future.
  • Use the "subject" prefix and suffix matches to limit events to a particular event.

Next steps

Get job state events