tGSBucketCreate Standard properties

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.

• Service account: authenticate using a Google account that is associated with your Google Cloud Platform project. When selecting this mode, the parameter to be defined is Service account key.
• Application Default Credentials: authenticate using the Application Default Credentials. When selecting this mode, no additional parameters need to be defined as credentials are automatically found based on the application environment.
• OAuth Access Token: authenticate using an OAuth access token. When selecting this mode, the parameter to be defined is OAuth Access Token.

To know more about the Google Cloud authentication process, read the Google Cloud documentation.

Click the [...] button next to the service account key field to browse for the JSON file that contains your service account key.

This property is only available when you authenticate using Service account.

The lifetime of the token is one hour. The component does not perform the token refresh operation but will fetch the new access token to operate beyond the one-hour limit.

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 Bucket names in the Google Cloud documentation.

Special configure

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

Project ID

When the credential type is set to OAuth Access Token, specify the project ID to which the new bucket belongs.

Location and access control

Select from the list the location where the new bucket will be created. Europe and US are available for all credential types and ASIA only for Service account and OAuth Access Token. 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 Overview of access control in the Google Cloud documentation.

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.

When selected, enter the URL in the Google Storage Private API URL property, by respecting the following format: "https://storage.goggleapis.com".

For more information, see Access Google APIs through endpoints from Google documentation.

This property is only available when you authenticate using Service account and Application Default Credentials.

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 more information about variables, see Using contexts and variables.

Usage rule

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