Cloud Storage

1. In the Configure connector task dialog, click Entities.
2. Select the Objects entity and then select the List operation.
3. Click Done.

This lists all the objects in all the buckets. The objects are listed in the Connectors task's connectorOutputPayload response parameter.

1. In the Configure connector task dialog, click Entities.
2. Select the Objects entity and then select the List operation.
3. Click Done.
4. Set the filterClause to the bucket name from which you want to list the objects. To set the clause, in the Task Input section of the Connectors task, click filterClause and then enter Bucket = 'BUCKET_NAME' in the Default Value field. For example, Bucket = 'bucket_01'.

1. In the Configure connector task dialog, click Entities.
2. Select the Objects entity and then select the List operation.
3. Click Done.
4. Set the filterClause to the bucket name from which you want to list the objects. To set the clause, in the Task Input section of the Connectors task, click filterClause and then enter Name LIKE 'NAME%' AND Bucket = 'BUCKET_NAME' in the Default Value field.

   For example, Name LIKE 'Operations%' AND Bucket = 'OperationsBucket'.

1. In the Configure connector task dialog, click Entities.
2. Select the Buckets entity and then select the List operation.
3. Click Done.

1. In the Configure connector task dialog, click Actions.
2. Select the DownloadObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter a value similar to the following in the Default Value field:

   {
     "Bucket": "bucket-test-01",
     "ObjectFilePath": "logfile.txt"
   }

This example downloads the logfile.txt file. The downloaded file's content is available to you in JSON format in the Connectors task's connectorOutputPayload response parameter.

The steps to download a binary object are the same as downloading a regular object as previously described. Additionally, you must specify the HasBytes as true in the connectorInputPayload field. This downloads the object as a Base64 encoded string. Sample value for the connectorInputPayload field:

{
"Bucket": "bucket-test-01",
"ObjectFilePath": "image01.png",
"HasBytes" : true
}

If the download is successful, the output in the connectorOutputPayload field will be similar to the following:

{
"Success": "true",
"ContentBytes": "SGVsbG8gdGVzdCE\u003d"
}

By default, the HasBytes field is set to false.

If the file, contains special characters, such as ä, Ø, Thành, do the following:

1. Encode in UTF-8: Encode the file in UTF-8 to handle the special charecters.
2. Convert to Base64: Convert the file to Base64 to ensure that the original text remains intact.
3. Decode the Base64 string: Decode the file to Base64 string to retrieve the original value with the special characters.

1. In the Configure connector task dialog, click Actions.
2. Select the UploadObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "ContentBytes": "SGVsbG8gVGVzdCE=",
   "Bucket": "bucket-test-01",
   "ObjectName" : "test-file-01",
   "HasBytes": true
   }

This example creates the test-file-01 file in the bucket-test-01 bucket. If there is an existing file with the test-file-01 name, it's overwritten.

1. In the Configure connector task dialog, click Actions.
2. Select the UploadObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "Content": "Hello test!",
   "Bucket": "bucket-test-01",
   "ObjectName" : "test-file-01.txt"
   }

This example creates the test-file-01.txt file with the content Hello test! in the bucket-test-01 bucket. If there is an existing file with the test-file-01.txt name, it's overwritten.

1. In the Configure connector task dialog, click Actions.
2. Select the UploadObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "Content": "Hello test!",
   "Bucket": "bucket-test-01",
   "FolderPath": "folderA",
   "ObjectName": "test-file-01.txt"
   }

This example creates the test-file-01.txt file with the content Hello test! in the bucket-test-01's folderA folder. If the folder has an existing file with the test-file-01.txt name, it's overwritten.

1. In the Configure connector task dialog, click Actions.
2. Select the CopyObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "BucketSource": "bucket_01",
   "ObjectSource": "folderA/logfile.txt",
   "BucketDestination": "bucket_02",
   "ObjectDestination": "folderB/logfile.txt"
   }

This example copies the folderA/logfile.txt file from bucket_01 to folderB/logfile.txt in bucket_02.

If the copy is successful, the output in the connectorOutputPayload field will be similar to the following:

{
"Success": "true"
}

1. In the Configure connector task dialog, click Actions.
2. Select the MoveObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "BucketSource": "bucket_01",
   "ObjectSource": "folderA/logfile.txt",
   "BucketDestination": "bucket_02",
   "ObjectDestination": "folderB/logfile.txt"
   }

This example moves the folderA/logfile.txt file from bucket_01 to folderB/logfile.txt in bucket_02.

If the copy is successful, the output in the connectorOutputPayload field will be similar to the following:

{
"Success": "true"
}

1. In the Configure connector task dialog, click Actions.
2. Select the DeleteObject action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "BucketSource": "bucket_01",
   "ObjectSource": "logfile.txt"
   }

This example deletes the logfile.txt file from bucket_01.

If the copy is successful, the output in the connectorOutputPayload field will be similar to the following:

{
"Success": "true"
}

1. In the Configure connector task dialog, click Actions.
2. Select the SignURL action, and then click Done.
3. In the Task Input section of the Connectors task, click connectorInputPayload and then enter the following in the Default Value field:

   {
   "Bucket": "bucket-test-01",
   "ObjectName" : "test-file-01.txt"
   }

This example creates a signed URL for the test-file-01.txt file which is in the bucket-test-01 bucket. If the action is successful, you will get the signed URL in the response similar to the following:

{
"Success": "true",
"SignURL": "https://storage.googleapis.com/example-bucket/cat.jpeg?X-Goog-Algorithm=
GOOG4-RSA-SHA256&X-Goog-Credential=example%40example-project.iam.gserviceaccount.com
%2F20181026%2Fus-central1%2Fstorage%2Fgoog4_request&X-Goog-Date=20181026T18
1309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host&X-Goog-Signature=247a2aa45f16
9edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa849
6def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dc
c1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c2058
0e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a
66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823
a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b13344703
2ea7abedc098d2eb14a7"
}