Menu
Amazon Simple Storage Service
API Reference (API Version 2006-03-01)

DELETE Object tagging

Description

This implementation of the DELETE operation uses the tagging subresource to remove the entire tag set from the specified object. For more information about managing object tags, see Object Tagging in the Amazon Simple Storage Service Developer Guide.

To use this operation, you must have permission to perform the s3:DeleteObjectTagging action.

To delete tags of a specific object version, add the versionId query parameter in the request. You will need permission for the s3:DeleteObjectVersionTagging action.

Requests

Syntax

Copy
DELETE ObjectKey/?tagging HTTP/1.1 Host: BucketName.s3.amazonaws.com Date: date Authorization: authorization string (see Authenticating Requests (AWS Signature Version 4))

Request Parameters

This implementation of the operation does not use request parameters.

Request Headers

This implementation of the operation uses only request headers that are common to all operations. For more information, see Common Request Headers.

Request Elements

This implementation of the operation does not use request elements.

Responses

Response Headers

This implementation of the operation uses only response headers that are common to most responses. For more information, see Common Response Headers.

Examples

Sample Request

The following DELETE request deletes the tag set from the specified object.

Copy
DELETE exampleobject/?tagging HTTP/1.1 Host: examplebucket.s3.amazonaws.com Date: Wed, 25 Nov 2016 12:00:00 GMT Authorization: signatureValue

Sample Response

The following successful response shows Amazon S3 returning a 204 No Content response. The tag set for the object has been removed.

Copy
HTTP/1.1 204 No Content Date: Wed, 25 Nov 2016 12:00:00 GMT Connection: close Server: AmazonS3

Related Resources