tGSCopy 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.

Select the type to be used to authenticate to your project.

• HMAC key (deprecated): authenticate using Oauth credentials. When selecting this credential type, the parameters to be defined in the Basic settings view are Access Key and Secret Key.
• Service account: authenticate using a Google account. When selecting this credential type, the parameter to be defined in the Basic settings view is Service account key.
• OAuth Access Token: authenticate using an OAuth access token. When selecting this credential type, the parameter to be defined in the Basic settings view is OAuth Access Token.

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.

These two fields are available when the Use an existing connection check box is not selected and HMAC key (deprecated) is selected from the Credential type drop-down list.

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

This field is available when the Use an existing connection check box is not selected and Service account is selected from the Credential type drop-down list.

Enter an access token.

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

This field is available when the Use an existing connection check box is not selected and OAuth Access Token is selected from the Credential type drop-down list.

Source bucket name

Specify the name of the bucket from which you want to copy or move objects.

Source object key

Specify the key of the object to be copied.

Source is folder

Select this check box if the source object is a folder.

Target bucket name

Specify the name of the bucket to which you want to copy or move objects.

Target folder

Specify the target folder to which the objects will be copied or moved.

Action

Select the action that you want to perform on objects from the list.

• Copy: copies objects from the source bucket or folder to the target bucket or folder.

• Move: moves objects from the source bucket or folder to the target bucket or folder.

Rename

Select this check box and in the New name field enter a new name for the object to be copied or moved.

The Rename check box will not be available if you select the Source is folder check box.

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.

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

SOURCE_BUCKET: the source bucket name. This is an After variable and it returns a string.

SOURCE_OBJECTKEY: the key of a source object. This is an After variable and it returns a string.

DESTINATION_BUCKETNAME: the destination bucket name. This is an After variable and it returns a string.

DESTINATION_FOLDER: the destination folder. This is an After variable and it returns a string.

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 rule

This component can be used as a standalone component.