全部產品
Search
文件中心

Object Storage Service:建立儲存空間

更新時間:Aug 01, 2024

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

注意事項

  • 要建立儲存空間,您必須有oss:PutBucket許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

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

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

命令格式

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\"}"