HeadObject
Retrieves metadata from an object without returning the object itself. This operation is used when you are interested only in an object's metadata.
Request Syntax
HEAD /bucket/Key+?partNumber=PartNumber&versionId=VersionId HTTP/1.1 Host: msdps3.server:8443
Request Parameters
Bucket
Name of the bucket.
Required: Yes
Type: String
Key
Name of the object.
Required: Yes
Type: String
partNumber
Number of the part of the object that is being read. This is a positive integer between 1 and 10,000.
Type: Integer
versionId
Version ID of object.
Type: String
Response Syntax
HTTP/1.1 200 x-amz-delete-marker: DeleteMarker accept-ranges: AcceptRanges Last-Modified: LastModified Content-Length: ContentLength ETag: ETag x-amz-version-id: VersionId Content-Range: ContentRange
Response Headers
x-amz-delete-marker
Specifies the object return is a delete marker or not. If the object is not a delete marker, this header does not get added in a response.
Last-Modified
The last modified time of the object.
Content-Length
Returned body size in bytes.
ETag
Specifies SHA256 of returned object.
x-amz-version-id
Specifies the version ID of returned object.
Content-Range
The range of object that is returned in response.
x-amz-object-lock-mode (Flex WORM only)
The Object Lock mode currently in place for this object.
Valid Values: GOVERNANCE, COMPLIANCE
x-amz-object-lock-retain-until-date (Flex WORM only)
The date and time when this object's Object Lock expires.
x-amz-meta-msdps3-object-creator
The API used to upload the object. The value PutGroupObject means that "PutObject with the header x-amz-meta-snowball-auto-extract."
Valid Values: PutObject, PutGroupObject, UploadPart
Possible Error Response
Success
HTTP status code 200.
InvalidArgument
Invalid Argument. Invalid version ID specified.
HTTP status code 400.
AccessDenied
Request was rejected because user authentication failed.
HTTP status code 403.
NoSuchKey
The specified key does not exist.
HTTP status code 404.
NoSuchBucket
The specified bucket does not exist.
HTTP status code 404.
InternalError
Request failed because of an internal server error.
HTTP status code 500.