OSS Order --common commands

--切换为中文显示ls命令的帮助
./ossutil help ls -L ch

stat

1. cors 命令用于添加、修改、查询、删除Bucket的跨域资源共享（CORS）配置。

./ossutil cors --method put oss://bucket  local_xml_file

1. cors-options 命令用于测试存储空间（Bucket）是否允许指定的跨域访问请求。

   ./ossutil cors-options --acr-method <value> --origin <value> --acr-headers <value> oss://bucket/[object]

./ossutil64 cors-options  --acr-method put --origin "www.aliyun.com" oss://xpf-oss-demo

3.**cp **命令用于上传、下载、拷贝文件。

--上传文件
./ossutil cp file_url cloud_url  [-r] [-f] [-u] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--snapshot-path=sdir] [--payer requester]
--下载文件
./ossutil cp cloud_url file_url  [-r] [-f] [-u] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--range=x-y] [--payer requester]
--拷贝文件
./ossutil cp cloud_url cloud_url [-r] [-f] [-u] [--output-dir=odir] [--bigfile-threshold=size] [--checkpoint-dir=cdir] [--payer requester]

--上传单个文件
./ossutil cp a.txt oss://bucket/path
--上传文件夹
./ossutil cp -r dir oss://bucket/path
--上传文件并设置限速为1MByte/s
./ossutil cp a.jpg oss://bucket/path --maxupspeed 1024
--批量上传符合条件的文件
abc?.jpg    *.txt
abc[!0-7].jpg  abc[1-5].jpg
  --recursive（-r）
--上传所有文件格式为txt的文件：
./ossutil cp dir/ oss://bucket/path --include "*.txt" -r
上传所有文件名包含abc且不是jpg和txt格式的文件：
./ossutil cp dir/ oss://bucket/path --include "*abc*" --exculde "*.jpg"  --exculde "*.txt" -r
--上传单个文件并指定存储类型为IA（低频访问）类型
./ossutil cp dir/sys.log oss://bucket/path --meta X-oss-Storage-Class:IA
--上传文件目录并指定存储类型为IA类型：
./ossutil cp dir/ oss://bucket/path --meta X-oss-Storage-Class：IA -r
--上传文件并指定服务器端加密方式
./ossutil cp a.txt oss://my-bucket/path --meta=x-oss-server-side-encryption:AES256
--上传文件夹并跳过已有文件
./ossutil cp -r dir oss://bucket/path -u
--上传文件夹并生成快照信息
./ossutil cp -r dir oss://b/p --snapshot-path=path
--拷贝文件
--不支持跨region拷贝文件
--拷贝单个文件并重命名
./ossutil cp oss://b/p/a oss://b/p2/b
--批量拷贝符合指定条件的文件
--拷贝文件并修改文件存储类型
    --归档类型 先restore 再cp
--同region不同Bucket之间的文件拷贝  
./ossutil cp oss://b1/p oss://b2/p -r
--同region不同Bucket之间的增量文件拷贝
./ossutil cp oss://your_src_bucket/path1/ oss://your_dest_bucket/path2/ -r --update

3.set-meta 命令用于设置已上传对象（Object）的元信息。

./ossutil set-meta oss://bucket[/prefix] [header:value#header:value...] [--update] [--delete] [-r] [-f] [-c file]

--设置指定前缀的所有Object的meta信息
./ossutil set-meta oss://bucket1/path/ Cache-Control:no-cache#x-oss-object-acl:private -r                             
--更新指定Object的meta信息
./ossutil set-meta oss://bucket1/path/object x-oss-object-acl:private --update
--删除指定Object的meta信息
./ossutil set-meta oss://b/p/object X-Oss-Meta-delete --delete
--批量设置指定条件的Object的meta信息
--将所有文件类型为jpg的Object设置为低频存储
./ossutil64 set-meta oss://b/p X-Oss-Storage-Class:IA --include "*.jpg" -u -r

4.create-symlink命令用于创建符号链接（软链接）。

./ossutil create-symlink  oss://bucket1/b oss://bucket1/path/a.txt

