文档中心

对象存储

文件管理

上传文件

上传文件

本文介绍通过 TOS 控制台上传文件的操作步骤。

注意事项

前提条件：上传文件前，请确保您已经创建存储桶。

命名规范：文件名的命名规范，请参见文件说明。

上传限制：

控制台支持上传单个不超过 5 GiB 的文件。

如果文件大于 5GiB，请使用 API 分片上传。分片上传支持的单个文件最大为 48.8 TiB，其中每个分片最大为 5 GiB，分片数量最多为 10000 个。具体步骤，请参见UploadPart。

权限要求：主账号默认拥有全部权限，IAM 子用户默认没有任何权限。如果您需要使用子账号执行该操作，则需要主账号通过 IAM 策略或桶策略为该子账号授予 tos:PutObject 权限。

操作步骤

登录对象存储控制台。

在左侧导航栏，单击桶列表。

在顶部导航栏，选择存储桶所属项目。

在桶列表页面，单击目标桶名称。

在文件列表页面，单击上传文件，在上传文件页面，设置文件参数。

参数	说明
上传到	指定对象上传到 TOS 存储桶中的存储路径。当前目录：将文件上传到当前目录下。指定目录：可自定义目录名称，并将文件上传到该目录下。指定目录命名规范如下：支持中文、英文、数字及常见字符。您可以使用正斜线（/）快速创建子文件夹，但文件夹命名不能以正斜线（/）或反斜线（\）开头，且不能使用连续的正斜线（/）。不能以 .. 作为文件夹名称。
待上传	通过选择或者拖拽方式，指定需要上传的本地文件或文件夹。说明同一存储桶中的文件不允许重名，如果您上传的文件与桶中已存在的文件重名，将按照如下策略处理：存储桶未启用版本控制功能：上传文件会覆盖原有的同名文件。存储桶开启了版本控制功能：上传文件会成为最新版本，已有同名文件会成为历史版本。关于版本控制的更多信息，请参见版本控制。
高级设置	存储类型	展开高级设置，设置文件的存储类型，文件存储类型默认继承桶的存储类型。不同存储类型说明如下：继承存储桶：默认值，与桶的存储类型保持一致。标准存储：高可用、高可靠、高性能存储类型，适用于频繁被访问的数据。智能分层：适用于访问模式不固定的数据，需要收取对象监控费用。关于智能分层存储类型的详细信息，请参见智能分层。低频存储：适用于较低频率被访问的数据，最少存储 30 天。归档闪回：适用于基本不会被访问的数据，最少存储 90 天。归档：适用于基本不访问且需要长期保存的数据，最少存储 90 天。访问归档数据前需要先恢复数据。冷归档：适用于数据长期存储、基本不访问且访问可接受有一定响应时间的数据，最少存储 180 天。访问冷归档数据前需要先恢复数据。深度冷归档：适用于需要超长时间存放的极冷数据，最少存储 180 天。访问深度冷归档数据前需要先恢复数据。说明当前仅华北2（北京）、华东2（上海）和华南1（广州）支持冷归档存储。当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。关于存储类型的详细说明，请参见存储类型。当存储桶开启多 AZ 冗余时，文件的存储类型将仅支持继承存储桶、标准存储（多 AZ）、智能分层（多 AZ）、低频存储（多 AZ）、归档闪回（多 AZ）。关于多 AZ 的详细介绍，请参见多 AZ 冗余。
		服务端加密	展开高级设置，设置服务端加密方式。不同加密方式说明如下：继承桶加密配置：默认值，与存储桶的服务端加密方式保持一致。您可以在存储桶的概览页面基本信息区域，查看存储桶的服务端加密方式。您也可以修改存储桶的服务端加密方式，具体操作，请参见设置桶的服务端加密。无：不加密。 SSE-TOS：TOS 托管密钥方式，是指文件上传后 TOS 对文件自动加密落盘存储，下载时自动解密，密钥由 TOS 托管，更多信息，请参见服务端加密。 SSE-KMS：使用火山引擎 KMS 托管的密钥对文件进行加解密，更多信息，请参见服务端加密。说明仅华北2（北京）、华东2（上海）、亚太东南（柔佛）和亚太东南（雅加达）地域支持 SSE-TOS 和 SSE-KMS。仅支持在上传文件时设置服务端加密，上传后的文件不支持修改服务端加密。首次使用 SSE-KMS 进行服务端加密，您需要开通 KMS 服务。开通 KMS 服务免费，使用 KMS 服务会收费。使用 SSE-KMS 进行服务端加密会产生 API 调用费用，创建 KMS 密钥会产生密钥托管费用，API 调用费用和密钥托管费用由 KMS 收取，更多信息，请参见 KMS 计费说明。
		加密算法	展开高级设置，选择密钥的加密算法，可选 AES256 和 SM4 算法。说明仅服务端加密选择 SSE-KMS 或 SSE-TOS 时，展示加密算法参数。仅华北2（北京）、华东2（上海）、亚太东南（柔佛）和亚太东南（雅加达）地域支持 AES-256 算法；仅华北2（北京）、华东2（上海）支持 SM4 算法。
		加密密钥类型	展开高级设置，默认为自定义密钥。说明仅服务端加密选择 SSE-KMS 时，展示加密密钥类型参数。
		自定义密钥	展开高级设置，选择在 KMS 服务创建的密钥。如果您未创建密钥，您可以前往 KMS 服务创建密钥。具体操作，请参见 KMS 快速入门。说明仅服务端加密选择 SSE-KMS 时，需要设置自定义密钥参数。
		元数据	展开高级设置，单击添加字段可设置对象元数据信息。TOS 支持设置的对象元数据详细说明，请参见管理对象元数据。
		访问权限	设置对象的 ACL 策略，说明如下：继承桶：对象将继承桶 ACL ，即对象的 ACL 策略将和桶 ACL 策略保持一致。关于对象 ACL 和桶 ACL 的对应关系，请参见对象继承桶 ACL。说明您还可以开启默认继承桶 ACL 功能，开启后，新上传的对象的 ACL 策略默认将和桶 ACL 策略保持一致。具体操作，请参见开启默认继承桶 ACL 。私有：默认值，只有该对象的归属者及有授权的账号拥有读写权限，推荐使用。公共读：任何用户对该对象都有读权限（包含匿名用户），但只有该对象的归属者及有授权的账号有写权限。公共读写：任何用户对该对象都有读权限和写权限（包含匿名用户）。

