本节主要说明图片处理的应用场景。 图片处理支持用户在云端对图片进行简单的缩略、剪切、压缩等操作，不需下载占用空间巨大的本地图片处理软件即可直接在线对图片进行处理。

分隔符名称 分隔符 含义 处理分隔符 @ 区分object名称和处理字符串，后面加oosImage，表示进行图片处理。 管道分隔符 区分多种操作，相关描述详见管道。

请确定存储桶（Bucket）开通时设置权限为公共读写或公共读权限： 如果存储桶为私有，需要在URL后加入加密串获取，具体参见：分享文件、生成共享链接。 如果Bucket为公共读写或者公共读，文件的域名地址（访问地址）构成规则如下： 例如：创建了一个名称为“examplebucket”的存储桶，且权限设置为公共读，在文件夹“test”中，上传一个名为“1.jpg”文件。其文件的域名地址为：

用户可以配置Bucket的网站托管属性，并通过Bucket域名访问该静态网站。 注意 如果配置静态网站托管后，当匿名用户直接访问Bucket的域名，会将静态网站文件下载到本地。如果要实现访问静态网站时是预览网站内容，而非下载静态网站文件，静态网站域名须是Bucket绑定的已备案自定义域名，为Bucket绑定自定义域名请联系天翼云客服申请。 OOS自有网站托管域名不支持HTTPS访问，用户自定义域名支持HTTPS访问。如果需要支持通过HTTPS访问，请联系天翼云客服，提供域名证书，证书支持格式：crt+key或者PEM，请确保提供的证书在有效期内，建议证书有效期至少1年及以上，避免使用免费证书。 尽量避免目标Bucket名中带有“.”，否则通过HTTPS访问时可能出现客户端校验证书出错。 网站托管配置步骤如下： 1. 创建一个公共读属性的Bucket。 2. 向天翼云客服提交工单，申请客户自定义域名添加白名单。 3. 在域名管理系统（DNS服务器）中添加别名： 如果不使用CDN加速，将Bucket的CNAME Record Value（BucketName.ooswebsitecn.oosxx.ctyunapi.cn）作为别名添加到域名管理系统中。 如果使用CDN加速，将CDN厂商提供的别名添加到域名管理系统中，然后在CDN回源地址中配置OOS侧的CNAME Record Value，并将回源host配置为您的自定义域名（如yourdomain.com）。 4. 上传文件：将网站的所有文件（html、CSS、js、图片等）上传到之前创建的Bucket中，注意保持文件之间的相对路径。 5. 配置Bucket网站属性： 使用控制台配置，详见网站 。 使用API配置，详见PUT Bucket WebSite。

您可以在控制台指南的静态网站托管页面上获取到存储桶的静态网站托管地址。 您也可以拼接存储桶的静态网站访问地址。拼接地址格式为： 例如区域为“青岛”的存储桶名为“examplebucket”的存储桶配置成静态网站托管模式后，该存储桶的静态网站访问地址为 更多静态网站托管相关内容请参见网站或PUT Bucket Website。

生命周期管理可适用于以下典型场景： 周期性上传的日志文件或者视频文件，可能只需要保留一个星期或一个月，到期后要删除它们。 某些文档在一段时间内经常访问，但是超过一定时间后便可能不再访问了。这些文档需要在一定时间后转化为低频访问存储或者删除。 若您需要大量的删除存储桶内文件，您可以设置生命周期的过期删除策略为1天，1天后，存储桶内文件按照规则删除成功。若您以后不再按照该规则删除文件，停止或删除该生命周期规则即可。

本节主要介绍IAM策略编写规则。 详细请参见 控制台指南访问控制IAM策略IAM策略编写规则。

可以通过控制台和调用API使用Bucket： 控制台使用Bucket，详见存储桶管理。包括创建存储桶、存储桶列表、删除存储桶、查看/修改存储桶属性、区域属性、安全策略、网站、日志、生命周期、跨域设置、合规保留、清单配置。 调用API使用Bucket，可以详见关于Bucket的操作。

