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>