Put Object operation
The Put Object operation adds an object to the specified bucket. Unlike the Put Object Inline operation, the Put Object operation does not have any restrictions on the size of the file being added to the bucket.
The following figure shows the <items> XML element for the Put Object operation:
<item>
<parameters>
<bucket>TestBucket</bucket>
<key>PutObjectFile.mpg</key>
<file-name>C:\TEMP\PutObjectFile.mpg</file-name>
</parameters>
</item>
</items>
The following figure shows a sample adapter request for the Put Object operation:
<operation-name>put-object</operation-name>
<parameters>
<bucket>TestBucket</bucket>
<key>PutObjectFile.mpg</key>
<file-name>C:\TEMP\PutObjectFile.mpg</file-name>
</parameters>
</amazon-s3-request>
The following table describes the elements for the adapter request:
Element | Description | Required |
|---|---|---|
<wsdl-location> | Specifies the target WSDL URL for Amazon S3 | Conditional; required if not specified in the configuration |
<endpoint-address> | Specifies the web service endpoint to use for performing operations on Amazon S3 buckets across different regions
| No |
<aws-access-key-id> | Specifies the 20-character public access key ID that is included in an Amazon Web Service (AWS) service request to identify the user | Conditional; required if not specified in the configuration |
<secret-access-key> | Specifies the 40-character private identifier that is associated with the access key ID | Conditional; required if not specified in the configuration |
<operation-name> | Contains the name of the operation: put-object | Yes |
<bucket> | Specifies the name of the bucket to which you want to add the object | Yes |
<key> | Specifies the key that you want to assign to the object | Yes |
<file-name> | Specifies the name of the file to be added to the bucket | Yes |
The following figure shows a sample adapter response for the Put Object operation:
<metadata>
<status>success</status>
</metadata>
<PutObjectResponse>
<ETag>"3aa4369b5d760756a440773178c51612"</ETag>
<LastModified>2011-06-07T05:46:08.000Z</LastModified>
</PutObjectResponse>
</amazon-s3-response>