出于数据传输安全考虑，使用OOS默认域名访问Bucket内的特定类型文件时（例如网页或者图片类文件等），OOS会强制在返回头中增加下载Header ContentDisposition: attachment）。标准浏览器检测到ContentDisposition: attachment时，会出现强制下载而不是预览行为。 以下类型的文件，使用OOS控制台访问时会导致强制下载行为： ContentType取值为application/octetstream、text/html、application/xhtml+xml、application/xhttpdphp、image/jpeg、image/gif、image/tiff、image/png、image/webp、image/svg+xml、image/bmp、image/xmsbmp、image/xcmuraster、image/exr、image/xicon,image/heic。 ContentDisposition设置为attachment，指向下载行为。 浏览器不支持预览格式的文件或者图片，即文件后缀为：html、htm、shtml、xhtml、dhtml、jpg、jpeg、jpe、png、tif、tiff、gif、svg、bmp、ico、ras、dib、svgz、webp、bm、jfif、xpng、exr、heic。

OOS与自建服务器存储有如下区别： 弹性扩展：OOS按使用量计费，用户无需考虑由于业务需求的增长而扩充初期投资成本。 降低成本：使用OOS，您可以根据业务需求确定资源投入，避免投资和运营成本（电费、维护成本等）浪费。 安全可靠：云存储通过以下几种方式来保证数据安全： 通过数据自动切片、分布保存、每片签名等技术，保障数据存储的安全。 通过SSL加密技术和MD5校验技术，保障数据传输的安全。 通过用户鉴权、ACL访问控制等方式，保障数据使用的安全。 通过724的专业运维团队、原厂的金牌服务，保障数据运维的安全。 自建存储需要开发者自己从技术角度去实现安全防护，比如防火墙配置、加密技术等，对开发者要求较高，而且容易出现安全漏洞。而 OOS有专业的技术安全团队进行安全防护，同时运维团队724小时的安全监控也能及时得弥补安全漏洞。

本节简要介绍OOS数据迁移工具。 OOS数据迁移工具是一款将数据迁移至OOS的工具。您可以将迁移工具部署在本地服务器或云主机上，将其它云存储（阿里云、腾讯云、华为云、AmazaonS3）的数据迁移到OOS、本地数据迁移到OOS、或者进行OOS各资源池间数据迁移。 OOS数据迁移工具具有以下特点： 支持断点续传。迁移过程中，如果出现中断，重新启动工具后，可以继续执行迁移工作。已经迁移完成的部分数据，根据isSkipExist参数设置进行上传或跳过。 支持流量控制。迁移过程中，可以动态调整从源端获取数据的速率。 支持迁移指定前缀的文件。 支持文件并行下载和上传。 支持根据迁移工具日志（迁移成功日志、迁移失败日志、迁移忽略日志）进行文件迁移。

OOS单个存储桶（Bucket）没有总数据容量和文件数量的限制，但对于单次上传文件的大小有如下限制： OOS管理控制台支持批量上传文件，单次最多支持500个文件同时上传，单个文件最大为5GiB。 API和SDK普通上传的单个文件最大是5TiB。通过分片上传时，每个分片id最多支持10000个分片，单个分片大小无上限要求，但是在合并分片文件时，除了最后一个分片外，其他分片均不能小于5MiB。 用户所购买的资源包的大小只影响计费，与实际可存储的空间无关。超出资源包额度部分自动转为按需计费。

文件可以是文本、图片、音频、视频或者网页等，对文件类型没有特殊限制。 通过web界面上传的文件大小有限制，单个文件不能超过5GiB。若用户需要上传大于5GiB且小于等于5TiB的文件时，可以通过API或SDK访问OOS服务进行上传。上传大于5TiB的文件时可以使用分片上传功能，但每个分片上传id最多支持上传1万个分片，每个分片文件的大小没有限制，但是当合并分片文件时，除了最后一个分片外，其他分片均不能小于5MiB。

