You can call this operation to complete manual recording on demand. You can start and stop recording at any time.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform. Set the value to RealTimeRecordCommand.
Command String Yes The operation. Valid values: start and stop.
DomainName String Yes The CDN domain name.
AppName String Yes The name of the live streaming application.
StreamName String Yes The name of the live stream.

Response parameters

Name Type Description
RequestId String The GUID generated by Alibaba Cloud for the request.

Examples

Sample requests
 https://live.aliyuncs.com?Action=RealTimeRecordCommand&DomainName=test101.cdnpe.com&AppName=abc&StreamName=s1&Command=start<Common request parameters>

Sample responses

JSON format
{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

Error code Error message HTTP status code Description
InvalidDomain.NotFound The domain provided does not exist in our records. 404 The error message returned when the domain name does not exist or does not belong to the current user.
MissingDomainName DomainName is mandatory for this action. 400 The error message returned when the value of DomainName is missing.
MissingAppName AppName is mandatory for this action. 400 The error message returned when the value of AppName is missing.
MissingStreamName StreamName is mandatory for this action. 400 The error message returned when the value of StreamName is missing.
MissingCommand Command is mandatory for this Command. 400 The error message returned when the value of Command is missing.
InvalidStream.NotFound Stream does not exist. 404 The error message returned when the specified stream does not exist.
InvalidConfig.NotFound Config does not exist. 404 The error message returned when the specified setting does not exist.
TaskAlreadyStarted Task has already started. 409 The error message returned when the recording task has already started.
InternalError The request processing has failed due to some unknown error, exception or failure. 500 The error message returned when an internal error occurred.

For more information, see common error codes of ApsaraVideo Live.