July 30, 2023

tS3BucketCreate – Docs for ESB 7.x

tS3BucketCreate

Creates a bucket on Amazon S3.

“Bucket” is a term used by AWS for top level folders on S3, which
can contain sub folders and store all your data (objects).

tS3BucketCreate Standard properties

These properties are used to configure tS3BucketCreate running in the Standard Job
framework.

The Standard
tS3BucketCreate component belongs to the Cloud family.

The component in this framework is available in all Talend
products
.

Basic settings

Use existing connection

Select this check box and in the Component List click the relevant connection component to
reuse the connection details you already defined.

Access Key

The Access Key ID that uniquely identifies an
AWS Account. For how to get your Access Key and Access Secret, visit Getting Your AWS Access
Keys
.

Secret Key

The Secret Access Key, constituting the
security credentials in combination with the access Key.

To enter the secret key, click the […] button next to
the secret key field, and then in the pop-up dialog box enter the password between double
quotes and click OK to save the settings.

Inherit credentials from AWS
role

Select this check box to obtain AWS security credentials
from Amazon EC2 instance metadata. To use this option, the Amazon EC2 instance must
be started and your Job must be running on Amazon EC2. For more information, see
Using an IAM Role to Grant
Permissions to Applications Running on Amazon EC2 Instances
.

Assume role

If you temporarily need some access permissions associated
to an AWS IAM role that is not granted to your user account, select this check box to
assume that role. Then specify the values for the following parameters to create a new
assumed role session.

Region

Specify the AWS region by selecting a region name from the
list or entering a region between double quotation marks (e.g. “us-east-1”) in the list. For more information about the AWS
Region, see Regions and Endpoints.

Bucket

Name of the bucket, namely the top level
folder, to create.

Die on error

This check box is cleared by default, meaning
to skip the row on error and to complete the process for error-free rows.

Advanced settings

Config client

Select this check box to configure client
parameters.

Client parameter: select
client parameters from the list.

Value: enter the
parameter value.

Not available when Use existing connection is selected.

STS Endpoint

Select this check box and in the field displayed, specify the
AWS Security Token Service endpoint, for example, sts.amazonaws.com, where session credentials are retrieved from.

This check box is available only when the Assume role check box is selected.

Access control

Select this check box to set the access control list (ACL) for the bucket.

With Access control selected, click the plus
button under the Access table to add a new line,
where you can add an AWS user account and set permissions for it as
follows.

  • Enter the canonical user ID or the Email address of the
    user in double quotation marks in the Account canonical ID / email column;
  • Select the check box in the List objects column
    to grant the permission to list the objects in the bucket created;
  • Select the check box in the Write objects column
    to grant the permission to create, overwrite, and remove the objects in
    the bucket created;
  • Select the check box in the Read bucket
    permissions
    column to grant the permission to read the ACL
    of the bucket created;
  • Select the check box in the Write bucket
    permissions
    column to grant the permission to write the
    ACL of the bucket created.
Note:

  • The string in the Account canonical ID / email column is
    considered as an Email address if it contains @.
  • If Access control is not
    selected, the user who creates a bucket becomes the owner of the bucket
    and owns all the permissions over the bucket.
  • If Access control is selected,
    the user who creates a bucket becomes the owner of the bucket but owns no
    permission over the bucket. You can grant permissions to the owner in the
    Access table in the way mentioned above.
  • AWS group is not supported.

tStatCatcher Statistics

Select this check box to collect log data at
the component level.

Global Variables

ERROR_MESSAGE

The error message generated by the component when an error occurs. This is an After
variable and it returns a string. This variable functions only if the Die on
error
check box is selected.

Usage

Usage rule

This component can be used alone or with other
S3 components, e.g. tS3BucketExist.

Dynamic settings

Click the [+] button to add a row in the table
and fill the Code field with a context
variable to choose your database connection dynamically from multiple
connections planned in your Job. This feature is useful when you need to
access database tables having the same data structure but in different
databases, especially when you are working in an environment where you
cannot change your Job settings, for example, when your Job has to be
deployed and executed independent of Talend Studio.

Once a dynamic parameter is defined, the Component List box in the Basic
settings
view becomes unusable.

For examples on using dynamic parameters, see Reading data from databases through context-based dynamic connections and Reading data from different MySQL databases using dynamically loaded connection parameters. For more information on Dynamic
settings
and context variables, see Talend Studio
User Guide.

Related scenario


Document get from Talend https://help.talend.com
Thank you for watching.
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x