对象存储网络是天翼云推出的最新对象存储服务。对象存储网络中包含分布在全国多个省、市、自治区及直辖市的资源池，这些资源池间的存储桶（Bucket）、文件（Object）、访问密钥（AccessKeyId和SecretAccessKey）信息互通，可以实现全国数据的就近读取和写入。您可以在控制台页面右上角的地域切换下拉菜单中，选择“对象存储网络”。OOS推荐您使用“对象存储网络”来进行文件的管理。除对象存储网络之外的其他地域，存储桶、文件、访问密钥信息是不互通的。

本节主要介绍购买OOS相关问题。 如何开通OOS服务？ 开通OOS服务，请参照开通OOS服务。 说明 只有实名认证并且绑定了邮箱的，才能开通OOS服务。 OOS开通时，默认按照按需计费（使用量按小时计费），根据资源使用量按天计费，不使用不计费；同时也支持包年包月（资源包）的方式提前购买使用额度和时长，获取更多的优惠。 是否支持试用订购OOS服务？ 支持试用订购。如果有试用需求，可以联系您的客户经理为账号发放至少100元按需试用体验券，由客户经理进行试用按需服务的订购。 如何订购OOS资源包？ 可以通过OOS控制台或者OOS帮助中心进行订购OOS资源包，详见资源包订购。 OOS支持哪些类型的资源包？ OOS提供多种类型的资源包，用于抵扣用户在使用过程中产生的各部分费用。但是请注意，一种类型的资源包只能抵扣一种计费项，并且超出了资源包的额度之后，仍会产生按需计费。 资源包按照存储类型，可以分为：存储包、流出流量包和请求次数包。 为什么购买的资源包没有享受包年优惠? 目前只有固定规格的资源包才有包年优惠。如果您购买的是自定义规格的资源包，是无法享受包年优惠的。OOS资源包支持叠加使用，可以购买多个固定规格资源包来抵扣用量。

存储容量如何换算？ 存储容量换算如下：1EiB 1024PiB，1PiB1024TiB，1TiB1024GiB，1GiB1024MiB，1MiB1024KiB，1KiB1024B。 如何查看资源使用情况？ 可以使用以下方式查看资源使用情况： 在控制台“统计概览”页面，可以查看资源使用情况，包括容量、流量、请求次数、带宽、并发连接数等信息。可以按照5分钟、一天等粒度进行查询。详见控制台指南统计概览。 使用API查看资源使用情况，详见API参考统计API。 OOS的费用是如何计算 OOS支持按需付费和按资源包付费两种计费方式，默认按需付费： 按需付费：按照各计费项的实际用量结算费用，先使用，后付费。 按资源包付费：针对不同的计费项，推出使用额度和时长不同的资源包，在费用结算时，优先从资源包抵扣用量，先购买，后抵扣，超出资源包的部分自动转按需计费。 详细的价格信息参见计费说明。 请求次数是如何计算的？ 通过控制台、工具、API、SDK、生命周期转储/删除等任意方式对OOS进行操作，都是对OOS API的调用，每调用一次API都计算一次请求次数。请求次数支持按需计费和资源包计费。除了服务端返回的状态码为5XX或403错误的请求外，其余的请求均会计费。

名称 描述 是否必须 Action DeleteLoginProfile。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 指定需要删除控制台登录密码的IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是

本节主要介绍IAM用户密码。 对于IAM用户，点击“访问控制”>“安全凭证”>“密码”，可以修改登录密码。 注意 只有具有更改密码权限用户的子用户才能进行更改密码。根用户的密码通过天翼云页面修改。

