DocsICP FilingConsole
官方文档
首页

CreateMediaLiveChannel

更新时间：
复制 MD 格式
产品详情
我的收藏

Creates a MediaLive channel.

Operation description

QPS limit

This operation can be called up to 50 times per second per Alibaba Cloud account. Requests that exceed this limit are dropped, which may cause service interruptions.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ice:CreateMediaLiveChannel

create

*All Resource

*

 None None

Request parameters

Parameter

Type

Required

Description

Example
Name

string

Yes

The name of the channel. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 64 characters in length.

mych
InputAttachments

array<object>

Yes

The associated inputs.

array<object>

No

InputId

string

Yes

The ID of the associated input.

myinput
LanguageName

string

No

The tag that identifies the language of the RTMP input. It can be referenced by the output. The maximum length is 32 characters. Supported characters:

  • Unicode letters

  • Digits (0-9)

  • Underscore (_)

  • Hyphen (-)

  • Space (a space cannot be at the beginning or end)

English
AudioSelectors

array<object>

No

The audio selectors.

array<object>

No

Name

string

Yes

The name of the audio selector. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 64 characters in length.

myselector
AudioLanguageSelection

object

No

The audio language selection.

LanguageCode

string

Yes

Enter a three-letter ISO 639-2 language code from within an audio source.

eng
AudioPidSelection

object

No

The audio PID selection.

Pid

integer

Yes

Enter a specific PID from within a source.

123
AudioTrackSelection

array<object>

No

The audio track selection.

object

No

TrackId

integer

Yes

Specify one or more audio tracks from within a source using Track ID.

1
OutputGroups

array<object>

Yes

The output groups.

array<object>

No

Name

string

Yes

The name of the output group. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 64 characters in length.

group1
Type

string

Yes

The output group type. Only MediaPackage is supported.

MediaPackage
Outputs

array<object>

Yes

The outputs in the output group.

array<object>

No

Name

string

Yes

The name of the output. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 64 characters in length.

output1
MediaType

integer

No

The media type of the output. Valid values:

  • 0: Audio and Video.

  • 1: Audio. If you set the value to 1, you cannot reference VideoSettings.

  • 2: Video. If you set the value to 2, you cannot reference AudioSettings.

0
MediaPackageOutputSetting

object

No

The settings of the output delivered to MediaPackage.

NameModifier

string

No

The manifest name modifier. The child manifests include this modifier in their M3U8 file names. Letters, digits, hyphens (-), and underscores (_) are supported. The maximum length is 40 characters.

480p
AudioGroupId

string

No

The manifest audio group ID. To associate several audio tracks into one group, assign the same audio group ID. Viewers can select a track as needed. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 40 characters in length.

audiogroup
VideoSettingName

string

No

The name of the referenced VideoSettings.

myVideo1
AudioSettingNames

array

No

The referenced AudioSettings.

string

No

The name of the referenced AudioSettings.

myAudio1
MediaPackageGroupSetting

object

No

The MediaPackage destination.

GroupName

string

Yes

GroupName in MediaPackage.

myPackageGroup
ChannelName

string

Yes

ChannelName in MediaPackage.

myPackageChannel
AudioSettings

array<object>

No

The audio settings.

array<object>

No

Name

string

Yes

The name of the audio settings. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 64 characters in length.

audio1
AudioSelectorName

string

No

The name of the audio selector.

a1
LanguageCode

string

No

Enter a three-letter ISO 639-2 language code. If the audio track selected by the audio selector has a language code, the language code specified in the audio selector is used. If the selected audio track does not have a language code, or if the audio selector cannot find a track that matches its criteria, this language code is used.

eng
LanguageName

string

No

The tag that identifies the language of the RTMP input. It can be referenced by the output. The maximum length is 32 characters. Supported characters:

  • Unicode letters

  • Digits (0-9)

  • Underscore (_)

  • Hyphen (-)

  • Space (a space cannot be at the beginning or end)

English
AudioCodec

string

No

The audio codec. If it is not specified, the source specification is used. Valid values: aac and libfdk_aac.

libfdk_aac
AudioCodecSetting

object

No

The audio encoding settings.

Profile

string

No

The audio codec profile. When AudioCodec is set to aac, AAC-LOW and AAC-MAIN are supported. When AudioCodec is set to libfdk_aac, AAC-LOW, AAC-HE, and AAC-HEV2 are supported.

