FTP

Use o grupo de ações do FTP para fazer upload e download de arquivos e manipular diretórios em servidores FTP.

Para estabelecer uma conexão FTP, use a ação Abrir conexão de FTP. O exemplo a seguir tem um host, porta e credenciais especificados. Além disso, o tempo limite definido faz com que a ação falhe se a conexão não for estabelecida a tempo.

Baixe arquivos usando a ação Baixar arquivos do FTP. O exemplo a seguir mostra a variável de conexão em uso e a pasta de destino selecionada. O arquivo remoto também foi especificado e configurado para substituir arquivos existentes no mesmo local.

Faça upload de arquivos usando a ação Carregar arquivos para FTP e especificando o arquivo e o local remoto.

Importante

A partir da versão 2.56, O Power Automate para desktop não oferece mais suporte a algoritmos de cifra herdados que foram preteridos em ações de FTP seguro (SFTP). Esta atualização destina-se a melhorar a segurança removendo métodos criptográficos desatualizados.

Os seguintes algoritmos não são mais suportados:

• blowfish-cbc
• twofish-cbc
• twofish192-cbc
• twofish128-cbc
• twofish256-cbc
• ArcFour
• Arcfour128
• Arcfour256
• CAST128-CBC
• hmac-sha2-512-96
• hmac-sha2-256-96
• hmac-sha1-96
• HMAC-MD5
• HMAC-MD5-96
• HMAC-SHA1-96-ETM
• hmac-md5-etm
• HMAC-MD5-96-ETM

Os usuários que dependem exclusivamente de algoritmos de codificação preteridos para seus servidores SFTP podem enfrentar fluxos com falha ao executar ações SFTP na versão 2.56 do Power Automate para desktop porque esses servidores não são compatíveis com a biblioteca atualizada.

Para garantir uma experiência perfeita e evitar interrupções no fluxo de trabalho, siga estas etapas:

• Verifique quais algoritmos de cifra seu servidor SFTP tem suporte.
• Se o servidor usar algoritmos de cifra preteridos, atualize-o para oferecer suporte a algoritmos de cifra modernos e seguros.
• Consulte sua equipe de TI ou provedor de servidor SFTP para obter orientação sobre como atualizar os recursos criptográficos do servidor.
• Evite instalar a versão 2.56 ou posterior até que os servidores SFTP sejam migrados para uma versão compatível.

Abrir conexão de FTP

Esta ação estabelece uma conexão específica com um servidor FTP remoto e armazena essa conexão como uma variável para uso posterior.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Host	Não	Valor do texto		Insira aqui o endereço do servidor FTP.
Port	Sim	Valor numérico	21	Insira aqui a porta do servidor FTP.
Active mode	N/D	Valor booliano	False	Especificar o modo de conexão
Username	Não	Valor do texto		Especifique o nome de usuário da conta FTP a ser usada
Senha	Sim	Entrada direta criptografada ou Valor do texto		Especifique a senha da conta FTP a ser usada
Tempo limite	Sim	Valor numérico	10	Definir o tempo em segundos que você deseja aguardar pelo estabelecimento da conexão antes de considerar que ação falhou

Variáveis produzidas

Argumento	Type	Description
FTPConnection	Conexão FTP	A conexão de FTP

Exceções

Exceção	Descrição
Login failure error	Indica falha no logon
Connection error	Indica que há um problema com a conexão

Listar diretório FTP

Esta ação retorna os subdiretórios e arquivos contidos no diretório atual de uma conexão de FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Connection	Não	Conexão FTP		A conexão de FTP
Path	Sim	Valor do texto		O caminho que você deseja listar.

Variáveis produzidas

Argumento	Type	Description
Directories	Lista de Diretórios FTP	Os diretórios listados
Arquivos	Lista de Arquivos FTP	Os arquivos listados

Exceções

Exceção	Descrição
Erro de listagem	Indica que não foi possível executar a listagem da pasta
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
Directory doesn't exist error	Indica que não foi possível encontrar o diretório

Abrir conexão segura de FTP