本节主要介绍REST错误响应。 当请求出错时，OOS返回以下格式的错误响应信息。 NoSuchKey The resource you requested does not exist. /mybucket/myfoto.jpg 4442587FB7D0A2F9 响应元素说明如下。 名称 描述 :: Code 错误码是描述出错信息的字符串。 Message 错误信息的简单描述。 RequestId 请求的ID。 Resource 出错相关的Bucket或Object信息。

响应结果 说明 调用IAM API后返回数据采用统一格式，响应结果格式为XML格式。本文档中的响应示例为了便于用户查看，做了格式化处理，实际返回结果是没有进行换行、缩进等处理的。 公共响应头 说明 在后续提到具体IAM API时，举例中都会有公共响应头，但是不对其进行描述和解释。 每个IAM API响应结果中都会包含公共响应头。公共响应头如下： 名称 描述 :: xamzrequestid 服务端生成的用于标识请求的ID。 ContentType 响应内容类型。 Date 响应日期。 Server 服务器名。 ContentLength 响应体的长度，单位为Byte。 Connection 客户端与OOS服务器之间的连接状态。 如果请求时Connection值为keepalive，请求结束后继续保持连接，不返回此响应头。 如果请求时Connection值为close，请求结束后关闭连接，返回此响应头Connection: close。 成功响应结果 调用IAM API成功后，如果响应结果HTTP状态为：200 OK，代表IAM API调用成功。示例如下： HTTP/1.1 200 OK 具体响应结果><> 失败响应结果 调用IAM API失败后，如果响应结果HTTP状态为：4xx或者5xx，代表调用失败。示例如下： HTTP/1.1 4xx或者5xx 具体响应结果><> 字符编码 请求及返回结果都使用UTF8字符集进行编码。

本节主要介绍统计概览中的概览页面。 点击“统计概览”>“概览”，可用查看存储桶当日统计，包括：标准存储、低频访问存储、互联网下行流量、互联网上行流量、Get类请求和Put类请求。 点击该页面的“昨日关键数据”（统计时间范围为北京时间当前时刻的前一天00:0024:00的数据），可用查看各数据位置昨日的标准存储（峰值）、低频访问存储（峰值）、互联网下行流量、请求次数、数据取回。 项目 描述 当日统计 当日的存储容量，包括标准存储和低频访问存储。 当日流量 当日的流量统计，可以选择互联网下行流量（下载量）、互联网上行流量（上传量）。 当日请求次数 当日的请求次数，可以选择： 全部：包括所有的Put类请求和Get类请求。 Put类请求。 Get类请求。 昨日关键数据 统计时间范围为北京时间当前时刻的前一天00:0024:00的数据。 数据位置 存放文件的位置。 标准存储（峰值） 标准存储类型的文件的容量峰值。 低频访问存储（峰值） 低频访问存储类型的文件的容量峰值。 互联网下行流量 从互联网下载文件的数据流量。 请求次数 统计产生的GET请求、HEAD请求、PUT请求、POST请求、DELETE请求、OTHERS的次数，以及所有请求的次数总和。统计产生返回码200、204、206、403、404、4xx的次数，以及所有返回码返回次数的总和。 数据取回 低频访问存储类型的文件在查看和下载时产生的从OOS服务端读取数据的数据量。 点击该页面的“当月关键数据”（统计时间范围为北京时间当前月份的1号00：00至当前时刻的能获取到的最后一个数据），可用查看各数据位置当月的标准存储（峰值）、低频访问存储（峰值）、互联网下行流量、请求次数、数据取回。

本节主要介绍DeleteGroup。 此操作用来删除指定的IAM用户组。 请求参数 名称 描述 是否必须 ::: Action DeleteGroup。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 GroupName IAM用户组名。 类型 ：字符串 取值 ：1~128个字符组成，字符只能包含字母、数字或特殊字符。字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 请求示例 删除名为testgroup的IAM用户组。 POST / HTTP/1.1 Host:ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190130T064232Z Contenttype: application/octetstream ActionDeleteGroup&Version20100508&GroupNametestgroup 响应示例 HTTP/1.1 200 OK xamzrequestid: ff7f5cc92e9e4d48 ContentType: text/xml;charsetUTF8 ContentLength:202 Date:Wed, 30 Jan 2019 06:42:32 GMT Server: CTYUN ff7f5cc92e9e4d48

