Todos os produtos
Search
Central de documentação

Object Storage Service:Como fazer upload e download de diretórios no OSS?

Última atualização: Jun 23, 2026

Diferentemente dos sistemas de arquivos comuns, o Object Storage Service (OSS) armazena os dados como objetos em uma estrutura plana, e não hierárquica. Todos os dados no OSS ficam organizados como objetos em buckets. No entanto, o OSS oferece suporte a diretórios como conceito para agrupar objetos e simplificar o gerenciamento. No console do OSS, um diretório é um objeto cujo nome termina com uma barra (/), semelhante a um diretório no Windows. Este tópico descreve como fazer upload e download de diretórios no OSS.

Usar o console do OSS

  • Upload de um diretório: ao fazer upload de um diretório, arraste-o para a seção de upload. O upload mantém a estrutura do diretório. Para mais informações, consulte Fazer upload de arquivos.

  • Download de um diretório: o console do OSS não permite o download direto de diretórios. Você pode baixar vários objetos de um bucket para o diretório especificado criado no computador local. Para mais informações, consulte Baixar objetos.

Usar OSS SDKs

  • Upload de um diretório: os OSS SDKs não permitem o upload direto de diretórios. Para fazer upload de vários objetos para o mesmo diretório, especifique o mesmo prefixo para os objetos que deseja enviar e separe o prefixo dos nomes dos objetos com barras (/). Por exemplo, suponha que você deseja fazer upload dos arquivos locais example1.txt, example2.txt e example3.txt para o diretório dir. Este exemplo utiliza o OSS SDK for Java. Defina os nomes dos objetos como dir/example1.txt, dir/example2.txt e dir/example3.txt durante o upload.

  • Download de um diretório: os OSS SDKs não permitem o download direto de diretórios. No entanto, é possível baixar vários objetos para o mesmo diretório local. Por exemplo, suponha que você deseja baixar todos os objetos armazenados no diretório folder de um bucket para um diretório local chamado local.

    • Quando você conhece os objetos armazenados no diretório folder

      Por exemplo, o diretório folder contém dois objetos: example1.jpg e example2.jpg. Este exemplo utiliza o OSS SDK for Java. Ao baixar os objetos do diretório, defina os nomes dos objetos como folder/example1.jpg e folder/example2.jpg e os caminhos locais como local/folder/example1.jpg e local/folder/example2.jpg.

    • Quando você não conhece os objetos armazenados no diretório folder

      1. Consulte todos os objetos no diretório folder chamando a operação GetBucket (ListObjects).

      2. Especifique os nomes dos objetos e os caminhos locais completos com base no método anterior.

Para mais informações sobre o código de exemplo para fazer upload e download de diretórios no OSS usando OSS SDKs para diversas linguagens de programação, consulte Introdução.

Usar o ossbrowser

  • Upload de um diretório: no bucket ou diretório especificado, clique em Folder e selecione o diretório que deseja enviar. Também é possível arrastar o diretório para o ossbrowser. Para mais informações, consulte Operações comuns.

  • Download de um diretório: clique em Download na coluna Actions do diretório. Para mais informações, consulte Operações comuns.

Usar o ossutil

  • Upload de um diretório: especifique a opção -r ao fazer upload de um diretório. Para mais informações, consulte cp (upload de arquivos).

  • Download de um diretório: especifique a opção -r ao fazer download de um diretório. Para mais informações, consulte cp (download de arquivos).