IMPORTANTE: esta documentação foi descontinuada. Leia a documentação Azure Blob Storage atualizada no nosso novo portal de documentação.
O Blob Storage ( Azure ) + possibilita a manipulação de arquivos dentro de contêineres da Azure Blob Storage .
Parâmetros de configuração
Dê uma olhada nas opções de configuração do componente:
Account: conta a ser utilizada pelo componente (listar as accounts suportadas pelo componente). As accounts suportadas são: basic e public key. A Basic é utilizada para se conectar via ConnectionString, deve ser passado o nome da account do storage no campo usuário e a key1 no campo password. A public key é utilizada caso queira autenticar via SAS token, utilizar a public-key no campo key, passar o SAS token gerado pela Azure. Para saber mais sobre esses accounts e os outros tipos existentes, clique no botão.
Step Name: Nome do passo que o componente é configurado.
Operation: Qual operação o componente irá realizar, list, download, upload ou delete (o preenchimento deste campo é obrigatório).
Container Name: Nome do container do Blob Storage ( Azure ) que manipulará os arquivos (o preenchimento deste campo é obrigatório).
Container Account: Nome do account na Azure que o Blob Storage utiliza (o preenchimento deste campo é obrigatório).
Remote File Name: Nome de destino do seu arquivo, o nome que o arquivo terá no Blob Storage ( Azure ) (o preenchimento deste campo é obrigatório apenas nas operações upload, download e delete). Este parâmetro aceita Double Braces).
File Name: Nome do arquivo que você deseja subir para o seu Blob Storage (Azure) (o preenchimento deste campo é obrigatório). Este parâmetro aceita Double Braces.
Show File Link: Gera um link de download do arquivo quando está configurado como true e a operação é upload.
Fail On Error: Caso o parâmetro esteja configurado como true ele lança a exceção para frente.
Page Size: Quantidade de registros que deseja trazer por página (apenas quando a operação é List). Este parâmetro aceita Double Braces.
Next Page Token: NextToken que será usado para trazer os registros da próxima página (apenas quando a operação é List ). Este parâmetro aceita Double Braces.
Next Page Type: Tipo do próximo registro que será listado na próxima página (apenas quando a operação é List ).
Overwrite File on Upload: Sobrescreve o arquivo no momento do upload (apenas quando a operação é Upload ). Este parâmetro aceita Double Braces.
Alguns dos parâmetros acima aceitam Double Braces. Para entender melhor como funciona essa linguagem, leia o nosso artigo clicando no botão.
Fluxo de mensagens
Exemplo de retorno quando operação é list:
{
"success": true,
"content": [
{
"fileName": "my-remote-file.txt",
"containerName": "newcontainer",
"properties": {
"createdDate": "Fri May 20 13:41:12 UTC 2022",
"lastUpdated": "Wed May 25 14:59:26 UTC 2022",
"contentType": "application/octet-stream",
"length": 23
}
},
{
"fileName": "testeOverwrite.txt",
"containerName": "newcontainer",
"properties": {
"createdDate": "Tue Jun 14 18:11:35 UTC 2022",
"lastUpdated": "Tue Jun 14 18:11:47 UTC 2022",
"contentType": "application/octet-stream",
"length": 76952
}
}
],
"count": 2,
"containerName": "newcontainer"
}
Importante:
Foram adicionados campos novos no componente para tornar possível filtrar por prefixo, e temos agora a opção de incluir alguns tipos de arquivo no retorno, como deletados, por exemplo:
Prefix: Filtra os resultados para retornar apenas blobs cujos nomes começam com o prefixo especificado na operação de lista: Permitir chaves duplas
Snapshot: Incluir Snapshots na resposta de blobs para operação de lista
Metadata: Incluir metadados na resposta de blobs para operação de lista
Uncommited: Incluir Uncommited blobs não confirmados na resposta para operação de lista
Copy: Incluir blobs Copy na resposta para operação de lista
Delete: Incluir Delete blobs de exclusão na resposta para operação de lista
Exemplo de retorno quando operação é upload:
{
"success": true,
"fileName": "teste-upload.jpeg",
"containerName": "teste",
"remoteFileName": "teste-upload.jpeg",
"urlGenerated": "https://digibeeblobstorage.blob.core.windows.net/teste/teste-upload.jpeg"
}
Exemplo de retorno quando operação é download:
Importante: Utilizar o componente File Reader para manipular o base64 retornado.
Exemplo de retorno quando operação é delete:
{
"success": true,
"containerName": "newcontainer",
"remoteFileName": "teste-upload.jpeg"
}