All Products
Search
Document Center

:DescribeLiveDomainMultiStreamConfig

Last Updated:May 22, 2025

Queries the configuration status of dual-stream disaster recovery

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

get

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

Domain

string

Yes

The main streaming domain.

pliveplay.gstv.com.cn

Response parameters

Parameter

Type

Description

Example

object

The response schema.

RequestId

string

The request ID.

F486A44F-6B35-5A96-BF2C-************

Switch

string

Indicates whether the dual-stream disaster recovery feature is enabled. Valid values:

  • on: enabled

  • off: disabled

on

Examples

Sample responses

JSONformat

{
  "RequestId": "F486A44F-6B35-5A96-BF2C-************",
  "Switch": "on"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter %s. Parameter error
400 CodeGetPushbackDomainError Unable to get the push domain name, please check the domain name mapping configuration. Unable to get the push domain name, please check the domain name mapping configuration.
500 InternalError %s. error on the live liveapi server.

For more error codes, see Error Center.