全部产品
Search
文档中心

对象存储 OSS:命令行工具ossutil 1.0

更新时间:Dec 10, 2024

ossutil支持通过Windows、Linux和macOS系统以命令行方式管理OSS数据。

版本升级

推荐您使用全新升级的ossutil2.0,快速安装并使用,请参见安装ossutil

ossutil2.0重点功能如下:

  • 全新的命令组织结构:引入了多级命令支持,包括API级命令(例如ossutil api put-bucket-acl)和高级命令(如ossutil config)。

  • 改进的配置管理机制:简化了初始配置流程,用户仅需提供AccessKey ID、AccessKey Secret及地域ID即可完成安装后的基础配置,并且支持通过--profile参数指定多个配置文件,增强了灵活性。

  • 丰富的过滤参数:对于批量处理命令(如lscprm等),新增了基于路径、文件大小、修改时间以及对象元数据等多种过滤条件的支持,极大地提升了操作的精确性和效率。

  • 灵活的输出格式调整:新增--output-format参数,允许用户将输出格式设定为JSON、YAML或XML,以便更好地适配不同的数据处理需求;同时引入了--output-query选项,让用户能够对输出内容进行筛选,获取所需信息。

  • 安全性增强:为了提高安全性,ossutil 2.0支持通过环境变量设置敏感参数,避免在命令行中直接暴露密钥,减少了泄露风险;此外,新增的--dry-run选项使用户能够在实际执行命令前验证其行为,确保操作无误。

安装ossutil

有关ossutil的下载及安装的具体操作,请参见安装ossutil

配置ossutil

有关ossutil的配置的具体操作,请参见配置ossutil

常用命令

您可以通过以下列表学习ossutil命令的用法:

名称

描述

access-monitor

配置存储空间(Bucket)的访问跟踪状态。

appendfromfile

用于在已上传的追加类型文件(Appendable Object)末尾直接追加内容。

bucket-cname

查看Bucket的CNAME配置。

bucket-encryption

添加、修改、查询、删除Bucket的加密配置。

bucket-policy

添加、修改、查询、删除Bucket的Bucket policy配置。

bucket-tagging

添加、修改、查询、删除Bucket的标签配置。

bucket-versioning

添加或查询Bucket的版本控制配置。

cat

将文件内容输出到ossutil。

config

创建配置文件来存储OSS访问信息。

cors

添加、修改、查询、删除Bucket的CORS配置。

cors-options

用于测试Bucket是否允许指定的跨域访问请求。

cp

用于上传、下载、拷贝文件。

create-symlink

创建符号链接(软链接)。

du

用于获取指定Bucket、指定Object或文件目录所占的存储空间大小。

getallpartsize

获取Bucket内所有未完成上传的Multipart任务的每个分片大小以及分片总大小。

hash

用于计算本地文件的CRC64或MD5。

help

获取命令的帮助信息。当您不清楚某个命令的用法时,建议您使用help命令获取该命令的帮助信息。

inventory

命令用于添加、查询、列举、删除Bucket的清单规则。

lifecycle

命令用于添加、修改、查询、删除生命周期规则配置。

listpart

列出没有完成分片上传的Object的分片信息。

logging

添加、修改、查询、删除Bucket的日志管理配置。

lrb

列举单个或多个地域(Region)下Bucket的基本信息。

ls

列举Bucket、Object和Part。

mb

创建Bucket。

mkdir

在Bucket内创建文件目录。

object-tagging

添加、修改、查询或删除Object的标签配置。

probe

针对OSS访问的检测命令,可用于排查上传、下载过程中因网络故障或基本参数设置错误导致的问题。

read-symlink

读取符号链接(软链接)文件的描述信息。

referer

添加、修改、查询、删除Bucket的防盗链配置。

replication

管理Bucket的跨区域复制规则配置。

request-payment

设置或查询Bucket的请求者付费模式配置。

resource-group

为存储空间(Bucket)配置所属资源组以及获取资源组信息。

restore

恢复冷冻状态的Object为可读状态。

revert-versioning

将已删除的Object恢复至最近的版本。

rm(删除)

删除Bucket、Object和Part。

set-acl

设置Bucket或Object的访问权限(ACL)。

set-meta

设置已上传Object的元数据。

sign

用于生成经过签名的文件URL,并将签名URL分享给第三方供其下载或预览。

stat

获取指定Bucket或Object的描述信息。

style

设置图片样式。

sync

用于同步本地文件到OSS、同步OSS文件到本地、在OSS之间同步文件。

update

用于更新ossutil版本。

website

用于添加、修改、查询、删除Bucket的静态网站托管配置、重定向配置、镜像回源配置。

worm

管理Bucket的合规保留策略。

查看选项

有关命令行选项的更多信息,请参见查看选项

常见问题

有关常见问题的更多信息,请参见常见问题