Query Cloud Recording Status

After you start a recording, you can call query method to check its status.

• Method: GET
• Endpoint: /v1/apps/<appid>/cloud_recording/resourceid/<resourceid>/sid/<sid>/mode/<mode>/query

The request frequency limit is 10 requests per second for each Agora account. Contact Agora technical support if you need to raise the limit.

HTTP request

The following parameters are required in the URL.

Request example

• The request URL is:

https://api.agora.io/v1/apps/<yourappid>/cloud_recording/resourceid/<resourceid>/sid/<sid>/mode/<mode>/query

• Content-type is application/json;charset=utf-8.
• Authorization is the basic authentication, see RESTful API authentication for details.

HTTP response

If the returned HTTP status code is 200, it means the request was successful, and the response body contains the following fields:

• code: Number. Status code.

• resourceId: String. The resource ID for cloud recording. The resource ID is valid for five minutes.

• sid: String. The recording ID. The unique identification of the current recording.

• serverResponse: JSON. The details about the recording status.

  The child elements in serverResponse vary according to your configurations in start. For example, if you configure snapshotConfig or extensionServiceConfig in start, then query does not return fileListMode.

  • fileListMode: String. The data type of fileList.

    • "string": fileList is a string. In composite mode, if you set avFileType as ["hls"], fileListMode is "string".
    • "json": fileList is a JSONArray. In individual mode, or if you set avFileType as ["hls","mp4"] in composite recording mode, fileListMode is "json".

  • fileList: When fileListMode is "string", fileList is a string that represents the filename of the M3U8 file. When fileListMode is "json", fileList is a JSONArray that contains the details of each recorded file. The query method does not return this field if you have set snapshotConfig.

    • fileName: String. The name of the M3U8 file and MP4 files.
    • trackType: String. The type of the recorded file.
      • "audio": Audio file.
      • "video": Video file (no audio).
      • "audio_and_video": Video file (with audio).
    • uid: String. User ID. The user whose audio or video is recorded in the file. In composite recording mode, uid is "0".
    • mixedAllUser: Boolean. Whether the audio and video of all users are combined into a single file.
      • true: All users are recorded in a single file.
      • false: Each user is recorded separately.
    • isPlayable: Boolean. Whether the file can be played online.
      • true: The file can be played online.
      • false: The file cannot be played online.
    • sliceStartTime: Number. The Unix time (ms) when the recording starts.

  • status: Number. The status of the cloud service.

    • 0: The cloud service has not started.
    • 1: The initialization is complete.
    • 2: The cloud service is starting.
    • 3: The cloud service is partially ready.
    • 4: The cloud service is ready.
    • 5: The cloud service is in progress.
    • 6: The cloud service receives the request to stop.
    • 7: The cloud service stops.
    • 8: The cloud service exits.
    • 20: The cloud service exits abnormally.

  • sliceStartTime: Number. The time when the recording starts. Unix timestamp (ms).

  • subServiceStatus: JSON. The status of the cloud recording submodules. The recording service does not return this field in web page recording mode.

    • recordingService: String. The status of the video subscription submodule. For details, see Service status.

  • extensionServiceState: JSONArray. An array of the detailed status information of each extension service.

    ApsaraVideo for VoD

    • serviceName: String. The name of the extension service. aliyun_vod_service means ApsaraVideo for VoD.
    • payload: JSON. The status of the extension service.
      • state: String. The status of uploading media content to the extension service.
        • "inProgress": The recorded files are being uploaded to the extension service.
        • "idle": No user is sending streams in the channel. Nothing is being uploaded.
      • videoInfo: JSONArray. An array of the M3U8 files and their corresponding video IDs. ApsaraVideo for VoD generates a video ID for each M3U8 file uploaded.
        • fileName: String. The name of the M3U8 file.
        • videoId: String. The corresponding video ID of the M3U8 file.

    Web page recording

    • serviceName: String . The name of the extension service. "web_recorder_service" means web page recording.
    • payload: JSON. The status of the extension service.
      • state: String. The status of uploading subscribed content to the extension service.
        • "init": The service is initializing.
        • "inProgress": The service has initialized and is working.
        • "exit": The service exits.
      • onhold：Bool. Whether the page recording is paused.
        • true: The web page recording is paused.
        • false: The eeb page recording continues.
      • fileList: JSONArray. An array that contains details of each recorded file.
        • fileName: String. The name of the M3U8 file or MP4 file.
        • sliceStartTime: Number. The Unix timestamp (ms) when the recording starts.:

    Push media stream to the CDN during a web page recording

    • serviceName: String . The name of the extension service. "rtmp_publish_service" means pushing media stream to the CDN during a web page recording.
    • payload: JSON. The status of the extension service.
    • outputs: JSON Array. Configure as follows:
    • rtmpUrl: String. The CDN address which you want to push stream to.
      • status：String. The CDN streaming status, including the following options:
        • connecting: Connecting to the CDN server.
        • publishing: Pushing the stream to the CDN server.
        • onhold: Pause streaming.
        • disconnected: Failed to connect to the CDN server. Agora recommends that you change the CDN address.

