tencent cloud

智能媒资托管

创建媒体库

下载
聚焦模式
字号
最后更新时间: 2026-05-26 23:25:14

1. 接口描述

接口请求域名: smh.intl.tencentcloudapi.com 。

创建 PaaS 服务媒体库

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数,本接口取值:CreateLibrary。
Version 是 String 公共参数,本接口取值:2021-07-12。
Region 否 String 公共参数,此参数为可选参数。
Name 是 String

媒体库名称,最多 50 个字符

Remark 否 String

备注,最多 250 个字符

BucketName 否 String

存储桶全名,新建后不可更改。当前版本不再支持指定存储桶。

BucketRegion 否 String

存储桶所在地域,新建后不可更改。当前版本不再支持指定存储桶所在地域。

LibraryExtension 否 LibraryExtension

媒体库配置项,部分参数新建后不可更改

3. 输出参数

参数名称 类型 描述
LibraryId String

媒体库 ID

AccessDomain String
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 创建媒体库

创建媒体库

输入示例

POST / HTTP/1.1
Host: smh.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLibrary
<公共请求参数>

{
    "Name": "测试媒体库",
    "LibraryExtension": {
        "IsFileLibrary": true,
        "IsMultiSpace": true
    }
}

输出示例

{
    "Response": {
        "AccessDomain": "smh3etdq8gpi2201.api.tencentmsh.cn",
        "LibraryId": "smh3etdq8gpi2201",
        "RequestId": "5cc1bd23-8ff1-4f7a-86f9-640c97266c15"
    }
}

5. 开发者资源

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。

错误码 描述
InternalError 内部错误。
InternalError.PostpaidFail 后付费开通失败
InvalidParameterValue 参数取值错误。
InvalidParameterValue.BucketNameInvalid 存储桶名称无效。
InvalidParameterValue.BucketNameNotBelongYou 存储桶名称不属于当前主账号。
InvalidParameterValue.BucketNotFound 存储桶不存在或不在指定地域。
InvalidParameterValue.BucketNotSupport 服务已不支持自选桶
InvalidParameterValue.BucketRegionInvalid 存储桶所在地域无效。
InvalidParameterValue.CosStorageClass 指定的存储类型无效。
InvalidParameterValue.CosStorageClassIntelligentTiering 指定的存储桶未开启智能分层存储,请先开通存储桶的智能分层存储功能。
MissingParameter 缺少参数错误。
UnauthorizedOperation.PassRole 未授予 cam:PassRole 权限。
UnauthorizedOperation.ServiceLinkedRole 未授予 SMH 服务相关角色。
UnsupportedOperation.BalanceLess 账户余额不足

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