DescribeLiveDomainRecordUsageData

Usage note

• You can call this operation to query the number of concurrent recording channels each day and event tracking data at different time intervals. These can be used to measure the peak number of concurrent recording channels on each day or month.
• The number of time-shifted channels is not included in the number of recording channels.
• You can query data by domain name or query data for multiple domain names. If you want to query data for multiple domain names, separate the domain names with commas (,).
• You can query data generated over the past 90 days.
• The data interval represents the time granularity of the data query. The data interval is fixed to one hour. You cannot customize data intervals.
• The maximum time range in which the data can be queried is 31 days.

QPS limit

A single user can perform a maximum of 10 queries per minute. 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.

Request parameters

Response parameters

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainRecordUsageData
&DomainName=example.com
&StartTime=2021-05-10T20:00:00Z
&EndTime=2021-05-10T21:00:00Z
&<Common request parameters>

Sample success responses

XML format

<DescribeLiveDomainRecordUsageDataResponse>
      <RequestId>4B460F8B-993C-4F48-B98A-910811DEBFEB</RequestId>
      <RecordUsageData>
            <DataModule>
                  <Type>MP4</Type>
                  <Duration>3560</Duration>
                  <Count>1</Count>
                  <Domain>example.com</Domain>
                  <TimeStamp>2021-05-10T20:00:00Z</TimeStamp>
            </DataModule>
            <DataModule>
                  <Type>TS</Type>
                  <Duration>3476</Duration>
                  <Count>1</Count>
                  <Domain>example.com</Domain>
                  <TimeStamp>2021-05-10T20:00:00Z</TimeStamp>
            </DataModule>
      </RecordUsageData>
</DescribeLiveDomainRecordUsageDataResponse>

JSON format

{
    "RequestId": "4B460F8B-993C-4F48-B98A-910811DEBFEB",
    "RecordUsageData": {
        "DataModule": [
            {
                "Type": "MP4",
                "Duration": 3560,
                "Count": 1,
                "Domain": "example.com",
                "TimeStamp": "2021-05-10T20:00:00Z"
            },
            {
                "Type": "TS",
                "Duration": 3476,
                "Count": 1,
                "Domain": "example.com",
                "TimeStamp": "2021-05-10T20:00:00Z"
            }
        ]
    }
}

Error codes

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

Special error codes