本节主要介绍RemoveUserFromGroup。 此操作用来将指定用户从指定用户组移除。 说明 如要移除的用户存在，但不在指定的用户组，不会报错，返回200；如果要移除的用户不存在，会报404 NoSuchEntity错误。 请求参数 名称 描述 是否必须 ::: Action RemoveUserFromGroup。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 GroupName IAM用户组名。 类型 ：字符串 取值 ：1~128个字符组成，字符只能包含字母、数字或特殊字符。字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 UserName 要删除的IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是 请求示例 将IAM用户testuser从IAM用户组testgroup中删除。 POST / HTTP/1.1 Host:ooscniam.ctyunapi.cn xamzcontentsha256: UNSIGNEDPAYLOAD Authorization: SignatureValue XAmzDate: 20190130T080102Z Contenttype: application/octetstream ActionRemoveUserFromGroup&Version20100508&GroupNametestgroup&UserNametestuser 响应示例 HTTP/1.1 200 OK xamzrequestid:86b7075854d24711 ContentType:text/xml;charsetUTF8 ContentLength:218 Date:Wed, 30 Jan 2019 08:01:03 GMT Server: CTYUN 86b7075854d24711

主要介绍授权用户/用户组。 查看授权用户/用户组 在“权限策略”页，点击对应策略名或者“操作”列的“管理”，进入对应策略详情页，可以在“用户/组”页，查看当前策略已关联的用户和用户组，同时可以为用户或用户组进行授权和移除授权。 授权用户/用户组 在“权限策略”页面，点击“授权”，弹出“授权用户/组”页面。选择需要授权的用户或用户组，可以为其进行授权。弹框中灰色的用户/组表示已关联该策略的用户或用户组。

本节主要介绍怎么退订OOS资源包。 资源包退订的步骤： 1. 进入资源包退订页面。 2. 资源包退订。 进入资源包退订页面 进入资源包退订页面有两种方式： 方式1：通过官网管理中心 点击“管理中心”>“资源管理”>“资源包”>“OOS资源包”，选择需要退订的资源包，点击“操作”列的“退订”，即可跳转到退订页。 方式2：通过OOS控制台 登录OOS控制台，点击“资源包管理”按钮，即可看到已订购的资源包。选择需要退订的资源包，点击“操作”列的“退订”，即可跳转到退订页。 资源包退订 进入退订页后，核对需要退订的资源包，选择退订原因，并勾选“我已确认本次退订金额和相关费用”，点击“退订”。 点击“退订”后，弹出提示框，可以根据提示框，点击“查看订单”或者“返回列表”。

本节主要介绍欠费问题。 欠费原因 未购买资源包，在按需计费的模式下帐号的余额不足。 已购买资源包，但使用量超出资源包额度，或者产生了与资源包属性不符的其他计费项金额，进而产生按需计费，同时帐号中的余额不足以抵扣产生的按需费用。 欠费说明 欠费后OOS服务会自动停止，您所占用的存储空间资源仍会继续扣费，因此欠费余额会累计。 如果您在15天内充值补足欠款，服务会自动启用。 当欠费超过15天，将视为您主动放弃该服务，您保存在OOS的全部数据将会被销毁，销毁后数据不可恢复。因此请您及时关注账户余额并及时续费以保证您的服务不受到影响。 若您不再继续使用OOS，为防止持续扣费导致帐号欠费，请将您帐号下所有资源（存储桶和文件）删除，同时请不要再使用您的帐号及帐号下的IAM用户访问您的OOS。 查看欠费资源 如果您想查询哪些资源的扣费导致帐户欠费，可以在“费用中心”>“账单管理”>“账单概览“查询在天翼云的消费概况。 续费说明 若是已购买资源包后欠费，请在15天内再次订购相应的资源包或保证帐号中的余额充足。 若是未购买资源包后欠费，请在15天内充值补足欠款并保证帐号中的余额充足。

