API概述

本文档介绍了媒体存储服务的REST API 接口。借助于这些REST API,您可以使用标准的HTTP 请求创建、获取和删除存储桶和对象，并进行桶和对象的管理；可以在任何时间、地点上传或下载数据。

使用限制

限制项	说明
存储空间（Bucket）	Bucket 的命名规范如下: 1. 仅包含小写英文字母、数字、短划线(-)。 2. 必需由字母或者数字开头。 3. 存储空间名称必须唯一，系统默认每个用户最多可以创建1000 个bucket。
对象（Object)	单个Object 允许存储0~5T 的数据。Object 包含key 和data。其中key 是object 的名字， data 是object 的数据。Key 为UTF-8 编码，且编码后的长度不得超过1024 个字节。
上传/下载文件	单个对象超过5GB，默认启动分段上传。
生命周期	一个生命周期配置最多可以有1000 个规则。ID 元素唯一地标识规则，ID 长度最多为255 个字符。

SDK说明

如果想要快速进行二次开发，可以使用对应的SDK，具体SDK的使用说明请参考天翼云官网。

资源术语

术语	中文	说明
Object	对象	Object 是媒体存储的基本单元。Object 包含key 和data。其中key 是object 的名字，data 是object 的数据。
Bucket	存储空间	Bucket 是存放Object 的容器，所有的Object 都必须存放在指定的Bucket 中。
Service	服务	提供给用户的虚拟存储空间，在这个虚拟空间中，每个用户可以拥有一个或多个Bucket。
Region	区域	Region 一般用于标识资源存储的物理位置，如中国区。
Endpoint	访问域名	对外服务的接入地址。
AccessKey/SecretKey	访问密钥	访问密钥通常为成对创建和使用，包含一个AccessKey(AK)和一个SecretKey(SK)，用于鉴别用户身份。
ACL	访问控制列表	ACL 是访问授权列表，用于指定用户可以对存储桶或对象执行的操作。权限作用于存储桶作用于对象。 READ：可以列出存储桶中对象用户可以读取对象。WRITE 可以在存储桶中写入或删除对象。 READ_ACP：用户可以读取存储桶的ACL 用户可以读取对象的ACL。 WRITE_ACP：用户可以修改存储桶的ACL，用户可以修改对象的ACL。 FULL_CONTROL：用户拥有全部控制权用户可以读取和修改对象的ACL。
CORS	跨源资源共享	跨源资源共享(CORS) 定义了在一个域中加载的客户端Web 应用程序与另一个域中的资源交互的方式。