Compartilhar via


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 .

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

  1. 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 endpoint parâ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

    1. No Microsoft Azure, navegue até a conta de Armazenamento do Azure que você deseja conectar
    2. Na Settings seção (folha esquerda), clique em Endpoints
    3. O ponto de extremidade do arquivo estará em Serviço de arquivo, na file service caixa de texto.
  • Usando contas de armazenamento – obter chamada à API REST de propriedades

    1. Obtenha a conta subscription Id de Armazenamento do Azure e resource group name.
    2. Navegar até contas de armazenamento – Obter propriedades
    3. Clique no Try it botão no canto superior direito da chamada HTTP
    4. Entrar (o usuário deve ter acesso à conta de armazenamento)
    5. Escolha o locatário do Azure no qual a conta de Armazenamento do Azure está localizada
    6. 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
    7. Clique Run
    8. O ponto de extremidade do arquivo estará na file propriedade em primaryEndpoints objeto na resposta

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

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.

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'.