All Products
Search
Document Center

Manual recording

Last Updated: Aug 18, 2018

Description

You can use RealTimeRecordCommand interface to perform manual recording. For example, to dynamically start and stop recording in real time.

Request parameters

Parameter Type Required or not Description
Command String Yes The act of operation.
Support start and stop operations.
DomainName String Yes Your acceleration domain name.
AppName String Yes The name of the App.
StreamName String Yes The name of the stream.

Response parameters

Parameter Type Description
RequestId String The request ID of the task.

Example

Request example

  1. https://live.aliyuncs.com?Action=RealTimeRecordCommand&DomainName=test101.cdnpe.com&AppName=abc&StreamName=s1&Command=start<Public request parameter>

Response example

JSONformat

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  3. }

Special error code

Error code Description Http Status code Meaning
InvalidDomain.NotFound The domain provided does not exist in our records. 404 The domain name is not found under the current account.
MissingDomainName DomainName is mandatory for this action. 400 The value of DomainName is missing.
MissingAppName AppName is mandatory for this action. 400 The value of AppName is missing.
MissingStreamName StreamName is mandatory for this action. 400 The value of StreamName is missing.
MissingCommand Command is mandatory for this Command. 400 The value of Commandis missing.
InvalidStream.NotFound Stream does not exist. 404 Stream does not exist.
InvalidConfig.NotFound Config does not exist. 404 Configuration does not exist.
TaskAlreadyStarted Task has already started. 409 The recording task has started.
InternalError The request processing has failed due to some unknown error, exception or failure. 500 Internal error.

You can view the general error code of ApsaraVideo Live console. For more information, see API Error Center.