CDN刷新
功能介绍
媒资状态为完成态、删除态、发布态，可通过指定媒资ID或URL向CDN进行刷新。将CDN节点缓存的资源强制过期，用户下次访问时CDN将回源获取最新的资源返回给用户，同时将新的资源缓存到CDN节点。单租户每天最多刷新1000个。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/asset/refresh
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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_list |
否 |
Array of strings |
完成态、删除态、发布态的媒资ID列表，一次性最多刷新10个媒资ID。 |
|
urls |
否 |
Array of strings |
完成态、删除态、发布态的播放URL列表，一次性最多刷新10个URL。 单个URL的长度不能超过10240。 |
响应参数
状态码：202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
task_id |
String |
刷新任务ID。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
-
刷新媒资，按照媒资ID进行刷新
POST https://{endpoint}/v1/{project_id}/asset/refresh { "asset_id_list" : [ "f488337c31c8e4622f1590735b134c65", "f360035c0f5833cf8e8b83e6df845187" ] } -
刷新媒资，按照媒资URL进行刷新
POST https://{endpoint}/v1/{project_id}/asset/refresh { "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 |
处理失败返回。 |
错误码
请参见错误码。
