文档

DescribeSiteMonitorLog - 查询一次性探测任务的探测日志

更新时间:

调用DescribeSiteMonitorLog接口查询一次性探测任务的探测日志。

接口说明

仅开通网络分析与监控的阿里云账号,才能创建一次性探测任务。

本文将提供一个示例,查询一次性探测任务afa5c3ce-f944-4363-9edb-ce919a29****的探测日志。

调试

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

授权信息

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

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

请求参数

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

探测任务 ID。多个探测任务 ID 之间用半角逗号(,)分隔。

afa5c3ce-f944-4363-9edb-ce919a29****
Ispstring

运营商标识码。

465
Citystring

城市标识码。

546
MetricNamestring

监控项。

目前仅支持监控项ProbeLog

ProbeLog
StartTimestring

开始时间。支持的格式:

  • UNIX 时间戳:从 1970 年 01 月 01 日开始所经过的毫秒数。
  • UTC 格式:YYYY-MM-DDThh:mm:ssZ。
说明
  • 开始时间和结束时间遵循左开右闭模式,StartTime 不能等于或大于 EndTime。
    - 建议您使用 UNIX 时间戳,避免时区问题。
  • 1638422474389
    EndTimestring

    结束时间。支持的格式:

    • UNIX 时间戳:从 1970 年 01 月 01 日开始所经过的毫秒数。
    • UTC 格式:YYYY-MM-DDThh:mm:ssZ。
    说明 建议您使用 UNIX 时间戳,避免时区问题。
    1638422475687
    NextTokenstring

    当请求的返回结果被截断时,您可以使用NextToken再次发起请求,获取从当前截断位置之后的内容。

    IWBjqMYSy0is7zSMGu16****
    Lengthinteger

    每页显示的记录条数,用于分页查询。取值范围:1~1440。

    1000
    Filterstring

    过滤探测值。

    支持简单的表达式,例如:TotalTime>100,表示过滤出总响应时间超过 100 毫秒的探测数据。

    TotalTime>100
    BrowserInfostring

    该参数已废弃,无需关注。

    Browserstring

    浏览器类型。

    枚举值:
    • Chrome Chrome
    • SafariSafari
    • EdgeEdge
    • FirefoxFirefox
    Chrome
    Devicestring

    设备类型(模拟屏幕大小类型)。

    枚举值:
    • tablettablet
    • mobilemobile
    • laptoplaptop
    laptop

    返回参数

    名称类型描述示例值
    object

    无。

    NextTokenstring

    查询下一页使用的 Token。

    IWBjqMYSy0is7zSMGu16****
    Datastring

    一次性探测任务的探测日志。

    [{\"redirectCount\":0.0,\"SSLConnectTime\":0.0,\"pingDetail\":\"\",\"HTTPConnectTime\":0.0,\"isp\":\"465\",\"errorCode\":611,\"ispCN\":\"阿里巴巴\",\"resolution\":\"\",\"areaEN\":\"HuaBei\",\"taskEndTimestamp\":1638422475687,\"targetIspEN\":\"\",\"TotalTime\":1.0,\"taskStartTimestamp\":1638422474389,\"countryCN\":\"中国\",\"provinceEN\":\"Beijing\",\"countryEN\":\"China\",\"targetCityEN\":\"\",\"curlConnectTime\":0.0,\"ips\":\"\",\"route\":\"\",\"tcpConnectTime\":0.0,\"cityEN\":\"Beijing\",\"HTTPDownloadSpeed\":0.0,\"HTTPDownloadTime\":0.0,\"HTTPResponseCode\":0.0,\"areaCN\":\"华北\",\"city\":\"546\",\"expection\":\"\",\"suorceIp\":\"192.168.XX.XX \",\"ispEN\":\"Alibaba\",\"HTTPDNSTime\":1.0,\"targetIsp\":\"\",\"curlStarttransferTime\":0.0,\"provinceCN\":\"北京市\",\"timestamp\":1638422474000,\"redirectTime\":0.0,\"targetCity\":\"\", \"expect\":\"\",\"HTTPDownloadSize\":0.0,\"localDns\":\"192.168.XX.XX\",\"cityCN\":\"北京市\",\"taskId\":\"afa5c3ce-f944-4363-9edb-ce919a29****\"}]
    RequestIdstring

    请求 ID。

    67F646FA-ED8A-58C2-B461-451DB52C8B14
    Successstring

    操作是否成功。取值:

    • true:成功。

    • false:失败。

    true
    Codestring

    状态码。

    说明 200 表示成功。
    200
    Messagestring

    返回信息。

    successful

    示例

    正常返回示例

    JSON格式

    {
      "NextToken": "IWBjqMYSy0is7zSMGu16****",
      "Data": "[{\\\"redirectCount\\\":0.0,\\\"SSLConnectTime\\\":0.0,\\\"pingDetail\\\":\\\"\\\",\\\"HTTPConnectTime\\\":0.0,\\\"isp\\\":\\\"465\\\",\\\"errorCode\\\":611,\\\"ispCN\\\":\\\"阿里巴巴\\\",\\\"resolution\\\":\\\"\\\",\\\"areaEN\\\":\\\"HuaBei\\\",\\\"taskEndTimestamp\\\":1638422475687,\\\"targetIspEN\\\":\\\"\\\",\\\"TotalTime\\\":1.0,\\\"taskStartTimestamp\\\":1638422474389,\\\"countryCN\\\":\\\"中国\\\",\\\"provinceEN\\\":\\\"Beijing\\\",\\\"countryEN\\\":\\\"China\\\",\\\"targetCityEN\\\":\\\"\\\",\\\"curlConnectTime\\\":0.0,\\\"ips\\\":\\\"\\\",\\\"route\\\":\\\"\\\",\\\"tcpConnectTime\\\":0.0,\\\"cityEN\\\":\\\"Beijing\\\",\\\"HTTPDownloadSpeed\\\":0.0,\\\"HTTPDownloadTime\\\":0.0,\\\"HTTPResponseCode\\\":0.0,\\\"areaCN\\\":\\\"华北\\\",\\\"city\\\":\\\"546\\\",\\\"expection\\\":\\\"\\\",\\\"suorceIp\\\":\\\"192.168.XX.XX \\\",\\\"ispEN\\\":\\\"Alibaba\\\",\\\"HTTPDNSTime\\\":1.0,\\\"targetIsp\\\":\\\"\\\",\\\"curlStarttransferTime\\\":0.0,\\\"provinceCN\\\":\\\"北京市\\\",\\\"timestamp\\\":1638422474000,\\\"redirectTime\\\":0.0,\\\"targetCity\\\":\\\"\\\", \\\"expect\\\":\\\"\\\",\\\"HTTPDownloadSize\\\":0.0,\\\"localDns\\\":\\\"192.168.XX.XX\\\",\\\"cityCN\\\":\\\"北京市\\\",\\\"taskId\\\":\\\"afa5c3ce-f944-4363-9edb-ce919a29****\\\"}]",
      "RequestId": "67F646FA-ED8A-58C2-B461-451DB52C8B14",
      "Success": "true",
      "Code": "200",
      "Message": "successful"
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidQueryParameter%s-
    401AccessDeniedExceptionYou donot have sufficient access to perform this action.-
    402LimitExceededThe quota for this customer had been reached.-
    403ForbiddenYou are not authorized to operate the specified resource.没有权限,请使用RAM进行授权
    406ExceedingQuotaExceeding quota limits.-
    409%s%s-
    429ThrottlingExceptionThe request was denied due to request throttling.-
    500InternalErrorThe request processing has failed due to some unknown error.-
    500InternalError%s-

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

    变更历史

    变更时间变更内容概要操作
    2023-08-22OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:401
      删除错误码:402
      删除错误码:403
      删除错误码:406
      删除错误码:409
      删除错误码:429
      删除错误码:500
      删除错误码:503
    入参OpenAPI 入参发生变更
      新增入参:BrowserInfo
      新增入参:Browser
      新增入参:Device
    2023-04-03OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:401
      删除错误码:402
      删除错误码:403
      删除错误码:406
      删除错误码:409
      删除错误码:429
      删除错误码:500
      删除错误码:503