CreateMediaLiveChannel - Intelligent Media Services - Alibaba Cloud Documentation Center

Creates a MediaLive channel.

Operation description

QPS limit

This operation can be called up to 50 times per second for each Alibaba Cloud account. Requests that exceed this limit are dropped and you may experience service interruptions. We recommend that you take note of this limit when you call this operation.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- For mandatory resource types, indicate with a prefix of * .
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
ice:CreateMediaLiveChannel	create	All Resources ``	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.
	object	Yes
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.
	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	long	Yes	Enter a specific PID from within a source.	123
AudioTrackSelection	array<object>	No	The audio track selection.
	object	No
TrackId	long	Yes	Specify one or more audio tracks from within a source using Track ID.	1
OutputGroups	array<object>	Yes	The output groups.
	object	Yes
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.
	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.
	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.
	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 parameters

Parameter	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

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.