tGSBucketCreate – Docs for ESB 5.x

Component Family

Big Data / Google Cloud Storage

Function

tGSBucketCreate creates a new
bucket in Google Cloud Storage.

Purpose

tGSBucketCreate allows you to
create a new bucket which you can use to organize data and control
access to data in Google Cloud Storage.

Basic settings

Use an 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 and Secret Key

Type in the authentication information obtained from Google for
making requests to Google Cloud Storage.

These keys can be consulted on the Interoperable Access tab view
under the Google Cloud Storage tab of the project from the Google
APIs Console.

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.

For more information about the access key and secret key, go to
https://developers.google.com/storage/docs/reference/v1/getting-startedv1?hl=en/
and see the description about developer keys.

Bucket configuration

Bucket name

Specify the name of the bucket which you want to create. Note that
the bucket name must be unique across the Google Cloud Storage
system.

For more information about the bucket naming convention, see https://developers.google.com/storage/docs/bucketnaming.

Special configure

Select this check box to provide the additional configuration for
the bucket to be created.

Project ID

Specify the project ID to which the new bucket belongs.

Location

Select from the list the location where the new bucket will be
created. Currently, Europe and
US are available. By default,
the bucket location is in the US.

Note that once a bucket is created in a specific location, it
cannot be moved to another location.

Acl

Select from the list the desired access control list (ACL) for the
new bucket.

Depending on the ACL on the bucket, the access requests from users
may be allowed or rejected. If you do not specify a predefined ACL
for the new bucket, the predefined project-private ACL applies.

For more information about ACL, see https://developers.google.com/storage/docs/accesscontrol?hl=en.

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

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the
Job level as well as at each 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
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio
User Guide.

Usage

This component can be used together with the tGSBucketList component to check if a new bucket is
created successfully.

Log4j

The activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User
Guide.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.

Limitation

n/a