调用SetCdnBlockIP对访问指定域名的IP进行封禁和解禁操作。

说明 该接口仅支持使用POST方式调用。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String SetCdnBlockIP

系统规定参数。取值:SetCdnBlockIP

DomainName String example.com

域名列表,多个域名用英文逗号(,)分隔。

IPList String 1.1.1.1,2.2.2.190,4.4.4.2

待封禁或解禁的IP列表。多个IP用英文逗号(,)分隔,最多支持1000个IP。

OperationType String block

操作动作。取值:

  • block:封禁。
  • unblock:解禁。
BlockInterval Integer 3000

封禁时长,单位:秒。当操作动作为unblock时,无需传入该参数。

返回数据

名称 类型 示例值 描述
IPBlockInfo Array of IPBlockInfoItem

操作结果信息。

Code Integer 1

操作结果。取值:

  • 0:失败。
  • 1:成功。

Code=0的可能情况如下:

  • IP格式不正确。
  • 域名不存在。
  • 域名没有开启边缘防护。
  • 其他原因。
DomainName String example.com

域名。

Message String success

操作结果描述。取值:

  • faild:当Code=0时,Message=faild,表示操作失败。
  • success:当Code=1时,Message=success,表示操作成功。
RequestId String CB1A380B-09F0-41BB-802B-72F8FD6DA2FE

请求ID。

示例

请求示例

http(s)://cdn.aliyuncs.com/?Action=SetCdnBlockIP
&DomainName=example.com
&IPList=1.1.1.1,2.2.2.190,4.4.4.2
&OperationType=block
&<公共请求参数>

正常返回示例

XML格式

<SetCdnBlockIPResponse>
  <IPBlockInfo>
        <Domain>example.com</Domain>
        <Code>1</Code>
        <Message>success</Message>
  </IPBlockInfo>
  <RequestId>CB1A380B-09F0-41BB-802B-72F8FD6DA2FE</RequestId>
</SetCdnBlockIPResponse>

JSON格式

{
  "IPBlockInfo": [
    {
      "Domain": "example.com",
      "Code": 1,
      "Message": "success"
    }
  ],
  "RequestId": "CB1A380B-09F0-41BB-802B-72F8FD6DA2FE"
}

错误码

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