UpdateMediaStorageClass_视频点播_API文档

插件下载了解更多
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 存储类型

流控信息

请求速率为50/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
vod:UpdateMediaStorageClass
Update
全部资源
*

请求参数

字段名称字段详情
MediaIdsstring

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

示例值:d56c2ac0cee271ed80004710b5ba****参考取值来源:
    RestoreMedia
    RegisterMedia
    BatchGetMediaInfos
    GetAIMediaAuditJob
    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

返回示例

变更历史

变更时间变更内容概要操作
2023-08-18
变更请求参数MediaIds
变更请求参数StorageClass

相关示例

2024年08月20日