DeleteObject (API SOAP)

nota

As APIs SOAP para o Amazon S3 não estão disponíveis para novos clientes e chegam ao fim da vida útil (EOL) em 31 de agosto de 2025. Recomendamos usar a API REST ou os AWS SDKs.

A operação DeleteObject remove o objeto especificado do Amazon S3. Depois de excluído, não há método para restaurar ou recuperar um objeto.

nota

Se você excluir um objeto que não existe, o Amazon S3 retornará um sucesso (não uma mensagem de erro).

exemplo

Este exemplo exclui o objeto "Nelson" do bucket "quotes".

Sample Request

<DeleteObject xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <Bucket>quotes</Bucket>
  <Key>Nelson</Key>
  <AWSAccessKeyId> AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</DeleteObject>

Sample Response

<DeleteObjectResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <DeleteObjectResponse>
    <Code>200</Code>
    <Description>OK</Description>
  </DeleteObjectResponse>
</DeleteObjectResponse>

Elementos

• Bucket: O bucket que contém o objeto.

• Key: A chave que identifica o objeto.

Controle de acesso

Você só pode excluir um objeto se tiver acesso WRITE ao bucket, independentemente de quem é o proprietário do objeto ou de quais direitos são concedidos a ele.