Esta ação estabelece uma conexão específica segura com um servidor FTP remoto e armazena essa conexão como uma variável para uso posterior.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Host	Não	Valor do texto		Insira aqui o endereço do servidor FTP.
Port	Sim	Valor numérico	22	Insira aqui a porta do servidor FTP.
Active mode	N/D	Valor booliano	Verdadeiro	Especificar o modo de conexão
Secure FTP Protocol	N/D	SFTP, FTPS explícito, FTPS implícito	SFTP	Escolher o protocolo FTP que você deseja usar para criptografar a conexão
Authentication method	N/D	Nome de usuário e senha, Chave privada, Chave privada e senha	Nome de usuário e senha	Escolha o método que você deseja usar para se autenticar no servidor FTP
User name	Não	Valor do texto		Especifique o nome de usuário da conta FTP a ser usada
Senha	Sim	Entrada direta criptografada ou Valor do texto		Especifique a senha da conta FTP que você deseja usar
Path to private key	Não	Valor do texto		Insira o caminho do arquivo para a chave privada a ser usada na autenticação
Senha da chave privada	Sim	Entrada direta criptografada ou Valor do texto		Insira aqui uma variável que contém a senha da chave privada
Timeout	Sim	Valor numérico	10	Definir o tempo em segundos que você deseja aguardar pelo estabelecimento da conexão antes de considerar que ação falhou

Variáveis produzidas

Argumento	Type	Description
SftpConnection	Conexão FTP	Conexão de SFTP

Exceções

Exceção	Descrição
Login failure error	Indica falha no logon
Connection error	Indica que há um problema com a conexão

Encerrar conexão

Esta ação encerra uma conexão de FTP aberta.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Connection	Não	Conexão FTP		A conexão de FTP

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP

Alterar diretório de trabalho

Esta ação define o diretório de trabalho atual para uma conexão de FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
Connection	Não	Conexão FTP		A conexão de FTP
Set working directory to	Não	Valor do texto		Configurar o caminho a ser definido como o diretório de trabalho

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
Directory doesn't exist error	Indica que não foi possível encontrar o diretório
Can't change working directory error	Indica que não é possível alterar o diretório de trabalho

Baixar arquivos do FTP

Baixa um ou mais arquivos de um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Download into folder	Não	Pasta		A pasta de destino dos arquivos que serão baixados
Arquivos a serem baixados	Não	Lista de Arquivos FTP		Os arquivos a serem baixados
Tipo de transferência	N/D	Automático, Binário, ASCII	Automático	Insira ASCII ou binário para especificar o método de download de um único arquivo. Se o tipo de arquivo for incerto ou mais de um for baixado, escolha Automático para seguir as regras de transferência especificadas nas opções
If file exists	N/D	Substituir, Não baixar, Baixar com nome exclusivo	Substituir	Especifique o que fazer se o arquivo já existir. Substituir grava sobre o arquivo original de maneira que você não possa mais acessá-lo, e baixar com nome exclusivo adiciona um sublinhado e um número sequencial ao final

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
Remote file doesn't exist error	Indica que o arquivo não existe no servidor FTP
Directory doesn't exist error	Indica que não foi possível encontrar o diretório
FTP connection aborted error	Indica que a conexão de FTP foi cancelada
Can't download file error	Indica que não foi possível baixar o arquivo

Baixar pastas do FTP

Baixa uma ou mais pastas de um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Folder(s) to download	Não	Lista de Diretórios FTP		O nome dos caminhos das pastas ou as pastas FTP a serem baixadas
Download into local folder	Não	Pasta		O caminho completo de destino das pastas FTP que você está baixando

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
Remote directory doesn't exist error	Indica que o diretório não existe no servidor FTP
Directory doesn't exist error	Indica que não foi possível encontrar o diretório
FTP connection aborted error	Indica que a conexão de FTP foi cancelada
Can't download directory error	Indica que não foi possível baixar o diretório

Carregar arquivos no FTP

