All Products
Search
Document Center

:SetLiveDomainMultiStreamMaster - Manually switch between the active stream and standby stream

Last Updated:May 22, 2025

Manually switches between the active stream and standby stream.

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.

Debug

RAM authorization

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

  • Action: The operation that is allowed. You can specify it in the Action element of a policy.

    Format: {#ramcode}:{#action-name}

    • {#ramcode}: The code used in RAM to indicate an Alibaba Cloud service. The RAM code for placeholder-${productName} is placeholder-${ramCodes?join("、")}.

    • {#action-name}: The name of API operations defined by placeholder-${productName}.

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

  • Access level: The level of access granted for the operation. Valid values: Write, Read, and List.

  • Rsource type: The resource types that support authorization to perform this operation. 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 operations where resource-level permissions are unavailable, it is shown as All Resources. You need to use an asterisk (*) in the Resource element of the policy.

    • For operations with resource-level permissions, required resource types are marked with an asterisk (*). You must specify the corresponding resource ARN in the Resource element of the policy. For details on the ARN format, see Resource.

  • Condition key: The condition keys defined for this action, which can be used in the Condition element of the policy. The key allows for granular control, applying to either actions alone or actions associated with specific resources. For more information on the Condition element, see Condition.

  • Dependent action: Dependent actions required to run the action. The requester must have permissions for all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

live:SetLiveDomainMultiStreamMaster

update

*All resources

*

None None

Request parameters

Parameter

Type

Required

Description

Example

Domain

string

Yes

The main streaming domain.

example.aliyundoc.com

AppName

string

Yes

The name of the application to which the live stream belongs.

testapp

StreamName

string

Yes

The name of the live stream.

teststream

UpstreamSequence

string

Yes

The unique identifier of the stream ingest.

teststream_***

Response parameters

Parameter

Type

Description

Example

object

The response schema.

RequestId

string

The request ID.

16A96B9A-F203-4E*****43-CB92E68F4CD8

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter %s. Parameter error
400 LiveServiceNotFound Your account does not open Live service yet Your account has not activated the Live service yet
400 CodeTaskNotExist Task does not exist. The task does not exist.
400 CodeTaskNotStarted Task not started, cannot operate. The task has not started and cannot be operated.
500 InternalError %s. Live API service error.

For more error codes, see Error Center.