# Blob Storage (Azure)

O **Blob Storage (Azure)** possibilita que você trabalhe com arquivos armazenados em *containers* da Azure Blob Storage.

## Parâmetros

Configure o conector utilizando os parâmetros abaixo. Campos que suportam [expressões *Double Braces*](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) estão marcados na coluna **Suporta DB**.

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Tipo</th><th>Suporta DB</th><th>Padrão</th></tr></thead><tbody><tr><td><strong>Alias</strong></td><td>Nome (alias) para a saída deste conector, permitindo referenciá-la posteriormente no fluxo usando expressões com Double Braces.</td><td>String</td><td>✅</td><td>az-blob-storage-1</td></tr><tr><td><strong>Use Dynamic Account</strong></td><td>Quando ativado, o conector utilizará a conta de forma dinâmica. Caso contrário, utilizará uma conta estática. <a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/FrKJOmsImCRBImMPMsU2">Saiba mais sobre credenciais dinâmicas</a>.</td><td>Boolean</td><td>❌</td><td>False</td></tr><tr><td><strong>Scoped</strong></td><td>Quando ativado, a conta armazenada é isolada de outros subprocessos. Nesse caso, os subprocessos enxergam sua própria versão dos dados da conta. Disponível apenas se o parâmetro Use Dynamic Account estiver habilitado.</td><td>Boolean</td><td>❌</td><td>False</td></tr><tr><td><strong>Account name</strong></td><td>Nome da conta dinâmica utilizada pelo conector. Essa conta deve ter sido previamente configurada em um conector Store Account no pipeline para que funcione. Disponível apenas se o parâmetro Use Dynamic Account estiver habilitado</td><td>String</td><td>✅</td><td>N/A</td></tr><tr><td><strong>Account</strong></td><td>Conta a ser utilizada pelo componente. As contas suportadas são: <em>Basic</em> e <em>Public key</em>. A <em>Basic</em> é utilizada para se conectar via <em>ConnectionString</em>; o nome da <em>storage account</em> deve ser passado no campo "<em>user</em>" e a <em>key1</em> no campo "<em>password</em>". A <em>Public key</em> é utilizada caso queira autenticar via SAS token; use a <em>public-key</em> no campo "<em>key</em>", e depois passe o <em>SAS token</em> gerado pela Azure. <a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/fS1QLzAg8rGSSJFwtrvy">Leia a documentação sobre Contas (Accounts)</a> para saber mais sobre esses e outros tipos de contas existentes.</td><td><em>String</em></td><td>❌</td><td>N/A</td></tr><tr><td><strong>Operation</strong></td><td>Define qual operação o componente irá realizar (<em>List</em>, <em>Download</em>, <em>Upload</em> ou <em>Delete</em>). O preenchimento deste campo é obrigatório.</td><td><em>String</em></td><td>❌</td><td><em>Upload</em></td></tr><tr><td><strong>Container Name</strong></td><td>Nome do <em>container</em> do Blob Storage (Azure) que manipulará os arquivos. O preenchimento deste campo é obrigatório.</td><td><em>String</em></td><td>❌</td><td><em>container</em></td></tr><tr><td><strong>Container Account</strong></td><td>Nome da conta Azure que o Blob Storage utiliza. O preenchimento deste campo é obrigatório.</td><td><em>String</em></td><td>❌</td><td>N/A</td></tr><tr><td><strong>Remote File Name</strong> <code>(DB)</code></td><td>Nome do arquivo ou caminho completo do arquivo remoto (ex.: tmp/file.txt). O preenchimento deste campo é obrigatório apenas quando as operações <em>Upload</em>, <em>Download</em> ou <em>Delete</em> estiverem selecionadas.</td><td><em>String</em></td><td>✅</td><td>test.csv</td></tr><tr><td><strong>File Name</strong> <code>(DB)</code></td><td>Nome do arquivo ou caminho completo (<em>full file path</em>, por exemplo tmp/processed/file.txt) para o arquivo local. O preenchimento deste campo é obrigatório.</td><td><em>String</em></td><td>✅</td><td>file.csv</td></tr><tr><td><strong>Generate a Download Link</strong></td><td>Se a opção é habilitada, você poderá gerar um link para download do arquivo. Este parâmetro é mostrado somente quando a operação <em>Upload</em> é selecionada.</td><td>Booleano</td><td>❌</td><td><em>True</em></td></tr><tr><td><strong>Page Size</strong> <code>(DB)</code></td><td>Quantidade de registros que deseja trazer por página. Este parâmetro é mostrado somente quando a operação <em>List</em> é selecionada.</td><td>Inteiro</td><td>✅</td><td>N/A</td></tr><tr><td><strong>Prefix</strong> </td><td>Filtra os resultados para retornar apenas blobs cujos nomes começam com o prefixo especificado. Este parâmetro é mostrado somente quando a operação <em>List</em> é selecionada.</td><td><em>String</em></td><td>❌</td><td>N/A</td></tr><tr><td><strong>Next Page Token</strong> <code>(DB)</code></td><td><em>NextToken</em> que será usado para trazer os registros da próxima página. Este parâmetro é mostrado somente quando a operação <em>List</em> é selecionada.</td><td><em>String</em></td><td>✅</td><td>N/A</td></tr><tr><td><strong>Next Token Type</strong> <code>(DB)</code></td><td>Tipo do próximo registro que será listado na próxima página. Este parâmetro é mostrado somente quando a operação <em>List</em> é selecionada.</td><td><em>String</em></td><td>✅</td><td>N/A</td></tr><tr><td><strong>Overwrite File on Upload</strong></td><td>Sobrescreve o arquivo no momento do <em>upload</em>. Este parâmetro é mostrado somente quando a operação <em>Upload</em> é selecionada.</td><td>Booleano</td><td>❌</td><td><em>True</em></td></tr><tr><td><strong>Snapshot</strong></td><td>Se a opção for ativada, irá incluir <em>snapshots</em> na resposta dos <em>blobs</em>. Disponível somente para a operação <em>List</em>.</td><td>Booleano</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Metadata</strong></td><td>Se a opção for ativada, irá incluir metadados (<em>metadata</em>) na resposta dos <em>blobs</em>. Disponível somente para a operação <em>List</em>.</td><td>Booleano</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Uncommited</strong></td><td>Se a opção for ativada, irá incluir <em>uncommited blobs</em> na resposta. Disponível somente para a operação <em>List</em>.</td><td>Booleano</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Copy</strong></td><td>Se a opção for ativada, irá incluir <em>copy blobs</em> na resposta. Disponível somente para a operação <em>List</em>.</td><td>Booleano</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Delete</strong></td><td>Se a opção for ativada, irá incluir <em>delete blobs</em> na resposta. Disponível somente para a operação <em>List</em>.</td><td>Booleano</td><td>❌</td><td>N/A</td></tr><tr><td><strong>Fail On Error</strong></td><td>Se a opção estiver habilitada, a execução do <em>pipeline</em> com erro será interrompida; do contrário, a execução do <em>pipeline</em> continua, mas o resultado vai mostrar um valor falso para a propriedade "<em>success</em>".</td><td>Booleano</td><td>❌</td><td><em>False</em></td></tr></tbody></table>

## **Fluxo de mensagens** <a href="#h_721d00c487" id="h_721d00c487"></a>

### Operação List <a href="#h_f1ad5045a4" id="h_f1ad5045a4"></a>

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

### Operação Upload <a href="#h_adcada8305" id="h_adcada8305"></a>

```
{
"success": true,
"fileName": "teste-upload.jpeg",
"containerName": "teste",
"remoteFileName": "teste-upload.jpeg",
"urlGenerated": "
https://digibeeblobstorage.blob.core.windows.net/teste/teste-upload.jpeg
"
}
```

### Operação Download <a href="#h_31719736bb" id="h_31719736bb"></a>

{% hint style="info" %}
**Importante:** Utilizar o componente [**File Reader**](/documentation/connectors-and-triggers/pt-br/connectors/files/file-reader.md) para manipular o base64 retornado.
{% endhint %}

### Operação Delete <a href="#h_30beadc363" id="h_30beadc363"></a>

```
{
"success": true,
"containerName": "newcontainer",
"remoteFileName": "teste-upload.jpeg"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/file-storage/azure-blob-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.