有關Bucket命令 - Object Storage Service

本文主要介紹與儲存空間（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