DescribeObject - AWS Elemental MediaStore


Gets the headers for an object at the specified path.

Request Syntax

HEAD /Path+ HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


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 ETag: ETag Content-Type: ContentType Content-Length: ContentLength Cache-Control: CacheControl Last-Modified: LastModified

Response Elements

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

The response returns the following HTTP headers.


An optional CacheControl header that allows the caller to control the object's cache behavior. Headers can be passed in as specified in the HTTP at

Headers with a custom user-defined value are also accepted.


The length of the object in bytes.

Valid Range: Minimum value of 0.


The content type of the object.

Pattern: ^[\w\-\/\.\+]{1,255}$


The ETag that represents a unique instance of the object.

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

Pattern: [0-9A-Fa-f]+


The date and time that the object was last modified.


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


The specified container was not found for the specified account.

HTTP Status Code: 404


The service is temporarily unavailable.

HTTP Status Code: 500


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

HTTP Status Code: 404



The following request gets the headers for the file mlaw.avi from the folder premium/canada in the container that is identified by the endpoint that is specified in the Host: header.

HEAD premium/canada/mlaw.avi Host: 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

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: