全部产品
Search
文档中心

CDN:DescribeCdnFullDomainsBlockIPConfig - 查询全量封禁配置

更新时间:Aug 27, 2026

调用DescribeCdnFullDomainsBlockIPConfig查询全量封禁的相关配置。

接口说明

说明
  • 该接口需要提交工单申请后使用。

  • 对用户给定的 IP/IP 段,给出该用户当前时间生效的 IP 和对应过期时间;用户不指定 IP 时,返回当前全量生效的 IP 和对应过期时间。

  • 结果写入 OSS,以 OSS 链接返回 ,OSS 文件中内容格式为 ip-对应过期时间,时间格式为 YYYY-MM-DD hh:mm:ss 。

  • OSS 文件分享链接有效期为 3 天。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

IPList

string

查询 IP/IP 段列表,多个 IP 请用半角逗号(,)分隔,最大支持 50 个。

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

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

95994621-8382-464B-8762-C708E73568D1

Message

string

结果信息,返回正常是为 OSS 链接,异常是为错误信息。

http://xxxx-api.oss-cn-hangzhou.aliyuncs.com/blocklist%2Fxxxxxxxxxxxx.txt?Expires=1682663947&OSSAccessKeyId=xxxxxxxxxx&Signature=xxxxxx

Code

integer

结果信息码。

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

  • IP 格式不正确。

  • IP 个数超出限制。

  • 其他。

0

示例

正常返回示例

JSON格式

{
  "RequestId": "95994621-8382-464B-8762-C708E73568D1",
  "Message": "http://xxxx-api.oss-cn-hangzhou.aliyuncs.com/blocklist%2Fxxxxxxxxxxxx.txt?Expires=1682663947&OSSAccessKeyId=xxxxxxxxxx&Signature=xxxxxx",
  "Code": 0
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter The specified parameter is invalid. 参数错误
400 QuotaExceeded The quota is exceeded. quota超过限制。
500 InternalServerError internal server error 服务错误

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

变更历史

更多信息,参考变更详情