Queries the stream pulling configurations of a domain name.

Usage note

This interface is currently applicable to regular stream pulling.

QPS limit

A single user can perform a maximum of 50 queries per second (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 DescribeLivePullStreamConfig

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

DomainName String Yes example.com

The name of the main streaming domain.

Response parameters

Parameter Type Example Description
LiveAppRecordList Array of LiveAppRecord

The stream pulling configurations.
LiveAppRecord
DomainName String example.com

The streaming domain to which the live stream belongs.
AppName String liveApp****

The name of the application to which the live stream belongs.
StreamName String liveStream****

The name of the live stream.
SourceUrl String guide.aliyundoc.com

The origin server of the live stream.
StartTime String 2016-05-15T01:30:00Z

The beginning of the time range in which data was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

EndTime String 2016-05-20T01:33:00Z

The end of the time range in which data was queried. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

RequestId String A3136B58-5876-4168-83CA-B562781981A0

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLivePullStreamConfig
&DomainName=example.com
&<Common request parameters>

Sample success responses

XML format 

<DescribeLivePullStreamConfigResponse>
  <RequestId>A3136B58-5876-4168-83CA-B562781981A0</RequestId>
  <LiveAppRecordList>
        <LiveAppRecord>
              <SourceUrl>guide.aliyundoc.com</SourceUrl>
              <StreamName>liveStream****</StreamName>
              <EndTime>2016-05-20T01:33:00Z</EndTime>
              <DomainName>example.com</DomainName>
              <StartTime>2016-05-15T01:30:00Z</StartTime>
              <SourceUsing>guide.aliyundoc.com</SourceUsing>
              <AppName>liveApp****</AppName>
        </LiveAppRecord>
  </LiveAppRecordList>
</DescribeLivePullStreamConfigResponse>

JSON format 

{
    "DescribeLivePullStreamConfigResponse": {
        "RequestId": "A3136B58-5876-4168-83CA-B562781981A0",
        "LiveAppRecordList": {
            "LiveAppRecord": {
                "SourceUrl": "guide.aliyundoc.com",
                "StreamName": "liveStream****",
                "EndTime": "2016-05-20T01:33:00Z",
                "DomainName": "example.com",
                "StartTime": "2016-05-15T01:30:00Z",
                "SourceUsing": "guide.aliyundoc.com",
                "AppName": "liveApp****"
            }
        }
    }
}

Error codes

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