Client library for Wowza Streaming Cloud REST API Reference Documentation
npm install --save @datafire/wowzalet wowza = require('@datafire/wowza').create({
"wsc-access-key": "",
"wsc-api-key": ""
});
.then(data => {
console.log(data);
});The Wowza Streaming CloudTM REST API (application programming interface) offers complete programmatic control over live streams, transcoders, stream sources, and stream targets. Anything you can do in the Wowza Streaming Cloud UI can also be achieved by making HTTP-based requests to cloud-based servers through the REST API.
The Wowza Streaming Cloud REST API features cross-origin resource sharing, or CORS. CORS is a W3C specification that provides headers in HTTP requests to enable a web server to safely make a network request to another domain.
In order to protect shared resources, the Wowza Streaming Cloud REST API is subject to limits. For details, see Wowza Streaming Cloud REST API limits.
This reference documentation is based on the open-source Swagger framework. It allows you to view the operations, parameters, and request and reponse schemas for every resource. Request samples are presented in cURL (Shell) and JavaScript; some samples also include just the JSON object. Response samples are all JSON.
For more information and examples on using the Wowza Streaming Cloud REST API, see our library of Wowza Streaming Cloud REST API technical articles.
The Wowza Streaming Cloud REST API uses HTTP requests to retrieve data from cloud-based servers. Requests must contain proper JSON, two authentication keys, and the correct version number in the base path.
The Wowza Streaming Cloud REST API uses the JSON API specification to request and return data. This means requests must include the header Content-Type: application/json and must include a single resource object in JSON format as primary data.
Responses include HTTP status codes that indicate whether the query was successful. If there was an error, a description explains the problem so that you can fix it and try again.
Requests to the Wowza Streaming Cloud REST API must be authenticated with two keys: an API key and an access key. Each key is a 64-character alphanumeric string that you can find on the API Access page in Wowza Streaming Cloud.
Use the wsc-api-key and wsc-access-key headers to authenticate requests, like this (in cURL):
curl -H 'wsc-api-key: [64-character-api-key-goes-here]' -H 'wsc-access-key: [64-character-access-key-goes-here]'The Wowza Streaming Cloud API is currently at version 1.0.0. Use v1 in your base path in every request, like this path to the live_streams endpoint:
https://api.cloud.wowza.com/api/v1/live_streams
Here is a complete example POST request, in cURL, with proper JSON syntax, headers, authentication, and version information:
curl -H 'wsc-api-key: [64-character-api-key-goes-here]' -H 'wsc-access-key: [64-character-access-key-goes-here]'
-H 'Content-Type: application/json' -X POST -d '{
"live_stream": {
"name": "My live Stream",
"...": "..."
}
}' https://api.cloud.wowza.com/api/v1/live_streamsThis operation shows the details of the Swagger specification.
wowza.specs(null, context)This action has no parameters
- output Spec
This operation shows the details of all of your live streams.
wowza.listLiveStreams({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output live_streams
This operation creates a live stream.
wowza.createLiveStream({
"live_stream": {
"live_stream": {
"name": "",
"transcoder_type": "",
"billing_mode": "",
"broadcast_location": "",
"encoder": "",
"aspect_ratio_width": 0,
"aspect_ratio_height": 0
}
}
}, context)- input
object- live_stream required live_stream_create_input
- output
object- live_stream required live_stream
This operation deletes a live stream, including all assigned outputs and targets.
wowza.deleteLiveStream({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
Output schema unknown
This operation shows the details of a specific live stream.
wowza.showLiveStream({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required live_stream
This operation updates a live stream.
wowza.updateLiveStream({
"id": "",
"live_stream": {
"live_stream": {
"name": "",
"encoder": "",
"aspect_ratio_width": 0,
"aspect_ratio_height": 0
}
}
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream. - live_stream required live_stream_update_input
- id required
- output
object- live_stream required live_stream
This operation regenerates the connection code of a live stream.
wowza.regenerateConnectionCodeLiveStream({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required
object- connection_code
string: A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Streaming Cloud. The code can be used once and expires 24 hours after it's created.
- connection_code
- live_stream required
This operation resets a live stream.
wowza.resetLiveStream({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required
object- state
string(values: started, stopped, starting, stopping, resetting): The state of the live stream.
- state
- live_stream required
This operation starts a live stream.
wowza.startLiveStream({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required
object- state
string(values: started, stopped, starting, stopping, resetting): The state of the live stream.
- state
- live_stream required
This operation shows the current state of a live stream.
wowza.showLiveStreamState({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required
object- state
string(values: started, stopped, starting, stopping, resetting): The state of the live stream.
- state
- live_stream required
This operation returns a hash of metrics keys, each of which identifies a status, text description, unit, and value.
wowza.showLiveStreamStats({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required shm_metrics
This operation stops a live stream.
wowza.stopLiveStream({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required
object- state
string(values: started, stopped, starting, stopping, resetting): The state of the live stream.
- state
- live_stream required
This operation shows the thumbnail URL of a started live stream.
wowza.showLiveStreamThumbnailUrl({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the live stream.
- id required
- output
object- live_stream required
object- thumbnail_url
string: The URL to receive the preview thumbnail.
- thumbnail_url
- live_stream required
This operation shows the details of all of your players.
wowza.listPlayers({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output players
This operation shows details of a specific player.
wowza.showPlayer({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the player.
- id required
- output
object- player required player
This operation updates a player.
wowza.updatePlayer({
"id": "",
"player": {
"player": {}
}
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the player. - player required player_update_input
- id required
- output
object- player required player
This operation rebuilds the player with the current configuration.
wowza.requestPlayerRebuild({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the player.
- id required
- output
object- player required
object- state
string(values: requested, already_requested, activated, archived): The state of the player.
- state
- player required
This operation shows the current state of a player.
wowza.showPlayerState({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the player.
- id required
- output
object- player required
object- state
string(values: requested, already_requested, activated, archived): The state of the player.
- state
- player required
This operation shows the details of all player URLs.
wowza.listPlayerUrls({
"player_id": ""
}, context)- input
object- player_id required
string: The unique alphanumeric string that identifies the player.
- player_id required
- output urls
This operation creates a new player URL.
wowza.createPlayerUrl({
"player_id": "",
"url": null
}, context)- input
object- player_id required
string: The unique alphanumeric string that identifies the player. - url required url_create_input
- player_id required
- output
object- url required url
This operation deletes a player URL.
wowza.deletePlayerUrl({
"player_id": "",
"id": ""
}, context)- input
object- player_id required
string: The unique alphanumeric string that identifies the player. - id required
string: The unique alphanumeric string that identifies the player URL.
- player_id required
Output schema unknown
This operation shows the details of a player URL.
wowza.showPlayerUrl({
"player_id": "",
"id": ""
}, context)- input
object- player_id required
string: The unique alphanumeric string that identifies the player. - id required
string: The unique alphanumeric string that identifies the player URL.
- player_id required
- output
object- url required url
This operation updates a player URL.
wowza.updatePlayerUrl({
"player_id": "",
"id": "",
"url": null
}, context)- input
object- player_id required
string: The unique alphanumeric string that identifies the player. - id required
string: The unique alphanumeric string that identifies the player URL. - url required url_update_input
- player_id required
- output
object- url required url
This operation shows the details of all of your recordings.
wowza.listRecordings({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output recordings
This operation deletes a recording.
wowza.deleteRecording({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the recording.
- id required
Output schema unknown
This operation shows the details of a specific recording.
wowza.showRecording({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the recording.
- id required
- output
object- recording required recording
This operation shows the current state of a recording.
wowza.showRecordingState({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the recording.
- id required
- output
object- recording required
object- state
string(values: uploading, converting, removing, completed, failed): The state of the recording.
- state
- recording required
This operation shows the details of all of your schedules.
wowza.listSchedules({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output schedules
This operation creates a schedule.
wowza.createSchedule({
"schedule": {
"schedule": {
"name": "",
"transcoder_id": "",
"action_type": "",
"recurrence_type": ""
}
}
}, context)- input
object- schedule required schedule_create_input
- output
object- schedule required schedule
This operation deletes a schedule.
wowza.deleteSchedule({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the schedule.
- id required
Output schema unknown
This operation shows the details of a specific schedule.
wowza.showSchedule({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the schedule.
- id required
- output
object- schedule required schedule
This operation updates a schedule.
wowza.updateSchedule({
"id": "",
"schedule": {
"schedule": {
"name": "",
"action_type": ""
}
}
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the schedule. - schedule required schedule_update_input
- id required
- output
object- schedule required schedule
This operation disables a schedule.
wowza.disableSchedule({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the schedule.
- id required
- output
object- schedule required
object- state
string(values: enabled, disabled, expired): A schedule must be enabled to run. Specify enabled to run the schedule or disabled to turn off the schedule so that it doesn't run.
- state
- schedule required
This operation enables a schedule.
wowza.enableSchedule({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the schedule.
- id required
- output
object- schedule required
object- state
string(values: enabled, disabled, expired): A schedule must be enabled to run. Specify enabled to run the schedule or disabled to turn off the schedule so that it doesn't run.
- state
- schedule required
This operation shows the current state of a schedule.
wowza.showScheduleState({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the schedule.
- id required
- output
object- schedule required
object- state
string(values: enabled, disabled, expired): A schedule must be enabled to run. Specify enabled to run the schedule or disabled to turn off the schedule so that it doesn't run.
- state
- schedule required
This operation shows the details of all of your stream sources.
wowza.listStreamSources({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output stream_sources
This operation adds a stream source.
wowza.createStreamSource({
"stream_source": {
"stream_source": {
"name": "",
"location_method": ""
}
}
}, context)- input
object- stream_source required stream_source_create_input
- output
object- stream_source required stream_source
POST /stream_sources/add/ is deprecated. To add a stream source, use POST /stream_sources instead.
wowza.addStreamSource({
"stream_source": {
"stream_source": {
"name": "",
"location_method": ""
}
}
}, context)- input
object- stream_source required stream_source_create_input
- output
object- stream_source required stream_source
This operation deletes a stream source.
wowza.deleteStreamSource({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream source.
- id required
Output schema unknown
This operation shows details of a specific stream source.
wowza.showStreamSource({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream source.
- id required
- output
object- stream_source required stream_source
This operation updates a stream source.
wowza.updateStreamSource({
"id": "",
"stream_source": {
"stream_source": {
"name": ""
}
}
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream source. - stream_source required stream_source_update_input
- id required
- output
object- stream_source required stream_source
This operation lists the details of all of your stream targets.
wowza.listStreamTargets({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output stream_targets
This operation creates a stream target. There are three types of targets that you can create: CustomStreamTarget for an an external, third-party destination; WowzaStreamTarget for a Wowza CDN target; or UltraLowLatencyStreamTarget for an ultra low latency Wowza CDN target. The availability of many parameters depends on the type of target you create.
wowza.createStreamTarget({
"stream_target": null
}, context)- input
object- stream_target required stream_target_create_input
- output
object- stream_target required stream_target
POST /stream_targets/add/ is deprecated. To add a stream target, use POST /stream_targets instead.
wowza.addStreamTarget({
"stream_target": {
"stream_target": {
"name": "",
"location": ""
}
}
}, context)- input
object- stream_target required wowza_stream_target_input
- output
object- stream_target required stream_target
This operation deletes a stream target.
wowza.deleteStreamTarget({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target.
- id required
Output schema unknown
This operation shows details of a specific stream target.
wowza.showStreamTarget({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target.
- id required
- output
object- stream_target required stream_target
This operation updates a stream target.
wowza.updateStreamTarget({
"id": "",
"stream_target": {
"stream_target": {}
}
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target. - stream_target required stream_target_update_input
- id required
- output
object- stream_target required stream_target
This operation returns a snapshot of the current connection and throughput details for an active target whose type is UltraLowLatencyStreamTarget. The interval for current metrics is 30 seconds from the moment of the query.
wowza.showStreamTargetMetricsCurrent({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target.
- id required
- output
object- id
string: The unique alphanumeric string that identifies the stream target. - metrics stream_target_metrics
- id
This operation shows historic connection and throughput details for target whose type is UltraLowLatencyStreamTarget.
wowza.showStreamTargetMetricsHistoric({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target. - from
string: The start of the range of time used to aggregate the metrics. Express the value by using the ISO 8601 standard of YYYY-MM-DDTHH:MM:SSZ where HH is a 24-hour clock in UTC. - to
string: The end of the range of time used to aggregate the metrics. Express the value by using the ISO 8601 standard of YYYY-MM-DDTHH:MM:SSZ where HH is a 24-hour clock in UTC. - interval
string(values: second, minute, hour, day, month, #s, #m, #h, #d): The length of time for a block of metrics. The default is 10m (10 minutes).
- id required
- output
object- id
string: The unique alphanumeric string that identifies the stream target. - interval
string: The length of time for a block of metrics. The default is 10m (10 minutes). - metrics
array- items stream_target_metrics
- id
This operation regenerates the connection code of a stream target.
wowza.regenerateConnectionCodeStreamTarget({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target.
- id required
- output
object- stream_target required
object- connection_code
string: A six-character, alphanumeric string that allows Wowza Streaming Engine to send a transcoded stream to a WowzaStreamTarget or for the Wowza GoCoder app to send an encoded stream to a UltraLowLatencyStreamTarget. The code can be used once and expires 24 hours after it's created.
- connection_code
- stream_target required
This operation shows the details of geo-blocking applied to a specific stream target. Only stream targets whose type is WowzaStreamTarget can be geo-blocked.
wowza.showStreamTargetGeoblock({
"stream_target_id": ""
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- stream_target_id required
- output
object- geoblock required geoblock
This operation updates the geo-blocking applied to a stream target. Only stream targets whose type is WowzaStreamTarget can be geo-blocked.
wowza.updateStreamTargetGeoblock({
"stream_target_id": "",
"geoblock": null
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - geoblock required geoblock_update_input
- stream_target_id required
- output
object- geoblock required geoblock
This operation allows you to block or whitelist viewing of a stream target by geographic location. Only stream targets whose type is WowzaStreamTarget can be geo-blocked. For more information see the technical article How to geo-block stream targets by using the Wowza Streaming Cloud REST API.
wowza.createStreamTargetGeoblock({
"stream_target_id": "",
"geoblock": null
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - geoblock required geoblock_create_input
- stream_target_id required
- output
object- geoblock required geoblock
This operation shows the details of all of the properties assigned to a specific stream target. Properties can be applied to a CustomStreamTarget or WowzaStreamTarget whose provider is akamai_cupertino.
wowza.listStreamTargetProperties({
"stream_target_id": ""
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- stream_target_id required
- output stream_target_properties
This operation creates a property for a stream target. Properties can be applied to a CustomStreamTarget or WowzaStreamTarget whose provider is akamai_cupertino. For more information see the technical article How to set advanced properties by using the Wowza Streaming Cloud REST API.
wowza.createStreamTargetProperty({
"stream_target_id": "",
"property": {
"property": {
"section": "",
"key": "",
"value": ""
}
}
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - property required stream_target_property_create_input
- stream_target_id required
- output
object- property required stream_target_property
This operation removes a property from a stream target.
wowza.deleteStreamTargetProperty({
"stream_target_id": "",
"id": ""
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - id required
string: The unique string that identifies the stream target property. The string contains the section and the key, connected by a dash. For example, hls-chunkSize.
- stream_target_id required
Output schema unknown
This operation shows the details of a specific property assigned to a specific stream target. Properties can be applied to a CustomStreamTarget or WowzaStreamTarget whose provider is akamai_cupertino.
wowza.showStreamTargetProperty({
"stream_target_id": "",
"id": ""
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - id required
string: The unique string that identifies the stream target property. The string contains the section and the key, connected by a dash. For example, hls-chunkSize.
- stream_target_id required
- output
object- property required stream_target_property
This operation shows the details of the token authorization applied to a stream target. Only stream targets whose type is WowzaStreamTarget can use token authorization.
wowza.showStreamTargetTokenAuth({
"stream_target_id": ""
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- stream_target_id required
- output
object- token_auth required token_auth
This operation updates the token authorization applied to a stream target. Only stream targets whose type is WowzaStreamTarget can use token authorization.
wowza.updateStreamTargetTokenAuth({
"stream_target_id": "",
"token_auth": {
"token_auth": {}
}
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - token_auth required token_auth_update_input
- stream_target_id required
- output
object- token_auth required token_auth
This operation creates token authorization for a stream target. Only stream targets whose type is WowzaStreamTarget can use token authorization. For more information see the technical article How to protect stream targets with token authorization by using the Wowza Streaming Cloud REST API.
wowza.createStreamTargetTokenAuth({
"stream_target_id": "",
"token_auth": {
"token_auth": {
"enabled": true,
"trusted_shared_secret": ""
}
}
}, context)- input
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - token_auth required token_auth_create_input
- stream_target_id required
- output
object- token_auth required token_auth
This operation shows the details of all of your transcoders.
wowza.listTranscoders({}, context)- input
object- page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- page
- output transcoders
This operation creates a transcoder.
wowza.createTranscoder({
"transcoder": {
"transcoder": {
"name": "",
"transcoder_type": "",
"billing_mode": "",
"broadcast_location": "",
"protocol": "",
"delivery_method": ""
}
}
}, context)- input
object- transcoder required transcoder_create_input
- output
object- transcoder required transcoder
This operation deletes a transcoder, including all of its assigned output renditions and stream targets.
wowza.deleteTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
Output schema unknown
This operation shows the details of a specific transcoder.
wowza.showTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required transcoder
This operation updates a transcoder.
wowza.updateTranscoder({
"id": "",
"transcoder": {
"transcoder": {
"name": "",
"protocol": "",
"delivery_method": ""
}
}
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder. - transcoder required transcoder_update_input
- id required
- output
object- transcoder required transcoder
This operation disables all of the stream targets assigned to a specific transcoder.
wowza.disableAllStreamTargetsTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- stream_targets required
object- state
string(values: enabled, disabled): The state of the transcoder's stream targets.
- state
- stream_targets required
- transcoder required
This operation enables all of the stream targets assigned to a specific transcoder.
wowza.enableAllStreamTargetsTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- stream_targets required
object- state
string(values: enabled, disabled): The state of the transcoder's stream targets.
- state
- stream_targets required
- transcoder required
This operation shows the details of all of the recordings for a specific transcoder.
wowza.listTranscoderRecordings({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- recordings
array: Array of recordings of this transcoder. See /recordings for more details.- items recording
- recordings
- transcoder required
This operation resets a transcoder.
wowza.resetTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- state
string(values: starting, stopping, started, stopped, resetting): The state of the transcoder.
- state
- transcoder required
This operation shows the details of all of the schedules for a specific transcoder.
wowza.listTranscoderSchedules({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- schedules
array: Array of schedules of this transcoder. See /schedules for more details.- items schedule
- schedules
- transcoder required
This operation starts a transcoder.
wowza.startTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- state
string(values: starting, stopping, started, stopped, resetting): The state of the transcoder. - transcoding_uptime_id
string: The transcoding_uptime_id parameter is deprecated and is replaced by uptime_id. The unique identifier associated with a specific uptime period of a transcoder.
- state
- transcoder required
This operation shows the current state and uptime ID of a transcoder.
wowza.showTranscoderState({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- state
string(values: starting, stopping, started, stopped, resetting): The state of the transcoder. - transcoding_uptime_id
string: The transcoding_uptime_id parameter is deprecated and is replaced by uptime_id. The unique identifier associated with a specific uptime period of a transcoder. - uptime_id
string: The unique identifier associated with a specific uptime period of a transcoder.
- state
- transcoder required
This operation responds with a hash of metrics (keys) for a currently running transcoder. Each key has a status, text (description), units, and value.
wowza.showTranscoderStats({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required shm_metrics
This operation stops a transcoder.
wowza.stopTranscoder({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- state
string(values: starting, stopping, started, stopped, resetting): The state of the transcoder. - transcoding_uptime_id
string: The transcoding_uptime_id parameter is deprecated and is replaced by uptime_id. The unique identifier associated with a specific uptime period of a transcoder.
- state
- transcoder required
This operation shows the thumbnail URL of a started transcoder.
wowza.showTranscoderThumbnailUrl({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the transcoder.
- id required
- output
object- transcoder required
object- thumbnail_url
string: The URL to receive the preview thumbnail.
- thumbnail_url
- transcoder required
This operation shows the details of all of the output renditions of a specific transcoder.
wowza.listTranscoderOutputs({
"transcoder_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder.
- transcoder_id required
- output outputs
This operation creates an output rendition for a specific transcoder.
wowza.createTranscoderOutput({
"transcoder_id": "",
"output": null
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output required output_create_input
- transcoder_id required
- output
object- output required output
This operation deletes an output, including all of its assigned targets.
wowza.deleteTranscoderOutput({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the output rendition.
- transcoder_id required
Output schema unknown
This operation shows the details of a specific output rendition for a specific transcoder.
wowza.showTranscoderOutput({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the output rendition.
- transcoder_id required
- output
object- output required output
This operation updates an output rendition.
wowza.updateTranscoderOutput({
"transcoder_id": "",
"id": "",
"output": null
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the output rendition. - output required output_update_input
- transcoder_id required
- output
object- output required output
The operation POST /transcoders/{transcoder_id}/outputs/{id}/add_stream_target is deprecated. Use POST /transcoders/{transcoder_id}/outputs/{output_id}/output_stream_targets to add an existing stream target to an output.
wowza.addStreamTargetToTranscoderOutput({
"transcoder_id": "",
"id": "",
"output_stream_target": {
"output_stream_target": {
"stream_target_id": ""
}
}
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the output rendition. - output_stream_target required output_add_stream_target_input
- transcoder_id required
- output
object- output_stream_target required output_stream_target
The operation DELETE /transcoders/{transcoder_id}/outputs/{id}/remove_stream_target is deprecated. Use DELETE /transcoders/{transcoder_id}/outputs/{output_id}/output_stream_targets/{id} to remove a stream target from an output.
wowza.removeStreamTargetToTranscoderOutput({
"transcoder_id": "",
"id": "",
"output_stream_target": {
"output_stream_target": {
"stream_target_id": ""
}
}
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the output rendition. - output_stream_target required output_remove_stream_target_input
- transcoder_id required
Output schema unknown
This operation shows the details of all of the output stream targets of an output of a transcoder.
wowza.listTranscoderOutputOutputStreamTargets({
"transcoder_id": "",
"output_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition.
- transcoder_id required
- output output_stream_target
This operation creates an output stream target. Targets whose type is UltraLowLatencyStreamTarget can't be added to output renditions.
wowza.createTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"output_stream_target": null
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - output_stream_target required output_stream_target_create_input
- transcoder_id required
- output
object- output_stream_target required output_stream_target
This operation deletes an output stream target, including all of its assigned targets.
wowza.deleteTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"stream_target_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- transcoder_id required
Output schema unknown
This operation shows the details of an output stream target.
wowza.showTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"stream_target_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- transcoder_id required
- output
object- output_stream_target required output_stream_target
This operation updates an output stream target.
wowza.updateTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"stream_target_id": "",
"output_stream_target": null
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - output_stream_target required output_stream_target_update_input
- transcoder_id required
- output
object- output_stream_target required output_stream_target
This operation disables an output stream target.
wowza.disableTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"stream_target_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- transcoder_id required
- output
object- stream_target required
object- state
string(values: enabled, disabled, restarted): The state of the output stream target.
- state
- stream_target required
This operation enables an output stream target.
wowza.enableTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"stream_target_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- transcoder_id required
- output
object- stream_target required
object- state
string(values: enabled, disabled, restarted): The state of the output stream target.
- state
- stream_target required
This operation restarts an output stream target.
wowza.restartTranscoderOutputOutputStreamTarget({
"transcoder_id": "",
"output_id": "",
"stream_target_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - output_id required
string: The unique alphanumeric string that identifies the output rendition. - stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- transcoder_id required
- output
object- stream_target required
object- state
string(values: enabled, disabled, restarted): The state of the output stream target.
- state
- stream_target required
This operation shows all of the properties of a specific transcoder.
wowza.listTranscoderProperties({
"transcoder_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder.
- transcoder_id required
- output transcoder_properties
This operation creates a property for a transcoder. For more information see the technical article How to set advanced properties by using the Wowza Streaming Cloud REST API.
wowza.createTranscoderProperty({
"transcoder_id": "",
"property": {
"property": {
"section": "",
"key": "",
"value": ""
}
}
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - property required transcoder_property_create_input
- transcoder_id required
- output
object- property required transcoder_property
This operation deletes a specific property from a specific transcoder.
wowza.deleteTranscoderProperty({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique string that identifies the transcoder property. The string contains the section and the key, connected by a dash. For example, cupertino-cupertinoProgramDateTimeOffset.
- transcoder_id required
Output schema unknown
This operation shows the details of a specific property for a specific transcoder.
wowza.showTranscoderProperty({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique string that identifies the transcoder property. The string contains the section and the key, connected by a dash. For example, cupertino-cupertinoProgramDateTimeOffset.
- transcoder_id required
- output
object- property required transcoder_property
This operation shows all of the uptime records for a specific transcoder. An uptime record identifies a specific transcoding session.
wowza.indexUptimes({
"transcoder_id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - page
integer: Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed first. Next and Previous links allow you to navigate multiple pages of results. Omit the page parameter or specify an integer that's less than or equal to 0 to view all (unpaginated) results. - per_page
integer: For use with the page parameter. Indicates how many records should be included on each page of results. A valid value is any positive integer. The default is 10.
- transcoder_id required
- output uptimes
This operation shows the details of a specific uptime record for a specific transcoder. An uptime record identifies a transcoding session.
wowza.showUptime({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the uptime record.
- transcoder_id required
- output uptime
This operation returns a snapshot of the current source connection and processing details of an active (running) transcoder.
wowza.showUptimeMetricsCurrent({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the uptime record. - fields
string: A comma-separated list of fields to return.
- transcoder_id required
- output
object- current required shm_metrics
- limits required
object- fields required
string: A comma-separated list of fields that were returned in the request.
- fields required
This operation shows the historic source connection and processing details for a transcoding session (uptime record). The transcoder can be running or stopped. Metrics are recorded every 20 seconds.
wowza.showUptimeMetricsHistoric({
"transcoder_id": "",
"id": ""
}, context)- input
object- transcoder_id required
string: The unique alphanumeric string that identifies the transcoder. - id required
string: The unique alphanumeric string that identifies the uptime record. - fields
string: A comma-separated list of fields to return. - from
string: The start of the range of time used to aggregate the metrics. Express the value by using the ISO 8601 standard of YYYY-MM-DDTHH:MM:SSZ where HH is a 24-hour clock in UTC. - to
string: The end of the range of time used to aggregate the metrics. Express the value by using the ISO 8601 standard of YYYY-MM-DDTHH:MM:SSZ where HH is a 24-hour clock in UTC.
- transcoder_id required
- output
object- historic required
array- items shm_historic_metrics
- limits required
object- fields required
string: A comma-separated list of fields that were returned in the request. - from required
string: The start of range of time when the metrics were aggregated for the query. - to required
string: The end of the range of time when the metrics were aggregated for the query.
- fields required
- historic required
This operation shows the amount of network usage for all stream sources in the account. The default time frame is from the last billing date to the end of the current day.
wowza.usageNetworkStreamSourcesIndex({}, context)- input
object- from
string: The start of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The from default is the last billing date. - to
string: The end of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The to default is the end of the current day.
- from
- output usage_network_stream_sources
This operation shows the amount of network usage for all stream targets in the account cumulatively and individually. The default time frame is from the last billing date to the end of the current day.
wowza.usageNetworkStreamTargetsIndex({}, context)- input
object- from
string: The start of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The from default is the last billing date. - to
string: The end of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The to default is the end of the current day.
- from
- output usage_network_stream_targets
This operation shows the amount of network usage (egress) for all transcoders in the account. The default time frame is from the last billing date to the end of the current day.
wowza.usageNetworkTranscodersIndex({}, context)- input
object- from
string: The start of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The from default is the last billing date. - to
string: The end of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The to default is the end of the current day. - transcoder_type
string(values: transcoded, passthrough): The type of transcoder. The default is transcoded. - billing_mode
string(values: pay_as_you_go, twentyfour_seven): The billing mode for the transcoder. The default is pay_as_you_go.
- from
- output usage_network_transcoders
This operation shows the amount of peak recording storage used for the account. The default time frame is from the last billing date to the end of the current day.
wowza.usageStoragePeakRecordingIndex({}, context)- input
object- from
string: The start of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The from default is the last billing date. - to
string: The end of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The to default is the end of the current day.
- from
- output usage_storage_peak_recording
This operation shows the amount of stream processing time used by all transcoders in the account. The default time frame is from the last billing date to the end of the current day.
wowza.usageTimeTranscodersIndex({}, context)- input
object- from
string: The start of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The from default is the last billing date. - to
string: The end of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The to default is the end of the current day. - transcoder_type
string(values: transcoded, passthrough): The type of transcoder. The default is transcoded. - billing_mode
string(values: pay_as_you_go, twentyfour_seven): The billing mode for the transcoder. The default is pay_as_you_go.
- from
- output usage_time_transcoders
This operation shows viewer data for a specific stream target. The default time frame is from the last billing date to the end of the current day.
wowza.showViewerDataStreamTarget({
"id": ""
}, context)- input
object- id required
string: The unique alphanumeric string that identifies the stream target. - from
string: The start of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The from default is the last billing date. - to
string: The end of the range of time you want to view. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. The to default is the end of the current day.
- id required
- Error401
object- meta required
object- code
string - description
string - links
array- items
string
- items
- message
string - status
integer - title
string
- code
- meta required
- Error403
object- meta required
object- code
string - description
string - links
array- items
string
- items
- message
string - status
integer - title
string
- code
- meta required
- Error404
object- meta required
object- code
string - description
string - links
array- items
string
- items
- message
string - status
integer - title
string
- code
- meta required
- Error410
object- meta required
object- code
string - description
string - links
array- items
string
- items
- message
string - status
integer - title
string
- code
- meta required
- Error422
object- meta required
object- code
string - description
string - links
array- items
string
- items
- message
string - status
integer - title
string
- code
- meta required
- Error422InvalidTimeFormat
object- meta required
object- code
string - description
string - links
array- items
string
- items
- message
string - status
integer - title
string
- code
- meta required
- Spec
object- basePath
string: The base path on which the API is served, relative to the host. - consumes
array: A list of MIME types that the API can consume.- items
string
- items
- definitions
object: The data types produced and consumed by operations. - externalDocs
object: Links to and descriptions of related external documentation. - host
string: The host (domain name or IP address) serving the API. - info
object: Metadata about the API. - paths
object: The paths and operations available to the API. - produces
array: A list of MIME types that the API can produce.- items
string
- items
- schemes
array: The transfer protocol being used by the API.- items
string
- items
- security
array: A list of the security schemes being used by the API.- items
object
- items
- securityDefinitions
object: The security scheme definitions being used by the API.- items
object
- items
- swagger
string: The version of the Swagger specification that's being used. - tags
array: A list of tags used by the specification, with metadata.- items
object
- items
- x-tagGroups
array: A list of the groups and tags used in the left column of the Swagger page.- items
object
- items
- basePath
- audio_codec_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
string: The value of the associated key.
- status
- bits_in_rate_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
number: The value of the associated key.
- status
- bits_out_rate_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
number: The value of the associated key.
- status
- bytes_in_rate_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
number: The value of the associated key.
- status
- bytes_out_rate_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
number: The value of the associated key.
- status
- configured_bytes_out_rate_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- connected_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
string: The value of the associated key.
- status
- cpu_idle_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- cpu_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- custom_stream_target_input
object- stream_target required
object- backup_url
string: Only for targets whose type is CustomStreamTarget. The backup RTMP ingest URL of the target, without the preceding protocol and without the trailing slash (/). - hds_playback_url
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The web address that the target uses to play Adobe HDS streams. - hls_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play Apple HLS streams. - name required
string: A descriptive name for the stream target. Maximum 255 characters. - password
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. A username must also be present. The password associated with the target username for RTMP authentication. - primary_url required
string: Only for targets whose type is CustomStreamTarget. The primary RTMP ingest URL, without the preceding protocol and without the trailing slash (/). - provider required
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - rtmp_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play RTMP streams. - stream_name required
string: Only for targets whose type is CustomStreamTarget. The name of the stream as defined in the target's ingestion settings. - type
string: WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination. - username
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The username or ID that the target uses for RTMP authentication.
- backup_url
- stream_target required
- frame_rate_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- frame_size_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
string: The value of the associated key.
- status
- geoblock
object- countries
array: Required when type is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list (an array) of two-letter ISO 3166-1 country codes. For a list, see ISO 3166-1 on wikipedia.- items
string
- items
- created_at
string: The date and time that the geo-blocking rendition was created. - state
string(values: requested, activated, update_requested, delete_requested, failed): The state of the geo-blocking. - stream_target_id
string: The unique alphanumeric string that identifies the stream target. - type
string(values: disabled, allow, deny): The type of geo-blocking to apply. The value allow permits viewing only in the locations specified by the countries parameter. The value deny prohibits viewing in the locations specified by the countries parameter. The value disabled (the default) permits viewing everywhere. - updated_at
string: The date and time that the geo-blocking rendition was updated. - whitelist
array: Whitelisted addresses can be viewed even if they're within a geo-blocked location. Enter a comma-separated list (an array) of IP addresses that always allow streaming.- items
string
- items
- countries
- geoblock_create_input
- geoblock required
object- countries
array: Required when type is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list (an array) of two-letter ISO 3166-1 country codes. For a list, see ISO 3166-1 on wikipedia.- items
string
- items
- type required
string(values: disabled, allow, deny): The type of geo-blocking to apply. The value allow permits viewing only in the locations specified by the countries parameter. The value deny prohibits viewing in the locations specified by the countries parameter. The value disabled (the default) permits viewing everywhere. - whitelist
array: Whitelisted addresses can be viewed even if they're within a geo-blocked location. Enter a comma-separated list (an array) of IP addresses that always allow streaming.- items
string
- items
- countries
- geoblock required
- geoblock_input
object- geoblock required
object- countries
array: Required when type is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list (an array) of two-letter ISO 3166-1 country codes. For a list, see ISO 3166-1 on wikipedia.- items
string
- items
- type required
string(values: disabled, allow, deny): The type of geo-blocking to apply. The value allow permits viewing only in the locations specified by the countries parameter. The value deny prohibits viewing in the locations specified by the countries parameter. The value disabled (the default) permits viewing everywhere. - whitelist
array: Whitelisted addresses can be viewed even if they're within a geo-blocked location. Enter a comma-separated list (an array) of IP addresses that always allow streaming.- items
string
- items
- countries
- geoblock required
- geoblock_update_input
- geoblock required
object- countries
array: Required when type is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list (an array) of two-letter ISO 3166-1 country codes. For a list, see ISO 3166-1 on wikipedia.- items
string
- items
- type required
string(values: disabled, allow, deny): The type of geo-blocking to apply. The value allow permits viewing only in the locations specified by the countries parameter. The value deny prohibits viewing in the locations specified by the countries parameter. The value disabled (the default) permits viewing everywhere. - whitelist
array: Whitelisted addresses can be viewed even if they're within a geo-blocked location. Enter a comma-separated list (an array) of IP addresses that always allow streaming.- items
string
- items
- countries
- geoblock required
- gpu_decoder_usage_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- gpu_driver_version_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
string: The value of the associated key.
- status
- gpu_encoder_usage_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- gpu_memory_usage_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- gpu_usage_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- height_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- index_stream_target
object- chunk_size
string(values: 2, 4, 6, 8, 10): The chunk_size parameter is deprecated. To set the chunk size of a stream target, use the POST /stream_targets/[stream_target_id]/properties endpoint. Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. The segment duration for HLS encoding. The default is 10. - connection_code
string: A six-character, alphanumeric string that allows Wowza Streaming Engine to send a transcoded stream to a WowzaStreamTarget or for the Wowza GoCoder app to send an encoded stream to a UltraLowLatencyStreamTarget. The code can be used once and expires 24 hours after it's created. - connection_code_expires_at
string: The date and time that the connection_code expires. - created_at
string: The date and time that the stream target was created. - hds_playback_url
string: The web address that the target uses to play Adobe HDS streams. - hls_playback_url
string: Only for targets whose provider is akamai_cupertino. The web address that the target uses to play Apple HLS streams. - id
string: The unique alphanumeric string that identifies the stream target. - location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): Only for targets whose type is WowzaStreamTarget and provider is not akamai_cupertino. Choose a location as close as possible to your video source. - name
string: A descriptive name for the stream target. Maximum 255 characters. - primary_url
string: The primary ingest URL of the target. - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - rtmp_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play RTMP streams. - stream_name
string: The name of the stream being ingested into the target. Returned for all targets except those whose type is UltraLowLatencyStreamTarget and whose source_delivery_method is pull. - type
string(values: WowzaStreamTarget, UltraLowLatencyStreamTarget, CustomStreamTarget): WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination. - updated_at
string: The date and time that the stream target was updated. - username
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The username or ID that the target uses for RTMP authentication.
- chunk_size
- keyframe_interval_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- live_stream
object- aspect_ratio_height
integer: The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. - aspect_ratio_width
integer: The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. - billing_mode
string(values: pay_as_you_go, twentyfour_seven): The billing mode for the stream. The default is pay_as_you_go. - broadcast_location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): The location of your stream. Choose a location as close as possible to your video source. - closed_caption_type
string(values: none, cea, on_text, both): The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioing data streams are being provided. - connection_code
string: A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Streaming Cloud. The code can be used once and expires 24 hours after it's created. - connection_code_expires_at
string: The date and time that the connection_code expires. - created_at
string: The date and time that the live stream was created. - delivery_method
string(values: pull, cdn, push): The type of connection between the video source and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder. - delivery_protocol
string(values: hls-https, hls-hds): The delivery_protocol parameter is deprecated. To set the delivery protocol of a transcoder's target, use target_delivery_protocol. - delivery_protocols
array: An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.- items
string
- items
- delivery_type
string(values: single-bitrate, multi-bitrate): For streams whose encoder is wowza_streaming_engine. The default is multi-bitrate, which means you're sending one or more bitrate renditions from Wowza Streaming Engine directly to a Wowza CDN target without transcoding in Wowza Streaming Cloud. The value single-bitrate means you're sending a single source stream to Wowza Streaming Cloud for transcoding and/or to deliver the source stream to multiple stream targets in Wowza Streaming Cloud. - direct_playback_urls
array: An array of direct playback URLs for the live stream's delivery protocols. Each protocol has a URL for the source and a URL for each output rendition.- items
object- name
string: The name of the playback URL: source, default, passthrough, or the output rendition's resolution. - output_id
string: Only for output rendition-based playback URLs, not source playback URLs. The unique alphanumeric string that identifies the output rendition. - url
string: The playback URL for the source or output rendition.
- name
- items
- encoder
string(values: wowza_streaming_engine, wowza_gocoder, media_ds, axis, epiphan, hauppauge, jvc, live_u, matrox, newtek_tricaster, osprey, sony, telestream_wirecast, teradek_cube, vmix, x_split, ipcamera, other_rtmp, other_rtsp): The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp. - hosted_page
boolean: A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page. - hosted_page_description
string: A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_logo_image_url
string: The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. - hosted_page_sharing_icons
boolean: Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. - hosted_page_title
string: A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_url
string: The URL of the Wowza Streaming Cloud-hosted webpage that viewers can visit to watch the stream. - id
string: The unique alphanumeric string that identifies the live stream. - low_latency
boolean: For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false.
This parameter only affects streams played over a target whose type is WowzaStreamTarget and whose provider is akamai_cupertino. It does not reduce latency in streams played over a hosted page and is unrelated to Wowza ultra low latency stream targets. - name
string: A descriptive name for the live stream. Maximum 200 characters. - player_countdown
boolean: A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. - player_countdown_at
string: The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC. - player_embed_code
string: The HTML code that can be used in an external webpage to host the Wowza Streaming Cloud player. - player_hds_playback_url
string: The address that can be used to configure playback of the stream using the Adobe HDS protocol. - player_hls_playback_url
string: The address that can be used to configure playback of the stream using the Apple HLS protocol. - player_id
string: The unique alphanumeric string that identifies the player. - player_logo_image_url
string: The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. - player_logo_position
string(values: top-left, top-right, bottom-left, bottom-right): The corner of the player in which you want the player logo to appear. The default is top-left. - player_responsive
boolean: A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width. - player_type
string: The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over Apple HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5. - player_video_poster_image_url
string: The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. - player_width
integer: The width, in pixels, of a fixed-size player. The default is 640. - recording
boolean: If true, creates a recording of the live stream. The default is false. - source_connection_information
object: Details that you can use to manually configure and connect a video source to the live stream. - stream_source_id
string: The unique alphanumeric string that identifies the stream source, if a stream source is used. - stream_targets
array: An array of unique alphanumeric strings that identify the stream targets used by the live stream.- items
object- id
string: The unique alphanumeric string that identifies the stream target.
- id
- items
- target_delivery_protocol
string(values: hls-https, hls-hds): The type of stream being delivered from Wowza Streaming Cloud. The default is hls-https. - transcoder_type
string(values: transcoded, passthrough): The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded. - updated_at
string: The date and time that the live stream was updated. - use_stream_source
boolean: If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud. - video_fallback
boolean: If true, black video plays if the video source disconnects from the transcoder. If false (the default), a stream-not-available message appears. Works only with HLS stream targets.
- aspect_ratio_height
- live_stream_create_input
object- live_stream required
object- aspect_ratio_height required
integer: The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. - aspect_ratio_width required
integer: The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. - billing_mode required
string(values: pay_as_you_go, twentyfour_seven): The billing mode for the stream. The default is pay_as_you_go. - broadcast_location required
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): The location of your stream. Choose a location as close as possible to your video source. - closed_caption_type
string(values: none, cea, on_text, both): The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioing data streams are being provided. - delivery_method
string(values: pull, cdn, push): The type of connection between the video source and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder. - delivery_protocols
array: An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.- items
string
- items
- delivery_type
string(values: single-bitrate, multi-bitrate): For streams whose encoder is wowza_streaming_engine. The default is multi-bitrate, which means you're sending one or more bitrate renditions from Wowza Streaming Engine directly to a Wowza CDN target without transcoding in Wowza Streaming Cloud. The value single-bitrate means you're sending a single source stream to Wowza Streaming Cloud for transcoding and/or to deliver the source stream to multiple stream targets in Wowza Streaming Cloud. - disable_authentication
boolean: Authentication is required by default for RTMP and RTSP push connections from a video source to Wowza Streaming Cloud. Specify true to disable authentication with the video source. - encoder required
string(values: wowza_streaming_engine, wowza_gocoder, media_ds, axis, epiphan, hauppauge, jvc, live_u, matrox, newtek_tricaster, osprey, sony, telestream_wirecast, teradek_cube, vmix, x_split, ipcamera, other_rtmp, other_rtsp): The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp. - hosted_page
boolean: A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page. - hosted_page_description
string: A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_logo_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. - hosted_page_sharing_icons
boolean: Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. - hosted_page_title
string: A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. - low_latency
boolean: For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false.
This parameter only affects streams played over a target whose type is WowzaStreamTarget and whose provider is akamai_cupertino. It does not reduce latency in streams played over a hosted page and is unrelated to Wowza ultra low latency stream targets. - name required
string: A descriptive name for the live stream. Maximum 200 characters. - password
string: A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - player_countdown
boolean: A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. - player_countdown_at
string: The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC. - player_logo_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. - player_logo_position
string(values: top-left, top-right, bottom-left, bottom-right): The corner of the player in which you want the player logo to appear. The default is top-left. - player_responsive
boolean: A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width. - player_type
string: The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over Apple HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5. - player_video_poster_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. - player_width
integer: The width, in pixels, of a fixed-size player. The default is 640. - recording
boolean: If true, creates a recording of the live stream. The default is false. - remove_hosted_page_logo_image
boolean: If true, removes the logo file from the hosted page. The default is false. - remove_player_logo_image
boolean: If true, removes the logo file from the player. The default is false. - remove_player_video_poster_image
boolean: If true, removes the poster image. The default is false. - source_url
string: The URL of an IP camera or video encoder using an RTMP and RTSP pull connection to Wowza Streaming Cloud. Consult the camera or encoder documentation for the URL syntax. - target_delivery_protocol
string(values: hls-https, hls-hds): The type of stream being delivered from Wowza Streaming Cloud. The default is hls-https. - transcoder_type required
string(values: transcoded, passthrough): The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded. - use_stream_source
boolean: If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud. - username
string: A username for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - video_fallback
boolean: If true, black video plays if the video source disconnects from the transcoder. If false (the default), a stream-not-available message appears. Works only with HLS stream targets.
- aspect_ratio_height required
- live_stream required
- live_stream_update_input
object- live_stream required
object- aspect_ratio_height required
integer: The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. - aspect_ratio_width required
integer: The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. - closed_caption_type
string(values: none, cea, on_text, both): The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioing data streams are being provided. - delivery_method
string(values: pull, cdn, push): The type of connection between the video source and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder. - delivery_protocols
array: An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, and wowz are enabled.- items
string
- items
- disable_authentication
boolean: Authentication is required by default for RTMP and RTSP push connections from a video source to Wowza Streaming Cloud. Specify true to disable authentication with the video source. - encoder required
string(values: wowza_streaming_engine, wowza_gocoder, media_ds, axis, epiphan, hauppauge, jvc, live_u, matrox, newtek_tricaster, osprey, sony, telestream_wirecast, teradek_cube, vmix, x_split, ipcamera, other_rtmp, other_rtsp): The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Streaming Cloud transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp. - hosted_page_description
string: A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_logo_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. - hosted_page_sharing_icons
boolean: Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. - hosted_page_title
string: A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. - name required
string: A descriptive name for the live stream. Maximum 200 characters. - password
string: A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - player_countdown
boolean: A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. - player_countdown_at
string: The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC. - player_logo_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. - player_logo_position
string(values: top-left, top-right, bottom-left, bottom-right): The corner of the player in which you want the player logo to appear. The default is top-left. - player_responsive
boolean: A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width. - player_type
string: The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over Apple HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5. - player_video_poster_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. - player_width
integer: The width, in pixels, of a fixed-size player. The default is 640. - recording
boolean: If true, creates a recording of the live stream. The default is false. - remove_hosted_page_logo_image
boolean: If true, removes the logo file from the hosted page. The default is false. - remove_player_logo_image
boolean: If true, removes the logo file from the player. The default is false. - remove_player_video_poster_image
boolean: If true, removes the poster image. The default is false. - source_url
string: The URL of an IP camera or video encoder using an RTMP and RTSP pull connection to Wowza Streaming Cloud. Consult the camera or encoder documentation for the URL syntax. - target_delivery_protocol
string(values: hls-https, hls-hds): The type of stream being delivered from Wowza Streaming Cloud. The default is hls-https. - use_stream_source
boolean: If true, uses a stream source to deliver the stream to Wowza Streaming Cloud. The default, false, pushes directly to Wowza Streaming Cloud. - username
string: A username for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - video_fallback
boolean: If true, black video plays if the video source disconnects from the transcoder. If false (the default), a stream-not-available message appears. Works only with HLS stream targets.
- aspect_ratio_height required
- live_stream required
- live_streams
object- live_streams required
array- items live_stream
- live_streams required
- output
object- aspect_ratio_height
integer: The height, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1080. - aspect_ratio_width
integer: The width, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1980. - bitrate_audio
integer: The audio bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough audio) and 1000. The default is 128. - bitrate_video
integer: The video bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough video) and 10240. The default is 4000. - created_at
string: The date and time that the output rendition was created. - framerate_reduction
string(values: 0, 1/2, 1/4, 1/25, 1/30, 1/50, 1/60): Reduce the frame rate of the transcoded output rendition. The default, 0, uses the encoded stream's frame rate without reduction. - h264_profile
string(values: main, baseline, high): The encoding method. Specify main for desktop streaming, baseline for playback on mobile devices, or high for HD playback. The default is high. - id
string: The unique alphanumeric string that identifies the output rendition. - keyframes
string(values: follow_source, 25, 30, 50, 60, 100, 120): The interval used to define the compression applied to a group of frames. The default, follow_source, uses the keyframe interval of the source video. - name
string: A descriptive name for the output (generated, not writable). - output_stream_targets
array- items output_stream_target
- passthrough_audio
boolean: If true, sends the audio track to the target without transcoding. The default is false. - passthrough_video
boolean: If true, sends the video track to the target without transcoding. The default is false. - stream_format
string(values: audiovideo, videoonly, audioonly): The contents of the stream. The default is both audio and video (audiovideo). - transcoder_id
string: The unique alphanumeric string that identifies the transcoder. - updated_at
string: The date and time that the output rendition was updated.
- aspect_ratio_height
- output_add_stream_target_input
object- output_stream_target required
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - use_stream_target_backup_url
boolean: Use the target's backup URL. Not available for targets whose provider is akamai_cupertino. The default is false.
- stream_target_id required
- output_stream_target required
- output_create_input
- output required
object- aspect_ratio_height
integer: The height, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1080. - aspect_ratio_width
integer: The width, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1980. - bitrate_audio
integer: The audio bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough audio) and 1000. The default is 128. - bitrate_video
integer: The video bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough video) and 10240. The default is 4000. - framerate_reduction
string(values: 0, 1/2, 1/4, 1/25, 1/30, 1/50, 1/60): Reduce the frame rate of the transcoded output rendition. The default, 0, uses the encoded stream's frame rate without reduction. - h264_profile
string(values: main, baseline, high): The encoding method. Specify main for desktop streaming, baseline for playback on mobile devices, or high for HD playback. The default is high. - keyframes
string(values: follow_source, 25, 30, 50, 60, 100, 120): The interval used to define the compression applied to a group of frames. The default, follow_source, uses the keyframe interval of the source video. - passthrough_audio
boolean: If true, sends the audio track to the target without transcoding. The default is false. - passthrough_video
boolean: If true, sends the video track to the target without transcoding. The default is false. - stream_format required
string(values: audiovideo, videoonly, audioonly): The contents of the stream. The default is both audio and video (audiovideo).
- aspect_ratio_height
- output required
- output_input
object- output required
object- aspect_ratio_height
integer: The height, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1080. - aspect_ratio_width
integer: The width, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1980. - bitrate_audio
integer: The audio bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough audio) and 1000. The default is 128. - bitrate_video
integer: The video bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough video) and 10240. The default is 4000. - framerate_reduction
string(values: 0, 1/2, 1/4, 1/25, 1/30, 1/50, 1/60): Reduce the frame rate of the transcoded output rendition. The default, 0, uses the encoded stream's frame rate without reduction. - h264_profile
string(values: main, baseline, high): The encoding method. Specify main for desktop streaming, baseline for playback on mobile devices, or high for HD playback. The default is high. - keyframes
string(values: follow_source, 25, 30, 50, 60, 100, 120): The interval used to define the compression applied to a group of frames. The default, follow_source, uses the keyframe interval of the source video. - passthrough_audio
boolean: If true, sends the audio track to the target without transcoding. The default is false. - passthrough_video
boolean: If true, sends the video track to the target without transcoding. The default is false. - stream_format required
string(values: audiovideo, videoonly, audioonly): The contents of the stream. The default is both audio and video (audiovideo).
- aspect_ratio_height
- output required
- output_remove_stream_target_input
object- output_stream_target required
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target.
- stream_target_id required
- output_stream_target required
- output_stream_target
object- created_at
string: The date and time that the output stream target was created. - id
string: The unique alphanumeric string that identifies the output stream target. - output_id
string: The unique alphanumeric string that identifies the output rendition. - stream_target stream_target
- stream_target_id
string: The unique alphanumeric string that identifies the stream target. - updated_at
string: The date and time that the output stream target was updated. - use_stream_target_backup_url
boolean: Specifies whether to use the stream target's primary or backup URL.
- created_at
- output_stream_target_create_input
- output_stream_target required
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - use_stream_target_backup_url
boolean: Specifies whether to use the stream target's primary or backup URL.
- stream_target_id required
- output_stream_target required
- output_stream_target_input
object- output_stream_target required
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - use_stream_target_backup_url
boolean: Specifies whether to use the stream target's primary or backup URL.
- stream_target_id required
- output_stream_target required
- output_stream_target_update_input
- output_stream_target required
object- stream_target_id required
string: The unique alphanumeric string that identifies the stream target. - use_stream_target_backup_url
boolean: Specifies whether to use the stream target's primary or backup URL.
- stream_target_id required
- output_stream_target required
- output_stream_targets
object- output_stream_targets required
array- items output_stream_target
- output_stream_targets required
- output_update_input
- output required
object- aspect_ratio_height
integer: The height, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1080. - aspect_ratio_width
integer: The width, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1980. - bitrate_audio
integer: The audio bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough audio) and 1000. The default is 128. - bitrate_video
integer: The video bitrate, in kilobits per second (Kbps). Must be between 0 (for passthrough video) and 10240. The default is 4000. - framerate_reduction
string(values: 0, 1/2, 1/4, 1/25, 1/30, 1/50, 1/60): Reduce the frame rate of the transcoded output rendition. The default, 0, uses the encoded stream's frame rate without reduction. - h264_profile
string(values: main, baseline, high): The encoding method. Specify main for desktop streaming, baseline for playback on mobile devices, or high for HD playback. The default is high. - keyframes
string(values: follow_source, 25, 30, 50, 60, 100, 120): The interval used to define the compression applied to a group of frames. The default, follow_source, uses the keyframe interval of the source video. - passthrough_audio
boolean: If true, sends the audio track to the target without transcoding. The default is false. - passthrough_video
boolean: If true, sends the video track to the target without transcoding. The default is false. - stream_format required
string(values: audiovideo, videoonly, audioonly): The contents of the stream. The default is both audio and video (audiovideo).
- aspect_ratio_height
- output required
- outputs
object- outputs required
array- items output
- outputs required
- player
object- countdown
boolean: A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. - countdown_at
string: The date and time that the event starts, used by the countdown clock. Enter YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - created_at
string: The date and time that the player was created. - embed_code
string: The HTML code that can be used in an external webpage to host the Wowza Streaming Cloud player. - hds_playback_url
string: The address that can be used to configure playback of the stream using the Adobe HDS protocol. - hls_playback_url
string: The address that can be used to configure playback of the stream using the Apple HLS protocol. - hosted_page
boolean: A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page. - hosted_page_description
string: A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_logo_image_url
string: The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. - hosted_page_sharing_icons
string: Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. - hosted_page_title
string: A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_url
string: The URL of the Wowza Streaming Cloud-hosted webpage that viewers can visit to watch the stream. - id
string: The unique alphanumeric string that identifies the player. - logo_image_url
string: The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. - logo_position
string: The corner of the player in which you want the player logo to appear. The default is top-left. - responsive
boolean: A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a width. - transcoder_id
string: The unique alphanumeric string that identifies the transcoder. - type
string: The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over Apple HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5. - updated_at
string: The date and time that the player was updated. - video_poster_image_url
string: The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. - width
integer: The width, in pixels, of a fixed-size player. The default is 640.
- countdown
- player_update_input
object- player required
object- countdown
boolean: A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. - countdown_at
string: The date and time that the event starts, used by the countdown clock. Enter YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - hosted_page
boolean: A web page hosted by Wowza Streaming Cloud that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page. - hosted_page_description
string: A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. - hosted_page_logo_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. - hosted_page_sharing_icons
boolean: Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. - hosted_page_title
string: A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. - logo_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. - logo_position
string: The corner of the player in which you want the player logo to appear. The default is top-left. - remove_hosted_page_logo_image
boolean: If true, removes the logo file from the output. The default is false. - remove_logo_image
boolean: If true, removes the logo file from the output. The default is false. - remove_video_poster_image
boolean: If true, removes the poster image from the output. The default is false. - responsive
boolean: A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a width. - type
string: The player you want to use. Valid values are original_html5, which provides HTML5 playback and falls back to Flash on older browsers, and wowza_player, which provides HTML5 playback over Apple HLS. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. The default is original_html5. - video_poster_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. - width
integer: The width, in pixels, of a fixed-size player. The default is 640.
- countdown
- player required
- players
object- players required
array- items player
- players required
- recording
object- created_at
string: The date and time that the recording was created. - download_url
string: The URL that can be used to download the recording. - duration
integer: The length of the recording, in hours, minutes, and seconds. - file_name
string: The file name of the recording. - file_size
integer: The file size of the recording. - id
string: The unique alphanumeric string that identifies the recording. - reason
string: The reason that a recording has the state failed. - starts_at
string: The date and time that the recording started. - state
string(values: uploading, converting, removing, completed, failed): The state of the recording. - transcoder_id
string: The unique alphanumeric string that identifies the transcoder that was recorded. - transcoder_name
string: The descriptive name of the transcoder that was recorded. - transcoding_uptime_id
string: The unique identifier associated with the transcoding uptime for this recording. - updated_at
string: The date and time that the recording was updated.
- created_at
- recordings
object- recordings required
array- items recording
- recordings required
- schedule
object- action_type
string(values: start, stop, start_stop): The type of action that the schedule should trigger on the transcoder. The default is start. - created_at
string: The date and time that the schedule was created. - end_repeat
string: The month, day, and year that a recurring schedule should stop running. Specify YYYY-MM-DD. - id
string: The unique alphanumeric string that identifies the schedule. - name
string: A descriptive name for the schedule. Maximum 255 characters. - recurrence_data
string(values: sunday, monday, tuesday, wednesday, thursday, friday, saturday): The day or days of the week that a recurring schedule should run. - recurrence_type
string(values: once, recur): A schedule can run one time only (once) or repeat (recur) until a specified end_repeat date. The default is once. - start_repeat
string: The month, day, and year that the recurring schedule should go into effect. Specify YYYY-MM-DD. - start_transcoder
string: The month, day, year, and time of day that the action_type start should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - state
string(values: enabled, disabled, expired): A schedule must be enabled to run. Specify enabled to run the schedule or disabled to turn off the schedule so that it doesn't run. - stop_transcoder
string: The month, day, year, and time of day that the action_type stop should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - transcoder_id
string: The unique alphanumeric string that identifies the transcoder being scheduled. - transcoder_name
string: The name of the transcoder being scheduled. - updated_at
string: The date and time that the schedule was updated.
- action_type
- schedule_create_input
object- schedule required
object- action_type required
string(values: start, stop, start_stop): The type of action that the schedule should trigger on the transcoder. The default is start. - end_repeat
string: The month, day, and year that a recurring schedule should stop running. Specify YYYY-MM-DD. - name required
string: A descriptive name for the schedule. Maximum 255 characters. - recurrence_data
string(values: sunday, monday, tuesday, wednesday, thursday, friday, saturday): The day or days of the week that a recurring schedule should run. - recurrence_type required
string(values: once, recur): A schedule can run one time only (once) or repeat (recur) until a specified end_repeat date. The default is once. - start_repeat
string: The month, day, and year that the recurring schedule should go into effect. Specify YYYY-MM-DD. - start_transcoder
string: The month, day, year, and time of day that the action_type start should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - stop_transcoder
string: The month, day, year, and time of day that the action_type stop should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - transcoder_id required
string: The unique alphanumeric string that identifies the transcoder being scheduled.
- action_type required
- schedule required
- schedule_update_input
object- schedule required
object- action_type required
string(values: start, stop, start_stop): The type of action that the schedule should trigger on the transcoder. The default is start. - end_repeat
string: The month, day, and year that a recurring schedule should stop running. Specify YYYY-MM-DD. - name required
string: A descriptive name for the schedule. Maximum 255 characters. - recurrence_data
string(values: sunday, monday, tuesday, wednesday, thursday, friday, saturday): The day or days of the week that a recurring schedule should run. - start_repeat
string: The month, day, and year that the recurring schedule should go into effect. Specify YYYY-MM-DD. - start_transcoder
string: The month, day, year, and time of day that the action_type start should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC. - stop_transcoder
string: The month, day, year, and time of day that the action_type stop should occur. Specify YYYY-MM-DD HH:MM:SS where HH is a 24-hour clock in UTC.
- action_type required
- schedule required
- schedules
object- schedules required
array- items schedule
- schedules required
- shm_historic_metrics
object- audio_codec audio_codec_metric
- bits_in_rate bits_in_rate_metric
- bits_out_rate bits_out_rate_metric
- cpu_idle cpu_idle_metric
- created_at
string: The date and time that the stream health record was created. - frame_rate frame_rate_metric
- height height_metric
- keyframe_interval keyframe_interval_metric
- video_codec video_codec_metric
- width width_metric
- shm_metrics
object- audio_codec audio_codec_metric
- bits_in_rate bits_in_rate_metric
- bits_out_rate bits_out_rate_metric
- bytes_in_rate bytes_in_rate_metric
- bytes_out_rate bytes_out_rate_metric
- configured_bytes_out_rate configured_bytes_out_rate_metric
- connected connected_metric
- cpu cpu_metric
- frame_rate frame_rate_metric
- frame_size frame_size_metric
- gpu_decoder_usage gpu_decoder_usage_metric
- gpu_driver_version gpu_driver_version_metric
- gpu_encoder_usage gpu_encoder_usage_metric
- gpu_memory_usage gpu_memory_usage_metric
- gpu_usage gpu_usage_metric
- height height_metric
- keyframe_interval keyframe_interval_metric
- stream_target_status_OUTPUTIDX_STREAMTARGETIDX stream_target_status_OUTPUTIDX_STREAMTARGETIDX_metric
- unique_views unique_views_metric
- video_codec video_codec_metric
- width width_metric
- stream_source
object- backup_ip_address
string: If location_method is ip_address, specify the backup IP address of the source encoder. - backup_url
string: The backup RTMP playback URL of the transcoded stream. - created_at
string: The date and time that the stream source was created. - id
string: The unique alphanumeric string that identifies the stream source. - ip_address
string: If location_method is ip_address, specify the primary IP address of the source encoder. - location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): If location_method is region, specify a location as close as possible to the source encoder. - location_method
string(values: region, ip_address): The method used to determine the location of the stream source, either by region or based on the source encoder's ip_address. - name
string: A descriptive name for the stream source. Maximum 255 characters. - password
string: The password that you can use to configure the source encoder to authenticate to the stream source. - playback_url
string: The full RTMP playback URL. - primary_url
string: The primary RTMP playback URL of the transcoded stream. - provider
string: The provider of the Wowza Streaming Cloud stream source. - stream_name
string: The name of the stream that you can use to configure the source encoder to connect to the stream source. - updated_at
string: The date and time that the stream source was updated. - username
string: The username that you can use to configure the source encoder to authenticate to the stream source.
- backup_ip_address
- stream_source_create_input
object- stream_source required
object- backup_ip_address
string: If location_method is ip_address, specify the backup IP address of the source encoder. - ip_address
string: If location_method is ip_address, specify the primary IP address of the source encoder. - location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): If location_method is region, specify a location as close as possible to the source encoder. - location_method required
string(values: region, ip_address): The method used to determine the location of the stream source, either by region or based on the source encoder's ip_address. - name required
string: A descriptive name for the stream source. Maximum 255 characters.
- backup_ip_address
- stream_source required
- stream_source_update_input
object- stream_source required
object- name required
string: A descriptive name for the stream source. Maximum 255 characters.
- name required
- stream_source required
- stream_sources
object- stream_sources required
array- items stream_source
- stream_sources required
- stream_target
object- backup_url
string: The backup ingest URL for a target whose type is WowzaStreamTarget or CustomStreamTarget. - chunk_size
string(values: 2, 4, 6, 8, 10): The chunk_size parameter is deprecated. To set the chunk size of a stream target, use the POST /stream_targets/[stream_target_id]/properties endpoint. Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. The segment duration for HLS encoding. The default is 10. - connection_code
string: A six-character, alphanumeric string that allows Wowza Streaming Engine to send a transcoded stream to a WowzaStreamTarget or for the Wowza GoCoder app to send an encoded stream to a UltraLowLatencyStreamTarget. The code can be used once and expires 24 hours after it's created. - connection_code_expires_at
string: The date and time that the connection_code expires. - created_at
string: The date and time that the stream target was created. - enable_hls
boolean: Returned only for targets whose type is UltraLowLatencyStreamTarget. Indicates whether Apple HLS playback is enabled for the stream target. - enabled
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true (the default), the source stream is ready to be ingested. If false, the source stream won't be ingested by the target's origin server. - hds_playback_url
string: The web address that the target uses to play Adobe HDS streams. - hls_playback_url
string: Only for targets whose provider is akamai_cupertino. The web address that the target uses to play Apple HLS streams. - id
string: The unique alphanumeric string that identifies the stream target. - ingest_ip_whitelist
array: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is push. A list of IP addresses that can be used to connect to the target's origin server.- items
string
- items
- location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): Only for targets whose type is WowzaStreamTarget and provider is not akamai_cupertino. Choose a location as close as possible to your video source. - name
string: A descriptive name for the stream target. Maximum 255 characters. - password
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. A username must also be present. The password associated with the target username for RTMP authentication. - playback_urls
object: Only for targets whose type is UltraLowLatencyStreamTarget. A hash of hls, wowz, and ws URLs that can be used by the player.- hls
string: The web address that the ultra low latency target can use to play the Apple HLS stream. - wowz
string: The wowz and wowzs web addresses that the ultra low latency target can use to play WOWZ streams. - ws
string: The ws and wss web addresses that the ultra low latency target can use to play the WebSocket stream.
- hls
- primary_url
string: The primary ingest URL of the target. - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - region_override
string(values: azure-westus, azure-eastus2, azure-northeurope, null): Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The location of the stream target's origin server. If unspecified, Wowza Streaming Cloud determines the optimal region for the origin server. - rtmp_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play RTMP streams. - secure_ingest_query_param
string: Only for targets whose use_secure_ingest is true. The query parameter needed for secure stream delivery between the transcoder and the target. - source_delivery_method
string(values: push, pull): Only for targets whose type is UltraLowLatencyStreamTarget. The type of connection between the stream source and the stream target. push instructs the source to push the stream to the stream target. pull instructs the stream target to pull the stream from the source. - source_url
string: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The URL of a source IP camera or encoder connecting to the stream target. - stream_name
string: The name of the stream being ingested into the target. Returned for all targets except those whose type is UltraLowLatencyStreamTarget and whose source_delivery_method is pull. - type
string(values: WowzaStreamTarget, UltraLowLatencyStreamTarget, CustomStreamTarget): WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination. - updated_at
string: The date and time that the stream target was updated. - use_cors
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. CORS, or cross-origin resource sharing, allows streams to be sent to providers such as Peer5, Viblast, and Streamroot, which implement a peer-to-peer grid delivery system. - use_https
boolean: The use_https parameter is deprecated. Use the POST /stream_targets/[stream_target_id]/properties endpoint and the relative_playlists parameter instead. - use_secure_ingest
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. If true, generates a secure_ingest_query_param to securely deliver the stream from the transcoder to the provider. - username
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The username or ID that the target uses for RTMP authentication.
- backup_url
- stream_target_create_input
- stream_target required
object- backup_url
string: Only for targets whose type is CustomStreamTarget. The backup RTMP ingest URL of the target, without the preceding protocol and without the trailing slash (/). - chunk_size
string(values: 2, 4, 6, 8, 10): The chunk_size parameter is deprecated. To set the chunk size of a stream target, use the POST /stream_targets/[stream_target_id]/properties endpoint. Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. The segment duration for HLS encoding. The default is 10. - enable_hls
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true, creates an Apple HLS URL for playback on iOS devices (hls_playback_url). The default is false. - enabled
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true (the default), the source stream is ready to be ingested. If false, the source stream won't be ingested by the target's origin server. - hds_playback_url
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The web address that the target uses to play Adobe HDS streams. - hls_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play Apple HLS streams. - ingest_ip_whitelist
array: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is push. A list of IP addresses that can be used to connect to the target's origin server.- items
string
- items
- location required
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): Only for targets whose type is WowzaStreamTarget and provider is not akamai_cupertino. Choose a location as close as possible to your video source. - name required
string: A descriptive name for the stream target. Maximum 255 characters. - password
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. A username must also be present. The password associated with the target username for RTMP authentication. - primary_url required
string: Only for targets whose type is CustomStreamTarget. The primary RTMP ingest URL, without the preceding protocol and without the trailing slash (/). - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - region_override
string(values: azure-westus, azure-eastus2, azure-northeurope): Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The location of the stream target's origin server. If unspecified, Wowza Streaming Cloud determines the optimal region for the origin server. - rtmp_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play RTMP streams. - source_delivery_method required
string(values: push, pull): Only for targets whose type is UltraLowLatencyStreamTarget. The type of connection between the stream source and the stream target. push instructs the source to push the stream to the stream target. pull instructs the stream target to pull the stream from the source. - source_url required
string: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The URL of a source IP camera or encoder connecting to the stream target. - stream_name required
string: Only for targets whose type is CustomStreamTarget. The name of the stream as defined in the target's ingestion settings. - type
string(values: WowzaStreamTarget, UltraLowLatencyStreamTarget, CustomStreamTarget): WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination. - use_cors
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. CORS, or cross-origin resource sharing, allows streams to be sent to providers such as Peer5, Viblast, and Streamroot, which implement a peer-to-peer grid delivery system. - use_https
boolean: The use_https parameter is deprecated. Use the POST /stream_targets/[stream_target_id]/properties endpoint and the relative_playlists parameter instead. - use_secure_ingest
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. If true, generates a secure_ingest_query_param to securely deliver the stream from the transcoder to the provider. - username
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The username or ID that the target uses for RTMP authentication.
- backup_url
- stream_target required
- stream_target_input
object- stream_target required
object- backup_url
string: Only for targets whose type is CustomStreamTarget. The backup RTMP ingest URL of the target, without the preceding protocol and without the trailing slash (/). - chunk_size
string(values: 2, 4, 6, 8, 10): The chunk_size parameter is deprecated. To set the chunk size of a stream target, use the POST /stream_targets/[stream_target_id]/properties endpoint. Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. The segment duration for HLS encoding. The default is 10. - enable_hls
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true, creates an Apple HLS URL for playback on iOS devices (hls_playback_url). The default is false. - enabled
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true (the default), the source stream is ready to be ingested. If false, the source stream won't be ingested by the target's origin server. - hds_playback_url
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The web address that the target uses to play Adobe HDS streams. - hls_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play Apple HLS streams. - ingest_ip_whitelist
array: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is push. A list of IP addresses that can be used to connect to the target's origin server.- items
string
- items
- location required
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): Only for targets whose type is WowzaStreamTarget and provider is not akamai_cupertino. Choose a location as close as possible to your video source. - name required
string: A descriptive name for the stream target. Maximum 255 characters. - password
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. A username must also be present. The password associated with the target username for RTMP authentication. - primary_url required
string: Only for targets whose type is CustomStreamTarget. The primary RTMP ingest URL, without the preceding protocol and without the trailing slash (/). - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - region_override
string(values: azure-westus, azure-eastus2, azure-northeurope): Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The location of the stream target's origin server. If unspecified, Wowza Streaming Cloud determines the optimal region for the origin server. - rtmp_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play RTMP streams. - source_delivery_method required
string(values: push, pull): Only for targets whose type is UltraLowLatencyStreamTarget. The type of connection between the stream source and the stream target. push instructs the source to push the stream to the stream target. pull instructs the stream target to pull the stream from the source. - source_url required
string: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The URL of a source IP camera or encoder connecting to the stream target. - stream_name required
string: Only for targets whose type is CustomStreamTarget. The name of the stream as defined in the target's ingestion settings. - type
string(values: WowzaStreamTarget, UltraLowLatencyStreamTarget, CustomStreamTarget): WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination. - use_cors
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. CORS, or cross-origin resource sharing, allows streams to be sent to providers such as Peer5, Viblast, and Streamroot, which implement a peer-to-peer grid delivery system. - use_https
boolean: The use_https parameter is deprecated. Use the POST /stream_targets/[stream_target_id]/properties endpoint and the relative_playlists parameter instead. - use_secure_ingest
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. If true, generates a secure_ingest_query_param to securely deliver the stream from the transcoder to the provider. - username
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The username or ID that the target uses for RTMP authentication.
- backup_url
- stream_target required
- stream_target_metrics
object- average_bytes_in
number: The average number of bytes transfered to the origin server by the source. - average_total_connections
number: The total number of current connections. - created_at
string: The date and time, in UTC, that the metrics were recorded. - dropped_connections
integer: The total number of dropped connections since the last interval. - maximum_total_connections
integer: The maximum number of connections during the interval. - minimum_total_connections
integer: The minimum number of connections during the interval. - new_connections
integer: The total number of new connections since the last interval.
- average_bytes_in
- stream_target_properties
object- properties required
array- items stream_target_property
- properties required
- stream_target_property
object- key
string(values: chunkSize, playSSL, relativePlaylists, sendSSL): chunkSize defines the duration of the time-based audio and video chunks that Wowza Streaming Cloud delivers to the target. playSSL determines whether Wowza Streaming Cloud sends the stream from the target to the player by using SSL (HTTPS). relativePlaylists allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. sendSSL determines whether Wowza Streaming Cloud sends the stream from the transcoder to the target by using SSL (HTTPS). - section
string(values: hls, playlist): The section of the stream target configuration table that contains the property. For chunkSize and sendSSL, use hls. For playSSL and relativePlaylists, use playlist. - stream_target_id
string: The unique alphanumeric string that identifies the stream target. - value
string(values: 2, 4, 6, 8, 10, true, false): For chunkSize use 2, 4, 6, 8, or 10. For playSSL, relativePlaylists, and sendSSL use true or false.
- key
- stream_target_property_create_input
object- property required
object- key required
string(values: chunkSize, playSSL, relativePlaylists, sendSSL): chunkSize defines the duration of the time-based audio and video chunks that Wowza Streaming Cloud delivers to the target. playSSL determines whether Wowza Streaming Cloud sends the stream from the target to the player by using SSL (HTTPS). relativePlaylists allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. sendSSL determines whether Wowza Streaming Cloud sends the stream from the transcoder to the target by using SSL (HTTPS). - section required
string(values: hls, playlist): The section of the stream target configuration table that contains the property. For chunkSize and sendSSL, use hls. For playSSL and relativePlaylists, use playlist. - value required
string(values: 2, 4, 6, 8, 10, true, false): For chunkSize use 2, 4, 6, 8, or 10. For playSSL, relativePlaylists, and sendSSL use true or false.
- key required
- property required
- stream_target_status_OUTPUTIDX_STREAMTARGETIDX_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
string: The value of the associated key.
- status
- stream_target_update_input
object- stream_target required
object- backup_url
string: Only for targets whose type is CustomStreamTarget. The backup RTMP ingest URL of the target, without the preceding protocol and without the trailing slash (/). - chunk_size
string(values: 2, 4, 6, 8, 10): The chunk_size parameter is deprecated. To set the chunk size of a stream target, use the POST /stream_targets/[stream_target_id]/properties endpoint. Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. The segment duration for HLS encoding. The default is 10. - enabled
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true (the default), the source stream is ready to be ingested. If false, the source stream won't be ingested by the target's origin server. - hds_playback_url
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The web address that the target uses to play Adobe HDS streams. - hls_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play Apple HLS streams. - ingest_ip_whitelist
array: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is push. A list of IP addresses that can be used to connect to the target's origin server.- items
string
- items
- name
string: A descriptive name for the stream target. Maximum 255 characters. - password
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. A username must also be present. The password associated with the target username for RTMP authentication. - primary_url
string: Only for targets whose type is CustomStreamTarget. The primary RTMP ingest URL, without the preceding protocol and without the trailing slash (/). - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - rtmp_playback_url
string: Only for targets whose type is CustomStreamTarget. The web address that the target uses to play RTMP streams. - source_url
string: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The URL of a source IP camera or encoder connecting to the stream target. - stream_name
string: Only for targets whose type is CustomStreamTarget. The name of the stream as defined in the target's ingestion settings. - username
string: Only for targets whose type is CustomStreamTarget and provider is not akamai_cupertino. The username or ID that the target uses for RTMP authentication.
- backup_url
- stream_target required
- stream_targets
object- stream_targets required
array- items index_stream_target
- stream_targets required
- token_auth
object- created_at
string: The date and time that the token authorization was created. - enabled
boolean: Specify true to enable token authorization or false to disable. - stream_target_id
string: The unique alphanumeric string that identifies the stream target. - trusted_shared_secret
string: The trusted shared secret of the token authorization. Must contain only hexadecimal characters and be an even number of total characters not exceeding 32. - updated_at
string: The date and time that the token authorization was updated.
- created_at
- token_auth_create_input
object- token_auth required
object- enabled required
boolean: Specify true to enable token authorization or false to disable. - trusted_shared_secret required
string: The trusted shared secret of the token authorization. Must contain only hexadecimal characters and be an even number of total characters not exceeding 32.
- enabled required
- token_auth required
- token_auth_update_input
object- token_auth required
object- enabled
boolean: Specify true to enable token authorization or false to disable. - trusted_shared_secret
string: The trusted shared secret of the token authorization. Must contain only hexadecimal characters and be an even number of total characters not exceeding 32.
- enabled
- token_auth required
- transcoder
object- application_name
string: The application name from the pull stream source URL. - billing_mode
string(values: pay_as_you_go, twentyfour_seven): The billing mode for the transcoder. The default is pay_as_you_go. - broadcast_location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): The location where Wowza Streaming Cloud transcodes your stream. Choose a location as close as possible to your video source. - buffer_size
integer(values: 0, 1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000): The size, in milliseconds, of the incoming buffer. 0 means no buffer. The default is 4000 (4 seconds). - closed_caption_type
string(values: none, cea, on_text, both): The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioing data streams are being provided. - created_at
string: The date and time that the transcoder was created. - delivery_method
string(values: pull, cdn, push): The type of connection between the source encoder and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder. - delivery_protocols
array: An array of playback protocols enabled for this transcoder. By default, rtmp, rtsp, and wowz are returned.- items
string
- items
- description
string: An optional description of the transcoder. - direct_playback_urls
array: An array of direct playback URLs the transcoder's delivery protocols. Each protocol has a URL for the source and a URL for each output rendition.- items
object- name
string: The name of the playback URL: source, passthrough, or the output rendition's resolution. - output_id
string: Only for output rendition-based playback URLs, not source playback URLs. The unique alphanumeric string that identifies the output rendition. - url
string: The playback URL for the source or output rendition.
- name
- items
- disable_authentication
boolean: Authentication is required by default for RTMP and RTSP push connections from a video source to the transcoder. Specify true to disable authentication with the video source. - domain_name
string: The domain name from the pull stream source URL. - id
string: The unique alphanumeric string that identifies the transcoder. - idle_timeout
integer: The amount of idle time, in seconds, before the transcoder automatically shuts down. Valid values are the integers 0 (never shuts down) to 172800 (48 hours). The default is 1200 (20 minutes). - low_latency
boolean: If true, turns off the sort packet buffer and speeds the time it takes to decode and deliver video data to the player. The default is false. - name
string: A descriptive name for the transcoder. Maximum 200 characters. - outputs
array: Output renditions associated with the transcoder.- items output
- password
string: A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - play_maximum_connections
integer(values: 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100): The number of users who are allowed to connect directly to the transcoder. - protocol
string(values: rtmp, rtsp): The transport protocol for the source video. The default is rtmp. - recording
boolean: If true, creates a recording of the transcoded output. The default is false. - source_port
integer: The port used for RTMP pull connections to Wowza Streaming Cloud. - source_url
string: For the delivery_method pull. Enter the source's web address without the preceding protocol or the trailing slash (/). - stream_extension
string: For the delivery_method push. Some encoders append an extension to their stream names. If the device you're using does this, enter the extension. - stream_name
string: The stream name from the pull stream source URL. - stream_smoother
boolean: A dynamic buffer that helps stabilize streams in rough network conditions, but adds latency. Specify true to enable stream smoothing. The default is false. - stream_source_id
string: For the delivery_method cdn. The alphanumeric string that identifies the stream source that you want to use to deliver the stream to the transcoder. - suppress_stream_target_start
boolean: If true, disables stream targets when the transcoder starts. If false (the default), the targets start when the transcoder starts. - transcoder_type
string(values: transcoded, passthrough): The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded. - updated_at
string: The date and time that the transcoder was updated. - username
string: A username for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - video_fallback
boolean: If true, black video plays if the video source disconnects from the transcoder. If false (the default), a stream-not-available message appears. Works only with stream targets whose provider is akamai_cupertino. - watermark
boolean: Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image. - watermark_height
integer: The height, in pixels, of the watermark image. If blank, Wowza Streaming Cloud uses the original image height. - watermark_image_url
string: The path to a GIF, JPEG, or PNG image that is embedded in all bitrate renditions of the stream. Watermark image files must be 2.5 MB or smaller. - watermark_opacity
integer(values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100): The opacity, or percentage of transparency, of the watermark. 0 is fully transparent; 100 is fully opaque. - watermark_position
string(values: top-left, top-right, bottom-left, bottom-right): The corner of the video frame in which you want the watermark to appear. The default is top-left. - watermark_width
integer: The width, in pixels, of the watermark image. If blank, Wowza Streaming Cloud uses the original image width.
- application_name
- transcoder_create_input
object- transcoder required
object- billing_mode required
string(values: pay_as_you_go, twentyfour_seven): The billing mode for the transcoder. The default is pay_as_you_go. - broadcast_location required
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): The location where Wowza Streaming Cloud transcodes your stream. Choose a location as close as possible to your video source. - buffer_size
integer(values: 0, 1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000): The size, in milliseconds, of the incoming buffer. 0 means no buffer. The default is 4000 (4 seconds). - closed_caption_type
string(values: none, cea, on_text, both): The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioing data streams are being provided. - delivery_method required
string(values: pull, cdn, push): The type of connection between the source encoder and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder. - delivery_protocols
array: An array of playback protocols enabled for this transcoder. By default, rtmp, rtsp, and wowz are returned.- items
string
- items
- description
string: An optional description of the transcoder. - disable_authentication
boolean: Authentication is required by default for RTMP and RTSP push connections from a video source to the transcoder. Specify true to disable authentication with the video source. - idle_timeout
integer: The amount of idle time, in seconds, before the transcoder automatically shuts down. Valid values are the integers 0 (never shuts down) to 172800 (48 hours). The default is 1200 (20 minutes). - low_latency
boolean: If true, turns off the sort packet buffer and speeds the time it takes to decode and deliver video data to the player. The default is false. - name required
string: A descriptive name for the transcoder. Maximum 200 characters. - password
string: A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - play_maximum_connections
integer(values: 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100): The number of users who are allowed to connect directly to the transcoder. - protocol required
string(values: rtmp, rtsp): The transport protocol for the source video. The default is rtmp. - recording
boolean: If true, creates a recording of the transcoded output. The default is false. - source_url
string: For the delivery_method pull. Enter the source's web address without the preceding protocol or the trailing slash (/). - stream_extension
string: For the delivery_method push. Some encoders append an extension to their stream names. If the device you're using does this, enter the extension. - stream_smoother
boolean: A dynamic buffer that helps stabilize streams in rough network conditions, but adds latency. Specify true to enable stream smoothing. The default is false. - stream_source_id
string: For the delivery_method cdn. The alphanumeric string that identifies the stream source that you want to use to deliver the stream to the transcoder. - suppress_stream_target_start
boolean: If true, disables stream targets when the transcoder starts. If false (the default), the targets start when the transcoder starts. - transcoder_type required
string(values: transcoded, passthrough): The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. The default is transcoded. - username
string: A username for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - video_fallback
boolean: If true, black video plays if the video source disconnects from the transcoder. If false (the default), a stream-not-available message appears. Works only with stream targets whose provider is akamai_cupertino. - watermark
boolean: Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image. - watermark_height
integer: The height, in pixels, of the watermark image. If blank, Wowza Streaming Cloud uses the original image height. - watermark_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG image that is embedded in all bitrate renditions of the stream. Watermark image files must be 2.5 MB or smaller. - watermark_opacity
integer(values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100): The opacity, or percentage of transparency, of the watermark. 0 is fully transparent; 100 is fully opaque. - watermark_position
string(values: top-left, top-right, bottom-left, bottom-right): The corner of the video frame in which you want the watermark to appear. The default is top-left. - watermark_width
integer: The width, in pixels, of the watermark image. If blank, Wowza Streaming Cloud uses the original image width.
- billing_mode required
- transcoder required
- transcoder_properties
object- properties required
array- items transcoder_property
- properties required
- transcoder_property
object- key
string: The key of the property. For rtsp, valid values are debugRtspSession, maxRtcpWaitTime, avSyncMethod, rtspValidationFrequency, rtpTransportMode, rtspFilterUnknownTracks, rtpIgnoreSpropParameterSets, and rtpIgnoreProfileLevelId. For cupertino, valid values are cupertinoEnableProgramDateTime, cupertinoEnableId3ProgramDateTime, and cupertinoProgramDateTimeOffset. - section
string: The section of the transcoder configuration table that contains the property. Valid values are rtsp and cupertino. - transcoder_id
string: The unique alphanumeric string that identifies the transcoder. - value
string: The value of the property. For debugRtspSession, avSyncMethod, rtspFilterUnknownTracks, rtpIgnoreSpropParameterSets, rtpIgnoreProfileLevelId, cupertinoEnableProgramDateTime, and cupertinoEnableId3ProgramDateTime, valid values are true or false. maxRtcpWaitTime must be 0 (ms, off) or greater. The default is 2000. Valid values for rtpTransportMode are udp or interleave (the default). rtspValidationFrequency must be 0 (ms, off) or greater. The default is 15000. cupertinoProgramDateTimeOffset must be an integer, positive or negative. The default is 0 (ms).
- key
- transcoder_property_create_input
object- property required
object- key required
string: The key of the property. For rtsp, valid values are debugRtspSession, maxRtcpWaitTime, avSyncMethod, rtspValidationFrequency, rtpTransportMode, rtspFilterUnknownTracks, rtpIgnoreSpropParameterSets, and rtpIgnoreProfileLevelId. For cupertino, valid values are cupertinoEnableProgramDateTime, cupertinoEnableId3ProgramDateTime, and cupertinoProgramDateTimeOffset. - section required
string: The section of the transcoder configuration table that contains the property. Valid values are rtsp and cupertino. - value required
string: The value of the property. For debugRtspSession, avSyncMethod, rtspFilterUnknownTracks, rtpIgnoreSpropParameterSets, rtpIgnoreProfileLevelId, cupertinoEnableProgramDateTime, and cupertinoEnableId3ProgramDateTime, valid values are true or false. maxRtcpWaitTime must be 0 (ms, off) or greater. The default is 2000. Valid values for rtpTransportMode are udp or interleave (the default). rtspValidationFrequency must be 0 (ms, off) or greater. The default is 15000. cupertinoProgramDateTimeOffset must be an integer, positive or negative. The default is 0 (ms).
- key required
- property required
- transcoder_update_input
object- transcoder required
object- broadcast_location
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): The location where Wowza Streaming Cloud transcodes your stream. Choose a location as close as possible to your video source. - buffer_size
integer(values: 0, 1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000): The size, in milliseconds, of the incoming buffer. 0 means no buffer. The default is 4000 (4 seconds). - closed_caption_type
string(values: none, cea, on_text, both): The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioing data streams are being provided. - delivery_method required
string(values: pull, cdn, push): The type of connection between the source encoder and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder. - delivery_protocols
array: An array of playback protocols enabled for this transcoder. By default, rtmp, rtsp, and wowz are returned.- items
string
- items
- description
string: An optional description of the transcoder. - disable_authentication
boolean: Authentication is required by default for RTMP and RTSP push connections from a video source to the transcoder. Specify true to disable authentication with the video source. - idle_timeout
integer: The amount of idle time, in seconds, before the transcoder automatically shuts down. Valid values are the integers 0 (never shuts down) to 172800 (48 hours). The default is 1200 (20 minutes). - low_latency
boolean: If true, turns off the sort packet buffer and speeds the time it takes to decode and deliver video data to the player. The default is false. - name required
string: A descriptive name for the transcoder. Maximum 200 characters. - password
string: A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - play_maximum_connections
integer(values: 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100): The number of users who are allowed to connect directly to the transcoder. - protocol required
string(values: rtmp, rtsp): The transport protocol for the source video. The default is rtmp. - recording
boolean: If true, creates a recording of the transcoded output. The default is false. - remove_watermark_image
boolean: If true, removes the watermark from the output. The default is false. - source_url
string: For the delivery_method pull. Enter the source's web address without the preceding protocol or the trailing slash (/). - stream_extension
string: For the delivery_method push. Some encoders append an extension to their stream names. If the device you're using does this, enter the extension. - stream_smoother
boolean: A dynamic buffer that helps stabilize streams in rough network conditions, but adds latency. Specify true to enable stream smoothing. The default is false. - stream_source_id
string: For the delivery_method cdn. The alphanumeric string that identifies the stream source that you want to use to deliver the stream to the transcoder. - suppress_stream_target_start
boolean: If true, disables stream targets when the transcoder starts. If false (the default), the targets start when the transcoder starts. - username
string: A username for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. - video_fallback
boolean: If true, black video plays if the video source disconnects from the transcoder. If false (the default), a stream-not-available message appears. Works only with stream targets whose provider is akamai_cupertino. - watermark
boolean: Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image. - watermark_height
integer: The height, in pixels, of the watermark image. If blank, Wowza Streaming Cloud uses the original image height. - watermark_image
string: A Base64-encoded string representation of a GIF, JPEG, or PNG image that is embedded in all bitrate renditions of the stream. Watermark image files must be 2.5 MB or smaller. - watermark_opacity
integer(values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100): The opacity, or percentage of transparency, of the watermark. 0 is fully transparent; 100 is fully opaque. - watermark_position
string(values: top-left, top-right, bottom-left, bottom-right): The corner of the video frame in which you want the watermark to appear. The default is top-left. - watermark_width
integer: The width, in pixels, of the watermark image. If blank, Wowza Streaming Cloud uses the original image width.
- broadcast_location
- transcoder required
- transcoders
object- transcoders required
array- items transcoder
- transcoders required
- ull_stream_target_input
object- stream_target required
object- enable_hls
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true, creates an Apple HLS URL for playback on iOS devices (hls_playback_url). The default is false. - enabled
boolean: Only for targets whose type is UltraLowLatencyStreamTarget. If true (the default), the source stream is ready to be ingested. If false, the source stream won't be ingested by the target's origin server. - ingest_ip_whitelist
array: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is push. A list of IP addresses that can be used to connect to the target's origin server.- items
string
- items
- name required
string: A descriptive name for the stream target. Maximum 255 characters. - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - region_override
string: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The location of the stream target's origin server. If unspecified, Wowza Streaming Cloud determines the optimal region for the origin server. - source_delivery_method required
string: Only for targets whose type is UltraLowLatencyStreamTarget. The type of connection between the stream source and the stream target. push instructs the source to push the stream to the stream target. pull instructs the stream target to pull the stream from the source. - source_url required
string: Only for targets whose type is UltraLowLatencyStreamTarget and source_delivery_method is pull. The URL of a source IP camera or encoder connecting to the stream target. - type
string: WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination.
- enable_hls
- stream_target required
- unique_views_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- uptime
object- billed
boolean: A Boolean value that indicates if the usage generated by this uptime has been sent for billing processing. - created_at
string: The date and time that the uptime record was created. - ended_at
string: The date and time that the transcoder was stopped for this uptime. If this value is not present, it indicates that the transcoder is currently running. - id
string: The unique alphanumeric string that identifies the uptime record. - running
boolean: A Boolean value that indicates if the transcoder is still running for this uptime. - started_at
string: The date and time that the transcoder started for this uptime. - transcoder_id
string: The unique alphanumeric string that identifies the transcoder. - updated_at
string: The date and time that the uptime record was updated.
- billed
- uptimes
object- uptimes required
array- items uptime
- uptimes required
- url
object- bitrate
integer: The video bitrate, in kilobits per second (Kbps), of the output rendition that will be played at the URL. May correspond to the bitrate of an output rendition being used by the live stream or transcoder. Must be greater than 0. - created_at
string: The date and time that the player URL was created. - height
integer: The height, in pixels, of the output rendition that will be played at the URL. May correspond to the height of an output rendition being used by the live stream or transcoder. Must be greater than 0. - id
string: The unique alphanumeric string that identifies the player URL. - label
string: A descriptive name for the player URL. Maximum 255 characters. - player_id
string: The unique alphanumeric string that identifies the player. - updated_at
string: The date and time that the player URL was updated. - url
string: The URL of the player. If using a Wowza CDN target, the URL format ishttp://[wowzasubdomain]-f.akamaihd.net/z/[stream_name]_[angle]@[stream_id]/manifest.f4mfor Adobe HDS playback orhttp://[wowzasubdomain]-f.akamaihd.net/i/[stream_name]_[angle]@[stream_id]/master.m3u8for Apple HLS playback. - width
integer: The width, in pixels, of the output rendition that will be played at the URL. May correspond to the width of an output rendition being used by the live stream or transcoder. Must be greater than 0.
- bitrate
- url_create_input
- url required
object- bitrate
integer: The video bitrate, in kilobits per second (Kbps), of the output rendition that will be played at the URL. May correspond to the bitrate of an output rendition being used by the live stream or transcoder. Must be greater than 0. - height
integer: The height, in pixels, of the output rendition that will be played at the URL. May correspond to the height of an output rendition being used by the live stream or transcoder. Must be greater than 0. - label
string: A descriptive name for the player URL. Maximum 255 characters. - url
string: The URL of the player. If using a Wowza CDN target, the URL format ishttp://[wowzasubdomain]-f.akamaihd.net/z/[stream_name]_[angle]@[stream_id]/manifest.f4mfor Adobe HDS playback orhttp://[wowzasubdomain]-f.akamaihd.net/i/[stream_name]_[angle]@[stream_id]/master.m3u8for Apple HLS playback. - width
integer: The width, in pixels, of the output rendition that will be played at the URL. May correspond to the width of an output rendition being used by the live stream or transcoder. Must be greater than 0.
- bitrate
- url required
- url_input
object- url required
object- bitrate
integer: The video bitrate, in kilobits per second (Kbps), of the output rendition that will be played at the URL. May correspond to the bitrate of an output rendition being used by the live stream or transcoder. Must be greater than 0. - height
integer: The height, in pixels, of the output rendition that will be played at the URL. May correspond to the height of an output rendition being used by the live stream or transcoder. Must be greater than 0. - label
string: A descriptive name for the player URL. Maximum 255 characters. - url
string: The URL of the player. If using a Wowza CDN target, the URL format ishttp://[wowzasubdomain]-f.akamaihd.net/z/[stream_name]_[angle]@[stream_id]/manifest.f4mfor Adobe HDS playback orhttp://[wowzasubdomain]-f.akamaihd.net/i/[stream_name]_[angle]@[stream_id]/master.m3u8for Apple HLS playback. - width
integer: The width, in pixels, of the output rendition that will be played at the URL. May correspond to the width of an output rendition being used by the live stream or transcoder. Must be greater than 0.
- bitrate
- url required
- url_update_input
- url required
object- bitrate
integer: The video bitrate, in kilobits per second (Kbps), of the output rendition that will be played at the URL. May correspond to the bitrate of an output rendition being used by the live stream or transcoder. Must be greater than 0. - height
integer: The height, in pixels, of the output rendition that will be played at the URL. May correspond to the height of an output rendition being used by the live stream or transcoder. Must be greater than 0. - label
string: A descriptive name for the player URL. Maximum 255 characters. - url
string: The URL of the player. If using a Wowza CDN target, the URL format ishttp://[wowzasubdomain]-f.akamaihd.net/z/[stream_name]_[angle]@[stream_id]/manifest.f4mfor Adobe HDS playback orhttp://[wowzasubdomain]-f.akamaihd.net/i/[stream_name]_[angle]@[stream_id]/master.m3u8for Apple HLS playback. - width
integer: The width, in pixels, of the output rendition that will be played at the URL. May correspond to the width of an output rendition being used by the live stream or transcoder. Must be greater than 0.
- bitrate
- url required
- urls
object- urls required
array- items url
- urls required
- usage_network_stream_source
object- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream source during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream source during the selected time frame. - deleted
boolean: A value of true indicates that the stream source has been removed from Wowza Streaming Cloud. - id
string: The unique alphanumeric string that identifies the stream source. - name
string: A descriptive name for the stream source.
- bytes_billed
- usage_network_stream_sources
object- stream_sources
array
- stream_sources
- usage_network_stream_target
object- stream_targets
object: An array of stream targets and their usage by protocol and zone.- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream target during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream target during the selected time frame. - deleted
boolean: A value of true indicates that the stream target has been removed from Wowza Streaming Cloud. - id
string: The unique alphanumeric string that identifies the stream target. - name
string: A descriptive name for the stream target. - protocols
object: A hash of protocols that accrued network usage, keyed by the name of the protocol that generated the usage.- zones
object: A hash of zones with network usage, keyed by the name of the billing zone where the usage was generated.- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream target during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream target during the selected time frame.
- bytes_billed
- zones
- bytes_billed
- total
object: A hash of total usage, including overall total billed and used for all targets, and totals by zone for each protocol.- bytes_billed
integer: The amount of usage, in bytes, that was billed for all stream targets during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through all stream targets during the selected time frame. - protocols
object: A hash of protocols that accrued network usage, keyed by the name of the protocol that generated the usage.- zones
object: A hash of zones with network usage, keyed by the name of the billing zone where the usage was generated.- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream target during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream target during the selected time frame.
- bytes_billed
- zones
- bytes_billed
- stream_targets
- usage_network_stream_targets
object- stream_targets
object: An array of stream targets and their usage by protocol and zone.- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream target during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream target during the selected time frame. - deleted
boolean: A value of true indicates that the stream target has been removed from Wowza Streaming Cloud. - id
string: The unique alphanumeric string that identifies the stream target. - name
string: A descriptive name for the stream target. - protocols
object: A hash of protocols that accrued network usage, keyed by the name of the protocol that generated the usage.- zones
object: A hash of zones with network usage, keyed by the name of the billing zone where the usage was generated.- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream target during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream target during the selected time frame.
- bytes_billed
- zones
- bytes_billed
- total
object: A hash of total usage, including overall total billed and used for all targets, and totals by zone for each protocol.- bytes_billed
integer: The amount of usage, in bytes, that was billed for all stream targets during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through all stream targets during the selected time frame. - protocols
object: A hash of protocols that accrued network usage, keyed by the name of the protocol that generated the usage.- zones
object: A hash of zones with network usage, keyed by the name of the billing zone where the usage was generated.- bytes_billed
integer: The amount of usage, in bytes, that was billed for the stream target during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the stream target during the selected time frame.
- bytes_billed
- zones
- bytes_billed
- stream_targets
- usage_network_transcoder
object- bytes_billed
integer: The amount of usage, in bytes, that was billed for the live stream or transcoder during the selected time frame. - bytes_used
integer: The amount of content, in bytes, that went through the live stream or transcoder during the selected time frame. - deleted
boolean: A value of true indicates that the live stream or transcoder has been removed from Wowza Streaming Cloud. - id
integer: The unique alphanumeric string that identifies the live stream or transcoder. - name
string: A descriptive name for the live stream or transcoder.
- bytes_billed
- usage_network_transcoders
object- transcoders
array- items usage_network_transcoder
- transcoders
- usage_storage_peak_recording
object- peak_recording
object- bytes_total
integer: The amount, in bytes, used to store recordings during the selected time frame. If the time frame is in the past, bytes_total is the amount of storage that was used and billed. If the time frame includes the current billing period, bytes_total is the greatest amount of content stored in Wowza Streaming Cloud at any point to date in the billing period.
- bytes_total
- peak_recording
- usage_time_transcoder
object- deleted
boolean: A value of true indicates that the live stream or transcoder has been removed from Wowza Streaming Cloud. - id
integer: The unique alphanumeric string that identifies the live stream or transcoder. - name
string: A descriptive name for the live stream or transcoder. - seconds_billed
integer: The amount of stream processing time, in seconds, that was billed for the live stream or transcoder. - seconds_used
integer: The amount of time, in seconds, that it took for the live stream or transcoder to be processed.
- deleted
- usage_time_transcoders
object- transcoders
array- items usage_time_transcoder
- transcoders
- usage_viewer_data_countries
array- items
object- country_code
object- name
string: The name of the country. - percentage_viewers
integer: Total percentage of viewers (100). - percentage_viewing_time
integer: The percentage of total viewing time that the protocol or rendition was viewed. Always 100 for stream_target. - protocols usage_viewer_data_protocols
- seconds_avg_viewing_time
integer: The average length of time, in seconds, that viewers played the stream at the target. - seconds_total_viewing_time
integer: The total length of time, in seconds, that all viewers played the stream at the target. seconds_total_viewing_time may be longer than the duration of the stream. - total_unique_viewers
integer: The total number of unique viewers that downloaded at least one chunk of the stream at the target (for HTTP streams) or connected to and viewed the stream (for ultra low latency streams). A unique viewer is a single IP address; multiple users that share the same IP address are counted once.
- name
- country_code
- items
- usage_viewer_data_protocols
array- items
object- protocol_name
object- name
string: The name of the protocol. - percentage_viewers
integer: Total percentage of viewers (100). - percentage_viewing_time
integer: The percentage of total viewing time that the protocol or rendition was viewed. Always 100 for stream_target. - seconds_avg_viewing_time
integer: The average length of time, in seconds, that viewers played the stream at the target. - seconds_total_viewing_time
integer: The total length of time, in seconds, that all viewers played the stream at the target. seconds_total_viewing_time may be longer than the duration of the stream. - total_unique_viewers
integer: The total number of unique viewers that downloaded at least one chunk of the stream at the target (for HTTP streams) or connected to and viewed the stream (for ultra low latency streams). A unique viewer is a single IP address; multiple users that share the same IP address are counted once.
- name
- protocol_name
- items
- usage_viewer_data_renditions
array- items
object- rendition_name
object- countries usage_viewer_data_countries
- name
string: The name of the rendition. - percentage_viewers
integer: Total percentage of viewers (100). - percentage_viewing_time
integer: The percentage of total viewing time that the protocol or rendition was viewed. Always 100 for stream_target. - protocols usage_viewer_data_protocols
- seconds_avg_viewing_time
integer: The average length of time, in seconds, that viewers played the stream at the target. - seconds_total_viewing_time
integer: The total length of time, in seconds, that all viewers played the stream at the target. seconds_total_viewing_time may be longer than the duration of the stream. - total_unique_viewers
integer: The total number of unique viewers that downloaded at least one chunk of the stream at the target (for HTTP streams) or connected to and viewed the stream (for ultra low latency streams). A unique viewer is a single IP address; multiple users that share the same IP address are counted once.
- rendition_name
- items
- usage_viewer_data_stream_target
object- stream_target
object- countries usage_viewer_data_countries
- country_list
array: A comma-separated list of all viewed country codes shown as strings, for quick reference.- items
string
- items
- percentage_viewers
integer: Total percentage of viewers (100). - percentage_viewing_time
integer: The percentage of total viewing time that the protocol or rendition was viewed. Always 100 for stream_target. - protocols usage_viewer_data_protocols
- rendition_list
array: A comma-separated list of all viewed renditions shown as numbers, for quick reference.- items
string
- items
- renditions usage_viewer_data_renditions
- seconds_avg_viewing_time
integer: The average length of time, in seconds, that viewers played the stream at the target. - seconds_total_viewing_time
integer: The total length of time, in seconds, that all viewers played the stream at the target. seconds_total_viewing_time may be longer than the duration of the stream. - total_unique_viewers
integer: The total number of unique viewers that downloaded at least one chunk of the stream at the target (for HTTP streams) or connected to and viewed the stream (for ultra low latency streams). A unique viewer is a single IP address; multiple users that share the same IP address are counted once.
- stream_target
- video_codec_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
string: The value of the associated key.
- status
- width_metric
object- status
string: The status of the current key. Possible values are normal (everything is fine), warning (something may be misconfigured), and no_data (no data was returned, perhaps because the instance isn't running). - text
string: A message related to the value and status of the current key. Usually blank unless there's a warning status. - units
string: The unit of the returned value, such as Kbps, bps, %, FPS, or GOP. - value
integer: The value of the associated key.
- status
- wowza_stream_target_input
object- stream_target required
object- chunk_size
string(values: 2, 4, 6, 8, 10): The chunk_size parameter is deprecated. To set the chunk size of a stream target, use the POST /stream_targets/[stream_target_id]/properties endpoint. Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. The segment duration for HLS encoding. The default is 10. - location required
string(values: asia_pacific_australia, asia_pacific_japan, asia_pacific_singapore, asia_pacific_taiwan, eu_belgium, eu_germany, eu_ireland, south_america_brazil, us_central_iowa, us_east_s_carolina, us_east_virginia, us_west_california, us_west_oregon): Only for targets whose type is WowzaStreamTarget and provider is not akamai_cupertino. Choose a location as close as possible to your video source. - name required
string: A descriptive name for the stream target. Maximum 255 characters. - provider
string: The CDN for the target.
Required for targets whose type is CustomStreamTarget. Valid values for CustomStreamTarget are akamai, akamai_cupertino, akamai_rtmp, limelight, rtmp, and ustream. Values can be appended with _mock to use in the sandbox environment.
Valid values for WowzaStreamTarget are akamai, akamai_cupertino (default), akamai_legacy_rtmp, and wowza.
UltraLowLatencyStreamTarget defaults to and must be wowza. - type
string: WowzaStreamTarget is a Wowza CDN target. UltraLowLatencyStreamTarget is an ultra low latency Wowza stream target. CustomStreamTarget (the default) is an external, third-party destination. - use_cors
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. CORS, or cross-origin resource sharing, allows streams to be sent to providers such as Peer5, Viblast, and Streamroot, which implement a peer-to-peer grid delivery system. - use_https
boolean: The use_https parameter is deprecated. Use the POST /stream_targets/[stream_target_id]/properties endpoint and the relative_playlists parameter instead. - use_secure_ingest
boolean: Only for targets whose type is WowzaStreamTarget and provider is akamai_cupertino. If true, generates a secure_ingest_query_param to securely deliver the stream from the transcoder to the provider.
- chunk_size
- stream_target required