Creates a stream pulling configuration for a live stream.

Note You can pull only live streams in the RTMP, HTTP, and FLV formats. This operation can be called up to 15 times per second.

Debugging

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 AddLivePullStreamInfoConfig

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

AppName String Yes testApp

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

DomainName String Yes live.yourdomain.com

The domain name used in stream pulling. It is the streaming domain.

EndTime String Yes 2017-12-22T08:00:00Z

The time when stream pulling ends.

The duration specified by the StartTime parameter and the EndTime parameter cannot exceed seven days. The time specified by the EndTime parameter must be later than the current time. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

StartTime String Yes 2017-12-21T08:00:00Z

The time when stream pulling starts.

The duration specified by the StartTime parameter and the EndTime parameter cannot exceed seven days. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

SourceUrl String Yes live.yourdomain.com

The origin server of the live stream. You can specify multiple origin addresses. Separate them with semicolons (;).

StreamName String Yes testStream

The name of the live stream.

Response parameters

Parameter Type Example Description
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/? Action=AddLivePullStreamInfoConfig
&AppName=testApp
&DomainName=live.yourdomain.com
&EndTime=2017-12-22T08:00:00Z
&SourceUrl=live.yourdomain.com
&StartTime=2017-12-21T08:00:00Z
&StreamName=testStream
&<Common request parameters>

Sample success responses

XML format

<AddLivePullStreamInfoConfigResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</AddLivePullStreamInfoConfigResponse>

JSON format

{
    "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidStartTime.Malformed Specified StartTime is malformed. The error message returned because the format of the start time is invalid. Check whether the value of the StartTime parameter is correct.
400 InvalidEndTime.Malformed Specified EndTime is malformed. The error message returned because the format of the end time is invalid. Check whether the value of the EndTime parameter is correct.
400 ConfigAlreadyExists Config has already exist. The error message returned because an existing stream pulling configuration is found.

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