Google Storage
Descubra mais sobre o componente Google Storage e saiba como utilizá-lo na Digibee Integration Platform.
Atualizado
Isto foi útil?
Descubra mais sobre o componente Google Storage e saiba como utilizá-lo na Digibee Integration Platform.
Atualizado
Isto foi útil?
O Google Storage permite que uma conexão com o serviço Google Storage seja estabelecida e possibilita as seguintes operações com arquivos: List, Download, Upload e Delete. Descubra mais sobre .
Dê uma olhada nos parâmetros de configuração do componente. Parâmetros suportados por estão marcados com (DB)
.
Account
N/A
String
Operation
Operação a ser executada, que pode ser List, Download, Upload ou Delete.
Upload
String
Project ID
ID do projeto onde a operação com o arquivo será realizada.
projectId
String
Bucket Name
Esse recurso representa um bucket no Google Cloud Storage - há um único namespace compartilhado por todos os buckets.
bucketName
String
Page Size
Este parâmetro só está disponível quando a operação List é selecionada, e informa a quantidade de itens a serem retornados quando a operação List é utilizada.
Se o valor não for especificado, todos os itens são retornados. Caso haja mais itens do que a quantidade determinada neste parâmetro, é possível pedir uma segunda página (veja Page Token), a qual retorna os itens restantes.
N/A
Inteiro
Page Token
Este parâmetro só está disponível quando a operação List é selecionada, e define o token utilizado para solicitar a próxima página quando a operação List é utilizada. Nessa próxima página será retornada a quantidade de itens definidos no parâmetro Page Size.
N/A
String
File Name (DB)
Nome do arquivo ou caminho completo (full file path) para o arquivo local, disponível apenas nas operações Download e Upload.
local-pdf-test.pdf
String
Remote File Name (DB)
Nome do arquivo remoto ou caminho relativo (ex.: tmp/file.txt) para o arquivo remoto. Este parâmetro é apresentado nas operações Download, Upload e Delete.
pdf-test.pdf
String
Remote Directory
Diretório remoto base, que pode ser relativo (ex.: pub/tmp) ou absoluto (ex.: /root/pub), no qual será realizada a operação selecionada. Este parâmetro é apresentado nas operações List, Download, Upload e Delete.
folder
String
Generate Download Link
Se a opção estiver ativada, um link público para download do arquivo é gerado. Este parâmetro é aplicável apenas na operação Upload.
False
Booleano
Link Expiration
Tempo para expiração do link em milissegundos. Este parâmetro é válido apenas se a opção Generate Download Link estiver ativada.
0
Inteiro
Fail On Error
Se a opção estiver habilitada, a execução do pipeline com erro será interrompida; do contrário, a execução do pipeline continua, mas o resultado vai mostrar um valor falso para a propriedade "success".
False
Booleano
Não se espera nenhuma mensagem de entrada específica e sim apenas o preenchimento dos parâmetros obrigatórios que variam conforme a operação selecionada. Veja abaixo a obrigatoriedade de parâmetros para cada operação:
List: Account, Project ID, Bucket Name
Download: Account, Project ID, Bucket Name, File Name e Remote File Name
Upload: Account, Project ID, Bucket Name, File Name e Remote File Name
Delete: Account, Project ID, Bucket Name e Remote File Name
No caso da operação Upload é necessária a existência de um arquivo no diretório local do pipeline.
Ao executar o componente utilizando a operação List, a seguinte estrutura de JSON será gerada:
content: um vetor (array) de objetos para cada arquivo encontrado.
name: nome do arquivo remoto.
contentType: MIME type do arquivo.
contentEncoding: encoding do arquivo, caso exista.
createTime: timestamp da data de criação do arquivo.
bucket: bucket onde o arquivo se encontra.
size: tamanho do arquivo em bytes.
pageToken: token para recuperar próxima página.
fileName: nome do arquivo local.
remoteFileName: nome do arquivo remoto.
remoteDirectory: nome da pasta base remota.
success: "true" se a última operação ocorreu com sucesso.
error: surge se um erro ocorreu e o Fail on Error é "false".
Ao executar o componente utilizando as operações Download, Upload e Delete, a seguinte estrutura de JSON será gerada:
fileName: nome do arquivo local.
remoteFileName: nome do arquivo remoto.
remoteDirectory: nome da pasta base remota.
success: "true" se a última operação ocorreu com sucesso.
Parâmetros
Account: google-storage-test
Operation: List
Project ID: digibee-test
Bucket Name: digibee-test-digibee-test-bucket
Remote Directory: DGB-413
Page Size: 2
Como é possível ver, o resultado acima retorna a propriedade "pageToken" com um valor de referência para a próxima página. Essa propriedade será retornada quando o parâmetro Page Size é configurado (no exemplo está definido com o valor 2) e também quando há mais arquivos para serem listados.
Parâmetros
Account: google-storage-test
Operation: List
Project ID: digibee-test
Bucket Name: digibee-test-digibee-test-bucket
Remote Directory: DGB-413
Page Size: 2
Page Token: ChVER0ItNDEzL2lzbzg4NTktMi50eHQ=
No resultado acima a propriedade "pageToken" não foi retornada. Isso sinaliza que não há mais arquivos a serem listados.
Parâmetros
Account: google-storage-test
Operation: Download
Project ID: digibee-test
Bucket Name: digibee-test-digibee-test-bucket
File Name: iso8859-2.txt
Remote File Name: iso8859-2.txt
Remote Directory: DGB-413
Será realizado o download do arquivo no diretório local do pipeline.
Arquivo local: file.txt
Parâmetros
Account: google-storage-test
Operation: Upload
Project ID: digibee-test
Bucket Name: digibee-test-digibee-test-bucket
File Name: file.txt
Remote File Name: file.txt
Remote Directory: DGB-413
Arquivo local: file.txt
Parâmetros
Account: google-storage-test
Operation: Upload
Project ID: digibee-test
Bucket Name: digibee-test-digibee-test-bucket
File Name: file.txt
Remote File Name: file.txt
Remote Directory: DGB-413
Generate A Download Link: true
Link Expiration (in ms): 600000
Com a configuração dos parâmetros de entrada acima, o arquivo ficará disponível para download por 10 minutos (600000ms) através do link gerado na propriedade de saída "urlGenerated".
Parâmetros
Account: google-storage-test
Operation: Delete
Project ID: digibee-test
Bucket Name: digibee-test-digibee-test-bucket
Remote File Name: file.txt
Remote Directory: DGB-413
Para o componente fazer a autenticação ao serviço, é necessário usar uma conta do tipo Private key. Para saber mais sobre credenciais, visite a .