FTP

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Standard	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (GCC High)      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps
Aplicações Power	Standard	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (GCC High)      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Standard	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (GCC High)      - Departamento de Defesa dos EUA (DoD)

Metadados do conector
Editora	Microsoft

Problemas conhecidos e limitações

• Este artigo descreve as operações apenas para o conector gerenciado por FTP, que está disponível para Aplicativos Lógicos do Azure, Power Automatizar e Power Apps. O conector interno FTP está disponível apenas para fluxos de trabalho de aplicativos lógicos padrão nos Aplicativos Lógicos do Azure. Para obter mais informações sobre o conector interno FTP nos Aplicativos Lógicos do Azure, consulte Conectar-se a servidores FTP a partir de fluxos de trabalho nos Aplicativos Lógicos do Azure.

• Os gatilhos de FTP agora retornam apenas metadados ou propriedades, não o conteúdo do arquivo. No entanto, você pode seguir esses gatilhos com a ação chamada Obter conteúdo do arquivo. Para certificar-se de que um gatilho retorna um arquivo de cada vez, em vez de uma lista, certifique-se de ativar a opção "Dividir em" do gatilho. Para obter mais informações sobre essa opção nos Aplicativos Lógicos do Azure, consulte Acionar várias execuções.

• Os gatilhos FTP funcionam apenas na pasta especificada, não em subpastas. Para verificar também as subpastas de uma pasta, configure um fluxo separado para cada subpasta.

• Por padrão, as ações do conector gerenciado por FTP podem ler ou gravar arquivos com 50 MB ou menos. Para lidar com arquivos maiores que 50 MB, você pode usar a ação de conector gerenciado FTP chamada Obter conteúdo de arquivo, que usa implicitamente o fragmento de mensagens. Outras ações do conector gerenciado por FTP também suportam a habilitação do agrupamento de mensagens.

• Os gatilhos FTP podem sofrer atrasos ou resultados incompletos ao retornar arquivos recém-criados, adicionados ou atualizados.

  Quando um gatilho FTP verifica se há um arquivo recém-adicionado ou alterado, o gatilho também confirma que o arquivo está completo. Por exemplo, um arquivo pode ter alterações em andamento quando o gatilho verifica o servidor FTP. Para evitar retornar um arquivo incompleto, o gatilho anota o carimbo de data/hora do arquivo, mas não retorna imediatamente o arquivo. Em vez disso, o gatilho retorna o arquivo somente quando o gatilho verifica o servidor novamente. Às vezes, esse comportamento pode causar um atraso que dura até duas vezes o intervalo de sondagem do gatilho. Devido a esse comportamento, o gatilho FTP pode não retornar todos os arquivos ao mesmo tempo se você desativar a configuração Split On do gatilho FTP,

• Os gatilhos do conector gerenciado por FTP podem apresentar resultados ausentes, incompletos ou atrasados quando o carimbo de data/hora "última modificação" é preservado.

  • Resultados em falta

    Os gatilhos FTP funcionam pesquisando ou verificando o sistema de arquivos FTP e procurando por quaisquer arquivos que foram alterados desde a última pesquisa. O conector gerenciado FTP aciona comparar versões de arquivo usando o carimbo de data/hora da última modificação do arquivo.

    Se você criar, adicionar ou atualizar um arquivo com um carimbo de data/hora anterior ao carimbo de data/hora da última modificação rastreada no momento, o gatilho do conector gerenciado por FTP não detetará esse arquivo. Por outro lado, o gatilho do conector integrado FTP nos fluxos de trabalho do aplicativo lógico padrão não tem essa limitação.

    Portanto, se você usar uma ferramenta externa ou cliente que cria, adiciona ou atualiza arquivos no servidor FTP, certifique-se de desativar qualquer recurso na ferramenta ou cliente que preserve o carimbo de data/hora da última modificação de um arquivo.

    A tabela a seguir lista algumas ferramentas comumente usadas que preservam esse carimbo de data/hora e as etapas para desabilitar esse recurso:

    Cliente FTP	Ação
    WinSCP	Vá para Opções>Preferências Transferir>>Editar>Preservar carimbo de data/hora>Desativar.
    FileZilla	Vá para Transferir>Preservar carimbos de data/hora de arquivos> transferidosDesativar.

  • Resultados incompletos ou atrasados

    Quando um gatilho FTP verifica se há um arquivo recém-criado, adicionado ou atualizado, o gatilho também verifica se o arquivo está completo. Por exemplo, um arquivo pode ter alterações em andamento quando o gatilho verifica o servidor FTP. Para evitar retornar um arquivo incompleto, o gatilho anota o carimbo de data/hora do arquivo, mas não retorna imediatamente o arquivo. Em vez disso, o gatilho retorna o arquivo somente quando o gatilho verifica o servidor novamente.

    Às vezes, esse comportamento pode causar um atraso que dura quase duas vezes o intervalo de sondagem do gatilho. Devido a esse comportamento, se você desabilitar a configuração Dividir em do gatilho FTP, o gatilho FTP pode não retornar todos os arquivos ao mesmo tempo.

Requerimentos

• O conector FTP requer o endereço do servidor host FTP e as credenciais da conta.

• O conector FTP requer acesso ao servidor FTP a partir ou através da Internet. Para obter mais informações sobre como permitir o tráfego para o servidor FTP usando intervalos de IP específicos, consulte Endereços IP do conector gerenciado.

• O conector FTP requer que o servidor FTP opere ou aceite no modo passivo .

• O conector FTP requer que o servidor FTP habilite os seguintes comandos e suporte pastas que contenham espaço em branco para que os comandos possam funcionar corretamente. Para o comando LIST , certifique-se de que o comando retorna o year componente para carimbos de data/hora de arquivo com mais de 6 meses.

  • APPE
  • DELE
  • LISTA
  • MDTM
  • RENAME
  • RETR
  • TAMANHO
  • STOR

• Para FTP seguro, certifique-se de configurar o FTP (File Transfer Protocol Secure) explícito , em vez do FTPS implícito. Além disso, alguns servidores FTP, como o ProFTPd, exigem que você habilite a opção se usar o NoSessionReuseRequired modo TLS (Transport Layer Security), o sucessor do Secure Socket Layer (SSL).

  O conector FTP não funciona com FTPS implícito e suporta apenas FTP explícito sobre FTPS, que é uma extensão do TLS.

Conexões FTP

• Para melhorar o desempenho do conector FTP e do servidor FTP, você pode manter sua conexão FTP aberta e ativa depois que o conector concluir uma solicitação.

  Quando você cria uma conexão com um servidor FTP, a caixa de perfil de conexão que aparece tem uma configuração chamada Fechar conexão após a conclusão da solicitação. Essa configuração especifica se a conexão do servidor FTP deve ser fechada sempre após a conclusão de uma solicitação. Se você mantiver essa configuração desabilitada, a conexão não fechará após a conclusão de uma solicitação e permanecerá ativa para uso futuro.

• Se as instâncias do fluxo de trabalho forem executadas em paralelo, você poderá enfrentar erros de conectividade intermitentes. Algumas operações em seu fluxo de trabalho podem fechar a conexão à força, mesmo enquanto outras operações no fluxo de trabalho ainda estão usando essa conexão.

  Para evitar esse cenário, tente as seguintes recomendações:

  • Ao criar a conexão, habilite a configuração Fechar conexão após a conclusão da solicitação .

  • Desative qualquer paralelização ou simultaneidade habilitada em gatilhos ou ações. Para obter mais informações sobre essa solução nos Aplicativos Lógicos do Azure, consulte a seguinte documentação:

    • Alterar simultaneidade de gatilho
    • Chanage "Para cada um" simultaneidade de ação

  • Evite executar vários fluxos paralelos.

Use a ação "Criar arquivo" com e sem fragmentação

Para a ação Criar arquivo , o comportamento depende da configuração Permitir fragmentação da ação e do tamanho do arquivo a ser criado:

• Permitir fragmentação habilitada:

  • O tamanho do ficheiro é igual ou inferior a 50 MB: a ação carrega o ficheiro com um único pedido, utiliza o nome do ficheiro original e bloqueia o ficheiro durante o carregamento.

  • Tamanho do arquivo maior que 50 MB: A ação cria o arquivo com o formato de nome, nome do arquivo.new-GUID.ms.partial e carrega o arquivo usando várias solicitações ou fragmentação de mensagens. Depois que a ação carrega o último bloco, a ação renomeia o arquivo com o nome do arquivo original.

• Permitir fragmentação desabilitada: a ação carrega o arquivo com uma única solicitação, usa o nome do arquivo original e bloqueia o arquivo durante o upload.

Guia de instruções do conector

Para obter informações sobre como utilizar o conector gerido por FTP e o conector incorporado nas Aplicações Lógicas do Azure, consulte Ligar a servidores FTP a partir de fluxos de trabalho nas Aplicações Lógicas do Azure.

