此接口用于获取指定空间下已提交的封禁或解禁任务。
请求地址:https://vod.volcengineapi.com?Action=ListBlockObjectTasks&Version=2023-07-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListBlockObjectTasks | 接口名称。当前 API 的名称为 ListBlockObjectTasks 。 |
Version | String | 是 | 2023-07-01 | 接口版本。当前 API 的版本为 2023-07-01 。 |
SpaceName | String | 是 | test | |
FileNamesUrlEncoded | String | 否 | a%2Fb%2Fc | URL 编码后的文件路径。多个文件路径用英文逗号 说明
|
TaskIds | String | 否 | 667e78608f901****0915b73 | 封禁或解禁任务 ID。多个 ID 用英文逗号 , 连接,一次最多传入 20 个。可在 SubmitBlockObjectTasks 接口的返回参数中获取。 |
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ObjectBlockTaskInfos | Object[] | - | 封禁或解封的任务信息。 |
Status | String | complete | 封禁状态,表示源站是否完成媒资封禁。取值如下:
|
TaskId | String | 6683adbab8cac7d04a7****e | 任务 ID。 |
FileName | String | 1eb8debe45e4842f5822d61****40069452.mov2 | 文件路径。 |
Operation | String | forbid | 封禁任务类型。取值如下:
|
RefreshInfos | Object[] | - | 刷新任务信息。 |
Url | String | http://vod-month02.****-test.com/1eb8debe4*****d4640069452.mov2 | 刷新的 URL。 |
Status | String | running | 任务状态,取值如下:
|
Process | String | 70% | 任务进度,单位为 %。 |
RefreshStatus | String | running | 刷新缓存状态。取值如下:
|
RefreshTaskId | String | 刷新任务 ID。 |
https://vod.volcengineapi.com?Action=ListBlockObjectTasks&Version=2023-07-01&SpaceName=vod_test&TaskIds=667e78608*****740915b73
{ "ResponseMetadata": { "RequestId": "20240702153800283803E0ADD9F2924147", "Action": "ListBlockObjectTasks", "Version": "2023-07-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "ObjectBlockTaskInfos": [ { "Status": "complete", "TaskId": "6683adbab8ca***04a704cce", "FileName": "1eb8debe45e48****822d61d4640069452.mov2", "RefreshStatus": "complete", "Operation": "forbid", "RefreshTaskId": "refresh_url_7f4effbcaa3f4e8397947434b17787233cd2fffbf649677c", "RefreshInfos": [ { "Url": "http://vod-month02.****-test.com/1eb8debe45e4842*****d4640069452.mov2", "Status": "complete", "Process": "100%" } ] } ] } }
本接口无特有的错误码。更多信息请见公共错误码。