说明

设置文件参数后，您可以在上传文件页面查看待上传的文件列表。

您可以单击目标文件操作列的移除，取消所选文件的上传；或单击文件列表上方的清空列表，取消所有文件的上传。

文件上传过程中，请勿刷新或关闭页面，否则上传任务会被中断且列表会被清空。

确定上传文件后，单击上传，即可开始上传文件。

单击上传后，页面自动跳转至任务进度管理面板。您也可以单击控制台右上方的任务中心，查看任务进度及状态。

其他操作

您可以在任务进度管理面板的上传任务页签，查看文件的上传进度及上传状态。您还可以在上传任务页签，执行以下操作：

取消上传：在文件列表，单击目标文件操作列的取消，即可取消上传该文件。

重新上传：取消上传文件或上传失败后，如果您需要重新上传，可以单击目标文件操作列的重试，TOS 会重新上传该文件。

清除上传记录：在文件列表，单击目标文件操作列的清除记录，即可清除文件的上传记录。删除文件记录并不会导致文件的删除。

复制链接：在文件列表，单击目标文件操作列的复制链接，即可复制上传文件的下载链接。

清除成功任务：单击文件列表左上方的清除成功任务，即可清除所有上传成功的文件记录。

最近更新时间：2026.09.23 14:27:06

这个页面对您有帮助吗？

有用

有用

无用

无用