You need to enable JavaScript to run this app.
导航
预热缓存
最近更新时间:2024.01.08 17:26:44首次发布时间:2022.03.31 19:00:07

此接口用于预热缓存。

请求说明

请求地址:https://vod.volcengineapi.com?Action=CreateCdnPreloadTask&Version=2021-01-01

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数

参数类型是否必选示例值描述
ActionStringCreateCdnPreloadTask接口名称。当前 API 的名称为 CreateCdnPreloadTask
VersionString2021-01-01接口版本。当前 API 的版本为 2021-01-01

SpaceName

String

test

点播空间名称。您可通过以下方式获取:

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。

Urls

String

https://example.com

预热 URL。每个 URL 必须以 http:// 或者 https:// 开头。。多个 URL 之间需要用换行符(\n)分隔。最多输入 100 条。

注意

一个账号每日最多可预热 1000 个 URL。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数

参数类型示例值描述
TaskIdString6242b7c******451a4003任务 ID

请求示例

https://vod.volcengineapi.com?Action=CreateCdnPreloadTask&Version=2021-01-01&SpaceName=test&Urls=https://example.com

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202203291******1030F1A096A",
    "Action": "CreateCdnPreloadTask",
    "Version": "2021-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskId": "6242b7c******451a4003"
  }
}

错误码

下表列举了本接口特有的错误码。视频点播公共错误码,详见公共错误码

状态码错误码错误信息说明
400InvalidParameter.InvalidAccountId-无效的账号 ID,请调整后重试。
400InvalidParameter.NoActionQuota-预热配额已耗尽。

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK,支持多种编程语言,帮助您实现快速开发。建议使用服务端 SDK 来调用 API,此 API 各语言调用的示例代码,请参考如下: