本文主要介绍与存储空间(Bucket)相关的命令。
config
命令说明:
config --id=[accessid] --key=[accesskey] --host=[host] --sts_token=[sts_token]
使用示范:
python osscmd config --id=your_id --key=your_key
python osscmd config --id=your_id --key=your_key --host=oss-internal.aliyuncs.com
getallbucket(gs)
命令说明:
getallbucket(gs)
获取创建的bucket。gs是get allbucket的简写。gs和getallbucket是同样的效果。
使用示范:
python osscmd getallbucket
python osscmd gs
createbucket(cb,mb,pb)
命令说明:
createbucket(cb,mb,pb) oss://bucket --acl=[acl]
- cb是create bucket的简写、mb是make bucket的简写、pb是put bucket的简写。
- oss://bucket表示bucket。
- acl参数可以传入,也可以不传入。
使用示范:
python osscmd createbucket oss://mybucket
python osscmd cb oss://myfirstbucket --acl=public-read
python osscmd mb oss://mysecondbucket --acl=private
python osscmd pb oss://mythirdbucket
deletebucket(db)
命令说明:
deletebucket(db) oss://bucket
删除bucket的命令,db是delete bucket的简写。
使用示范:
python osscmd deletebucket oss://mybucket
python osscmd db oss://myfirstbucket
deletewholebucket
命令说明:
deletewholebucket oss://bucket
删除bucket及其内部object以及multipart相关的内容。
使用示范:
python osscmd deletewholebucket oss://mybucket
getacl
命令说明:
getacl oss://bucket
获取bucket的访问控制权限。
使用示范:
python osscmd getacl oss://mybucket
setacl
命令说明:
setacl oss://bucket --acl=[acl]
修改bucket的访问控制权限。acl允许设置的访问控制权限包括private、public-read、public-read-write。
使用示范:
python osscmd setacl oss://mybucket --acl=private
putlifecycle
命令说明:
putlifecycle oss://mybucket lifecycle.xml
设置lifecycle规则。其中lifecycle.xml为XML格式的lifecycle配置文件,详细的规则配置可以参考API文档。
使用示范:
python osscmd putlifecycle oss://mybucket lifecycle.xml
示例:
<LifecycleConfiguration> <Rule> <ID>1125</ID> <Prefix>log_backup/</Prefix> <Status>Enabled</Status> <Expiration> <Days>2</Days> </Expiration> </Rule> </LifecycleConfiguration>
getlifecycle
命令说明:
osscmd getlifecycle oss://bucket
获取该Bucket lifecycle规则。
使用示范:
python osscmd getlifecycle oss://mybucket
deletelifecycle
命令说明:
osscmd deletelifecycle oss://bucket
删除该bucket下所有的lifecycle规则。
使用示范:
python osscmd deletelifecycle oss://mybucket
putreferer
命令说明:
osscmd putreferer oss://bucket --allow_empty_referer=[true|false] --referer=[referer]
设置防盗链规则。其中参数allow_empty_referer
用来设置是否允许为空,为必选参数。参数referer
用来设置允许访问的白名单,例如“www.example.com,www.example.org”,以“,”作为分隔。详细的配置规则参考产品文档。
使用示范:
python osscmd putreferer oss://mybucket --allow_empty_referer=true --referer="www.example.com,www.example.org"
getreferer
命令说明:
osscmd getreferer oss://bucket
获取该Bucket下防盗链设置规则。
使用示范:
python osscmd getreferer oss://mybucket
putlogging
命令说明:
osscmd putlogging oss://source_bucket oss://target_bucket/[prefix]
其中source_bucket表示需要记录日志的bucket,而target_bucket则是用来存放产生的日志。允许对源bucket产生的日志文件设置前缀,方便用户归类查询。
使用示范:
python osscmd getlogging oss://mybucket
getlogging
命令说明:
osscmd getlogging oss://bucket
获取该bucket的logging设置规则。
使用示范:
python osscmd getlogging oss://mybucket