S3

Amazon Simple Storage Service (Amazon S3) is an object storage service offering industry-leading scalability, data availability, security, and performance.

s3 Integration

Description

<s3Integration> - command for integration with s3

Required parameters:

• alias - unique name of the integration
• enabled - a boolean flag to enable/disable integration
• truncate - a boolean flag to enable/disable that data will be cleared or not before each test run
• region - specifies the AWS region for S3
• endpoint - specifies the endpoint or URL for the S3
• accessKeyId - specifies a unique identifier for authentication
• secretAccessKey - specifies secret key for authentication

<s3Integration>

    <s3 alias="ALIAS_1" enabled="false" truncate="true">

        <region>REGION</region>

        <endpoint>http://URL</endpoint>

        <accessKeyId>ACCESS_KEY</accessKeyId>

        <secretAccessKey>SECRET_KEY</secretAccessKey>

    </s3>

    <s3 alias="ALIAS_2" enabled="false" truncate="false">

        <region>REGION</region>

        <endpoint>http://URL</endpoint>

        <accessKeyId>ACCESS_KEY</accessKeyId>

        <secretAccessKey>SECRET_KEY</secretAccessKey>

    </s3>

</s3Integration>

s3 command

Description

<s3> - command to interact with s3 integration

There are two types:

• file - to interact with files
• bucket - to interact with buckets

Required attribute for each type:

1. comment
2. alias

Optional attribute for each type:

1. condition - condition according to which this test step will or won't be executed
2. threshold - parameter, that sets the maximum allowed test step execution time

Required parameters according to the type:

1. bucket

   1. comment
      1. create - create a new bucket
      2. remove - remove existing bucket by name

2. file

   1. comment

   2. bucket

   3. key - unique key for a specific file in the selected bucket

      1. upload - upload any file by name that is in the same folder as the scenario

      2. download - download any file by selecting the key and comparing it according to the specified file or value

         1. file - comparison according to the specified file that is in the same folder as scenario
         2. value - comparison according to the specified value

      3. remove - remove any file by selected key

<s3 comment="s3 commands" alias="S3_0">

        <bucket comment="create bucket">

            <create>bucket-one</create>

        </bucket>

        <file comment="upload file"

              bucket="bucket-one"

              key="/test/upload_1.json">

            <upload>upload_1.json</upload>

        </file>

        <file comment="download file"

              bucket="bucket-one"

              key="/test/upload_1.json">

            <download>

                <file>expected_1.json</file>

            </download>

        </file>

        <file comment="remove file"

              bucket="bucket-one"

              key="/test/upload_1.json">

            <remove/>

        </file>

        <bucket comment="remove bucket">

            <remove>bucket-one</remove>

        </bucket>

    </s3>