使用阿里云CLI管理OSS中的数据

更新时间:
复制为 MD 格式

阿里云CLI集成了对象存储 OSS(Object Storage Service)的命令行工具ossutil 1.0。您可以通过使用阿里云CLI统一的命令格式,快速管理您在OSS中的数据。

前置概念

  • 阿里云CLI是基于阿里云OpenAPI建立的管理工具,您可在云命令行(Cloud Shell)使用阿里云CLI快速管理阿里云资源。更多信息,请参见什么是阿里云CLI

  • ossutil是阿里云官方提供的OSS命令行管理工具,您可以使用ossutil来管理您OSS中的如下数据:

    • 管理存储空间(Bucket)。例如:创建、列举或删除Bucket等。

    • 管理对象/文件(Object)。例如:上传、下载、列举、拷贝或删除Object等。

    • 管理碎片(Part)。例如:列举或删除Part等。

    更多信息,请参见命令行工具ossutil 1.0

操作步骤

步骤一:启动云命令行

重要

在启动云命令行之前,您需要使用已授予权限的可用RAM身份登录阿里云主页。云命令行将使用当前登录态为您自动配置身份凭证,无需手动操作。为避免自动配置凭证功能失效,建议您在操作时避免对初始配置文件default进行修改或删除。

您可以通过以下方式启动云命令行:

  • 在控制台中运行

    单击控制台首页顶部导航栏中的云命令行按钮,启动云命令行。

    image

  • 独立运行

    在浏览器中输入https://shell.aliyun.com,打开云命令行操作界面。

说明
  • 云命令行启动时会为您创建一台虚拟机,这个过程将消耗一些时间,最长不超过30秒。

  • 您可以根据实际需要打开多个云命令行窗口,最多可同时打开5个云命令行窗口。多个云命令行窗口会连接到同一台虚拟机,虚拟机数量不会因为您打开新的命令行窗口而增加。

  • 更多信息,请参见什么是云命令行?

步骤二:使用阿里云CLI管理OSS中的数据。

命令格式

云命令行中已预装阿里云CLI并内置授权,您可以使用阿里云CLI来管理您的OSS数据。通用命令格式如下所示

aliyun oss [command] [options and parameters]

命令示例

  • 执行如下命令,创建一个命名为vmeixme的存储空间(Bucket),并设定Bucket的存储类型为Standard

    aliyun oss mb oss://vmeixme --storage-class Standard
  • 执行如下命令,在Bucket内创建一个命名为horse的文件目录。

    aliyun oss mkdir oss://vmeixme/horse/
  • 执行如下命令,列举您账号下的OSS资源,包括存储空间(Bucket)、对象(Object)和碎片(Part)信息,并设定返回结果的最大个数为20。

    aliyun oss ls --limited-num 20

帮助信息

在阿里云CLI中,您可以通过在命令中使用--help选项获取帮助信息。

  • 执行aliyun oss --help命令,您可以查看并了解使用阿里云CLI管理OSS数据的所有操作命令。

    aliyun oss --help
  • 执行如下命令,可获取某一项操作的详细信息及可用选项。

    aliyun oss [command] --help

命令示例

  1. 执行如下命令,可以获取创建文件目录操作的详细信息及可用选项。

    aliyun oss mkdir --help
  2. 预期输出如下信息。

    image

常用操作命令

您可以通过如下列表了解阿里云CLI支持的OSS操作命令。

命令

说明

appendfromfile(追加上传)

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

bucket-encryption(服务器端加密)

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

bucket-policy(授权策略)

添加、修改、查询、删除Bucket授权策略(Bucket Policy)

bucket-tagging(存储空间标签)

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

cat(输出文件内容)

将存储空间(Bucket)内文件(Object)的内容输出到屏幕。

cors(跨域资源共享)

添加、修改、查询、删除存储空间(Bucket)的CORS配置。

cors-options(检测跨域请求)

通过向OSS发送HTTP OPTIONS请求的方式,用来检测指定的跨域访问请求是否被允许。

cp(上传、下载和拷贝文件)

对存储空间(Bucket)中的文件进行上传、下载和拷贝。

create-symlink(创建软链接)

创建软链接,通过软链接文件快速打开源文件。

du(获取大小)

获取指定存储空间(Bucket)、文件目录下包含的所有Object的大小。

getallpartsize(获取碎片大小)

获取Bucket内所有未完成的Multipart任务产生的碎片(Part)信息。

hash(计算CRC64MD5)

计算本地文件的MD5CRC64。

help(获取帮助信息)

获取命令的帮助信息。

lifecycle(生命周期)

添加、查询、列举或删除生命周期规则。

listpart(列举碎片)

列举未完成分片上传的文件(Object)包含的碎片(Part)信息。

logging(日志转存)

开启、查询、关闭Bucket的日志转存配置。

ls(列举账号级别下的资源)

列举当前账号下的存储空间(Bucket)、对象(Object)和碎片(Part)信息。

mb(创建存储空间)

创建Bucket。

mkdir(创建目录)

创建目录。

object-tagging(对象标签)

添加、修改、获取和删除对象标签。

probe(探测状态)

排查本地与OSS之间的网络状态、上传下载带宽、本地符号链接(软链接)状态等。

read-symlink(读取软链接)

读取软链接文件的描述信息,包括软链接文件的ETag值、最后更新时间等。

referer(防盗链)

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

request-payment(请求者付费)

设置请求者付费模式。

restore(解冻文件)

解冻归档、冷归档、深度冷归档文件。

rm(删除)

删除不再需要的文件(Object)、碎片(Part)或存储空间(Bucket),以免产生不必要的存储费用。

set-acl(设置或修改ACL)

设置或修改BucketObject的访问权限ACL。

set-meta(管理文件元数据)

为已上传的文件(Object)设置、修改或者删除文件元数据。

sign(生成签名URL)

创建签名URL,授权第三方用户在指定时间内下载或者预览文件。

stat(查看BucketObject信息)

查看指定存储空间(Bucket)或者对象(Object)的相关信息。

website(静态网站托管及回源配置)

添加、修改、查询、删除Bucket的静态网站托管以及回源配置。