Todos os produtos
Search
Central de documentação

Object Storage Service:rm (exclua)

Última atualização: Jul 03, 2026

Utilize o comando rm para excluir arquivos que não são mais necessários.

Formato do comando

ossutil rm oss://bucket[/prefix] [flags]

Parâmetro

Tipo

Descrição

prefix

string

Uma pasta ou um prefixo específico no bucket.

--all-versions

/

Especifique todas as versões de um objeto.

-d, --dirs

/

Lista os arquivos e subdiretórios no diretório atual em vez de listar recursivamente todos os arquivos em todos os subdiretórios.

--encoding-type

string

O codec para nomes de objetos ou nomes de arquivos. Valor válido: url.

--end-with

string

Retorna objetos que estão alfabeticamente antes ou iguais ao valor especificado.

--exclude

stringArray

As regras de exclusão para caminhos ou nomes de arquivos.

--exclude-from

stringArray

Lê regras de exclusão de um arquivo de regras.

--files-from

stringArray

Lê uma lista de nomes de arquivos de source de um arquivo. Linhas vazias ou linhas de comentário são ignoradas.

--files-from-raw

stringArray

Lê uma lista de nomes de arquivos de source de um arquivo.

--filter

stringArray

As regras de filtragem para caminhos ou nomes de arquivos.

--filter-from

stringArray

Lê regras de filtragem de um arquivo de regras.

-f, --force

/

Força a operação sem solicitar confirmação.

--include

stringArray

As regras de inclusão para caminhos ou nomes de arquivos.

--include-from

stringArray

Lê regras de inclusão de um arquivo de regras.

--limited-num

int

O número máximo de resultados a serem retornados.

--list-objects

/

Usa a operação ListObjects para listar objetos.

--max-size

SizeSuffix

O tamanho máximo de um arquivo a ser transferido. A unidade padrão é byte. É possível usar sufixos como B, K, M, G, T ou P. 1 K (KiB) = 1024 B.

--metadata-exclude

stringArray

As regras de exclusão para metadados de objetos.

--metadata-filter

stringArray

As regras de filtragem para metadados de objetos.

--metadata-filter-from

stringArray

Lê regras de filtragem de metadados de objetos de um arquivo de regras.

--metadata-include

stringArray

As regras de inclusão para metadados de objetos.

--min-age

Duration

Exclui apenas arquivos modificados antes do intervalo de tempo especificado. A unidade padrão é segundo. Use um sufixo para definir a unidade. Por exemplo, 1h indica 1 hora.

Nota

--min-age 1h exclui apenas arquivos modificados há 1 hora ou mais.

--max-age

Duration

Exclui apenas arquivos modificados dentro do intervalo de tempo especificado. A unidade padrão é segundo. Use um sufixo para definir a unidade. Por exemplo, 1h indica 1 hora.

Nota

--max-age 1h exclui apenas arquivos modificados na última hora.

--min-mtime

Time

Exclui apenas arquivos modificados após o horário especificado. O horário deve estar no formato UTC. Por exemplo, 2006-01-02T15:04:05.

Nota

--min-mtime "2006-01-02T15:04:05" exclui apenas arquivos modificados após as 15:04:05 de 2 de janeiro de 2006.

--max-mtime

Time

Exclui apenas arquivos modificados antes do horário especificado. O horário deve estar no formato UTC. Por exemplo, 2006-01-02T15:04:05.

--min-size

SizeSuffix

O tamanho mínimo de um arquivo a ser transferido. A unidade padrão é byte. É possível usar sufixos como B, K, M, G, T ou P. 1 K (KiB) = 1024 B.

-m, --multipart

/

Exclui todos os fragmentos de uploads multipart que não foram concluídos ou cancelados.

--page-size

int

O número máximo de objetos a serem listados por página durante o processamento em lote. O valor deve estar entre 1 e 1000. O valor padrão é 1000.

-r, --recursive

/

Execute a operação recursivamente. Se você especificar esta opção, o comando será executado em todos os objetos correspondentes no bucket. Caso contrário, o comando será executado apenas no objeto especificado pelo caminho.

--request-payer

string

O método de pagamento da solicitação. Defina este parâmetro como requester se você usar o modo de pagamento pelo solicitante.

--start-after

string

Retorna objetos que estão alfabeticamente após o valor especificado.

--version-id

string

O ID da versão do objeto.

Nota

Para obter mais informações, consulte Opções de linha de comando.

Exemplos

  • Exclua o arquivo exampleobject.txt do bucket examplebucket.

    ossutil rm oss://examplebucket/exampleobject.txt
  • Exclua todos os arquivos com o prefixo "test" do bucket examplebucket.

    ossutil rm oss://examplebucket/test -r
  • Exclua todos os arquivos com a extensão .png do bucket examplebucket.

    ossutil rm oss://examplebucket  --include "*.png" -r
  • Exclua arquivos do bucket examplebucket que atendam a qualquer uma das seguintes condições:

    • O nome do arquivo contém a string "abc".

    • A extensão do nome do arquivo não é .jpg.

    • A extensão do nome do arquivo não é .txt.

    ossutil rm oss://examplebucket  --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -r
  • Exclua uma versão específica do arquivo exampleobject.txt do bucket examplebucket com versionamento ativado.

    ossutil rm oss://examplebucket/exampleobject.txt --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****
  • Exclua todas as versões do arquivo exampleobject.txt do bucket examplebucket com versionamento ativado.

    ossutil rm oss://examplebucket/exampleobject.txt --all-versions -r
  • Exclua todas as versões de todos os objetos do bucket examplebucket com versionamento ativado.

    ossutil rm oss://examplebucket --all-versions -r
  • Exclua todos os fragmentos de uploads multipart que não foram concluídos ou cancelados.

    ossutil rm oss://examplebucket -m -r -f