You need to enable JavaScript to run this app.
导航
根据文件路径修改媒资存储类型
最近更新时间:2024.06.06 20:23:27首次发布时间:2024.05.30 19:32:37

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

注意事项

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

请求说明

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

请求参数

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

参数
类型
是否必选
示例值
描述
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&%5B%7B%22FileName%22%3A%22example.mp4%22%2C%22StorageClass%22%3A%22STANDARD%22%7D%5D=

返回示例

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

错误码

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