ApsaraVideo Live:DescribeLiveDomainRecordUsageData

Usage notes

• You can call this operation to query the number of concurrent recording channels on each day and event tracking data at different time intervals. This way, you can measure the peak number of concurrent recording channels on each day or month.
• The number of time-shifting channels is not included in the number of recording channels.
• You can query data by domain name or query data for multiple domain names at a time. If you want to query data for multiple domain names at a time, separate the domain names with commas (,).
• If you set the data granularity to 1 minute, the maximum time range to query is 24 hours. You can query data in the last 60 days.
• If you set the data granularity to 1 hour, the maximum time range to query is 31 days. You can query data in the last 180 days.
• If you set the data granularity to 1 day, the maximum time range to query is 90 days. You can query data in the last 366 days.

QPS limit

You can call this operation up to 10 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit on an API operation in ApsaraVideo Live.

Request parameters

Response parameters

Examples

Sample requests

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

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveDomainRecordUsageDataResponse>
    <StartTime>2021-05-10T20:00:00Z</StartTime>
    <EndTime>2021-05-10T21:00:00Z</EndTime>
    <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>
    </RecordUsageData>
</DescribeLiveDomainRecordUsageDataResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

For a list of error codes, see Service error codes.

Special error codes