修改文件存储类型--视频点播-火山引擎

文档中心

立即注册

导航

修改文件存储类型

最近更新时间：2024.08.23 16:14:03首次发布时间：2024.05.30 19:32:37

此接口用于修改 DirectUrl 模式下的文件存储类型。您可指定 SpaceName 空间名称、FileName 文件路径、StorageClass 文件存储类型修改指定空间下的文件存储类型。

使用说明

该接口仅处理单文件。如果是 HLS 或 DASH 格式的音视频，您调用该接口处理每个分片文件。

注意事项

请求频率：单用户请求频率限制为 20 次/秒。

请求说明

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

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必选	示例值	描述
Action	String	是	`UpdateFileStorageClass`	接口名称。当前 API 的名称为 `UpdateFileStorageClass`。
Version	String	是	`2023-07-01`	接口版本。当前 API 的版本为 `2023-07-01`。
SpaceName	String	是	`test`	点播空间名称。获取方式如下：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。
FileUpdateInfos	Object[]	是	`[{"FileName":"example.mp4","StorageClass":"STANDARD"}]`	文件修改信息。
FileName	String	否	`example.mp4`	文件路径，即文件在点播存储中的存储位置，等同于传统对象存储的对象键（ObjectKey）概念。您可根据业务需求自定义文件路径。最大不超过 1024 个字符。具体的字符规则，请见文件命名通用字符规则。
StorageClass	String	否	`STANDARD`	文件存储类型。取值如下： `STANDARD`：标准存储 `ARCHIVE`：归档存储 `IA`：低频存储
BucketName	String	否	`tos-vod-cn-358957***`	存储桶名称。

返回参数

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

参数	类型	示例值	描述
NotExistFileNames	String[]	`[]`	不存在的文件路径。

请求示例

https://vod.volcengineapi.com?Action=UpdateFileStorageClass&Version=2023-07-01
{
    "SpaceName": "space",
    "FileUpdateInfos": [{"FileName":"example.mov","StorageClass":"ARCHIVE"}    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202405111952384395799***567655",
        "Action": "UpadteFileStorageClass",
        "Version": "2023-07-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "NotExistFileNames": []
    }
    
}

错误码

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