Todos os produtos
Search
Central de documentação

Object Storage Service:Search for objects

Última atualização: Sep 24, 2026

Se um bucket contiver muitos objetos, você pode usar o OSS para localizá-los rapidamente especificando um prefixo.

Limites

  • Regras de pesquisa

    A pesquisa de objetos é feita pelo prefixo do nome. A string de pesquisa diferencia maiúsculas de minúsculas e não pode conter barra (/).

  • Resultados da pesquisa

    Ao pesquisar por prefixo no diretório raiz de um bucket ou em uma pasta específica, os resultados exibem apenas os arquivos ou subpastas correspondentes. Não é possível visualizar os arquivos dentro das subpastas.

    Nota

    Para pesquisar arquivos ou pastas de forma recursiva em um bucket, utilize a API GetBucket (ListObjects) ou o ls command of the ossutil command-line tool.

Procedimento

Use the OSS console

  1. Faça login no OSS console.

  2. No painel de navegação à esquerda, clique em Buckets. Na página exibida, clique no nome do bucket desejado.

  3. No painel de navegação à esquerda, escolha Object Management > Objects.

  4. Pesquise os arquivos.

    • Pesquisar um arquivo ou pasta específica no diretório raiz do bucket

      Insira um prefixo na caixa de pesquisa e pressione Enter ou clique no ícone search. Em seguida, visualize os arquivos e pastas no diretório raiz que correspondem ao prefixo.

      O exemplo a seguir mostra os resultados da pesquisa de objetos com o prefixo Example no bucket TestBucket.

      File structure                     Specified prefix      Search results
      TestBucket                         Example               Examplesrcfolder1                          
          └── Examplesrcfolder1                                Exampledestfolder.png                           
                 ├── test.txt                                
                 ├── abc.jpg
          └── Exampledestfolder.png
          └── example.txt
    • Pesquisar um arquivo ou subpasta específica em uma pasta de destino

      Clique na pasta de destino. Em seguida, insira um prefixo na caixa de pesquisa e pressione Enter ou clique no ícone search. Os arquivos e subpastas da pasta de destino que correspondem ao prefixo serão exibidos.

      O exemplo a seguir mostra os resultados da pesquisa de objetos com o prefixo Project na pasta Examplesrcfolder1.

      File structure                Specified prefix       Search results
      Examplesrcfolder1           Project                Projectfolder
          └── Projectfolder                              ProjectA.jpg
                ├── a.txt                                ProjectB.doc
                ├── b.txt
          └── ProjectA.jpg
          └── ProjectB.doc
          └── projectC.doc

Use the ossbrowser GUI tool

O ossbrowser oferece suporte a operações no nível de bucket semelhantes às do OSS console. Para realizar um upload simples, siga as instruções na interface do ossbrowser. Para mais informações sobre como usar o ossbrowser, consulte ossbrowser 2.0.