Deletes live stream recording files.

QPS limit

You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit on an API operation in ApsaraVideo Live.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteLiveStreamRecordIndexFiles

The operation that you want to perform. Set the value to DeleteLiveStreamRecordIndexFiles.

RegionId String No cn-shanghai

The region where the domain resides.

RecordId.N String Yes c4d7f0a4-b506-43f9-8de3-07732c3f****

The ID of the index file. You can configure a maximum of 20 IDs.

DomainName String Yes

The name of the main streaming domain.

AppName String Yes liveApp****

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

StreamName String Yes liveStream****

The name of the live stream.

RemoveFile String Yes true

Specifies whether to delete the corresponding file in Object Storage Service (OSS) synchronously. Valid values:

  • true: The corresponding file in OSS is deleted.
  • false: The corresponding file in OSS is not deleted.

Response parameters

Parameter Type Example Description
Code String OK

The status code. A return value of 500 indicates an error. For details, see the Error codes section of this topic.

Message String OK

The status description. A return value of 500 indicates an error. For details, see the Error codes section of this topic.

RequestId String 939D19EE-59A0-18E9-B458-*****

The ID of the request.

RecordDeleteInfoList Array of RecordDeleteInfo
Message String OK

The processing result of each file indicated by the file ID. Valid values:

  • OK: The file has been deleted.
  • AccessDenied: Access to the file has been denied.
  • FileNotFound: The file fails to be found.
RecordId String c4d7f0a4-b506-43f9-8de3-07732c3f**

The ID of the index file that is used to locate the live stream recording files to be deleted.


Sample requests

&<Common request parameters>

Sample responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RecordDeleteInfoList" : {
    "RecordDeleteInfo" : [ {
      "Message" : "OK",
      "RecordId" : "a5b03f0f-f5df-41a2-8507-*****"
    }, {
      "Message" : "FileNotFound",
      "RecordId" : "a5b03f0f-f5df-41a2-8507-*****"
    } ]
  "RequestId" : "939D19EE-59A0-18E9-B458-*****",
  "Message" : "OK",
  "Code" : "OK"

Error codes

HTTP status code Error code Error message Description
500 InternalError The request processing has failed due to some unknown error. The error message returned because an internal error has occurred. Try again later. If the error persists, submit a ticket.

For a list of error codes, visit the API Error Center.