DocsICP FilingConsole
官方文档
首页

UpdateMediaLiveChannel

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

Modifies a MediaLive channel.

Operation description

  • You can modify a MediaLive channel only when it is not running.

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:UpdateMediaLiveChannel

update

*All Resource

*

 None None

Request parameters

Parameter

Type

Required

Description

Example
ChannelId

string

Yes

The ID of the channel.

SEGK5KA6KYKAWQQH
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 inputs associated with the channel.

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

A three-letter ISO 639-2 language code from the audio source.

eng
AudioPidSelection

object

No

The audio PID selection.

Pid

integer

Yes

The PID to select from the source.

123
AudioTrackSelection

array<object>

No

The audio track selection.

object

No

TrackId

integer

Yes

The track ID of the audio track to select from the source.

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 only. VideoSettings cannot be referenced.

  • 2: Video only. AudioSettings cannot be referenced.

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. Assign the same ID to associate multiple audio tracks into one group for viewer selection. 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

A three-letter ISO 639-2 language code. If the audio selector finds a track with a language code, that code takes precedence. Otherwise, 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 not specified, the source codec 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 in bit/s. Valid values: 8000 to 1000000. The value must be divisible by 1000.

200000
SampleRate

integer

No

The audio sample rate in 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 output width. Set to 0 or leave empty to auto-adapt based on the specified height while preserving 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 output height. Set to 0 or leave empty to auto-adapt based on the specified width while preserving 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 not specified, the source setting is used.

Bitrate

integer

No

The video bitrate in bit/s. Set to 0 or leave empty to use the source bitrate. 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 in bit/s. Valid values: 100000 to 6000000. The value must be divisible by 1000.

6000000
BufferSize

integer

No

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

6000000
Framerate

object

No

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

FramerateControl

string

No

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

SPECIFIED
FramerateNumerator

integer

No

The numerator of the fixed frame rate. 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. 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 not specified, the source setting is used.

GopSizeUnits

string

No

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

FRAMES
GopSize

integer

No

The GOP size. Valid values: 1 to 20 when GopSizeUnits is SECONDS, or 1 to 3000 when FRAMES.

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. Takes effect only when the codec is H.264.

MAIN
Level

string

No

The video encoding level. 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 request ID.

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

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.

Previous：CreateMediaLiveChannelNext：GetMediaLiveChannel