You need to enable JavaScript to run this app.
导航
提交 URL 封禁任务
最近更新时间:2024.06.28 19:18:53首次发布时间:2021.11.26 20:06:53

通过 API 请求提交封禁 URL 任务。封禁 URL 任务提交后,终端用户对任务提交的封禁 URL 的访问将被 CDN 拒绝,并向终端用户返回 403 状态码。
封禁任务提交后,如果收到了被封禁 URL 的请求,内容分发网络会拒绝这些请求并返回 403 状态码。对于指定需要被封禁的 URL,内容分发网络提供了两种方法:

  • 指定具体的 URL。
  • 指定正则表达式匹配多个 URL。

说明

  • 要使用该 API,请 提交工单
  • 如果您需要在 API 请求中使用正则表达式,您需要额外提交工单。

使用限制

节流限制:您每秒最多可以发送 20 个请求。

默认情况下,每个火山引擎账号下的任务额度如下:

  • 基于 URL 的封禁任务:
    • 每日最多封禁 3,000 个 URL。
    • 每个任务最多封禁 100 个 URL。
  • 基于正则表达式的封禁任务:
    • 您最多可以对一个加速域名下指定 20 个正则表达式。

如果您需要指定更多的 URL 或者正则表达式,请提交工单。

请求说明

  • 请求方式:POST
  • 请求地址:https://cdn.volcengineapi.com/?Action=SubmitBlockTask&Version=2021-03-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
接口名称。当前 API 的名称为 SubmitBlockTask
Version
String
接口版本。当前 API 的版本为 2021-03-01

Body

参数名称
数据类型
是否必选
参数说明
示例
Urls
String

表示需要封禁的 URL。

  • 如果 Type 是 url,您需要指定一个或者多个文件 URL。每个 URL 都必须以 http:// 或 https:// 开头。多个 URL 之间使用 \n 分隔。
  • 如果 Type 是 regex,您需要指定一个或者多个正则表达式用于匹配需要被封禁的文件 URL。多个正则表达式之间使用换行分隔。正则表达式在匹配时是区分大小写的。您指定的正则表达式必须符合以下要求:
    • 每个正则表达式不能超过 256 个字符。
    • 正则表达式匹配的是文件路径部分,不包含路径开头的 /。路径包含查询参数。也就是说,正则表达式能匹配的 URL 的格式是 http://<host>/<regex> 或者 https://<host>/<regex><host> 表示加速域名,<regex> 表示正则表达式。
    • 正则表达式中只能包含以下元字符:
      • [0-9]
      • [a-z]
      • [A-Z]
      • [a-zA-Z]
      • [^/]*
      • .*
      • [,?]
      • ?

说明

URL 中不能包含泛域名。您不能直接通过指定一个包含泛域名的 URL 来对多个子域名下的文件执行封禁操作。您必须为每个域名指定封禁 URL。参见 如何对泛域名下的文件和目录执行刷新、预热、封禁和解封操作

文件 URL 示例:https://www.a.com/1.jpg\nhttps://www.b.com/2.jpg 正则表达式示例: https://www.example.com/a[0-5]c/[0-9][a-z].*\.js\?a=[a-z]
Type
String

表示封禁类型。该参数的取值如下:

  • url:表示对指定的文件 URL 进行封禁。
  • regex:表示对匹配指定的正则表达式的文件 URL 进行封禁。
该参数的默认值是 url
url

响应正文

参数名称
数据类型
参数说明
示例
TaskID
String
表示提交的任务 ID。您可以调用 DescribeContentBlockTasks 查看 Urls 列表中每个 URL 的执行状态。
url_block_2021112615074501001104903931775

请求示例

POST https://cdn.volcengineapi.com/?Action=SubmitBlockTask&Version=2021-03-01
{
  "Urls": "https://www.a.com/1.txt\nhttps://www.b.com/2.txt"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202111261507450102120420191700979F",
    "Action": "SubmitBlockTask",
    "Version": "2021-03-01",
    "Service": "CDN",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskID": "url_block_2021112615074501001104903931775"
  }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段,则表示 API 请求失败。更多关于错误码的信息,参见错误码