ossutil支持通过Windows、Linux和macOS系统以命令行方式管理OSS数据。
版本升级
推荐您使用全新升级的ossutil2.0,快速安装并使用,请参见安装ossutil。
ossutil2.0重点功能如下:
- 全新的命令组织结构:引入了多级命令支持,包括API级命令(例如 - ossutil api put-bucket-acl)和高级命令(如- ossutil config)。
- 改进的配置管理机制:简化了初始配置流程,用户仅需提供AccessKey ID、AccessKey Secret及地域ID即可完成安装后的基础配置,并且支持通过 - --profile参数指定多个配置文件,增强了灵活性。
- 丰富的过滤参数:对于批量处理命令(如 - ls、- cp、- rm等),新增了基于路径、文件大小、修改时间以及对象元数据等多种过滤条件的支持,极大地提升了操作的精确性和效率。
- 灵活的输出格式调整:新增 - --output-format参数,允许用户将输出格式设定为JSON、YAML或XML,以便更好地适配不同的数据处理需求;同时引入了- --output-query选项,让用户能够对输出内容进行筛选,获取所需信息。
- 安全性增强:为了提高安全性,ossutil 2.0支持通过环境变量设置敏感参数,避免在命令行中直接暴露密钥,减少了泄露风险;此外,新增的 - --dry-run选项使用户能够在实际执行命令前验证其行为,确保操作无误。
安装ossutil
有关ossutil的下载及安装的具体操作,请参见安装ossutil。
配置ossutil
有关ossutil的配置的具体操作,请参见配置ossutil。
常用命令
您可以通过以下列表学习ossutil命令的用法:
| 名称 | 描述 | 
| 配置存储空间(Bucket)的访问跟踪状态。 | |
| 用于在已上传的追加类型文件(Appendable Object)末尾直接追加内容。 | |
| 查看Bucket的CNAME配置。 | |
| 添加、修改、查询、删除Bucket的加密配置。 | |
| 添加、修改、查询、删除Bucket的Bucket policy配置。 | |
| 添加、修改、查询、删除Bucket的标签配置。 | |
| 添加或查询Bucket的版本控制配置。 | |
| 将文件内容输出到ossutil。 | |
| 创建配置文件来存储OSS访问信息。 | |
| 添加、修改、查询、删除Bucket的CORS配置。 | |
| 用于测试Bucket是否允许指定的跨域访问请求。 | |
| 用于上传、下载、拷贝文件。 | |
| 创建符号链接(软链接)。 | |
| 用于获取指定Bucket、指定Object或文件目录所占的存储空间大小。 | |
| 获取Bucket内所有未完成上传的Multipart任务的每个分片大小以及分片总大小。 | |
| 用于计算本地文件的CRC64或MD5。 | |
| 获取命令的帮助信息。当您不清楚某个命令的用法时,建议您使用help命令获取该命令的帮助信息。 | |
| 命令用于添加、查询、列举、删除Bucket的清单规则。 | |
| 命令用于添加、修改、查询、删除生命周期规则配置。 | |
| 列出没有完成分片上传的Object的分片信息。 | |
| 添加、修改、查询、删除Bucket的日志管理配置。 | |
| 列举单个或多个地域(Region)下Bucket的基本信息。 | |
| 列举Bucket、Object和Part。 | |
| 创建Bucket。 | |
| 在Bucket内创建文件目录。 | |
| 添加、修改、查询或删除Object的标签配置。 | |
| 针对OSS访问的检测命令,可用于排查上传、下载过程中因网络故障或基本参数设置错误导致的问题。 | |
| 读取符号链接(软链接)文件的描述信息。 | |
| 添加、修改、查询、删除Bucket的防盗链配置。 | |
| 管理Bucket的跨区域复制规则配置。 | |
| 设置或查询Bucket的请求者付费模式配置。 | |
| 为存储空间(Bucket)配置所属资源组以及获取资源组信息。 | |
| 恢复冷冻状态的Object为可读状态。 | |
| 将已删除的Object恢复至最近的版本。 | |
| 删除Bucket、Object和Part。 | |
| 设置Bucket或Object的访问权限(ACL)。 | |
| 设置已上传Object的元数据。 | |
| 用于生成经过签名的文件URL,并将签名URL分享给第三方供其下载或预览。 | |
| 获取指定Bucket或Object的描述信息。 | |
| 设置图片样式。 | |
| 用于同步本地文件到OSS、同步OSS文件到本地、在OSS之间同步文件。 | |
| 用于更新ossutil版本。 | |
| 用于添加、修改、查询、删除Bucket的静态网站托管配置、重定向配置、镜像回源配置。 | |
| 管理Bucket的合规保留策略。 | 
查看选项
有关命令行选项的更多信息,请参见查看选项。
常见问题
有关常见问题的更多信息,请参见常见问题。