5.etallpartsize命令用于获取存储空间（Bucket）内所有未完成上传的Multipart任务的每个分片大小以及分片总大小。

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

7.listpart命令用于列出没有完成分片上传的Object的分片信息。

8.logging命令用于添加、修改、查询、删除Bucket的日志管理配置。

9.ls命令用于列举存储空间（Bucket）、对象（Object）和碎片（Part）

--分页列举所有的Object
--列举UploadID
--列举所有的Object和未完成的Multipart事件
./ossutil ls oss://b -a
--以精简模式显示列举结果
./ossutil ls oss://b -s
--模拟目录方式列举
./ossutil ls oss://bucket1 -s -d
--列举当前目录下指定前缀的Object或文件目录
./ossutil ls oss://bucket1/test -d

10.mb命令用于创建存储空间（Bucket）

--创建Bucket时指定访问权限
./ossutil mb oss://bucket1 --acl=public-read-write
--private & public-read & public-read-write
--创建Bucket时指定存储类型
./ossutil mb oss://bucket1 --storage-class IA
--IA:低频 & Archive：归档 & standard 
--在指定地域创建Bucket
./ossutil mb oss://b1 -e oss-cn-hanghzhou.aliyun.com
-e(endpoint) --指定bucket的地域（region）

11.mkdir命令可在存储空间内创建文件目录。

./ossutil mkdir oss://bucket/dir1/dir2/

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

--下载http_url地址到本地，并输出探测报告
./ossutil probe --download --url https://bucket1.oss-cn-beijing.aliyuncs.com/myphoto.jpg --addr=www.aliyun.com /file/myphoto.jpg

13、read-symlink命令用于读取符号链接（软链接）文件的描述信息。

./ossutil read-symlink oss://bucket1/object1
Etag                    : 455E20DBFFF1D588B67D092C46B16DB6
Last-Modified           : 2017-04-17 14:49:42 +0800 CST
X-Oss-Symlink-Target    : a

14.referer命令用于添加、修改、查询、删除Bucket的防盗链配置。

添加/修改防盗链配置
./ossutil referer --method put oss://bucket referer-value [--disable-empty-referer]
设置防盗链，且不允许Referer为空：
./ossutil referer --method put oss://bucket1 www.test1.com www.test2.com --disable-empty-referer

15、restore命令用于恢复冷冻状态的对象（Object）为可读状态。

恢复单个冷冻状态的Object为可读状态
./ossutil restore oss://bucket/object
恢复指定前缀的所有状态的Object为可读状态
./ossutil restore oss://bucket/path/ -r

16、rm命令用于删除存储空间（Bucket）、对象（Object）或碎片（Part）

删除空Bucket
./ossutil rm oss://bucket1 -b
清除Bucket数据并删除Bucket
./ossutil rm oss://bucket1 -bar
删除指定前缀的所有Object
./ossutil rm oss://bucket1/path/ -r

17、set-acl用于设置存储空间（Bucket）或对象（Object）的访问权限（ACL）。

设置Bucket的ACL
./ossutil set-acl oss://bucket1 private -b
设置指定Object的ACL
./ossutil set-acl oss://bucket1/path/object private      
定前缀的所有Object的ACL
./ossutil set-acl oss://bucket1/path/ private -r

18、sign命令用于生成经过签名的url供第三方用户访问存储空间（Bucket）内的对象（Object）。

生成默认超时时间的文件URL，默认超时时间为60秒
./ossutil sign oss://bucket/path/object
生成指定超时时间的文件URL
./ossutil sign oss://bucket/path/object --timeout 3600

19、stat命令用于获取指定存储空间（Bucket）或者对象（Object）的描述信息。例如，通过set-meta命令设置的Object元信息 ，可以通过该命令查看。

查看Bucket信息
./ossutil stat oss://bucket1
查看指定Object信息
./ossutil stat oss://bucket1/object

20、update命令用于更新ossutil版本。

./ossutil update 
当前版本为：v1.5.1，最新版本为：1.6.0
确定更新版本(y or N)? y
更新成功!

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

./ossutil website --method put oss://bucket  local_xml_file