全部產品
Search
文件中心

Object Storage Service:建立儲存空間

更新時間:Mar 27, 2025

您可以通過API級命令建立儲存空間。

注意事項

  • 同一阿里雲帳號在同一地區(Region)內最多支援建立100個Bucket。

  • 每個地區都有對應的訪問網域名稱(Endpoint)。關於地區與訪問網域名稱對應關係的更多資訊,請參見訪問網域名稱和資料中心

  • 北京時間2025年10月13日10:00:00起,OSS逐步調整所有地區通過API、SDK、ossutil建立Bucket時預設開啟阻止公用訪問。各個地區的生效變更時間,請參見公告說明。開啟後,不允許建立公用存取權限,包括公用讀取或者公用讀寫ACL、以及公用訪問語義的Bucket Policy。如果您的業務有公用訪問需求,可在Bucket建立後關閉阻止公用訪問。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予操作許可權。

API

Action

說明

PutBucket

oss:PutBucket

建立儲存空間(Bucket)。

oss:PutBucketAcl

建立儲存空間(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\"}"