Carrega um ou mais arquivos em um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
File(s) to upload	Não	Lista de Arquivos		Os arquivos a serem carregados
Remote location	Sim	Valor do texto		O local onde os arquivos devem ser carregados
Transfer type	N/D	Automático, Binário, ASCII	Automático	Insira ASCII ou binário para especificar o método de download de um único arquivo. Se você não sabe qual será o tipo de arquivo ou se estiver baixando mais de um tipo, escolha Automático para acompanhar as regras de transferência especificadas nas Opções
If file exists	N/D	Substituir, Não baixar, Baixar com nome exclusivo	Substituir	Especifique o que fazer se o arquivo já existir. Substituir grava sobre o arquivo original de maneira que você não possa mais acessá-lo, e Baixar com Nome Exclusivo adiciona um sublinhado e um número sequencial ao final

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
File not found error	Indica que o arquivo não foi encontrado
FTP connection aborted error	Indica que a conexão de FTP foi cancelada
Upload file error	Indica que não foi possível carregar o arquivo

Carregar pastas no FTP

Carrega uma ou mais pastas em um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Folder(s) to upload	Não	Lista de Pastas		As pastas a serem carregadas. As pastas sendo carregadas não devem existir no diretório ativo do servidor FTP
Remote location	Não	Valor do texto		O local onde as pastas devem ser carregadas

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
Remote directory doesn't exist error	Indica que o diretório não existe no servidor FTP
FTP connection aborted error	Indica que a conexão de FTP foi cancelada
Upload directory error	Indica que não foi possível carregar o diretório

Excluir arquivo FTP

Exclui um ou mais arquivos de um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Arquivos a serem excluídos	Não	Lista de Arquivos FTP		Os arquivos a serem excluídos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
File not found error	Indica que o arquivo não foi encontrado
Can't delete file error	Indica que a exclusão do arquivo não foi possível

Renomear Arquivo FTP

Renomeia um arquivo que reside em um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Arquivo a ser renomeado	Não	Arquivo FTP		O arquivo a ser renomeado
Novo nome do arquivo	Não	Valor do texto		O novo nome do arquivo. Se você inserir um nome com um caminho, o arquivo também será movido para esse local. Se o local não existir, ele gerará uma exceção

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
Can't rename file error	Indica que não foi possível renomear o arquivo
File not found error	Indica que o arquivo não foi encontrado

Criar diretório FTP

Cria um diretório em um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
New directory	Não	Diretório FTP		O novo diretório. Se um caminho for especificado, todas as novas pastas que levam ao novo diretório serão criadas

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Access denied error	Indica que esta conta não tem acesso a uma operação
File exists error	Indica que o arquivo já existe
Create directory error	Indica que não foi possível criar o diretório
Directory doesn't exist error	Indica que não foi possível encontrar o diretório
Not connected error	Indica que não há uma conexão aberta com o servidor FTP

Excluir diretório FTP

Exclui um diretório de um servidor FTP.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Directory to delete	Não	Diretório FTP		A pasta a ser excluída. Todos os itens da pasta também serão excluídos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção	Description
Delete directory error	Indica que não foi possível excluir o diretório
Remote directory doesn't exist error	Indica que o diretório não existe no servidor FTP
Working directory change error	Indica que não foi possível alterar o diretório de trabalho
Not connected error	Indica que não há uma conexão aberta com o servidor FTP

Invocar o comando FTP

Invoca o comando FTP literal fornecido no servidor.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação para abrir a conexão de FTP
FTP command	Não	Valor do texto		O comando a ser executado junto com quaisquer argumentos. Por exemplo, você pode executar FEAT ou CHMOD aqui
Valid reply code(s)	Sim	Valor do texto		Os códigos que podem ser retornados pelo comando, separados por ponto e vírgula. Se o comando FTP retornar um código que não tiver sido inserido aqui, essa ação gerará uma exceção. Aplica-se apenas a conexões simples de FTP ou FTPS

Variáveis produzidas

Argumento	Type	Description
ReplyCode	Valor do texto	O código real que foi retornado. Aplica-se apenas a conexões simples de FTP ou FTPS
ReplyText	Valor do texto	O texto retornado pelo servidor FTP

