DescribeMeterLiveBypassDuration - ApsaraVideo Live

Usage notes

The maximum time range for a query is 31 days.
The minimum time granularity for a query is 5 minutes.
You can query the data in the last 90 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 limits.

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	DescribeMeterLiveBypassDuration	The operation that you want to perform. Set the value to DescribeMeterLiveBypassDuration.
StartTime	String	Yes	2022-10-10T20:00:00Z	The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
EndTime	String	Yes	2022-10-10T21:00:00Z	The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. The end time must be later than the start time. The time range that can be specified is greater than or equal to 5 minutes and less than or equal to 31 days.
AppId	String	Yes	4346289a-a790-4869-9e23-22766d5e****	The ID of the application.
Interval	String	No	86400	The time granularity of the query. Unit: seconds. Valid values: 300 3600 86400 If you specify an invalid value or do not specify this parameter, the default value 3600 is used.

Response parameters

Parameter	Type	Example	Description
RequestId	String	4B460F8B-993C-4F48-B98A-910811DEBFEB	The request ID.
TotalSummaryDuration	Long	150	The total duration. Unit: minutes.
AudioSummaryDuration	Long	20	The total audio-only duration. Audio-only is a basic specification. Unit: minutes.
V480SummaryDuration	Long	30	The total standard definition (SD) duration. The video resolution is 640 × 480 or lower. Unit: minutes.
V720SummaryDuration	Long	40	The total high definition (HD) duration. The video resolution is 1280 × 720 or lower. Unit: minutes.
V1080SummaryDuration	Long	10	The total Full HD duration. The video resolution is 1920 × 1080 or lower. Unit: minutes.
SingleAudioSummaryDuration	Long	20	The total single-stream relay duration for audio. Unit: minutes.
SingleVideoSummaryDuration	Long	30	The total single-stream relay duration for video. Unit: minutes.
Data	Array of Data		The usage statistics for each time granularity.
TotalDuration	Long	150	The duration. Unit: minutes.
Single_Audio	Long	20	The single-stream relay duration for audio. Unit: minutes.
Single_Video	Long	30	The single-stream relay duration for video. Unit: minutes.
V480Duration	Long	30	The SD duration. The video resolution is 640 × 480 or lower. Unit: minutes.
V720Duration	Long	40	The HD duration. The video resolution is 1280 × 720 or lower. Unit: minutes.
V1080Duration	Long	10	The Full HD duration. The video resolution is 1920 × 1080 or lower. Unit: minutes.
AudioDuration	Long	20	The audio-only duration. Audio-only is a basic specification. Unit: minutes.
Timestamp	String	2022-10-10T20:00:00Z	The timestamp of the data returned.

Examples

Sample requests

http://live.aliyuncs.com?Action=DescribeMeterLiveBypassDuration&DomainName=example.com
&StartTime=2022-10-10T20:00:00Z
&EndTime=2022-10-10T21:00:00Z
&AppId=4346289a-a790-4869-9e23-22766d5e****
&Interval=86400
&<Common request parameters>

Sample success responses

XML format

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

<DescribeMeterLiveBypassDurationResponse>
    <RequestId>93FAB4C8-42AD-5BB9-BE9B-0AA8C6C0CC2F</RequestId>
    <V480SummaryDuration>30</V480SummaryDuration>
    <V1080SummaryDuration>10</V1080SummaryDuration>
    <V720SummaryDuration>40</V720SummaryDuration>
    <TotalSummaryDuration>150</TotalSummaryDuration>
    <AudioSummaryDuration>20</AudioSummaryDuration>
    <Data>
        <Single_Audio>20</Single_Audio>
        <V720Duration>40</V720Duration>
        <V1080Duration>10</V1080Duration>
        <V480Duration>30</V480Duration>
        <Timestamp>2022-10-10T20:00:00Z</Timestamp>
        <TotalDuration>150</TotalDuration>
        <Single_Video>30</Single_Video>
        <AudioDuration>20</AudioDuration>
    </Data>
    <SingleAudioSummaryDuration>20</SingleAudioSummaryDuration>
    <SingleVideoSummaryDuration>30</SingleVideoSummaryDuration>
</DescribeMeterLiveBypassDurationResponse>

JSON format

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

{
  "RequestId" : "93FAB4C8-42AD-5BB9-BE9B-0AA8C6C0CC2F",
  "V480SummaryDuration" : 30,
  "V1080SummaryDuration" : 10,
  "V720SummaryDuration" : 40,
  "TotalSummaryDuration" : 150,
  "AudioSummaryDuration" : 20,
  "Data" : [ {
    "Single_Audio" : 20,
    "V720Duration" : 40,
    "V1080Duration" : 10,
    "V480Duration" : 30,
    "Timestamp" : "2022-10-10T20:00:00Z",
    "TotalDuration" : 150,
    "Single_Video" : 30,
    "AudioDuration" : 20
  } ],
  "SingleAudioSummaryDuration" : 20,
  "SingleVideoSummaryDuration" : 30
}

Error codes

HttpCode	Error code	Error message	Description
400	Meter.ParamError	Param Error:%s,Please Check Again.	One or more parameters are invalid.
403	Meter.AuthError	Authentication Failed,Please Try Again.	Authentication failed.
500	Meter.ServerInternalError	The Request Processing Has Failed Due To Some Unknown Error.	An internal error occurred.
500	Meter.DataSourceQueryError	Data Source Error:%s,Please Try Again.	An error occurred during the query.
502	Meter.ReadyTsError	Get ReadyTs Failed,Please Try Again.	The data to query is not ready.

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