Skip to main content

channel

Gets an individual channel resource

Overview

Namechannel
TypeResource
Descriptionchannel
Idawscc.ivs.channel

Fields

NameDatatypeDescription
arnstringChannel ARN is automatically generated on creation and assigned as the unique identifier.
namestringChannel
authorizedbooleanWhether the channel is authorized.
insecure_ingestbooleanWhether the channel allows insecure ingest.
latency_modestringChannel latency mode.
typestringChannel type, which determines the allowable resolution and bitrate. If you exceed the allowable resolution or bitrate, the stream probably will disconnect immediately.
tagsarrayA list of key-value pairs that contain metadata for the asset model.
playback_urlstringChannel Playback URL.
ingest_endpointstringChannel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software.
recording_configuration_arnstringRecording Configuration ARN. A value other than an empty string indicates that recording is enabled. Default: "" (recording is disabled).
presetstringOptional transcode preset for the channel. This is selectable only for ADVANCED_HD and ADVANCED_SD channel types. For those channel types, the default preset is HIGHER_BANDWIDTH_DELIVERY. For other channel types (BASIC and STANDARD), preset is the empty string ("").
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
arn,
name,
authorized,
insecure_ingest,
latency_mode,
type,
tags,
playback_url,
ingest_endpoint,
recording_configuration_arn,
preset
FROM awscc.ivs.channel
WHERE data__Identifier = '<Arn>';

Permissions

To operate on the channel resource, the following permissions are required:

Read

ivs:GetChannel,
ivs:ListTagsForResource

Update

ivs:GetChannel,
ivs:UpdateChannel,
ivs:TagResource,
ivs:UnTagResource,
ivs:ListTagsForResource

Delete

ivs:DeleteChannel,
ivs:UnTagResource