最近更新时间:2024.03.08 10:30:38
首次发布时间:2022.07.28 21:39:27
调用本接口提交缓存刷新任务到云服务商平台,其中任务类型可以是按文件刷新或按目录刷新。
每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制。
节流限制:您每秒最多可以提交 50 个 API 请求。
参数名称 | 数据类型 | 是否必选 | 参数说明 |
---|---|---|---|
Action | String | 是 | 接口名称。当前 API 的名称为 SubmitRefreshTask 。 |
Version | String | 是 | 接口版本。当前 API 的版本为 2022-03-01 。 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
Urls | String | 是 | 设置一个或者多个需要刷新的 URL。
| http://www.example.com/1.txt |
Type | String | 是 | 设置刷新任务的类型。该参数有以下取值:
| file |
Vendor | String | 否 | 为刷新任务设置要提交到的云服务商。您可以设置一个或多个云服务商。多个云服务商之间以半角逗号(,)分隔。该参数有以下取值:
说明 如果您未设置该参数,则多云CDN将根据 URL 中的域名自动匹配云服务商,并向所有匹配到的云服务商都提交刷新任务。 |
|
参数名称 | 数据类型 | 参数说明 | 示例 |
---|---|---|---|
TaskId | String | 多云CDN为该刷新任务生成的任务 ID。 说明 您可以使用该任务 ID 调用 DescribeContentTaskByTaskId 接口,查询任务的执行状态。 |
|
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 请求失败。更多关于错误码的信息,参见错误码。