GetObject
Retrieves objects from an S3 bucket. For larger object download, use the range-based Get Object API.
Request Syntax
GET /bucket/Key+?partNumber=PartNumber&versionId=VersionId HTTP/1.1 Host: msdps3.server:8443 Range: Range
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
Request Headers
Range
Returns the specified range bytes of object.
Type: Integer
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 x-amz-storage-class: StorageClass Body
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 the 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-storage-class
Specifies the storage class of the returned object.
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.
EntityTooLarge
Your proposed upload exceeds the maximum allowed object size.
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.