If the object to download is present in a child folder of a bucket, you must provide the full path of such object. For example, to downloadlogfile.txt that is present inbucket_01'sfolderA, the object path should befolderA/logfile.txt.

By default, theHasBytes field is set tofalse.

1. In theConfigure connector task dialog, clickEntities.
2. Select theObjects entity and then select theList operation.
3. ClickDone.

This lists all the objects in all the buckets. The objects are listed in theConnectors task'sconnectorOutputPayload response parameter.

1. In theConfigure connector task dialog, clickEntities.
2. Select theObjects entity and then select theList operation.
3. ClickDone.
4. Set thefilterClause to the bucket name from which you want to list the objects. To set the clause, in theTask Input section of theConnectors task, clickfilterClause and then enterBucket = 'BUCKET_NAME' in theDefault Value field. For example,Bucket = 'bucket_01'.

1. In theConfigure connector task dialog, clickEntities.
2. Select theObjects entity and then select theList operation.
3. ClickDone.
4. Set thefilterClause to the bucket name from which you want to list the objects. To set the clause, in theTask Input section of theConnectors task, clickfilterClause and then enterName LIKE 'NAME%' AND Bucket = 'BUCKET_NAME' in theDefault Value field.

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

1. In theConfigure connector task dialog, clickEntities.
2. Select theBuckets entity and then select theList operation.
3. ClickDone.

1. In theConfigure connector task dialog, clickActions.
2. Select theDownloadObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter a value similar to the following in theDefault Value field:

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

This example downloads thelogfile.txt file. The downloaded file's content is available to you in JSON format in theConnectors task'sconnectorOutputPayload response parameter.

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

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

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

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

By default, theHasBytes field is set tofalse.

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 theConfigure connector task dialog, clickActions.
2. Select theUploadObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

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

1. In theConfigure connector task dialog, clickActions.
2. Select theUploadObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

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

1. In theConfigure connector task dialog, clickActions.
2. Select theUploadObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

This example creates thetest-file-01.txt file with the contentHello test! in thebucket-test-01'sfolderA folder. If the folder has an existing file with thetest-file-01.txt name, it's overwritten.

1. In theConfigure connector task dialog, clickActions.
2. Select theCopyObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

This example copies thefolderA/logfile.txt file frombucket_01 tofolderB/logfile.txt inbucket_02.

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

{"Success":"true"}

1. In theConfigure connector task dialog, clickActions.
2. Select theMoveObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

This example moves thefolderA/logfile.txt file frombucket_01 tofolderB/logfile.txt inbucket_02.

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

{"Success":"true"}

1. In theConfigure connector task dialog, clickActions.
2. Select theDeleteObject action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

This example deletes thelogfile.txt file frombucket_01.

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

{"Success":"true"}

1. In theConfigure connector task dialog, clickActions.
2. Select theSignURL action, and then clickDone.
3. In theTask Input section of theConnectors task, clickconnectorInputPayload and then enter the following in theDefault Value field:

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

This example creates a signed URL for thetest-file-01.txt file which is in thebucket-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=20181026T181309Z&X-Goog-Expires=900&X-Goog-SignedHeaders=host&X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7"}