Overview
This node integrates with Wowza Streaming Engine to manage stream targets, which are endpoints for pushing live video streams. It supports enabling, disabling, retrieving the status of a specific stream target, and listing all stream targets within a specified Wowza application.
Typical use cases include:
- Automating the control of live streaming destinations (e.g., social media platforms or CDN endpoints) by enabling or disabling them programmatically.
- Monitoring the status of stream targets to ensure they are active or troubleshoot issues.
- Retrieving a list of all configured stream targets for management or reporting purposes.
For example, a user can enable a stream target named "myStreamTarget" in the "live" application to start pushing a live stream to that destination, or disable it to stop streaming without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Operation | The main operation category; here it is fixed to "Stream Target" for managing stream targets. |
| Action | The action to perform on the stream target: - Enable: Activate a stream target. - Disable: Deactivate a stream target. - Get Status: Retrieve current status of a stream target. - List All: List all stream targets in the application. |
| Application Name | The name of the Wowza application where the stream target resides (e.g., "live"). |
| Stream Target Name | The name of the specific stream target to act upon (required for enable, disable, get status actions). |
| Server Name | The Wowza server instance name; defaults to "defaultServer". |
| VHost Name | The virtual host name in Wowza; defaults to "defaultVHost". |
Output
The node outputs JSON data containing details about the performed operation:
For Enable and Disable actions, the output includes:
success: Boolean indicating if the action succeeded.action: The action performed ("enable" or "disable").streamTarget: The name of the stream target affected.message: A confirmation message.
For Get Status, the output contains the detailed status information returned by Wowza for the specified stream target.
For List All, the output provides an array of all stream targets configured under the specified application.
Each output item also includes the original parameters used (operation, action, application, and streamTarget).
The node does not output binary data.
Dependencies
- Requires access to a Wowza Streaming Engine REST API endpoint.
- Needs credentials including:
- Server URL of the Wowza instance.
- Username and password for HTTP basic authentication.
- The node expects these credentials to be configured securely in n8n.
Troubleshooting
- Missing Stream Target Name: For actions other than "List All", the stream target name must be provided. Omitting this will cause an error.
- Authentication Errors: Incorrect username, password, or server URL will result in HTTP errors. Verify credentials and endpoint accessibility.
- HTTP Errors: The node throws errors if the Wowza API returns non-success HTTP status codes. Check the error message for the status code and response body to diagnose issues.
- Empty Responses: For enable/disable actions, if the API returns an empty response, the node assumes success and returns a default success message.
- Network Issues: Ensure the Wowza server is reachable from the n8n environment.
Links and References
If you need further assistance configuring or using this node, consulting the official Wowza documentation or support channels is recommended.