DELETE Object

Last updated: 2019-12-16 17:49:23

PDF

Description

This API is used to delete an object from a COS bucket. To make this request, you need to have the permission to write to the bucket.

Notes

  • If an object you want to delete in a DELETE Object request does not exist, the request will still be successful and 204 No Content will be returned.
  • To use the DELETE Object API, you need to have Write access to the object.

Request

Sample Request

DELETE /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-Length: length
Authorization: Auth String

Authorization: Auth String (see Request Signature for more information).

Request Headers

Common Headers

The implementation of this operation uses common request headers. For more information on common request headers, see Common Request Headers.

Special Headers

This request does not use any special request header.

Request Body

The request body of this request is empty.

Response

Response Headers

Common Response Headers

This response uses common response headers. For more information on common response headers, see Common Response Headers.

Special Response Headers

This request does not use any special response header.

Response Body

The response body of this request is empty.

Error Analysis

The following describes some frequent special errors that may occur when you make this request:

Error Code HTTP Status Code Description
NoSuchBucket 404 Not Found The bucket does not exist

For more COS error codes or a complete list of errors, see Error Codes.

Example

Request

DELETE /exampleobject HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 23 Oct 2016 21:32:00 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484213409;32557109409&q-key-time=1484213409;32557109409&q-header-list=host&q-url-param-list=&q-signature=1c24fe260ffe79b8603f932c4e916a6cbb0af44a

Response

HTTP /1.1 204 No Content
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Wed, 23 Oct 2016 21:32:00 GMT
Server: tencent-cos
x-cos-request-id: NTg3NzRjYTRfYmRjMzVfMzFhOF82MmM3Yg==