Criar um bucket do OSS com o comando put-bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

Cria um bucket do OSS com configurações opcionais de ACL, classe de armazenamento e redundância de dados.

Notas de uso

Uma conta Alibaba Cloud pode criar 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.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas. Usuários RAM ou funções RAM sob uma conta Alibaba Cloud não possuem permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de políticas do RAM ou Bucket Policy.

API	Action	Descrição
PutBucket	`oss:PutBucket`	Cria um bucket.
PutBucket	`oss:PutBucketAcl`	Após criar um bucket, essa permissão é necessária para modificar a ACL do bucket.

Sintaxe do comando

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

Parâmetro	Tipo	Descrição
--acl	string	A ACL do bucket.
--bucket	string	O nome do bucket.
--create-bucket-configuration	string	A configuração do bucket no formato XML ou JSON.
--resource-group-id	string	O ID do grupo de recursos.

Nota

O comando put-bucket fornece acesso à operação PutBucket. Para obter mais informações sobre a operação da API, consulte PutBucket.

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

Nota

Para obter mais informações, consulte Opções de linha de comando.

Exemplos

Crie um bucket chamado examplebucket.

ossutil api put-bucket --bucket examplebucket

Crie o examplebucket com ACL privada, 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\"}"