Modifies the stream pulling configurations of a live stream.

Usage note

This interface is currently applicable to regular stream pulling. Call this interface to update the live streaming configuration information, including the origin URLs, the time when stream pulling starts, and the time when stream pulling ends.

Note After you modify the configurations, ApsaraVideo Live pulls streams based on the modified configurations. Make sure that the modification does not affect online business.

QPS limit

A single user can perform a maximum of 1000 queries per minute (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.

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 UpdateLivePullStreamInfoConfig

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

UpdateLivePullStreamInfoConfig.

AppName String Yes liveApp****

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

DomainName String Yes example.com

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

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

The time when stream pulling ends.

The time range specified by the StartTime and EndTime parameters 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.

SourceUrl String Yes rtmp://guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream****

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

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

The time when stream pulling starts.

The time range specified by the StartTime and EndTime parameters 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.

StreamName String Yes liveStream****

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=UpdateLivePullStreamInfoConfig
&AppName=liveApp****
&DomainName=example.com
&EndTime=2017-12-22T08:00:00Z
&SourceUrl=rtmp://guide.aliyundoc.com/liveApp****/liveStream****;rtmp://developer.aliyundoc.com/liveApp****/liveStream****
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream****

Sample success responses

XML format

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

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 valid.
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 valid.
400 InvalidEndTime.Mismatch Specified end time does not math the specified start time. The error message returned because the end time is not later than the start time. Check whether the values of the StartTime and EndTime parameters are valid.

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

Special error codes

Error code

Error message

HTTP status code

Description

InternalError

The request processing has failed due to some unknown error.

500

The error message returned because an unknown error has occurred.

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

The error message returned because the domain name does not belong to your Alibaba Cloud account.

IllegalOperation

Illegal domain operate is not permitted.

403

The error message returned because the current operation is not supported. For example, the specified domain name is not a live domain.

Duration.Exceed

Duration between StartTime and EndTime is too long.

400

The error message returned because the time range specified by the StartTime and EndTime parameters exceeds the limit.