All Products
Search
Document Center

ApsaraVideo VOD:DescribeVodDomainBpsDataByLayer

Last Updated:Jul 19, 2024

Queries the bandwidth data by protocol.

Operation description

You can call this API operation up to 20 times per second per account. If you do not set the StartTime or EndTime parameter, the request returns the data collected in the last 24 hours. If you set both these parameters, the request returns the data collected within the specified time range. Time granularity

The time granularity supported by Interval, the maximum time period within which historical data is available, and the data delay vary based on the time range to query, as described in the following table.

Time granularityTime range per queryHistorical data availableData delay
15 minutes3 days93 days15 minutes
1 hour31 days186 days3 to 4 hours
1 day90 days366 days4 hours in most cases, not more than 24 hours

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DomainNamestringNo

The accelerated domain name. You can specify a maximum of 500 accelerated domain names. Separate multiple domain names with commas (,).

example.com
StartTimestringNo

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.

2019-01-23T12:35:12Z
EndTimestringNo

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.

2019-01-23T12:40:12Z
IntervalstringNo

The time interval between the data entries. Unit: seconds.

The time granularity varies based on the maximum time range per query. Valid values: 300 (5 minutes), 3600 (1 hour), and 86400 (1 day). For more information, see the supported time granularity described in Usage notes.

300
IspNameEnstringNo

The name of the Internet service provider (ISP).

unicom
LocationNameEnstringNo

The name of the region.

beijing
LayerstringNo

The layer at which you want to query the data.

Network layer: IPv4 and IPv6. Application layer: http, https, and quic. all: specifies that both the network and application layers are included. Default value: all.

IPv4

Response parameters

ParameterTypeDescriptionExample
object
DataIntervalinteger

The time interval between the entries returned. Unit: seconds.

300
RequestIdstring

The ID of the request.

25818875-5F78-4A*****F6-D7393642CA58
BpsDataIntervalarray<object>

The bandwidth returned at each time interval. Unit: bit/s.

object
Valuedouble

The peak bandwidth. Unit: bit/s.

75.33
TrafficValuelong

The total traffic. Unit: bytes.

1000
TimeStampstring

The timestamp of the data returned. The time follows the ISO 8601 standard in the yyyy-MM-ddThh:mm:ssZ format. The time is displayed in UTC.

2024-02-08T10:09:19Z

Examples

Sample success responses

JSONformat

{
  "DataInterval": 300,
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "BpsDataInterval": {
    "DataModule": [
      {
        "Value": 75.33,
        "TrafficValue": 1000,
        "TimeStamp": "2024-02-08T10:09:19Z"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.