Todos os produtos
Search
Central de documentação

Object Storage Service:delete-multiple-objects

Última atualização: Jul 03, 2026

Exclui vários objetos do mesmo bucket.

Observações de uso

  • Contas Alibaba Cloud podem excluir tags de objetos por padrão. Usuários RAM e STS exigem a permissão oss:DeleteObject. Para mais informações, consulte Conceder uma política personalizada.

  • Uma única chamada exclui até 1.000 objetos.

  • Não é possível recuperar objetos excluídos. Proceda com cautela.

Sintaxe do comando

ossutil api delete-multiple-objects --bucket value --delete value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--delete

string

Configuração de exclusão no formato XML ou JSON.

--encoding-type

string

Tipo de codificação para nomes de objetos na resposta.

Nota

Este comando corresponde à API DeleteMultipleObjects. Para obter detalhes sobre os parâmetros, consulte DeleteMultipleObjects.

--delete

A opção --delete aceita os formatos XML e JSON. Use o prefixo 'file://' para carregar a configuração de um arquivo.

  • Formato XML:

    <Delete>
        <Quiet>false</Quiet>
        <Object>
            <Key>string</Key>
            <VersionId>string</VersionId>
        </Object>
        <Object>
            <Key>string</Key>
            <VersionId>string</VersionId>
        </Object>
    </Delete>
  • Formato JSON:

    {
      "Quiet": "false",
      "Object": [
        {
          "Key": "string",
          "VersionId": "string"
        },
        {
          "Key": "string",
          "VersionId": "string"
        }
      ]
    }
Nota

Todas as opções globais compatíveis estão documentadas em Opções de linha de comando.

Exemplos

  • Exclua vários objetos em examplebucket.

    • Crie um arquivo chamado delete.xml:

      <?xml version="1.0" encoding="UTF-8"?>
      <Delete>
          <Quiet>false</Quiet>
          <Object>
              <Key>multipart.data</Key>
          </Object>
          <Object>
              <Key>test.jpg</Key>
          </Object>
      </Delete>

      Comando de exemplo:

      ossutil api delete-multiple-objects --bucket examplebucket --delete file://delete.xml
    • Crie um arquivo chamado delete.json:

      {
        "Quiet": "false",
        "Object": [
          {
            "Key": "multipart.data"
          },
          {
            "Key": "test.jpg"
          }
        ]
      }

      Comando de exemplo:

      ossutil api delete-multiple-objects --bucket examplebucket --delete file://delete.json
    • Forneça os parâmetros diretamente como JSON:

      ossutil api delete-multiple-objects --bucket examplebucket --delete "{\"Quiet\":\"false\",\"Object\":[{\"Key\":\"multipart.data\"},{\"Key\":\"test.jpg\"}]}"
  • Exclua versões específicas de objetos em examplebucket.

    • Crie um arquivo chamado delete.xml:

      <?xml version="1.0" encoding="UTF-8"?>
      <Delete>
          <Quiet>false</Quiet>
          <Object>
              <Key>multipart.data</Key>
          </Object>
          <Object>
              <Key>test.jpg</Key>
          </Object>
      </Delete>

      Comando de exemplo:

      ossutil api delete-multiple-objects --bucket examplebucket --delete file://delete.xml
    • Crie um arquivo chamado delete.json:

      {
        "Quiet": "false",
        "Object": [
          {
            "Key": "multipart.data",
            "VersionId": "CAEQNRiBgIDyz.6C0BYiIGQ2NWEwNmVhNTA3ZTQ3MzM5ODliYjM1ZTdjYjA4****"
          },
          {
            "Key": "test.jpg",
            "VersionId": "CAEQMhiBgIDB3aWB0BYiIGUzYTA3YzliMzVmNzRkZGM5NjllYTVlMjYyYWEy****"
          }
        ]
      }

      Comando de exemplo:

      ossutil api delete-multiple-objects --bucket examplebucket --delete file://delete.json
    • Forneça os parâmetros diretamente como JSON:

      ossutil api delete-multiple-objects --bucket examplebucket --delete "{\"Quiet\":\"false\",\"Object\":[{\"Key\":\"multipart.data\",\"VersionId\":\"CAEQNRiBgIDyz.6C0BYiIGQ2NWEwNmVhNTA3ZTQ3MzM5ODliYjM1ZTdjYjA4****\"},{\"Key\":\"test.jpg\",\"VersionId\":\"CAEQMhiBgIDB3aWB0BYiIGUzYTA3YzliMzVmNzRkZGM5NjllYTVlMjYyYWEy****\"}]}"