Todos os produtos
Search

Este produto

    Object Storage Service:mb

    Central de documentação

    Object Storage Service:mb

    Última atualização: Jul 03, 2026

    Buckets são contêineres de objetos no OSS. Execute o comando mb para criar um bucket antes de enviar objetos.

    Observações de uso

    Crie um bucket com opções de comando

    Sintaxe do comando

    ossutil mb oss://bucketname 
[--acl <value>]
[--storage-class <value>]
[--redundancy-type <value>]

    Parâmetros e opções:

    Parâmetro/Opção

    Descrição

    bucketname

    Nome do bucket. Deve ser globalmente exclusivo no OSS e não pode ser alterado após a criação.

    --acl

    ACL do bucket. Valores válidos:

    • private (padrão): Somente o proprietário do bucket tem permissão de leitura e gravação de objetos. Outros usuários não têm acesso.

    • public-read: Apenas o proprietário do bucket pode gravar objetos. Todos os usuários, incluindo anônimos, podem ler objetos. Essa configuração pode resultar em acesso não autorizado e custos inesperados. Use com cautela.

    • public-read-write: Qualquer usuário, inclusive anônimo, consegue ler e gravar objetos. Isso pode causar acesso indevido, cobranças imprevistas e riscos legais devido a uploads proibidos. Evite usar, exceto se for estritamente necessário.

    --storage-class

    Classe de armazenamento do bucket. Valores válidos:

    • Standard (padrão): Indicado para dados acessados frequentemente.

    • IA: Acesso Infrequente. Destinado a dados acessados uma ou duas vezes por mês. Período mínimo de armazenamento: 30 dias. Tamanho mínimo faturável: 64 KB. Oferece acesso em tempo real. Taxas de recuperação de dados são aplicáveis.

    • Archive: Projetado para armazenamento de longo prazo. Período mínimo de armazenamento: 60 dias. Tamanho mínimo faturável: 64 KB. Exige restauração antes do acesso (aproximadamente 1 minuto). Taxas de recuperação de dados são aplicáveis.

    • ColdArchive: Recomendado para armazenamento prolongado de dados raramente acessados. Período mínimo de armazenamento: 180 dias. Tamanho mínimo faturável: 64 KB. Requer restauração prévia para acesso. O tempo de restauração varia conforme o tamanho do objeto e o modo escolhido. Taxas de recuperação de dados são aplicáveis.

    Nota

    No OSS no CloudBox, apenas a classe de armazenamento Standard é compatível.

    Para mais informações sobre classes de armazenamento, consulte Classes de armazenamento.

    --redundancy-type

    Tipo de redundância do bucket. Valores válidos:

    • LRS (padrão): Armazenamento com redundância local. Armazena cópias em dispositivos distintos dentro da mesma zona, garantindo a confiabilidade dos dados mesmo em caso de falha simultânea de dois dispositivos.

    • ZRS: Armazenamento com redundância de zona. Distribui cópias dos dados por várias zonas na mesma região. Os dados permanecem acessíveis mesmo se uma zona ficar indisponível.

    Importante

    • O ZRS está disponível nas regiões: China (Shenzhen), China (Pequim), China (Hangzhou), China (Xangai), China (Hong Kong), Singapura e Indonésia (Jacarta). O ZRS aumenta os custos de armazenamento e não pode ser desativado após a ativação.

    • No OSS no CloudBox, este parâmetro não é compatível.

    Exemplos

    • Crie um bucket chamado examplebucket:

      ossutil mb oss://examplebucket

      Se nenhuma região for especificada, o bucket será criado na região mapeada para o endpoint definido no seu arquivo de configuração do ossutil. Por exemplo, se o endpoint for https://oss-cn-hangzhou.aliyuncs.com, o bucket será criado na região China (Hangzhou).

    • Crie um bucket chamado examplebucket com ACL definida como private, classe de armazenamento IA e tipo de redundância ZRS:

      ossutil mb oss://examplebucket --acl private --storage-class IA --redundancy-type ZRS

    • A saída abaixo indica que o bucket foi criado com sucesso:

      0.335189(s) elapsed

    Crie um bucket a partir de um arquivo XML

    Sintaxe do comando

    ossutil mb oss://bucketname local_xml_file

    Parâmetros:

    Parâmetro

    Descrição

    bucketname

    Nome do bucket.

    local_xml_file

    Caminho para um arquivo XML local contendo as configurações do bucket. Exemplo: localfile.xml.

    Exemplos

    1. Defina as configurações do bucket no arquivo localfile.xml.

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

    2. Crie um bucket utilizando o arquivo de configuração XML local:

      ossutil mb oss://examplebucket localfile.xml

    Opções comuns

    Para acessar um bucket em outra região, use -e para especificar o endpoint. Para acessar um bucket pertencente a outra conta Alibaba Cloud, utilize -i para o AccessKey ID e -k para o AccessKey secret.

    Por exemplo, crie um bucket chamado examplebucket na região China (Xangai) sob uma conta Alibaba Cloud diferente:

    ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

    Opções comuns.