Limites Gerais

Nome	Valor
Número máximo de pastas em um único arquivo. Este limite só se aplica quando 'Criar pastas?' está definido como 'Sim'.	16
Número máximo de megabytes sendo transferidos de/para o 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

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Endereço do servidor	cadeia (de caracteres)	Endereço do servidor	Verdade
Nome de Utilizador	cadeia (de caracteres)	Nome de Utilizador	Verdade
Palavra-passe	securestring	Palavra-passe	Verdade
Porta do servidor FTP	int	Número da porta FTP (exemplo: 21)
Ativar SSL?	bool	Ativar SSL? (Verdadeiro/Falso)
Transporte binário?	bool	Ativar o transporte binário? (Verdadeiro/Falso)
Desativar a validação de certificado?	bool	Desativar a validação de certificado? (Verdadeiro/Falso)
Fechar conexão após a conclusão da solicitação	bool	Fechar a conexão FTP toda vez após a conclusão da solicitação? (Verdadeiro/Falso)

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	900	60 segundos

Ações

Atualizar ficheiro	Esta operação atualiza um arquivo. Se um arquivo estiver sendo excluído/renomeado no servidor logo após ter sido atualizado, o conector pode retornar o erro HTTP 404 por seu design. Por favor, use um atraso de 1 minuto antes de excluir ou renomear o arquivo atualizado recentemente.
Copiar ficheiro	Esta operação copia um ficheiro para um servidor FTP. Se um arquivo estiver sendo excluído/renomeado no servidor logo após ter sido copiado, o conector pode retornar o erro HTTP 404 por seu design. Por favor, use um atraso de 1 minuto antes de excluir ou renomear o arquivo recém-criado.
Criar ficheiro	Esta operação cria um arquivo. Se um arquivo estiver sendo excluído/renomeado no servidor logo após ter sido criado, o conector pode retornar o erro HTTP 404 por seu design. Por favor, use um atraso de 1 minuto antes de excluir ou renomear o arquivo recém-criado.
Eliminar ficheiro	Esta operação exclui um arquivo.
Extrair arquivo para pasta	Esta operação extrai um arquivo morto para uma pasta (exemplo: .zip).
Listar arquivos na pasta	Esta operação obtém a lista de arquivos e subpastas em uma pasta.
Listar arquivos na pasta raiz	Esta operação obtém a lista de arquivos e subpastas na pasta raiz.
Obter conteúdo de arquivo usando o caminho	Esta operação obtém o conteúdo de um arquivo usando o caminho do arquivo.
Obter conteúdo de ficheiro	Esta operação obtém o conteúdo de um arquivo.
Obter metadados de arquivo usando o caminho	Esta operação obtém os metadados de um arquivo usando o caminho do arquivo.
Obter metadados do ficheiro	Esta operação obtém os metadados de um arquivo.

Atualizar ficheiro

Copiar ficheiro

Criar ficheiro

Eliminar ficheiro

Extrair arquivo para pasta

Listar arquivos na pasta

Listar arquivos na pasta raiz

Obter conteúdo de arquivo usando o caminho

Obter conteúdo de ficheiro

Obter metadados de arquivo usando o caminho

Obter metadados do ficheiro

Acionadores

Quando um arquivo é adicionado ou modificado [DEPRECATED]

Esta operação dispara um fluxo quando um arquivo é adicionado ou modificado em uma pasta. O gatilho buscará os metadados do arquivo, bem como o conteúdo do arquivo. O gatilho depende da hora da última modificação de um arquivo. Se um arquivo estiver sendo criado por um cliente de terceiros, a preservação da hora da última modificação deve ser desabilitada no cliente. Arquivos maiores que 50 megabytes são ignorados pelo gatilho. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.

Quando um ficheiro é adicionado ou modificado (apenas propriedades)

Esta operação dispara um fluxo quando um ou mais arquivos são adicionados ou modificados em uma pasta. Esse gatilho buscará apenas os metadados do arquivo. Para obter o conteúdo do arquivo, você pode usar a operação "Obter conteúdo do arquivo". O gatilho depende da hora da última modificação de um arquivo. Se um arquivo estiver sendo criado por um cliente de terceiros, a preservação da hora da última modificação deve ser desabilitada no cliente. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.

Quando um arquivo é adicionado ou modificado [DEPRECATED]

Quando um ficheiro é adicionado ou modificado (apenas propriedades)

Definições

BlobMetadata

binário