Prev

Next

Deleting an Object

Deleting an object removes the object key from your bucket and makes the object permanently irretrievable. Simply send an HTTP DELETE request to the URL that identifies the object you want to delete, including the required authentication information.

The following sample code snippets demonstrate deletion of an Amazon S3 object.

Java

To run the sample

Open the sample file.

Replace bucket-name with the name of your bucket and key-name with the name of the object to delete.

Response response = conn.delete("[bucket-name]", "[key-name]", null);

if (response.connection.getResponseCode() == 204) {

    // object was deleted

} else {

    // something bad happened

}

C#

To run the sample

Open the sample file.

Replace bucket-name with the name of your bucket and key-name with the name of the object to delete.

try {

    Response response = conn.delete("[bucket-name]", "[key-name]");

    response.Close();

} catch ( WebException ex ) {

    // Something bad happened

}

Perl

To run the sample

Open the sample file.

Replace bucket-name with the name of your bucket and key-name with the name of the object to delete.

$conn->delete("[bucket-name]", "[key-name]");



if ($response->http_response->code == 204) {

    # object was deleted

} else {

    # something bad happened

}

PHP

To run the sample

Open the sample file.

Replace bucket-name with the name of your bucket and key-name with the name of the object to delete.

$req =& new HTTP_Request("http://s3.amazonaws.com/[bucket-name]/[key-name]");

$req->setMethod("DELETE");

setAuthorizationHeader($req);

$req->sendRequest();



if ($req->getResponseCode() == 204) {

    // bucket was deleted

} else {

    // something bad happened

}

Ruby

To run the sample

Open the sample file.

Replace bucket-name with the name of your bucket and key-name with the name of the object to delete.

conn.delete("[bucket-name]", "[key-name]");



if response.http_response.status == 204

  # object was deleted

else

  # something bad happened

end

Python

To run the sample

Open the sample file.

Replace bucket-name with the name of your bucket and key-name with the name of the object to delete.

conn.delete("[bucket-name]", "[key-name]");



if response.http_response.status == 204:

    # object was deleted

else:

    # something bad happened

HTTP

The following is an example of an HTTP request.

# delete object request



DELETE /[bucket-name]/[key-name] HTTP/1.0

Date: Wed, 08 Mar 2006 04:06:19 GMT

Authorization: AWS [aws-access-key-id]:[header-signature]

Host: s3.amazonaws.com



# delete object response



HTTP/1.1 204 No Content

x-amz-id-2: RvtfYQa0bFoavLma0eYJ1tgK17N/N6AWs6VQOUBSdzNTXwTL5W9BGIxt+D6gK+7I

x-amz-request-id: 6F7B7DB829785419

Date: Wed, 08 Mar 2006 04:06:19 GMT

Connection: keep-alive

Server: AmazonS3

	Copyright Information