• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (Swift)
  4. Operations on Objects
  5. Delete Object
  6. Request

Request

Method

Table 1 Method description

Method

URI

Description

DELETE

/v1/{account}/{container}/{object}{?multipart-manifest}

Permanently deletes an object from the OBS system.

{account} indicates the name of an account.

{container} indicates the name of a container.

{object} indicates the name of an object.

This operation does not involve a request body.

Example Request

Delete the helloworld object from the marktwain container.

curl -i $publicURL/
marktwain/helloworld -X DELETE -H "X-Auth-Token: $token"

Request Query Parameters

Header

Type

Description

multipart-manifest

String

(Optional)

If you include the multipart-manifest=delete query parameter and the object is a static large object, the segment objects and the manifest object are deleted.

If you omit the multipart-manifest=delete query parameter, the manifest object is deleted and the segment objects are not deleted.

If this is a dynamic large object, do not specify multipart-manifest=delete query parameter.

Request Headers

Request URI parameters

Parameter

Type

Description

{account}

String

(Required)

Unique name of the account. In the current version, it indicates the unique ID of the account.

{container}

String

(Required)

Unique name of the container.

For details about container naming rules, see Naming Rules.

{object}

String

(Required)

Name of the object.

For details about object naming rules, see Object Naming Rules.

Table 2 Request header parameters

Header

Type

Description

X-Auth-Token

String

(Required)

Authentication token. If you omit this header, your request fails unless the account owner has granted you access through an ACL.