文档

DescribeCdnFullDomainsBlockIPHistory - 查询封禁历史

更新时间:

调用DescribeCdnFullDomainsBlockIPHistory获取封禁历史记录。

接口说明

说明
  • 该接口需要提交工单申请后使用。
  • 对用户指定的 IP 和时间段,返回用户在该时间段对该 IP 的下发时间和对应结果。
  • 当指定的 IP/IP 段在指定时间段存在多条下发记录时,会按下发时间降序排列。
  • 查询时间段支持的最大范围为 90 天。
  • 给定 IP 和时间段不存在下发记录或下发失败时,下发时间为空。
  • 调试

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

    授权信息

    当前API暂无授权信息透出。

    请求参数

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

    查询 IP/IP 段。

    1.XXX.XXX.1,2.XXX.XXX.2
    StartTimestring

    查询获取数据起始时间点,时间格式为:YYYY-MM-DDThh:mm:ssZ。

    2023-04-24T17:00:00Z
    EndTimestring

    查询获取数据结束时间点,时间格式为:YYYY-MM-DDThh:mm:ssZ;结束时间需大于起始时间。

    2023-04-24T19:00:00Z

    返回参数

    名称类型描述示例值
    object

    Schema of Response

    RequestIdstring

    请求 ID。

    BCD7D917-76F1-442F-BB75-C810DE34C761
    IPBlockInfoarray<object>

    操作结果。

    object
    BlockIPstring

    下发的 IP/IP 段。

    1.XXX.XXX.0~1.XXX.XXX.255
    DeliverTimestring

    下发时间。

    2023-04-24 18:49:37
    Statusstring

    下发状态。

    • Success:下发成功。
    • Failed:下发失败,或未有下发记录。
    Success
    Codeinteger

    结果信息码。

    Code 不为 0 可能有以下三种情况:

    • IP 格式不正确。
    • 时间格式不正确。
    • 其他。
    0
    Descriptionstring

    接口返回状态描述。

    OK

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "BCD7D917-76F1-442F-BB75-C810DE34C761",
      "IPBlockInfo": [
        {
          "BlockIP": "1.XXX.XXX.0~1.XXX.XXX.255\n",
          "DeliverTime": "2023-04-24 18:49:37\n",
          "Status": "Success"
        }
      ],
      "Code": 0,
      "Description": "OK"
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidParameterThe specified parameter is invalid.参数错误
    400QuotaExceededThe quota is exceeded.quota超过限制。
    500InternalServerErrorinternal server error服务错误

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