You need to enable JavaScript to run this app.
导航

提交缓存刷新任务

最近更新时间2024.03.08 10:30:38

首次发布时间2022.07.28 21:39:27

调用本接口提交缓存刷新任务到云服务商平台,其中任务类型可以是按文件刷新或按目录刷新。

使用说明

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制

使用限制

节流限制:您每秒最多可以提交 50 个 API 请求。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com/?Action=SubmitRefreshTask&Version=2022-03-01

请求参数

Query

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

Body

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

设置一个或者多个需要刷新的 URL。

  • 多个 URL 以\n分隔。如果按文件刷新,您最多可以输入 1000 个 URL;如果按目录刷新,您最多可以输入 20 个 URL。
  • URL 必须以http://https://开头。如果按目录刷新,URL 必须以/结尾。
  • URL 中的域名必须是某个已同步到多云CDN的加速域名。
http://www.example.com/1.txt
Type
String

设置刷新任务的类型。该参数有以下取值:

  • dir:目录刷新
  • file:文件刷新
file
Vendor
String

为刷新任务设置要提交到的云服务商。您可以设置一个或多个云服务商。多个云服务商之间以半角逗号(,)分隔。该参数有以下取值:

  • aliyun:阿里云
  • tencent:腾讯云
  • ksyun:金山云
  • huawei:华为云
  • volcengine:火山引擎
  • wangsu:网宿科技
  • qiniu:七牛云
  • ucloud:UCloud
  • akamai:Akamai
  • baishan:白山云
  • aws:AWS
  • baidu:百度智能云
  • jingdong:京东云
  • gcp:Google Cloud

说明

如果您未设置该参数,则多云CDN将根据 URL 中的域名自动匹配云服务商,并向所有匹配到的云服务商都提交刷新任务。

volcengine

响应正文

参数名称
数据类型
参数说明
示例
TaskId
String

多云CDN为该刷新任务生成的任务 ID。

说明

您可以使用该任务 ID 调用 DescribeContentTaskByTaskId 接口,查询任务的执行状态。

62de5f86d0df2b0fe96b4638

请求示例

POST https://open.volcengineapi.com/?Action=SubmitRefreshTask&Version=2022-03-01&<其他公共请求参数> 
{
    "Urls": "http://www.example.com/1.txt",
    "Type": "file"
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "202207251716530102120631660FAADEBA",
        "Action": "SubmitRefreshTask",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "TaskId": "62de5f86d0df2b0fe96b4638"
    }
}

错误码

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