本节主要介绍怎么在控制台进行文件预览。 在“存储桶列表”页面，点击对应的存储桶，进入“文件列表”，在该页面，可以预览对象。 点击文件“操作”列的“预览”按钮，可以预览该文件。 注意 基于安全合规要求，禁止通过OOS默认域名预览后缀为apk、ipa的文件，在Header中包含签名或者通过自定义域名方式下载此类文件不受影响。 预览的文件为图片或网页时，会以附件的形式下载到本地。

本节主要介绍DELETE Bucket Policy。 在DELETE操作的url中加上Policy，可以删除指定Bucket的Policy。只有根用户和拥有DELETE Bucket Policy权限的子用户才能执行此操作，否则会返回403 AccessDenied错误。如果Bucket配置了Policy，删除成功，返回200 OK。如果Bucket没有配置Policy，返回204 No Content。 请求语法 DELETE /?policy HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: date Authorization: SignatureValue 请求参数 名称 描述 是否必须 BucketName 存储桶名称。 是 请求示例 DELETE /?policy HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn ContentMD5: 1B2M2Y8AsgTpgAmY7PhCfg ContentType: application/octetstream XAmzContentSha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 Date: Sun, 28 Apr 2024 06:37:14 GMT Authorization: SignatureValue Connection: keepalive 响应示例 HTTP/1.1 204 No Content xamzrequestid: b10f8d28916049988bfef100f502040ac9cbd5bfc1c3c5c7c9 Date: Sun, 28 Apr 2024 06:37:14 GMT Server: CTYUN

本节主要介绍V4签名步骤。 客户端按照如下步骤创建签名： 1. 创建规范请求。 2. 使用规范请求和其他信息创建待签名的字符串。 3. 使用SecretAccessKey派生签名密钥。然后将该签名密钥与在上一步中创建的字符串结合使用来创建签名。 4. 将生成的签名添加到HTTP请求头中或者作为参数添加到URL中。 OOS服务收到请求后，将执行相同步骤来计算请求中发送的签名。之后，OOS会将计算得到的签名与用户在请求中发送的签名进行比较。如果签名匹配，则处理请求。如果签名不匹配，则拒绝请求。

本节主要介绍怎么快速创建子用户。 进入“访问控制”>“概览”，点击“创建用户”，进入“创建用户”页面，启动创建用户。可以按照下列步骤创建子用户： 1. 设置用户 ：根据页面提示添加用户名，可以添加一个或多个用户，并为新创建的用户设置访问方式。 2. 设置权限 （可选）：为用户添加权限，有三种添加权限的方式（只能选择一种）： 将用户添加到组 （前提：已经有用户组）：用户将继承该用户组的所有权限。 从现有用户复制 （前提：现有用户有通过直接附加的方式被授权的策略），每次只能复制一个用户的权限。只能复制现有用户直接附加的策略，不能复制用户所在组的策略。 附加现有策略 。 3. 设置标签（可选） ：可以为新建用户添加标签键和标签值。每个用户最多可添加10个标签。 4. 信息审核 ：对新建用户的信息进行审核，如果需要更改，可以在此页面点击对应的编辑标识，然后到对应的页面进行修改。 5. 完成 ：可以在完成页面查看用户名、访问密钥、用户登录密码。也可以通过“下载凭证 ”，查看用户名、访问密钥、密码、子用户登录链接。 注意 凭证信息仅可下载一次，页面跳转后无法再次获取，请妥善保存相关访问密钥ID及私有密钥。

