Armazenamento de Arquivos do Azure
O Armazenamento do Microsoft Azure fornece um armazenamento extremamente escalonável, durável e altamente disponível para dados na nuvem e serve como a solução de armazenamento de dados para aplicativos modernos. Conecte-se ao Armazenamento de Arquivos para executar várias operações, como criar, atualizar, obter e excluir arquivos em sua conta de Armazenamento do Azure.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate |
| Aplicativos Lógicos | Standard | Todas as regiões de Aplicativos Lógicos |
| Power Apps | Premium | Todas as regiões do Power Apps |
| Power Automate | Premium | Todas as regiões do Power Automate |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://azure.microsoft.com/services/storage/files/ |
Ações que dão suporte ao recurso de agrupamento .
- Obter conteúdo do arquivo
- Obter conteúdo do arquivo usando o caminho
- Criar arquivo
- Atualizar arquivo
Essas ações podem ser usadas para manipular arquivos de até 300 MB. O recurso está habilitado por padrão.
Problemas e limitações conhecidos
- Os aplicativos lógicos não poderão acessar diretamente contas de armazenamento que estão por trás de firewalls se ambos estiverem na mesma região. Como solução alternativa, você pode ter seus aplicativos lógicos e sua conta de armazenamento em regiões diferentes. Para obter mais informações sobre como habilitar o acesso dos Aplicativos Lógicos do Azure a contas de armazenamento por trás de firewalls, consulte as contas de armazenamento do Access por trás de firewalls
Conectar-se ao conector de Arquivos do Azure usando o ponto de extremidade de arquivo
Insira o ponto de extremidade completo do arquivo do Armazenamento do Azure no
Azure Storage account name or file endpointparâmetro.Você deve fornecer o ponto de extremidade completo, incluindo o esquema, por exemplo:
https://account.file.core.windows.net/-
https://account-secondary.file.core.windows.net/(se estiver se conectando ao ponto de extremidade secundário) - AS URLs relativas (por exemplo,
account.file.core.windows.net) serão rejeitadas.
Obter o ponto de extremidade de arquivo do Armazenamento do Azure para uma determinada conta de armazenamento
Há várias maneiras de obter esse ponto de extremidade de arquivo:
Usando o Portal do Azure
- No Microsoft Azure, navegue até a conta de Armazenamento do Azure que você deseja conectar
- Na
Settingsseção (folha esquerda), clique emEndpoints - O ponto de extremidade do arquivo estará em Serviço de arquivo, na
file servicecaixa de texto.
Usando contas de armazenamento – obter chamada à API REST de propriedades
- Obtenha a conta
subscription Idde Armazenamento do Azure eresource group name. - Navegar até contas de armazenamento – Obter propriedades
- Clique no
Try itbotão no canto superior direito da chamada HTTP - Entrar (o usuário deve ter acesso à conta de armazenamento)
- Escolha o locatário do Azure no qual a conta de Armazenamento do Azure está localizada
- Insira o nome da conta do Armazenamento do Azure, o nome do grupo de recursos e selecione a assinatura na qual a conta de armazenamento está localizada
- Clique
Run - O ponto de extremidade do arquivo estará na
filepropriedade emprimaryEndpointsobjeto na resposta
- Obtenha a conta
Limites Gerais
| Nome | Value |
|---|---|
| Tamanho máximo do arquivo (em MB) | 50 |
| Número máximo de megabytes sendo transferidos para/do conector dentro de um intervalo de tempo de largura de banda (por conexão) | 1000 |
| Intervalo de tempo de largura de banda (em milissegundos) | 60000 |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a visão geral dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Nome da conta de Armazenamento do Azure ou ponto de extremidade de arquivo | cadeia | Nome ou ponto de extremidade de arquivo da conta de Armazenamento do Azure que o conector deve usar. | Verdade |
| Chave de Acesso da Conta de Armazenamento do Azure | secureString | Especifique uma chave de acesso da conta de Armazenamento do Azure primária/secundária válida. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 600 | 60 segundos |
Ações
| Atualizar arquivo |
Esta operação atualiza um arquivo no Armazenamento de Arquivos do Azure. |
| Copiar arquivo |
Esta operação copia um arquivo. |
| Criar arquivo |
Essa operação carrega um arquivo no Armazenamento de Arquivos do Azure. |
| Excluir arquivo |
Essa operação exclui um arquivo. |
| Extrair arquivo morto para pasta |
Esta operação extrai um arquivo morto em uma pasta (exemplo: .zip). |
| Listar arquivos |
Esta operação lista arquivos em uma pasta. |
| Obter conteúdo do arquivo |
Esta operação recupera o conteúdo do arquivo usando id. |
| Obter conteúdo do arquivo usando o caminho |
Esta operação recupera o conteúdo do arquivo usando o caminho |
| Obter metadados de arquivo usando o caminho |
Essa operação recupera metadados de arquivo usando o caminho. |
| Obter metadados do arquivo |
Esta operação recupera metadados de arquivo usando a ID do arquivo. |
Atualizar arquivo
Esta operação atualiza um arquivo no Armazenamento de Arquivos do Azure.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo a ser atualizado |
|
Conteúdo do ficheiro
|
body | True | binary |
Especifique o conteúdo com o qual atualizar o arquivo |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Copiar arquivo
Esta operação copia um arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL de origem
|
source | True | string |
Especificar a URL para o arquivo de origem |
|
Caminho do arquivo de destino
|
destination | True | string |
Especifique o caminho do arquivo de destino, incluindo o nome do arquivo de destino |
|
Sobrescrever?
|
overwrite | boolean |
O arquivo de destino deve ser substituído (true/false)? |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Criar arquivo
Essa operação carrega um arquivo no Armazenamento de Arquivos do Azure.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho da pasta
|
folderPath | True | string |
Especificar o caminho da pasta a ser carregado |
|
Nome do arquivo
|
name | True | string |
Especificar o nome do arquivo a ser criado |
|
Conteúdo do ficheiro
|
body | True | binary |
Especificar o conteúdo do arquivo a ser carregado |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Excluir arquivo
Essa operação exclui um arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo a ser excluído |
Extrair arquivo morto para pasta
Esta operação extrai um arquivo morto em uma pasta (exemplo: .zip).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo de arquivo de origem
|
source | True | string |
Especificar o caminho para o arquivo morto |
|
Caminho da pasta de destino
|
destination | True | string |
Especificar o caminho no Armazenamento de Arquivos do Azure para extrair o conteúdo do arquivo morto |
|
Sobrescrever?
|
overwrite | boolean |
O arquivo de destino deve ser substituído (true/false)? |
Retornos
- response
- array of BlobMetadata
Listar arquivos
Esta operação lista arquivos em uma pasta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
id | True | string |
Especificar a pasta |
Retornos
Representa uma página de metadados de blob.
- Corpo
- BlobMetadataPage
Obter conteúdo do arquivo
Esta operação recupera o conteúdo do arquivo usando id.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo para obter conteúdo |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Inferir o tipo de conteúdo com base na extensão |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Obter conteúdo do arquivo usando o caminho
Esta operação recupera o conteúdo do arquivo usando o caminho
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
Especificar o caminho exclusivo para o arquivo |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Inferir o tipo de conteúdo com base na extensão |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
Obter metadados de arquivo usando o caminho
Essa operação recupera metadados de arquivo usando o caminho.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
Especificar o caminho exclusivo para o arquivo |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Obter metadados do arquivo
Esta operação recupera metadados de arquivo usando a ID do arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo para obter metadados |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Definições
BlobMetadata
Metadados de blob
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
A ID exclusiva do arquivo ou pasta. |
|
Nome
|
Name | string |
O nome do arquivo ou pasta. |
|
DisplayName
|
DisplayName | string |
O nome de exibição do arquivo ou pasta. |
|
Caminho
|
Path | string |
O caminho do arquivo ou pasta. |
|
LastModified
|
LastModified | date-time |
A data e a hora em que o arquivo ou a pasta foi modificado pela última vez. |
|
Tamanho
|
Size | integer |
O tamanho do arquivo ou pasta. |
|
Tipo de Mídia
|
MediaType | string |
O tipo de mídia do arquivo ou pasta. |
|
IsFolder
|
IsFolder | boolean |
Um valor booliano (true, false) para indicar se o blob é ou não uma pasta. |
|
Etag
|
ETag | string |
A etag do arquivo ou pasta. |
|
FileLocator
|
FileLocator | string |
O filelocator do arquivo ou pasta. |
BlobMetadataPage
Representa uma página de metadados de blob.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of BlobMetadata |
Coleção de metadados de blob. |
binário
Esse é o tipo de dados básico 'binary'.