本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
本文介绍在使用ossutil时可能出现的问题及处理方法。
从ossutil 1.6.16版本开始,命令行中Binary名称支持直接使用ossutil,您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16,则需要根据系统刷新Binary名称。更多信息,请参见命令行工具ossutil命令参考。
ossutil支持v4签名么?
1.7.12及以上版本支持v4签名。关于v4签名的更多信息,请参见签名版本4(推荐)。
ossutil在原有命令的基础上,添加--sign-version、--region参数。例如:您可以使用以下命令,创建杭州地域的Bucket。
./ossutil64 --sign-version v4 --region cn-hangzhou mb oss://examplebucket
低频存储或标准存储的文件是否支持同步文件操作?
低频存储或标准存储的文件支持同步文件操作。关于同步文件的更多信息,请参见简介。
如何设置不覆盖同名文件
在ossutil执行命令中增加-u参数,则不会覆盖同名文件。
使用-u参数上传文件时出现skip提示
问题分析:使用-u参数上传文件的时候,ossutil会将上传文件和存储空间(Bucket)内已有文件进行一次比对。
若发现上传的文件与目标Bucket内已有文件同名,且该文件的最后修改时间早于或等于Bucket内已有文件,上传时会跳过该文件;若该文件的最后修改时间晚于Bucket内已有文件,则重新上传该文件。所以使用-u参数上传文件时出现skip提示是正常现象。
解决方案:确认Bucket内文件上传无问题后忽略该提示。
文件解冻时出现403报错
问题分析:操作解冻文件的过程中出现403,有以下两种可能性。
若您是使用RAM用户操作文件,可能是RAM用户权限不足,无目标文件的操作权限。
您文件内容违禁OSS被封禁了。
解决方案:
RAM用户权限不足:增加RAM用户权限。
文件内容违禁:删除或忽略该文件。
使用ls命令查看Bucket无文件,删除Bucket时报错
问题分析:使用ls命令列举Bucket内的文件且未携带任何选项时,无法列举碎片、历史版本文件(仅存在于开启过版本控制的Bucket)。若Bucket为非空(即Bucket中存在碎片、历史版本文件),仅使用rm命令无法删除该Bucket。
解决方案:
Bucket及文件被删除后,无法恢复,请谨慎使用该命令。
先删除碎片和历史版本文件(未开启过版本控制请忽略),再删除Bucket。
删除碎片和历史版本文件。
列举并删除碎片:
./ossutil64 ls oss://bucket1 -m ./ossutil64 rm -m oss://bucket1 -r
列举并删除历史版本文件:
./ossutil64 ls oss://bucket1 --all-versions ./ossutil64 rm oss://bucket1 --all-versions -r
删除Bucket。
./ossutil64 rm oss://bucket1 -b
强制删除Bucket。
若存储空间未开启版本控制,使用如下命令强制删除Bucket:
./ossutil64 rm oss://bucketname -abrf
若存储空间已开启版本控制,使用如下命令强制删除Bucket:
./ossutil64 rm oss://bucketname -abrf --all-versions
文件上传、下载进度超过100%
问题分析:ossutil在上传、下载文件时,会自动生成一个名为.ossutil_checkpoint文件夹。当目标文件超过100 MB时,ossutil默认使用断点续传上传或下载目标文件,并将过程中生成的断点信息文件保存在.ossutil_checkpoint文件夹中。上传、下载任务完成后,会自动删除这个文件夹。若单机运行超过一个ossutil实例,且都在进行上传或下载任务,当其中一个ossutil的任务完成后,会自动删除.ossutil_checkpoint文件夹,导致其它需要使用断点续传的ossutil任务进度超过100%且无法完成。
解决方案:
将当前任务结束,重新开始上传、下载任务。
在cp命令中加上--checkpoint-dir参数,并手动指定一个与默认checkpoint文件夹不同名的文件夹。例如:
./ossutil64 cp oss://bucket1/myphoto.jpg /dir --checkpoint-dir checkpoint
使用ossutil发起单个文件的下载请求,但OSS日志里面有多条请求记录
问题分析:出现该问题有两种可能。
请求异常或请求失败时,ossutil会进行重试操作,默认为10次。
如果您下载的文件超过100 MB,ossutil会使用range方式去请求,即每次请求该文件的部分内容,通过多次请求完成完整文件的下载。因此,超过100 MB的文件下载时也会产生多条请求记录 。
使用ossutil下载文件时,下载任务中断怎么办
文件下载任务中断的场景与影响因素
下载较大文件时,可能出现下载时间过长,任务中断的情况。
影响因素:网络带宽限制,网络稳定性较差。
下载较大文件时返回EOF错误码,任务中断。
影响因素:网络中断、磁盘读写速度较慢无法匹配大文件高速下载的数据写入需求。
解决方案:配置断点文件续传。
以cp命令为例,您可以在上传文件时设置断点文件(--checkpoint-dir),指定断点续传所在的目录。
./ossutil64 cp examplefile.txt oss://examplebucket/desfolder/ --checkpoint-dir localfolder/
关于如何设置断点文件(--checkpoint-dir),请参见命令格式。
使用ossutil执行相关命令时,报错Error: accessKeyID and ecsUrl are both empty
问题分析:未在home目录下生成配置文件。
解决方案:
使用ossutil执行相关命令之前,需在当前用户的home目录下生成配置文件。具体步骤,请参见安装ossutil。
使用ossutil执行相关命令时单独指定配置文件路径。例如,通过cp命令上传文件时指定配置文件路径:
./ossutil64 cp examplefile.txt oss://examplebucket/destfolder/ -c /home/admin/.ossutilconfig
通过ossutil上传的文件的content-type为什么会有charset=utf-8
问题分析:上传文件时,ossutil会根据文件的扩展名,查找关联的MIME类型来设置文件的Content-Type。在查找关联的MIME类型时,会通过Go的标准库MIME的接口查找,该接口对于文本类型的会自动添加charset=utf-8
,例如,对于.htm扩展名的文件会返回text/html; charset=utf-8
。
解决方法:请升级到1.7.14及之后的版本。你可以通过重新安装来升级ossutil,具体操作,请参见安装ossutil。
是否可以通过ossutil查询一个目录的大小
您可以通过du命令查询目录的大小,du命令会通过ListObjects接口获取目录下的所有文件信息,再进行统计。如果该目录下的文件数量很多,需要花费很长时间。
更多信息,请参见du(获取大小)。
如何生成包含自定义域名的签名URL
为Bucket配置自定义域名。
具体操作,请参见配置自定义域名。
通过sign命令生成签名URL。
具体操作,请参见sign(生成签名URL)。
ossutil查询文件时,是否支持排序?
ossutil在查询文件时,不支持排序。
使用ossutil执行相关命令时,报错no such host
问题原因:Endpoint设置不正确。
解决方案:正确设置-e参数,或者将Endpoint放入配置文件中。其中,-e参数指定Bucket对应的Endpoint,例如:-e oss-cn-shanghai.aliyuncs.com
,Endpoint中请不要添加其他字段。各地域Endpoint详情,请参见访问域名和数据中心。
du命令如何计费
du命令执行后,如果不开启--all-versions,调用ListObjects接口;如果开启--all-versions,调用ListObjectVersions接口。同时会调用ListMultipartUploads接口,产生对应的请求费用。更多信息,请参见请求费用。
如果有分片,会额外产生 ListUploadedParts请求。