DescribeStatusCode

1. 接口描述

本接口(DescribeStatusCode)用于查询cdn状态码。

准备工作

查询大洲，国家地区：调用DescribeAnalysisRegions。

2. 请求参数

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

参数名称	必选	类型	描述
startTime	是	String	获取数据起始时间点。日期格式按照 ISO8601 表示法，并使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ，例如2024-08-22T00:00:00Z
endTime	是	String	获取数据结束时间点。日期格式按照 ISO8601 表示法，并使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ，例如2024-08-22T00:10:00Z。结束时间点需要大于起始时间
domain	否	String	加速域名，多个域名英文逗号间隔。默认查询所有加速域
continent	否	String	大洲
country	否	String	国家地区
group	否	String	状态码分组类型

参数名称

必选

类型

描述

startTime

是

String

获取数据起始时间点。日期格式按照 ISO8601 表示法，并使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ，例如2024-08-22T00:00:00Z

endTime

是

String

获取数据结束时间点。日期格式按照 ISO8601 表示法，并使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ，例如2024-08-22T00:10:00Z。结束时间点需要大于起始时间

domain

否

String

加速域名，多个域名英文逗号间隔。默认查询所有加速域

continent

否

String

大洲

country

否

String

国家地区

group

否

String

状态码分组类型

3. 响应结果

参数名称	类型	描述
dataSet	Array of StatusCodeData	状态码集合。
requestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 requestId。

参数名称

类型

描述

dataSet

Array of StatusCodeData

状态码集合。

requestId

String

唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 requestId。

4. 代码示例

查询cdn状态码。

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

Request:
{
    "startTime": "2024-08-22T00:00:00Z",
    "endTime": "2024-08-22T00:02:00Z"
}

Response:
{
  "requestId": "T6883FCD0-3E7D-44EA-A517-A421A52A27F4",
  "response": {
    "requestId": "T6883FCD0-3E7D-44EA-A517-A421A52A27F4",
    "dataSet": [{
      "data": [{
        "detail": [{
          "code": "200",
          "count": 286
          }, {
          "code": "404",
          "count": 1
        }],
        "time": "2024-08-22T00:00:00Z"
      }],
      "domain": "*"
    }]
  }
}

5. 错误码

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

最后更新于5天前