如何使用mb命令建立Bucket - Object Storage Service

儲存空間（Bucket）是用於儲存物件（Object）的容器。在上傳任意類型的Object前，您需要先建立Bucket。本文介紹如何通過mb命令建立Bucket。

注意事項

要建立Bucket，您必須具有oss:PutBucket許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。
從ossutil 1.6.16版本開始，命令列中Binary名稱支援直接使用ossutil，您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16，則需要根據系統重新整理Binary名稱。更多資訊，請參見命令列工具ossutil命令參考。

以命令中指定選項的形式建立Bucket

命令格式

ossutil mb oss://bucketname 
[--acl <value>]
[--storage-class <value>]
[--redundancy-type <value>]

參數及選項說明如下：

參數	說明
bucketname	建立的Bucket名稱。Bucket名稱在OSS範圍內必須全域唯一，一旦建立完成則無法修改。
--acl	Bucket的讀寫權限ACL。取值如下： private（預設值）：只有該Bucket的擁有者可以對該Bucket內的檔案進行讀寫操作，其他人無法訪問該Bucket內的檔案。 public-read：只有Bucket擁有者可以對該Bucket內的檔案進行寫操作，其他使用者（包括匿名訪問者）都可以對該Bucket中的檔案進行讀操作。這有可能造成您資料的外泄以及費用激增，請謹慎操作。 public-read-write：任何人（包括匿名訪問者）都可以對該Bucket內檔案進行讀寫操作。這有可能造成您資料的外泄以及費用激增，若被人惡意寫入違法資訊還可能會侵害您的合法權益。除特殊情境外，不建議您配置公用讀寫許可權。
--storage-class	Bucket的儲存類型。取值如下： Standard（預設值）：支援頻繁的資料訪問。 IA：適用於較低訪問頻率（平均每月訪問頻率1到2次）的業務情境，有最低儲存時間（30天）和最小計量單位（64 KB）要求。支援資料即時訪問，訪問資料時會產生資料取回費用。 Archive：適用於資料長期儲存的業務情境，有最低儲存時間（60天）和最小計量單位（64 KB）要求。資料需解凍（約1分鐘）後訪問，解凍會產生資料取回費用。 ColdArchive：適用於需要超長時間存放的極冷資料，有最低儲存時間（180天）和最小計量單位（64 KB）要求。資料需解凍後訪問，解凍時間根據資料大小和選擇的解凍模式決定，解凍會產生資料取回費用。說明在OSS ON雲盒使用情境中，僅支援Standard類型。關於儲存類型的更多資訊，請參見儲存類型概述。
--redundancy-type	Bucket的資料容災類型。取值如下： LRS（預設值）：本地冗餘LRS將您的資料冗餘儲存在同一個可用性區域的不同存放裝置上，可支援兩個存放裝置並發損壞時，仍鑑效組資料不丟失，可正常訪問。 ZRS：同城冗餘ZRS採用多可用性區域（AZ）內的資料冗餘儲存機制，將使用者的資料冗餘儲存在同一地區（Region）的多個可用性區域。當某個可用性區域不可用時，仍然能夠保障資料的正常訪問。重要華南1（深圳）、華北2（北京）、華東1（杭州）、華東2（上海）、中國香港、新加坡以及印尼（雅加達）地區支援開啟同城冗餘儲存。此外，同城冗餘儲存的費用較高，且開啟後不支援關閉，請謹慎操作。在OSS ON雲盒使用情境中，不支援使用此選項。

使用樣本

僅建立examplebucket。
```
ossutil mb oss://examplebucket
```
如果建立Bucket時未指定Bucket所在地區，則預設在ossutil設定檔中Endpoint指向的地區建立Bucket。例如設定檔中的Endpoint為https://oss-cn-hangzhou.aliyuncs.com，則表示在華東1（杭州）地區建立了Bucket。
建立examplebucket，並指定讀寫權限ACL為私人、儲存類型為低頻訪問以及資料容災類型為同城冗餘ZRS。
```
ossutil mb oss://examplebucket --acl private --storage-class IA --redundancy-type ZRS
```
以下輸出結果表明已成功建立符合指定條件的Bucket。
```
0.335189(s) elapsed
```

以命令中指定XML結構的方式建立Bucket

命令格式

ossutil mb oss://bucketname local_xml_file

參數說明如下：

參數	說明
bucketname	待建立的Bucket名稱。
local_xml_file	指定Bucket配置的本地檔案路徑，例如`localfile.xml`。

使用樣本

在本地檔案路徑localfile.xml中以XML結構的方式指定Bucket選項。

<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>    
    <StorageClass>IA</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
</CreateBucketConfiguration>

ossutil先從本地檔案路徑讀取Bucket配置，然後將讀取到Bucket配置添加到待建立的Bucket。
```
ossutil mb oss://examplebucket localfile.xml
```

通用選項

當您需要通過命令列工具ossutil切換至另一個地區的Bucket時，可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時，可以通過-i選項指定該帳號的AccessKey ID，並通過-k選項指定該帳號的AccessKey Secret。

例如您需要為另一個阿里雲帳號下，華東2（上海）地區建立名為examplebucket的儲存空間，命令如下：

ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

關於此命令的其他通用選項的更多資訊，請參見通用選項。