以命令中指定選項的形式創建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的數據容災類型。取值如下: |
使用示例
僅創建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****
關于此命令的其他通用選項的更多信息,請參見通用選項。