您可以通過API級命令建立儲存空間。
注意事項
同一阿里雲帳號在同一地區(Region)內最多支援建立100個Bucket。
每個地區都有對應的訪問網域名稱(Endpoint)。關於地區與訪問網域名稱對應關係的更多資訊,請參見訪問網域名稱和資料中心。
北京時間2025年10月13日10:00:00起,OSS逐步調整所有地區通過API、SDK、ossutil建立Bucket時預設開啟阻止公用訪問。各個地區的生效變更時間,請參見公告說明。開啟後,不允許建立公用存取權限,包括公用讀取或者公用讀寫ACL、以及公用訪問語義的Bucket Policy。如果您的業務有公用訪問需求,可在Bucket建立後關閉阻止公用訪問。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
PutBucket |
| 建立儲存空間(Bucket)。 |
| 建立儲存空間(Bucket)後,修改Bucket的ACL,需要此操作的許可權。 |
命令格式
ossutil api put-bucket --bucket value [flags]
參數 | 類型 | 說明 |
--acl | string | 指定Bucket的存取權限ACL。 |
--bucket | string | Bucket名稱。 |
--create-bucket-configuration | string | 儲存建立Bucket資訊的容器。 |
--resource-group-id | string | 指定資源群組ID。 |
put-bucket命令對應API介面PutBucket。關於API中的具體參數含義,請參見PutBucket。
--create-bucket-configuration
--create-bucket-configuration配置選項既支援XML文法也支援JSON文法:
XML文法:
<?xml version="1.0" encoding="UTF-8"?> <CreateBucketConfiguration> <StorageClass>Standard</StorageClass> <DataRedundancyType>LRS</DataRedundancyType> </CreateBucketConfiguration>
JSON文法:
{ "StorageClass": "Standard", "DataRedundancyType": "LRS" }
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
建立名為examplebucket的儲存空間。
ossutil api put-bucket --bucket examplebucket
建立存取權限為私人,資源群組ID為rg-123,名字為examplebucket,儲存類型為Standard,資料容災類型為LRS的儲存空間。
使用XML設定檔,create-bucket-configuration.xml內容如下:
<?xml version="1.0" encoding="UTF-8"?> <CreateBucketConfiguration> <StorageClass>Standard</StorageClass> <DataRedundancyType>LRS</DataRedundancyType> </CreateBucketConfiguration>
命令樣本如下:
ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.xml
使用JSON設定檔,create-bucket-configuration.json內容如下:
{ "StorageClass": "Standard", "DataRedundancyType": "LRS" }
命令樣本如下:
ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.json
使用JSON配置參數,命令樣本如下:
ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration "{\"StorageClass\":\"Standard\",\"DataRedundancyType\":\"LRS\"}"