Service operation


This section illustrates the adapter requests and responses for the Service operation and describes the elements used in the request.

Use the <items> element when you call an adapter from an out-of-the-box process in BMC Atrium Orchestrator Development Studio. Use the adapter request XML when you create a custom process by using the Call Adapter activity in BMC Atrium Orchestrator Development Studio.

List All My Buckets operation

The List All My Buckets operation returns a list of all the buckets owned by the sender of the request.

Note

Even if you specify the <endpoint-address> for a specific region, the List All My Buckets operation lists all the buckets in the various regions assigned to that user.

The following figure shows the <items> XML element for the List All My Buckets operation:

<items>
<item>
<parameters>
</parameters>
</item>
</items>

The following figure shows a sample adapter request for the List All My Buckets operation:

<amazon-s3-request>
<secret-access-key />
<operation-name>list-all-my-buckets</operation-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: list-all-my-buckets

Yes

The following figure shows a sample adapter response for the List All My Buckets operation:

<amazon-s3-response>
<metadata>
   <status>success</status>
 </metadata>
 <ListAllMyBucketsResponse>
   <Owner>
     <ID>f7fd1a1bae4c700bf452ad628f5bc4787a52cca4d33bf2509b3364237143892d</ID>
     <DisplayName>invincible99</DisplayName>
   </Owner>
   <Buckets>
     <Bucket>
       <Name>MakeMyBucket</Name>
       <CreationDate>2011-04-15T04:44:20.000Z</CreationDate>
     </Bucket>
     <Bucket>
       <Name>TestBucket</Name>
       <CreationDate>2011-04-07T09:37:05.000Z</CreationDate>
     </Bucket>
     <Bucket>
       <Name>bmc-bucket-5e2373e2-b660-45dc-9db6-fd3bbfe5c04d</Name>
       <CreationDate>2011-04-12T10:13:46.000Z</CreationDate>
     </Bucket>
     <Bucket>
       <Name>kaar</Name>
       <CreationDate>2011-04-12T09:11:43.000Z</CreationDate>
     </Bucket>
   </Buckets>
</ListAllMyBucketsResponse>
</amazon-s3-response>

 

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