Spectra Logic
1-800-833-1132 : 1-303-449-6400


Amazon S3 Operations : Amazon S3 Object Operations : Put Object

Put Object
Description
Create an S3 object in a bucket. Include the data for the object with your request. Spectra Logic recommends using Spectra S3 requests to create a PUT job rather than using this request stand alone in a strict Amazon S3 manner. This is particularly important when putting many small objects or putting very large objects that must be broken up for physical placement.
This is an Amazon S3 compatible operation with additional request parameters. The job and offset parameters should always be used when doing a PUT object as part of a bulk PUT job (see Processing a Bulk PUT Job). If not using the job and offset parameters, the maximum object length is 1 TB (1,099,511,627,776 bytes).
See Put Object for Amazon S3 operation details.
Requests
Syntax
PUT http[s]://{datapathDNSname}/{bucket_name}/{object_name}[?job={string}][&offset={64‑bit integer}]
{object_name} must follow the Amazon S3 naming restrictions. See Object Key and Metadata for more information.
Request Parameters
Request Header
The client-side checksum is passed to the BlackPearl system by supplying the applicable CRC HTTP header (see Common Request Header Elements). If this is done, the BlackPearl system verifies that the data received matches the checksum provided. End-to-end data protection requires that the client provide the CRC when uploading the object and then verify the CRC after downloading the object at a later time (see Get Object). The BlackPearl system also verifies the CRC when reading from physical data stores so the system can identify problems before transmitting data to the client.
Responses
Response Elements
The operation returns status only.
Notable status codes:
§
§
Example
Sample Request
This request creates the object named “object1” in the bucket “bucket1”.
PUT http://blackpearl-hostname/bucket1/object1 HTTP/1.1
Sample Response
HTTP/1.1 200 OK