tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

简单上传

PDF
聚焦模式
字号
最后更新时间: 2025-09-23 15:22:11
简单上传指用户使用 PUT Object 接口上传对象。简单上传方式适用于在单个请求中,上传不超过 5GB 的单个对象。
如需上传大于 5GB 的单个对象,可使用以下方式:
使用控制台上传:控制台可支持上传最大512GB 的单个对象,详情请参见 上传对象 控制台指南文档。
使用 API/SDK 的分块上传:可支持上传最大48.82TB(即50000GB)的单个对象,请参见 分块上传
使用 COSCMD 工具支持上传最大 40TB 的单个对象,详情请参见 COSCMD 工具
说明:
在发起上传请求时,如需上传到指定的文件夹或路径,可通过 / 实现,例如将 picture.png 上传到 doc 文件夹,则对象键设置为 doc/picture.png。

适用场景

简单上传方式适用于上传不超过 5GB 对象的场景。
在高宽带或弱网络环境中,若您要上传的对象较大,例如超过100MB(即便小于5GB),我们建议您优先使用 分块上传 的方式。因为分块上传可以并行传输多个分块。在高宽带环境中,可以有效利用资源;在弱网络环境中,单一分块上传失败不会影响其他已上传的分块,通过简单的重试即可重传失败分块,从而提高整体的上传成功率。有关移动端在弱网络环境的上传,可参见 弱网分块续传实践

使用方法

使用控制台

2. 在左侧导航栏中,单击存储桶列表,进入存储桶列表页面。
3. 单击需要存储对象的存储桶,进入存储桶的文件列表页面。
4. 在文件列表中,单击上传文件
5. 在弹出的窗口中,单击选择文件选择文件夹,根据实际需求,选择单个或多个本地文件(或文件夹)。
说明:
部分浏览器不支持多文件上传,建议使用 IE10以上、Firefox、Chrome 等主流浏览器。
6. (可选)单击参数配置。



7. (可选)在上传文件窗口中,设置对象属性。

配置说明如下:
存储类型:根据不同的业务场景,您可以为不同的对象设置不同的存储类型,默认存储类型为标准存储。关于存储类型的介绍,请参见 存储类型
注意:
若您的存储桶开启了多 AZ 配置,则存储类型只能选择为拥有多 AZ 特性的存储类型,例如标准存储(多 AZ);若同时还开启了智能分层存储配置,则还可选择智能分层存储(多 AZ)类型。
访问权限:您可以为不同的对象设置不同的访问权限,默认访问权限为继承权限(即继承存储桶权限)。关于访问权限的更多信息,请参见 访问控制基本概念
服务端加密:您在上传对象的同时,配置对象的服务器加密属性。腾讯云 COS 将为上传的对象添加数据加密的保护策略,帮助您在数据写入前自动加密,并在您访问该数据时自动解密。目前支持 SSE-COS、SSE-KMS,关于服务端加密的介绍和适用地域,请参见 服务端加密概述
对象标签:您可以为待上传的对象添加对象标签,对象标签由标签的键(tagKey)、标签的值(tagValue)与“=”相连组成,每个对象标签为一个键值对,例如一个对象标签表示为group = IT。关于对象标签的更多介绍,请参见 对象标签概述
元数据:对象元数据是服务器以 HTTP 协议传 HTML 资料到浏览器前所送出的字符串,又称为 HTTP Header。通过修改 HTTP Header,可以改变页面的响应形式,或者传达配置信息,例如修改缓存时间。修改对象的 HTTP Header 不会修改对象本身。具体信息请参见 自定义对象 Headers
8. 单击上传
9. 您可以在页面右上方的任务已完成中查看当前的上传进度,上传完成后,您将可以在存储桶文件列表页查看到刚才已上传的对象。

说明:
图中的任务进度表示统计当前操作建立的任务个数,例如您执行了一个上传任务(这个上传任务是上传10个文件),并且均上传成功,则该任务进度会显示“任务已完成(已成功 10 个)”。

使用 REST API

您可以直接使用 REST API 发起简单上传对象请求,详情请参见 PUT Object API 文档。

使用 SDK

您可以直接调用 SDK 的简单上传对象方法,详情请参见下列各语言 SDK 文档:


帮助和支持

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

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

文档反馈