Todos os produtos
Search
Central de documentação

Object Storage Service:Search for objects

Última atualização: Jul 03, 2026

Se um bucket contiver muitos objetos, use o OSS para localizá-los rapidamente ao especificar um prefixo.

Limites

  • Regras de pesquisa

    É possível pesquisar objetos 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 arquivos ou subpastas correspondentes. Não é possível visualizar os arquivos dentro das subpastas.

    Nota

    Para pesquisar recursivamente arquivos ou pastas em um bucket, use a API GetBucket (ListObjects) ou o comando ls da ferramenta de linha de comando ossutil.

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 em o 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ífico no diretório raiz do bucket

      Insira um prefixo na caixa de pesquisa e pressione Enter ou clique em o ícone search. Em seguida, visualize os arquivos e pastas no diretório raiz correspondentes 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ífico em uma pasta de destino

      Clique em a pasta de destino. Em seguida, insira um prefixo na caixa de pesquisa e pressione Enter ou clique em o ícone search. Assim, você visualiza os arquivos e subpastas na pasta de destino correspondentes ao prefixo.

      O exemplo a seguir ilustra 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 executar um upload simples, siga as instruções na interface do ossbrowser. Para obter mais informações sobre como usar o ossbrowser, consulte ossbrowser 2.0.