All Products
Search
Document Center

ApsaraVideo Live:DescribeMeterLiveBypassDuration

最終更新日:Sep 18, 2023

Queries the mixed-stream transcoding usage data.

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.