本节主要介绍IAM用户绑定MFA。 对于IAM用户，点击“访问控制”>“安全凭证”>“MFA”，可以绑定MFA。 注意 MFA认证仅IAM用户支持，但是如果没有授权使用MFA认证，则IAM用户无法进行MFA认证。 点击“绑定”，进行MFA绑定，步骤如下： 1. 安装应用 在手机端下载安装基于时间的一次性密码（TOTP）口令认证工具。 2. 绑定MFA 可以使用扫码获取和手动获取两种方式获取验证码。 注意 输入的“第一组验证码”和“第二组验证码”必须是连续的。 3. 完成 注意 如果您后续不再使用 MFA ，并希望卸载已安装的动态口令工具，请先解绑已绑定的MFA设备。如果您在未解绑MFA的情况下卸载动态口令工具，可能会造成相关用户不可用，请慎重操作。

本节主要介绍断点续传。 通过MultipleUpload类以及文件上传请求UploadFileRequest类，实现基于分段上传的断点续传的功能。 参数设置 名称 描述 :: EnableCheckpoint 是否开启断点续传功能。 取值： true：开启。 false：关闭。 默认值为false。 PartSize 每个分段的大小partSize，若partSize小于5MiB，则会将partSize调整至5MiB。 默认：5MiB。 UploadFile 上传的本地文件路径。 checkpointFile 记录本地分片上传结果的文件。如果未指定checkpointFile，默认为uploadFile.ucp，与上传的本地文件同路径。 objectMetadata 文件的元数据。 ProgressListener 上传状态监听器。 TaskNum 分片上传并发线程数，默认为1，最多为1000。 用checkpointFile来记录所有分片的状态。上传过程中的进度信息会保存在该文件中，如果某一分片上传失败，再次上传时会根据文件中记录的点继续上传。上传完成后，该文件会被删除。checkpointfile默认与待上传的本地文件同目录，为uploadFile.ucp。 Java上传代码示例 public static void multiUpload(AmazonS3 ossClient) { try { String bucketName "examplebucket"; String key "objecttest1.pdf" ; String uploadFile "D:tmp2.txt"; // 通过UploadFileRequest设置多个参数 UploadFileRequest request new UploadFileRequest(bucketName, key); // 上传的本地文件 request.setUploadFile(uploadFile); // 分片上传并发线程数，默认为1，最多为1000 request.setTaskNum(2); /每个分片的大小，默认5MiB，若partSize小于5MiB，除了最后一个分片以外，会将partSize调整至5MiB / request.setPartSize(5 1024 1024); // 开启断点续传功能，默认关闭 request.setEnableCheckpoint(true); /记录本地分片上传结果的文件。开启断点续传功能时需要设置此参数，上传过程中的进度信息会保存在该文件中，如果某一分片上传失败，再次上传时会根据文件中记录的点继续上传。/ // 上传完成后，该文件会被删除。默认与待上传的本地文件同目录，为uploadFile.ucp // request.setCheckpointFile(" "); MultipleUpload multiUpload new MultipleUpload(request, ossClient); // 断点续传上传 CompleteMultipartUploadResult result multiUpload.upload(); //System.out.println("location: "+result.getLocation()); System.out.println("Upload complete. Upload object name:" + result.getKey()); } catch (AmazonServiceException ase) { System.out.println("Caught an AmazonServiceException, which means your request made it " + "to OOS, but was rejected with an error response for some reason."); System.out.println("Error Message: " + ase.getMessage()); System.out.println("HTTP Status Code: " + ase.getStatusCode()); System.out.println("OOS Error Code: " + ase.getErrorCode()); System.out.println("Request ID: " + ase.getRequestId()); } catch (AmazonClientException ace) { System.out.println("Caught an AmazonClientException, which means the client encountered " "a serious internal problem while trying to communicate with OOS, " "such as not being able to access the network."); System.out.println("Error Message: " + ace.getMessage()); } }