调用 RestoreColdArchiveVideo 接口恢复指定 Vid（视频 ID）对应的冷归档文件。

使用说明 #

冷归档存储为白名单功能，当前仅支持已挂载火山引擎对象存储 TOS Bucket 的存储场景。使用前请提交工单联系火山引擎技术支持团队申请开通。
文件恢复完成后，在 Days 指定的有效期内可直接读取；有效期结束后，文件恢复为不可直接读取的冷归档状态。

注意事项 #

• Vids 和 FileIds 至少填写一项。传入 FileIds 时，Vids 仅支持填写一个 Vid。
• Vids 和 FileIds 单次均最多支持填写 20 个。
• 冷归档文件恢复完成前无法直接播放、下载或执行媒体处理。
• 不同恢复优先级对应的预计完成时间不同，实际恢复时间可能受文件类型和数量影响。

请求说明 #

请求地址：https://vod.volcengineapi.com?Action=RestoreColdArchiveVideo&Version=2023-07-01

请求参数 #

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

返回参数 #

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

请求示例 #

https://vod.volcengineapi.com?Action=RestoreColdArchiveVideo&Version=2023-07-01&SpaceName=test&Vids=v02c24g1000***1v0q66n3sip0&FileIds=v02c24g10***1v0q66n3sip0&RestoreTier=Expedited&Days=1
{
  "SpaceName": "test",
  "Vids": "v02c24g1000***1v0q66n3sip0",
  "FileIds": "v02c24g10***1v0q66n3sip0",
  "RestoreTier": "Expedited",
  "Days": "1"
}

返回示例 #

{
  "Result": {
    "NotExistVids": [
      "v02c24g1000***1v0q66n3sip0"
    ]
  },
  "ResponseMetadata": {
    "Action": "RestoreColdArchiveVideo",
    "Region": "cn-north-1",
    "Service": "vod",
    "Version": "2023-07-01",
    "RequestId": "20230604110420****100232280022D31"
  }
}

错误码 #

本接口无特有的错误码。更多信息请见公共错误码。