UpdateMediaStorageClass
修改媒资存储类型
服务地址:
华东2(上海)
输入参数
只看必填
MediaIds媒体ID
Scope变更范围
StorageClass存储类型
RestoreTier解冻优先级(仅冷归档媒资需要)
AllowUpdateWithoutTimeLimit是否允许存储时长不足的媒资进行存储类型变更
请选择布尔值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 请确保在使用该接口前,已充分了解视频点播产品的收费方式和价格。视频点播中修改媒资存储类型会产生存储费用,计费详情,请参见媒资存储计费

  • 修改媒资存储类型是一个异步操作,整体完成后给用户发送回调。

  • 若媒资当前的存储类型为归档或冷归档,调用本接口会自动触发解冻,解冻完成后修改存储类型,不需要用户手动调用 RestoreMedia 接口解冻媒资。其中冷归档需要传入解冻优先级,默认为 RestoreTier=Standard。

  • 变更中的媒资不能再次发起变更任务,不能进行生产、处理。

  • 非标准存储的媒资有最低存储时长要求,低频/源文件低频至少存储 30 天;归档/源文件归档至少存储 60 天;冷归档、源文件冷归档至少存储 180 天。如果存储时长不够,修改媒资存储类型,会产生不足规定时间的存储费用,例如:低频访问存储 10 天后通过接口修改存储类型为标准存储,会一次性产生 20 天的低频访问存储费用,总共 30 天的低频访问存储费用。

  • 暂不支持修改自有 bucket 存储类型

请求参数

字段名称字段详情
MediaIdsstring

媒体 ID,即音/视频 ID(VideoId)。多个 ID 之间使用半角逗号(,)分隔,最多支持 20 个。可通过以下方式获取:展开详情

示例值:d56c2ac0cee271ed80004710b5ba****参考取值来源:
    RestoreMedia
    RegisterMedia
    GetAIMediaAuditJob
    BatchGetMediaInfos
    SearchMedia
    UpdateAttachedMediaInfos
    SubmitAIMediaAuditJob
    DescribeVodMediaPlayData
    RefreshMediaPlayUrls
Scopestring

变更范围,不传则取默认值 All。取值:展开详情

示例值:All
StorageClassstring

存储类型。取值:展开详情

示例值:Archive参考取值来源:
    DescribeVodTieringStorageData
RestoreTierstring

解冻优先级(仅冷归档媒资需要)。不传则取默认值 Standard,取值:展开详情

示例值:Standard
AllowUpdateWithoutTimeLimitboolean

是否允许存储时长不足的媒资进行存储类型变更。取值:展开详情

示例值:false

请求说明

对于冷归档类型的媒资,您可以指定解冻天数和解冻优先级,解冻天数最短为 1 天,最长为 365 天。不同解冻优先级的取回时间如下:

  • 高优先级(Expedited):表示 1 小时内完成解冻。
  • 标准(Standard):表示 2~5 小时内完成解冻。
  • 批量(Bulk):表示 5~12 小时内完成解冻。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:30FA0B7C-3A81-5449-93CD-ACA149E6****
Statusstring

任务状态。取值:展开详情

示例值:Processing
IgnoredListobject
ForbiddenListobject
变更历史
暂无变更历史