查询访问日志--全站加速-火山引擎

文档中心

立即注册

导航

查询访问日志

最近更新时间：2024.04.16 16:10:01首次发布时间：2021.12.27 17:16:07

API说明

API名称：DescribeDomainLogs 。
API域名：open.volcengineapi.com。
API描述：查询访问日志。

URI参数

公共参数

Action和Version需要放在请求 URL 后方参数中。

参数名称	是否必选	参数类型	参数说明
Action	是	String	API 名称，该参数的取值是 DescribeDomainLogs 。
Version	是	String	API 版本，该参数的取值是 2021-04-01 。

请求正文

参数名称	是否必选	参数类型	参数说明	示例值
StartTime	是	String	查询起始时间。查询时最多支持查到距今日30天前的日志。	`2021-01-01 00:00:00`
EndTime	是	String	查询结束时间。结束时间晚于起始时间。	`2021-01-01 23:59:59`
Domain	是	String	域名。	`www.a.com`
ProjectName	否	[ ]String	指定查询域名所属的项目，为空代表查询当前用户所有项目。	`["TEST"]`
PageSize	否	Integer	每页条数，默认20，取值范围 1 ~ 1000 。	`20`
PageNum	否	Integer	页码，默认1，从 1 开始计数，可取 >= 1的任意整数。	`1`

响应参数

参数名称	参数类型	参数说明	示例
PageSize	Integer	指定的每页条数。	`100`
PageNum	Integer	指定的页码。	`1`
FilesCount	Integer	日志总数据条数。	`100`
FileLists	FileList	日志详情列表。	`-`

调用示例

请求示例

POST https://open.volcengineapi.com/?Version=2021-04-01&Action=DescribeDomainLogs&<其他公共请求参数>
{
   "Domain":"www.a.com",
   "StartTime":"2019-12-13 00:00:00",
   "EndTime":"2019-12-13 00:00:00"
}

响应示例

{
   "ResponseMetadata": {
       "RequestId": "202107191522410102252431530006E032",
       "Action": "DescribeDomainLogs",
       "Version": "2021-04-01",
       "Service": "dcdn",
       "Region": "cn-south-1"
    },
   "Result": {
      "FilesCount": 3,
      "PageSize":20,
      "PageNum":1,
      "FileLists": [
        {
          "DomainName": "www.a.com",
          "StartTime": "2021-07-16 02:00:00",
          "EndTime": "2021-07-16 03:00:00",
          "FileName": "www.a.com_20210716020000_20210716030000.gz",
          "FilePath": "https://cdnlog.volces.com/dsa-openapi/userlog2/file-download/v1?fileName=www.a.com_20211229110000_20211229120000.gz&token=xxx",
          "FileSize": 23173
       },
       {
	  "DomainName": "www.a.com",
	  "StartTime": "2021-07-16 01:00:00",
	  "EndTime": "2021-07-16 02:00:00",
	  "FileName": "www.a.com_20210716010000\_20210716020000.gz",
	  "FilePath": "https://cdnlog.volces.com/dsa-openapi/userlog/file-download/v1?fileName=www.a.com\_20210716010000\_20210716020000.gz&token=xxx",
	  "FileSize": 23167
       }
      ]
   }
}