Todos os produtos
Search
Central de documentação

Object Storage Service:mkdir (criar um diretório)

Última atualização: Jul 03, 2026

Use o comando mkdir para criar diretórios e organizar objetos em um bucket.

Notas de uso

  • Para criar um diretório, você precisa das permissões oss:GetObject e oss:PutObject. Anexe uma política de acesso personalizada a um usuário RAM.

  • Para ossutil 1.6.16 e versões posteriores, use ossutil como nome do binário nos comandos. Não é necessário alterar o nome do binário com base no sistema operacional. Para versões anteriores a 1.6.16, use o nome do binário específico do sistema. Para mais informações, consulte Referência de comandos do ossutil.

Sintaxe do comando

ossutil mkdir oss://bucketname/dirname [--encoding-type <value>]

Os parâmetros e opções são os seguintes:

Parâmetro

Descrição

bucketname

O nome do bucket de destino.

dirname

O nome do diretório. Deve terminar com uma barra (/). Se você não adicionar uma barra (/), o ossutil adiciona automaticamente.

--encoding-type

Tipo de codificação da chave, que corresponde ao nome do diretório após oss://bucket_name. Valor válido: url. Padrão: sem codificação.

Exemplos

Crie um diretório e faça upload de um objeto para ele.

  1. Crie um diretório.

    • Criar um diretório de nível único

      ossutil mkdir oss://examplebucket/dir/

      A saída a seguir indica que o diretório dir/ foi criado no bucket examplebucket.

      0.385877(s) elapsed
    • Criar um diretório de vários níveis

      Crie diretórios de vários níveis para classificar melhor os objetos. Exemplo: crie um diretório Photo/2021/ no examplebucket:

      ossutil mkdir oss://examplebucket/Photo/2021/ 

      Se você excluir 2021/ e Photo/ não contiver outros objetos, Photo/ também será removido.

  2. Faça upload de um objeto para o diretório de destino

    Faça upload de exampleobject.txt para o diretório dir/ no examplebucket:

    ossutil cp exampleobject.txt oss://examplebucket/dir/

    A saída a seguir indica que o arquivo foi carregado no diretório de destino.

    Succeed: Total num: 1, size: 0. OK num: 1(upload 1 files).
    
    average speed 0(byte/s)

Opções comuns

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

Exemplo: crie o diretório dir/ no examplebucket, que está na região China (Hangzhou) sob uma conta Alibaba Cloud diferente:

ossutil mkdir oss://examplebucket/dir/ -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Opções comuns.