vod_notification_uri

The `vod_notification_uri` directive specifies a URI for receiving notifications from the VOD packager module in NGINX.

Syntaxvod_notification_uri URI;
Defaultnone
Contexthttp, server, location
Arguments1

Description

The vod_notification_uri directive is utilized in the NGINX-based VOD packager module to configure a specific URI endpoint where the VOD packager can send notifications regarding the processing state of media files. This directive can be set in the main configuration context (http), in a specific server block (server), or in an individual location block (location).

When a request is made for a video, and certain events occur during processing—such as the completion of file packaging, errors during processing, or status updates—the VOD packager will send HTTP notifications to the specified URI. These notifications can be leveraged for building real-time monitoring systems, logging, or invoking additional processing workflows based on the state of the media file. The directive requires a single argument that defines the absolute path to the notification endpoint.

It's important to ensure that the endpoint specified can handle incoming notifications and respond appropriately. Any issues at the notification URL, like server unavailability or incorrect path handling, could lead to missed or undelivered notifications, affecting operational workflows.

Config Example

vod_notification_uri /vod/notifications;

Ensure the specified URI is accessible and can handle requests appropriately.

Check for proper security measures at the notification URI to prevent unauthorized access.

Test the notification flow to ensure that the VOD packager correctly reaches the endpoint.

← Back to all directives