[ aws . mediatailor ]

create-channel

Description

Creates a channel.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  create-channel
--channel-name <value>
[--filler-slate <value>]
--outputs <value>
--playback-mode <value>
[--tags <value>]
[--tier <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--channel-name (string)

The identifier for the channel you are working on.

--filler-slate (structure)

The slate used to fill gaps between programs in the schedule. You must configure filler slate if your channel uses the LINEAR PlaybackMode. MediaTailor doesn’t support filler slate for channels using the LOOP PlaybackMode.

SourceLocationName -> (string)

The name of the source location where the slate VOD source is stored.

VodSourceName -> (string)

The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.

Shorthand Syntax:

SourceLocationName=string,VodSourceName=string

JSON Syntax:

{
  "SourceLocationName": "string",
  "VodSourceName": "string"
}

--outputs (list)

The channel’s output properties.

(structure)

The output configuration for this channel.

DashPlaylistSettings -> (structure)

DASH manifest configuration parameters.

ManifestWindowSeconds -> (integer)

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

MinBufferTimeSeconds -> (integer)

Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: 2 seconds. Maximum value: 60 seconds.

MinUpdatePeriodSeconds -> (integer)

Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

SuggestedPresentationDelaySeconds -> (integer)

Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

HlsPlaylistSettings -> (structure)

HLS playlist configuration parameters.

ManifestWindowSeconds -> (integer)

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

ManifestName -> (string)

The name of the manifest for the channel. The name appears in the PlaybackUrl.

SourceGroup -> (string)

A string used to match which HttpPackageConfiguration is used for each VodSource.

Shorthand Syntax:

DashPlaylistSettings={ManifestWindowSeconds=integer,MinBufferTimeSeconds=integer,MinUpdatePeriodSeconds=integer,SuggestedPresentationDelaySeconds=integer},HlsPlaylistSettings={ManifestWindowSeconds=integer},ManifestName=string,SourceGroup=string ...

JSON Syntax:

[
  {
    "DashPlaylistSettings": {
      "ManifestWindowSeconds": integer,
      "MinBufferTimeSeconds": integer,
      "MinUpdatePeriodSeconds": integer,
      "SuggestedPresentationDelaySeconds": integer
    },
    "HlsPlaylistSettings": {
      "ManifestWindowSeconds": integer
    },
    "ManifestName": "string",
    "SourceGroup": "string"
  }
  ...
]

--playback-mode (string)

The type of playback mode to use for this channel.

LINEAR - The programs in the schedule play once back-to-back in the schedule.

LOOP - The programs in the schedule play back-to-back in an endless loop. When the last program in the schedule stops playing, playback loops back to the first program in the schedule.

Possible values:

• LOOP

• LINEAR

--tags (map)

The tags to assign to the channel.

key -> (string)

value -> (string)

Shorthand Syntax:

KeyName1=string,KeyName2=string

JSON Syntax:

{"string": "string"
  ...}

--tier (string)

The tier of the channel.

Possible values:

• BASIC

• STANDARD

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

Arn -> (string)

The ARN of the channel.

ChannelName -> (string)

The name of the channel.

ChannelState -> (string)

Indicates whether the channel is in a running state or not.

CreationTime -> (timestamp)

The timestamp of when the channel was created.

FillerSlate -> (structure)

Contains information about the slate used to fill gaps between programs in the schedule.

SourceLocationName -> (string)

The name of the source location where the slate VOD source is stored.

VodSourceName -> (string)

The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.

LastModifiedTime -> (timestamp)

The timestamp of when the channel was last modified.

Outputs -> (list)

The channel’s output properties.

(structure)

This response includes only the “property” : “type” property.

DashPlaylistSettings -> (structure)

DASH manifest configuration settings.

ManifestWindowSeconds -> (integer)

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

MinBufferTimeSeconds -> (integer)

Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: 2 seconds. Maximum value: 60 seconds.

MinUpdatePeriodSeconds -> (integer)

Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

SuggestedPresentationDelaySeconds -> (integer)

Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

HlsPlaylistSettings -> (structure)

HLS manifest configuration settings.

ManifestWindowSeconds -> (integer)

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

ManifestName -> (string)

The name of the manifest for the channel that will appear in the channel output’s playback URL.

PlaybackUrl -> (string)

The URL used for playback by content players.

SourceGroup -> (string)

A string used to associate a package configuration source group with a channel output.

PlaybackMode -> (string)

The channel’s playback mode.

Tags -> (map)

The tags assigned to the channel.

key -> (string)

value -> (string)

Tier -> (string)

The channel’s tier.