全部产品
Search
文档中心

对象存储 OSS:有关Bucket命令

更新时间:Aug 31, 2023

本文主要介绍与存储空间(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