常见问题

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

本文介绍在使用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。

    1. 删除碎片和历史版本文件。

      • 列举并删除碎片:

        ./ossutil64 ls oss://bucket1 -m
        ./ossutil64 rm -m oss://bucket1 -r
      • 列举并删除历史版本文件:

        ./ossutil64 ls oss://bucket1 --all-versions
        ./ossutil64 rm oss://bucket1 --all-versions -r
    2. 删除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下载文件时,下载任务中断怎么办

  1. 文件下载任务中断的场景与影响因素

    • 下载较大文件时,可能出现下载时间过长,任务中断的情况。

      影响因素:网络带宽限制,网络稳定性较差。

    • 下载较大文件时返回EOF错误码,任务中断。

      影响因素:网络中断、磁盘读写速度较慢无法匹配大文件高速下载的数据写入需求。

  2. 解决方案:配置断点文件续传。

    • 以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

  1. 为Bucket配置自定义域名。

    具体操作,请参见配置自定义域名

  2. 通过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请求。