Object Storage Service:Create a bucket

Notas de uso

• Uma conta Alibaba Cloud pode crie no máximo 100 buckets em cada região.

• Cada região possui um endpoint correspondente. Para obter mais informações sobre os endpoints de cada região, consulte Endpoints.

• A partir das 10:00:00 (UTC+8) de 13 de outubro de 2025, o OSS ativará gradualmente o Block public access por padrão para buckets criados por meio de operações de API, OSS SDKs ou ossutil em todas as regiões. Para saber quando a alteração entra em vigor em cada região, consulte Comunicado. Com esse recurso ativado, não é possível conceder permissões de acesso público, incluindo a ACL public-read ou public-read-write e políticas de bucket que permitam acesso público. Caso seu negócio exija acesso público, desative o bloqueio de acesso público após crie o bucket.

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões completas. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não possuem nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

Sintaxe do comando

ossutil api put-bucket --bucket value [flags]

--create-bucket-configuration

Este parâmetro aceita XML ou JSON:

• Formato XML:

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

• Formato JSON:

  {
    "StorageClass": "Standard",
    "DataRedundancyType": "LRS"
  }

Exemplos

• Crie um bucket chamado examplebucket.

  ossutil api put-bucket --bucket examplebucket

• Crie o examplebucket com ACL private, grupo de recursos rg-123, classe de armazenamento Standard e redundância LRS.

  • Arquivo de configuração XML (create-bucket-configuration.xml)

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

    Comando:

    ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.xml

  • Arquivo de configuração JSON (create-bucket-configuration.json)

    {
      "StorageClass": "Standard",
      "DataRedundancyType": "LRS"
    }

    Comando:

    ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.json

  • Parâmetros JSON inline

    ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration "{\"StorageClass\":\"Standard\",\"DataRedundancyType\":\"LRS\"}"