提交刷新任务--内容分发网络-火山引擎

文档中心

立即注册

导航

提交刷新任务

最近更新时间：2024.07.03 17:50:36首次发布时间：2021.07.15 11:09:03

在火山引擎内容分发网络（CDN）中提交一个刷新任务。如果在任务中指定文件 URL，CDN 会执行任务时会删除这些文件。如果在任务中指定目录，CDN 默认会标记这些目录中的文件为过期。

使用限制

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

默认情况下，每个火山引擎主账号的刷新额度如下：

每天最多刷新 1,000 个 URL。
每天最多刷新 50 个目录。
每个任务可以包含 100 个 URL 或目录。

您账号下的实际额度可能会与默认额度有差异。要查看实际额度，有以下两个方法：

打开火山引擎控制台的刷新预热页面。
调用 DescribeContentQuota。

如需调整任务的额度，请提交工单。

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
Type	String	否	表示一个刷新类型。该参数有以下取值： `file`：表示 URL 刷新，对一个或者多个文件执行刷新操作。 `dir`：表示目录刷新，对一个或者多个目录下的所有文件，包括子目录下的文件执行刷新操作。 `regex`：表示正则刷新。指定一个或多个正则表达式，对与正则表达式匹配的文件 URL 执行刷新操作。要使用正则刷新，请提交工单。关于正则刷新的介绍和 URL 规范，参见正则刷新。该参数的默认值为 `file`。	`file`
Prefix	Boolean	否	表示是否使用前缀刷新。该参数仅当 `Type` 是 `dir` 时有效，有以下取值： `true`：表示使用前缀刷新，对以指定前缀开头的目录下的所有文件执行刷新操作。 `false`：表示不使用前缀刷新。该参数的默认值是 `false`。	`true`
Urls	String	是	表示一个或者多个对象待刷新的对象，多个对象之间使用 `\n` 分隔。每个对象必须以 `http://` 或 `https://` 开头。当 `Type` 是 `file` 时，这些对象是文件的 URL。当 `Type` 是 `dir` 时，如果 `Prefix` 是 `false`，这些对象是以 `/` 结尾的目录。如果 `Prefix` 是 `true`，这些对象是目录前缀，用以匹配目录。例如 `http://www.example.com/im` 可以匹配 `http://www.example.com/image/` 与 `http://www.example.com/ime/` 这两个目录。当 `Type` 是 `regex` 时，这些对象是正则表达式。参见正则刷新。说明对象中不能包含泛域名。如果您需要为一个泛域名下的多个子域名提交一个刷新任务，您必须对每个子域名指定需要刷新的那些对象。参见如何对泛域名下的文件和目录执行刷新、预热、封禁和解封操作。	`https://www.example.com/1.jpg\nhttps://www.example.com/2.jpg`
Delete	Boolean	否	对于目录刷新，该参数表示是否从缓存中删除 `Urls` 指定的文件。该参数仅当 `Type` 是 `dir` 时有效。要使用该参数，请提交工单。该参数有以下取值： `true`：表示删除这些文件。之后，如果收到了这些文件的请求，CDN 会向源站请求这些文件。 `false`：表示不删除这些文件，仅标记这些文件为已过期。之后，如果收到了这些文件的请求，CDN 会执行回源校验。该参数的默认值是 `false`。	`true`

响应正文

参数名称	数据类型	参数说明	示例
TaskID	String	表示该任务的 ID。您可以调用 DescribeContentTasks 查看 `Urls` 列表中每个对象的刷新结果。	`refresh_url_bbd36e1cb5154f52b648b07ee119223e2971399f5a1075c0`

请求示例

POST https://cdn.volcengineapi.com/?Action=SubmitRefreshTask&Version=2021-03-01
{
  "Type": "file",
  "Urls": "https://www.example.com/1.txt\nhttps://www.example.com/2.txt"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202201141648440102100180260E003ABA",
    "Action": "SubmitRefreshTask",
    "Version": "2021-03-01",
    "Service": "CDN",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskID": "refresh_url_bbd36e1cb5154f52b648b07ee119223e2971399f5a1075c0"
  }
}

错误码

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