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:

<items>
 <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:

<amazon-s3-request>
   <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
Example:
http://s3.amazonaws.com/doc/2006-03-01/AmazonS3.wsdl

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

Default: https://s3.amazonaws.com/soap: Endpoint in the US Standard region

Values for 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

The file must be present on the peer where the adapter is enabled.

Yes

The following figure shows a sample adapter response for the Put Object operation:

<amazon-s3-response>
 <metadata>
   <status>success</status>
 </metadata>
 <PutObjectResponse>
   <ETag>"3aa4369b5d760756a440773178c51612"</ETag>
   <LastModified>2011-06-07T05:46:08.000Z</LastModified>
 </PutObjectResponse>
</amazon-s3-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Content 24.3