文档

DescribeDcdnDomainLog - 查询离线访问日志下载地址

更新时间:

调用DescribeDcdnDomainLog查询指定域名的原始访问日志的下载地址。

接口说明

说明
  • 当您不指定 StartTimeEndTime 时,默认读取过去 24 小时的日志数据;当指定 StartTimeEndTime 时,按指定的起止时间查询日志。
  • 单用户调用频率:100 次/秒。
  • 调试

    您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

    授权信息

    下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

    • 操作:是指具体的权限点。
    • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
    • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
      • 对于必选的资源类型,用背景高亮的方式表示。
      • 对于不支持资源级授权的操作,用全部资源表示。
    • 条件关键字:是指云产品自身定义的条件关键字。
    • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    dcdn:DescribeDcdnDomainLogRead
    • domain
      acs:dcdn:*:{#accountId}:domain/{#domainName}

    请求参数

    名称类型必填描述示例值
    DomainNamestring

    待查询的加速域名,只支持查询单个域名。

    example.com
    PageSizelong

    分页大小。

    取值:1~1000,默认值:300,最大值:1000

    300
    PageNumberlong

    取得第几页,取值范围:大于 1 的任意整数。

    默认值为 1

    1
    StartTimestring

    获取日志起始时间点。

    日期格式按照 ISO8601 表示法,并使用 UTC+0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

    2021-11-07T17:00:00Z
    EndTimestring

    获取日志结束时间点。

    日期格式按照 ISO8601 表示法,并使用 UTC+0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

    说明 结束时间需大于起始时间。
    2021-11-07T18:00:00Z

    返回参数

    名称类型描述示例值
    object
    DomainNamestring

    域名。

    example.com
    RequestIdstring

    请求 ID。

    95594003-CAC5-5636-AF72-2A094364****
    DomainLogDetailsobject []

    DomainLogDetail 组成的数据。

    LogCountlong

    本页返回的总条数。

    4
    LogInfosobject []

    LogInfoDetail 组成的数据。

    EndTimestring

    结束时间。

    2021-11-07T18:00:00Z
    LogSizelong

    日志大小,单位:字节。

    192
    StartTimestring

    开始时间。

    2021-11-07T17:00:00Z
    LogNamestring

    日志名称。

    example.com_2021_11_08_010000_020000.gz
    LogPathstring

    日志路径。

    需要关注返回参数 LogPath 中的字段 Expires(过期时间戳),过期后日志下载链接失效,需要重新获取。更多信息,请参见 LogPath 字段信息

    example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_010000_020000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=u0V6foRfZniHE8i%2BHUdxGOhZsK****
    PageInfosobject

    PageInfoDetail 组成的数据。

    PageIndexlong

    返回数据的页码。

    1
    PageSizelong

    整页大小。

    10
    Totallong

    总条数。

    4

    示例

    正常返回示例

    JSON格式

    {
      "DomainName": "example.com",
      "RequestId": "95594003-CAC5-5636-AF72-2A094364****",
      "DomainLogDetails": {
        "DomainLogDetail": [
          {
            "LogCount": 4,
            "LogInfos": {
              "LogInfoDetail": [
                {
                  "EndTime": "2021-11-07T18:00:00Z",
                  "LogSize": 192,
                  "StartTime": "2021-11-07T17:00:00Z",
                  "LogName": "example.com_2021_11_08_010000_020000.gz",
                  "LogPath": "example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_010000_020000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=u0V6foRfZniHE8i%2BHUdxGOhZsK****"
                }
              ]
            },
            "PageInfos": {
              "PageIndex": 1,
              "PageSize": 10,
              "Total": 4
            }
          }
        ]
      }
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidEndTime.MismatchThe specified EndTime is earlier than the StartTime.结束时间早于开始时间,请检查。
    400InvalidStartTime.ValueNotSupportedThe StartTime cannot exceed 31 days before the current time.不能查询31天之前的数据。

    访问错误中心查看更多错误码。