DELETE Object
Description
The DELETE
operation removes the null version (if there is one) of an
object and inserts a delete marker, which becomes the latest version of the object. If
there isn't a null version, Amazon S3 does not remove any objects.
Versioning
To remove a specific version, you must be the bucket owner and you must use the
versionId
sub-resource. Using this sub-resource
permanently deletes the version. If the object deleted is a Delete Marker, Amazon S3
sets the response header, x-amz-delete-marker, to true
.
If the object you want to delete is in a bucket where the bucket versioning
configuration is MFA Delete enabled, you must include the x-amz-mfa
request header in the DELETE
verionId
request. Requests that include x-amz-mfa
must use HTTPS.
For more information about MFA Delete, go to
Requests
Syntax
DELETE /ObjectName
HTTP/1.1 Host:BucketName
.s3.amazonaws.com Date:date
Content-Length:length
Authorization:signatureValue
Request Parameters
This implementation of the operation does not use request parameters.
Request Headers
Name | Description | Required |
---|---|---|
x-amz-mfa
|
The value is the concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device. Type: String Default: None Condition: Required to permanently delete a versioned object if versioning is configured with MFA Delete enabled. |
Conditional |
Request Elements
This implementation of the operation does not use request elements.
Responses
Response Headers
Header | Description |
---|---|
x-amz-delete-marker |
Specifies whether the versioned object that was permanently
deleted was ( Type: Boolean Valid Values: Default: |
x-amz-version-id |
Returns the version ID of the delete marker created as a
result of the Type: String Default: None |
Response Elements
This implementation of the operation does not return response elements.
Special Errors
This implementation of the operation does not return special errors. For general information about Amazon S3 errors and a list of error codes, see Error Responses.
Examples
Sample Request
The following request deletes the object, my-second-image.jpg
.
DELETE /my-second-image.jpg HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 12 Oct 2009 17:50:00 GMT Authorization: AWS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE= Content-Type: text/plain
Sample Response
HTTP/1.1 204 NoContent x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7 x-amz-request-id: 0A49CE4060975EAC Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 0 Connection: close Server: AmazonS3
Sample Request Deleting a Specified Version of an Object
The following request deletes the specified version of the object, my-third-image.jpg
.
DELETE /my-third-image.jpg?versionId=UIORUnfndfiufdisojhr398493jfdkjFJjkndnqUifhnw89493jJFJ HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 12 Oct 2009 17:50:00 GMT Authorization: AWS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE= Content-Type: text/plain Content-Length: 0
Sample Response
HTTP/1.1 204 NoContent x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7 x-amz-request-id: 0A49CE4060975EAC x-amz-version-id: UIORUnfndfiufdisojhr398493jfdkjFJjkndnqUifhnw89493jJFJ Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 0 Connection: close Server: AmazonS3
Sample Response if the Object Deleted is a Delete Marker
HTTP/1.1 204 NoContent x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7 x-amz-request-id: 0A49CE4060975EAC x-amz-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY+MTRCxf3vjVBH40Nr8X8gdRQBpUMLUo x-amz-delete-marker: true Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 0 Connection: close Server: AmazonS3
Sample Request Deleting a Specified Version of an Object in an MFA-Enabled Bucket
The following request deletes the specified version of the object, my-third-image.jpg
, which is stored in an MFA-enabled bucket.
DELETE /my-third-image.jpg?versionId=UIORUnfndfiuf HTTP/1.1
Host: bucket.s3.amazonaws.com
Date: Wed, 12 Oct 2009 17:50:00 GMT
x-amz-mfa:[SerialNumber] [AuthenticationCode]
Authorization: AWS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=
Content-Type: text/plain
Content-Length: 0
Sample Response
HTTPS/1.1 204 NoContent x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7 x-amz-request-id: 0A49CE4060975EAC x-amz-version-id: UIORUnfndfiuf Date: Wed, 12 Oct 2009 17:50:00 GMT Content-Length: 0 Connection: close Server: AmazonS3