Response example

Audio and video recording in a channel

"Code": 200,
"Body":
{
    "resourceId": "JyvK8nXHuV1BE64GDkAaBGEscvtHW7v8BrQoRPCHxmeVxwY22-x-kv4GdPcjZeMzoCBUCOr9q-k6wBWMC7SaAkZ_4nO3JLqYwM1bL1n6wKnnD9EC9waxJboci9KUz2WZ4YJrmcJmA7xWkzs_L3AnNwdtcI1kr_u1cWFmi9BWAWAlNd7S7gfoGuH0tGi6CNaOomvr7-ILjPXdCYwgty1hwT6tbAuaW1eqR0kOYTO0Z1SobpBxu1czSFh1GbzGvTZG",
    "serverResponse": {
        "fileListMode": "json",
        "fileList": [
            {
                "fileName": "xxx.m3u8",
                "trackType": "audio_and_video",
                "uid": "123",
                "mixedAllUser": true,
                "isPlayable": true,
                "sliceStartTime": 1562724971626
            },
            {
                "fileName": "xxx.m3u8",
                "trackType": "audio_and_video",
                "uid": "456",
                "mixedAllUser": true,
                "isPlayable": true,
                "sliceStartTime": 1562724971626
            }
        ],
        "status": 5,
        "sliceStartTime": 1562724971626
    }
}

Web page recording

"Code": 200,
"Body":
{
    "resourceId": "JyvK8nXHuV1BE64GDkAaBGEscvtHW7v8BrQoRPCHxmeVxwY22-x-kv4GdPcjZeMzoCBUCOr9q-k6wBWMC7SaAkZ_4nO3JLqYwM1bL1n6wKnnD9EC9waxJboci9KUz2WZ4YJrmcJmA7xWkzs_L3AnNwdtcI1kr_u1cWFmi9BWAWAlNd7S7gfoGuH0tGi6CNaOomvr7-ILjPXdCYwgty1hwT6tbAuaW1eqR0kOYTO0Z1SobpBxu1czSFh1GbzGvTZG",
    "serverResponse": {
        "extensionServiceState": [
            {
                "payload": {
                    "fileList": [],
                    "onhold": false,
                    "state": "inProgress"
                },
                "serviceName": "web_recorder_service"
            }
        ],
        "status": 4
    }
}

Push media stream to the CDN during a web page recording

"Code": 200,
"Body":
{
    "resourceId": "JyvK8nXHuV1BE64GDkAaBGEscvtHW7v8BrQoRPCHxmeVxwY22-x-kv4GdPcjZeMzoCBUCOr9q-k6wBWMC7SaAkZ_4nO3JLqYwM1bL1n6wKnnD9EC9waxJboci9KUz2WZ4YJrmcJmA7xWkzs_L3AnNwdtcI1kr_u1cWFmi9BWAWAlNd7S7gfoGuH0tGi6CNaOomvr7-ILjPXdCYwgty1hwT6tbAuaW1eqR0kOYTO0Z1SobpBxu1czSFh1GbzGvTZG",
    "serverResponse": {
        "extensionServiceState": [
            {
                "payload": {
                    "fileList": [],
                    "onhold": false,
                    "state": "inProgress"
                },
                "serviceName": "web_recorder_service"
            },
            {
                "payload": {
                    "outputs": [
                        {
                            "rtmpUrl": "rtmp://xxx",
                            "status": "publishing"
                        }
                    ]
                },
                "serviceName": "rtmp_publish_service"
            }
        ],
        "status": 4
    }
}