DescribeAcceleratorMetrics

1. 接口描述

调用本接口用于查询加速器指标。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
acceleratorId	是	String	加速器 Id
startTime	是	Timestamp	查询开始时间。 按照ISO8601标准表示，并且使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ。
endTime	是	Timestamp	查询结束时间。 按照ISO8601标准表示，并且使用UTC时间。格式为：YYYY-MM-DDThh:mm:ssZ。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 requestId。
dataList	Array of AcceleratorMetricsData	指标数据列表
speedUnit	String	下载速率单位。例如：bps
timeUnit	String	耗时单位。例如：ms

4. 代码示例

示例

1. 查询加速器流量

POST /api/v2/zga HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeAcceleratorMetrics
<Common Request Params>

Request:
{
  "acceleratorId": "acceleratorIdxxxxx",
  "startTime": "2025-05-22T09:30:00Z",
  "endTime": "2025-05-22T09:31:00Z"
}

Response:
{
    "requestId": "TD99A14FD-0C79-4151-996E-339AC95B4276",
    "dataList": [
        {
            "requestCount": 2,
            "averageDownloadSpeed": 7693.521,
            "averageFirstByteTime": 365.5,
            "averageSslHandshakeTime": 0,
            "averageRequestTime": 59999.5,
            "time": "2025-05-22T09:30:00Z"
        },
        {
            "requestCount": 2,
            "averageDownloadSpeed": 7300.7974,
            "averageFirstByteTime": 365.5,
            "averageSslHandshakeTime": 0,
            "averageRequestTime": 60000,
            "time": "2025-05-22T09:31:00Z"
        }
    ],
    "speedUnit": "bps",
    "timeUnit": "ms"
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用 Zenlayer 的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP 状态码	错误码	说明
400	INVALID_START_TIME_MUST_BEFORE_END_TIME	开始时间必须在结束时间之前