有关Bucket命令 - 对象存储 OSS

本文主要介绍与存储空间（Bucket）相关的命令。

重要

osscmd于2019年7月31日下线，阿里云不再继续维护更新。osscmd操作命令已整合到ossutil中，推荐您使用ossutil。

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]

创建bucket的命令。

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