All Products
Search
Document Center

ApsaraVideo Live:ListRTCLiveRooms

Last Updated:Oct 18, 2025

Retrieves active ARTC channels.

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

AppId

string

Yes

The ID of the application.

a494caec-***-695ef345db77

PageSize

integer

No

The number of entries per page. Valid values: 10 to 100. Default value: 50.

50

PageNo

integer

No

The page number. Page numbers start from 1.

1

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

5c6a2a0df228-4a64-af62-20e91b96****

Total

integer

The total number of entries returned.

2

Rooms

array

The active channels.

string

The channel ID.

room1

Examples

Success response

JSON format

{
  "RequestId": "5c6a2a0df228-4a64-af62-20e91b96****",
  "Total": 2,
  "Rooms": [
    "room1"
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400

InputInvalid

%s.

Illegal input parameters

403

NoAuth

%s.

No permission

404

ResourceNotExist

%s.

The requested resource does not exist, please check and try again

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.