CDN预热
功能介绍
媒资发布后,可通过指定媒资ID或URL向CDN预热。用户初次请求时,将由CDN节点提供请求媒资,加快用户下载缓存时间,提高用户体验。单租户每天最多预热1000个。
URI
POST /v1.0/{project_id}/asset/preheating
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
asset_id |
否 |
String |
已发布媒资的ID。 |
urls |
否 |
Array of strings |
已发布媒资的播放URL列表,一次最多只能预热10个URL。 |
响应参数
状态码: 202
参数 |
参数类型 |
描述 |
---|---|---|
task_id |
String |
预热任务ID。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
-
预热媒资,按照媒资ID进行预热
POST https://{endpoint}/v1.0/{project_id}/asset/preheating Content-Type: application/json { "asset_id": "f488337c31c8e4622f1590735b134c65" }
-
预热媒资,按照媒资URL进行预热
POST https://{endpoint}/v1.0/{project_id}/asset/preheating Content-Type: application/json{ "urls": [ " https://example.com/asset/9db42f5e08c15edecd99a98da241994a/313bfd52a75f95ff48e8bf02eca2ab20.flv", " https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/68b1241af3bf58bcde9914626e07f5af.mp4", " https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/play_video/68b1241af3bf58bcde9914626e07f5af_H.264_480X270_HEAACV1_300.mp4" ]}
响应示例
状态码: 202
处理成功返回。
{ "task_id" : "5199337c31c8e4622f1590735b13a263" }
状态码: 400
处理失败返回。
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
202 |
处理成功返回。 |
400 |
处理失败返回。 |
错误码
请参见错误码。