Cloud Storage

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona la entidad Objects y, a continuación, la operación List.
3. Haz clic en Listo.

Se mostrarán todos los objetos de todos los segmentos. Los objetos se enumeran en el parámetro de respuesta connectorOutputPayload de la tarea Connectors.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona la entidad Objects y, a continuación, la operación List.
3. Haz clic en Listo.
4. Asigna el valor filterClause al nombre del segmento del que quieras listar los objetos. Para definir la cláusula, en la sección Task Input de la tarea Connectors, haga clic en filterClause y, a continuación, introduzca Bucket = 'BUCKET_NAME' en el campo Valor predeterminado. Por ejemplo, Bucket = 'bucket_01'.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona la entidad Objects y, a continuación, la operación List.
3. Haz clic en Listo.
4. Asigna el valor filterClause al nombre del segmento del que quieras listar los objetos. Para definir la cláusula, en la sección Task Input de la tarea Connectors, haz clic en filterClause y, a continuación, introduce Name LIKE 'NAME%' AND Bucket = 'BUCKET_NAME' en el campo Valor predeterminado.

   Por ejemplo, Name LIKE 'Operations%' AND Bucket = 'OperationsBucket'.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona la entidad Buckets y, a continuación, la operación List.
3. Haz clic en Listo.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

En este ejemplo se descarga el archivo logfile.txt. El contenido del archivo descargado está disponible en formato JSON en el parámetro de respuesta connectorOutputPayload de la tarea Connectors.

Los pasos para descargar un objeto binario son los mismos que para descargar un objeto normal, tal como se ha descrito anteriormente. Además, debes especificar HasBytes como true en el campo connectorInputPayload. De esta forma, se descarga el objeto como una cadena codificada en Base64. Valor de ejemplo del campo connectorInputPayload:

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

Si la descarga se realiza correctamente, el resultado del campo connectorOutputPayload será similar al siguiente:

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

De forma predeterminada, el campo HasBytes tiene el valor false.

Si el archivo contiene caracteres especiales, como ä, Ø o Thành, haz lo siguiente:

1. Codificar en UTF-8: codifica el archivo en UTF-8 para gestionar los caracteres especiales.
2. Convertir a Base64: convierte el archivo a Base64 para asegurarte de que el texto original no se modifique.
3. Decodifica la cadena Base64: decodifica el archivo en una cadena Base64 para recuperar el valor original con los caracteres especiales.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo se crea el archivo test-file-01 en el segmento bucket-test-01. Si ya existe un archivo con el nombre test-file-01, se sobrescribe.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo, se crea el archivo test-file-01.txt con el contenido Hello test! en el contenedor bucket-test-01. Si ya existe un archivo con el nombre test-file-01.txt, se sobrescribe.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UploadObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo, se crea el archivo test-file-01.txt con el contenido Hello test! en la carpeta folderA de bucket-test-01. Si la carpeta tiene un archivo con el nombre test-file-01.txt, se sobrescribirá.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CopyObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo, se copia el archivo folderA/logfile.txt de bucket_01 a folderB/logfile.txt en bucket_02.

Si la copia se realiza correctamente, el resultado del campo connectorOutputPayload será similar al siguiente:

{
"Success": "true"
}

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción MoveObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo, se mueve el archivo folderA/logfile.txt de bucket_01 a folderB/logfile.txt en bucket_02.

Si la copia se realiza correctamente, el resultado del campo connectorOutputPayload será similar al siguiente:

{
"Success": "true"
}

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DeleteObject y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo, se elimina el archivo logfile.txt de bucket_01.

Si la copia se realiza correctamente, el resultado del campo connectorOutputPayload será similar al siguiente:

{
"Success": "true"
}

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción SignURL y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haga clic en connectorInputPayload y, a continuación, introduzca lo siguiente en el campo Default Value:

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

En este ejemplo se crea una URL firmada para el archivo test-file-01.txt que se encuentra en el cubo bucket-test-01. Si la acción se realiza correctamente, obtendrá la URL firmada en la respuesta, que será similar a la siguiente:

{
"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"
}