Exceções

Exceção	Description
Erro ao invocar comando	Indica que ocorreu um erro ao invocar um comando FTP
Not connected error	Indica que não há uma conexão aberta com o servidor FTP

Sincronizar diretórios

Sincronize os arquivos e subdiretórios de uma determinada pasta com um determinado diretório FTP remoto.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Description
FTP connection	Não	Conexão FTP		A conexão FTP com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Abrir conexão de FTP
Synchronization direction	N/A	Remoto -> local (Download), Local -> remoto (Upload)	Remoto > local (download)	Direção do método Sincronização. Se a pasta local será sincronizada com o diretório remoto (DOWNLOAD) ou se o diretório remoto será sincronizado com a pasta local (UPLOAD)
Files to sync	N/D	Todos os arquivos, Somente arquivos que correspondem ao filtro de arquivo, Somente arquivos que não correspondem ao filtro de arquivo	Todos os arquivos	Escolha se você deseja sincronizar todos os arquivos ou se deseja usar um filtro de arquivo para incluir ou excluir um conjunto específico de arquivos
Filtro de arquivo	Não	Valor do texto	*	Padrão de nome de arquivo que controla quais arquivos serão incluídos ou excluídos. Essa opção permite curingas, como ".txt", "documento?.doc". A opção também permite vários filtros usando vírgula como separador: ".txt,*.pdf,documento?"
Local folder	Não	Pasta		Nome da pasta local a ser sincronizada
FTP directory	Sim	Diretório FTP	/	Nome do diretório FTP a ser sincronizado
Delete if source is absent	N/D	Valor booliano	False	Esta opção excluirá um arquivo ou pasta que existe no diretório de destino, e não a origem.
Include subdirectories	N/D	Valor booliano	Verdadeiro	Esta opção incluirá subdiretórios no processo de sincronização.
Time difference in hours	Sim	Valor numérico	0	Diferença de horário do servidor remoto (em horas) caso opere em um fuso horário diferente.
Time difference in minutes	Sim	Valor numérico	0	Diferença de horário do servidor remoto (em minutos) caso opere em um fuso horário diferente.
Time difference ahead	N/D	Valor booliano	Verdadeiro	Especifique se o fuso horário do servidor está adiantado ou não.

Variáveis produzidas

Argumento	Type	Description
FtpFilesAdded	Lista de Arquivos FTP	Lista de arquivos FTP que existiam inicialmente na origem e após o processo de sincronização foram adicionados ao destino.
FtpFilesModified	Lista de Arquivos FTP	Lista de arquivos FTP que existiam inicialmente na origem e no destino e após o processo de sincronização foram adicionados ao destino.
FtpFilesDeleted	Lista de Arquivos FTP	Lista de arquivos FTP que existiam inicialmente no diretório de destino e após o processo de sincronização foram excluídos.
FilesAdded	Lista de Arquivos	Lista de arquivos que existiam inicialmente na origem e após o processo de sincronização foram adicionados ao destino.
FilesModified	Lista de Arquivos	Lista de arquivos que existiam inicialmente na origem e no destino e após o processo de sincronização foram adicionados ao destino.
FilesDeleted	Lista de Arquivos	Lista de arquivos que existiam inicialmente no diretório de destino e após o processo de sincronização foram excluídos.

Exceções

Exceção	Description
Listing error	Indica que não foi possível executar a listagem da pasta
Not connected error	Indica que não há uma conexão aberta com o servidor FTP
File not found error	Indica que o arquivo não foi encontrado
FTP connection aborted error	Indica que a conexão de FTP foi cancelada
Upload file error	Indica que não foi possível carregar o arquivo
Remote file doesn't exist error	Indica que o arquivo não existe no servidor FTP
Can't download file error	Indica que não foi possível baixar o arquivo
Delete directory error	Indica que não foi possível excluir o diretório
Synchronization failed error	Indica que o processo de sincronização falhou devido a um erro inesperado.