Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors Examples See Also

DeleteObject

Important

End of support notice: On November 13, 2025, AWS will discontinue support for AWS Elemental MediaStore. After November 13, 2025, you will no longer be able to access the AWS Elemental MediaStore console or AWS Elemental MediaStore resources. For more information, visit this blog post.

Deletes an object at the specified path.

Request Syntax


DELETE /Path+ HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Path

The path (including the file name) where the object is stored in the container. Format: <folder name>/<folder name>/<file name>

Length Constraints: Minimum length of 1. Maximum length of 900.

Pattern: (?:[A-Za-z0-9_=:\.\-\~]+/){0,10}[A-Za-z0-9_=:\.\-\~]+

Required: Yes

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

ContainerNotFoundException

The specified container was not found for the specified account.

HTTP Status Code: 404

InternalServerError

The service is temporarily unavailable.

HTTP Status Code: 500

ObjectNotFoundException

Could not perform an operation on an object that does not exist.

HTTP Status Code: 404

Examples

Example

The following request deletes the file mlaw.avi that is in the folder premium/canada:


DELETE premium/canada/mlaw.avi
Host: aaabbbcccdddee.files.mediastore-us-west-2.com
x-amz-Date: 20170323T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/mediastore/aws4_request,SignedHeaders=host;x-amz-date;x-amz-mediastore-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: 0
x-amz-mediastore-version: 2016-07-11