AAC-LOW
Bitrate

integer

No

The audio bitrate. Unit: bit/s. Valid values: 8000 to 1000000. The value must be divisible by 1000.

200000
SampleRate

integer

No

The audio sample rate. Unit: Hz. Valid values: 22050, 32000, 44100, 48000, and 96000.

44100
VideoSettings

array<object>

No

The video settings.

array<object>

No

Name

string

Yes

The name of the video settings. Letters, digits, hyphens (-), and underscores (_) are supported. It can be up to 64 characters in length.

video1
Width

integer

No

The width of the output. If you set it to 0 or leave it empty, the width automatically adapts to the specified height to maintain the original aspect ratio.

Valid values:

  • For regular transcoding, the larger dimension cannot exceed 3840 px, and the smaller one cannot exceed 2160 px.

  • For Narrowband HD™ transcoding, the larger dimension cannot exceed 1920 px, and the smaller one cannot exceed 1080 px.

1280
Height

integer

No

The height of the output. If you set it to 0 or leave it empty, the height automatically adapts to the specified width to maintain the original aspect ratio.

Valid values:

  • For regular transcoding, the larger dimension cannot exceed 3840 px, and the smaller one cannot exceed 2160 px.

  • For Narrowband HD™ transcoding, the larger dimension cannot exceed 1920 px, and the smaller one cannot exceed 1080 px.

720
VideoCodec

string

No

The video codec. Valid values: H264 and H265.

H264
VideoCodecSetting

object

No

The video encoding settings.

Rate

object

No

The video encoding rate. If it is not specified, the source specification is used.

Bitrate

integer

No

The video bitrate. Unit: bit/s. If you set it to 0 or leave it empty, the source specification is used. Valid values: 50000 to 6000000. The value must be divisible by 1000.

2500000
RateControlMode

string

No

The bitrate control mode. Valid values: CBR, ABR, and VBR.

ABR
MaxBitrate

integer

No

The maximum bitrate. Unit: bit/s. Valid values: 100000 to 6000000. The value must be divisible by 1000.

6000000
BufferSize

integer

No

The video buffer size. Unit: bit/s. Valid values: 100000 to 6000000. The value must be divisible by 1000.

6000000
Framerate

object

No

The frame rate. If it is not specified, the source specification is used.

FramerateControl

string

No

The frame rate mode. Valid values: SPECIFIED (fixed frame rate) and FROM_SOURCE (use source specification).

SPECIFIED
FramerateNumerator

integer

No

The numerator of the fixed frame rate. The parameter is required when FramerateControl is set to SPECIFIED. Valid values: 1 to 60. The numerator must be divisible by the denominator.

25
FramerateDenominator

integer

No

The denominator of the fixed frame rate. The parameter is required when FramerateControl is set to SPECIFIED. Valid values: 1 to 60. The numerator must be divisible by the denominator.

1
Gop

object

No

The GOP setting. If it is not specified, the source specification is used.

GopSizeUnits

string

No

The GOP size unit. Valid values: FRAMES and SECONDS.

FRAMES
GopSize

integer

No

The GOP size. When GopSizeUnits is set to SECONDS, the value range is from 1 to 20. When GopSizeUnits is set to FRAMES, the value range is from 1 to 3000.

90
BframesNum

integer

No

The number of B frames. Valid values: 1 to 3.

3
CodecDetail

object

No

The video encoding settings.

Profile

string

No

The H.264 profile. Valid values: BASELINE, HIGH, and MAIN. Default value: MAIN. The parameter takes effect only when the codec is H.264.

MAIN
Level

string

No

The video encoding level. It is not supported yet.

H264_LEVEL_AUTO
VideoCodecType

string

No

The video transcoding method. Valid values:

  • NORMAL: regular transcoding

  • NBHD: Narrowband HD™ transcoding

If not specified, regular transcoding is used by default.

NORMAL

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The ID of the request.

******11-DB8D-4A9A-875B-275798******
ChannelId

string

The ID of the channel.

SEGK5KA6KYKAWQQH

Examples

Success response

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "ChannelId": "SEGK5KA6KYKAWQQH"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.

Previous：DeleteMediaLiveInputNext：UpdateMediaLiveChannel