SFTP [OBSOLETO]
SFTP (SSH File Transfer Protocol) é um protocolo de rede que fornece acesso a arquivos, transferência de arquivos e gerenciamento de arquivos em qualquer fluxo de dados confiável. Ele foi projetado pela Internet Engineering Task Force (IETF) como uma extensão do protocolo Secure Shell (SSH) versão 2.0 para fornecer recursos seguros de transferência de arquivos.
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 , exceto as seguintes: - Departamento de Defesa dos EUA (DoD) |
| 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) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
Este conector está em seu caminho de descontinuação, use o novo conector SFTP-SSH . Leia mais sobre como usar o novo conector aqui.
Para usar esse conector, você precisará acessar uma chave privada SSH e a senha de chave privada SSH.
São suportados os seguintes formatos de chave privada:
OpenSSHssh.comPuTTY
O conteúdo da chave privada SSH deve ser copiado/colado inteiramente no campo "Chave privada SSH" no formato multilinha. Abaixo estão exemplos de etapas de como fornecer a chave privada SSH usando Notepad.exe:
- Abra o arquivo de chave privada SSH no Notepad.exe;
- Clique em Editar → Selecionar Tudo;
- Clique em Editar → Copiar;
- No campo "Chave privada SSH" (ao criar uma conexão), clique com o botão direito do mouse e clique em Colar. Não edite o campo "Chave privada SSH" manualmente.
Limites de gatilho
Os gatilhos funcionam pesquisando o sistema de arquivos SFTP e procurando por qualquer arquivo que tenha sido modificado desde a última pesquisa, comparando arquivos por tempo de modificação. Algumas ferramentas permitem que o tempo de modificação do arquivo seja preservado. Nesses casos, você precisa desativar o recurso para que o gatilho funcione. Aqui estão algumas configurações comuns:
| Cliente SFTP | Ação |
|---|---|
| WinSCP | Opções → Preferências... → Transferência → Editar... → Preservar carimbo de data/hora → Desativar |
| FileZilla | Transferir → Preservar carimbos de data/hora de arquivos transferidos → Desativar |
Quando os gatilhos encontrarem um novo arquivo, ele tentará garantir que o novo arquivo seja completamente gravado. Por exemplo, é possível que o arquivo esteja sendo gravado ou modificado e atualizações estejam sendo feitas no momento em que o gatilho sondou o servidor de arquivos. Para evitar retornar um arquivo com conteúdo parcial, o gatilho tomará nota do carimbo de data/hora desses arquivos que foram modificados recentemente, mas não retornará imediatamente esses arquivos. Esses arquivos serão retornados somente quando o gatilho for acionado novamente. Às vezes, isso pode levar a um atraso de até duas vezes o intervalo de sondagem do gatilho. Isso também significa que o gatilho não garante retornar todos os arquivos em uma única execução quando a opção "Dividir em" estiver desativada.
O gatilho não pega arquivos com mais de 50 MB se o conteúdo for solicitado.
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.
Conector em profundidade
Para obter mais informações sobre o conector, consulte a seção detalhada.
Problemas conhecidos e limitações
- Esse conector pode enviar uma solicitação de no-op para o back-end.
Limites Gerais
| Nome | Valor |
|---|---|
| Número total máximo de solicitações por endereço de servidor SFTP por minuto | 600 |
| 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 host | cadeia (de caracteres) | Endereço do servidor host | Verdade |
| Nome de Utilizador | cadeia (de caracteres) | Nome de Utilizador | Verdade |
| Palavra-passe | securestring | Palavra-passe | |
| Chave privada SSH | securestring | Chave privada SSH (o conteúdo do arquivo deve ser fornecido inteiramente como está, no formato multilinha) | |
| Senha de chave privada SSH | securestring | Senha de chave privada SSH (se a chave privada estiver protegida por uma senha) | |
| Número da porta | int | Número da porta SFTP (exemplo: 22) | |
| Desabilitar a validação de chave de host SSH | bool | Desativar a validação de chave de host SSH? (Verdadeiro/Falso) | |
| Impressão digital da chave do host SSH | cadeia (de caracteres) | Impressão digital da chave do host SSH | |
| Desativar a capacidade de retomada | bool | Desativar a capacidade de retomar? (Verdadeiro/Falso) |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Arquivo de atualização [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use o arquivo de atualização .
|
| Copiar arquivo [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Copiar arquivo .
|
| Criar arquivo [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Criar arquivo .
|
| Excluir arquivo [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Excluir arquivo .
|
| Extrair arquivo para pasta [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Extrair arquivo para a pasta .
|
| Listar arquivos na pasta [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Listar arquivos na pasta .
|
| Listar arquivos na pasta raiz [DEPRECATED] |
Esta ação foi preterida. Por favor, use Listar arquivos na pasta raiz em vez disso.
|
| Obter conteúdo de arquivo usando o caminho [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo usando o caminho .
|
| Obter conteúdo do arquivo [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo .
|
| Obter metadados de arquivo [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo .
|
| Obter metadados de arquivo usando o caminho [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo usando caminho .
|
Arquivo de atualização [DEPRECATED]
Esta ação foi preterida. Em vez disso, use o arquivo de atualização .
Esta operação atualiza o conteúdo do 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.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ficheiro
|
id | True | string |
Especificar o ficheiro |
|
Conteúdo do ficheiro
|
body | True | binary |
Conteúdo do ficheiro a atualizar |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Copiar arquivo [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Copiar arquivo .
Esta operação copia um arquivo para um servidor SFTP. 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.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo de origem
|
source | True | string |
Caminho para o arquivo de origem |
|
Caminho do arquivo de destino
|
destination | True | string |
Caminho para o arquivo de destino, incluindo o nome do arquivo |
|
Substituir?
|
overwrite | boolean |
Substitui o arquivo de destino se definido como 'true' |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Criar arquivo [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Criar arquivo .
Esta operação carrega um arquivo para um servidor SFTP. 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.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho da pasta
|
folderPath | True | string |
Caminho exclusivo da pasta |
|
Nome do ficheiro
|
name | True | string |
Nome do ficheiro |
|
Conteúdo do ficheiro
|
body | True | binary |
Conteúdo do ficheiro a criar |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Excluir arquivo [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Excluir arquivo .
Esta operação exclui um arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ficheiro
|
id | True | string |
Especificar o ficheiro |
Extrair arquivo para pasta [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Extrair arquivo para a pasta .
Esta operação extrai um arquivo morto para uma pasta (exemplo: .zip).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo de origem
|
source | True | string |
Caminho para o arquivo morto |
|
Caminho da pasta de destino
|
destination | True | string |
Caminho para a pasta de destino |
|
Substituir?
|
overwrite | boolean |
Substitui os arquivos de destino se definido como 'true' |
Devoluções
- response
- array of BlobMetadata
Listar arquivos na pasta [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Listar arquivos na pasta .
Esta operação obtém arquivos contidos em uma pasta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
id | True | string |
Especifique a pasta |
Devoluções
- response
- array of BlobMetadata
Listar arquivos na pasta raiz [DEPRECATED]
Esta ação foi preterida. Por favor, use Listar arquivos na pasta raiz em vez disso.
Esta operação obtém os arquivos na pasta raiz.
Devoluções
- response
- array of BlobMetadata
Obter conteúdo de arquivo usando o caminho [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo usando o caminho .
Esta operação obtém o conteúdo do arquivo usando o caminho do arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
Caminho exclusivo do arquivo |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Inferir tipo de conteúdo com base na extensão |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Obter conteúdo do arquivo [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo .
Esta operação obtém o conteúdo do arquivo usando a ID do arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ficheiro
|
id | True | string |
Especificar o ficheiro |
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Inferir tipo de conteúdo com base na extensão |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Obter metadados de arquivo [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo .
Esta operação obtém metadados de arquivo usando a ID do arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ficheiro
|
id | True | string |
Especificar o ficheiro |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Obter metadados de arquivo usando o caminho [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo usando caminho .
Esta operação obtém metadados de arquivo usando o caminho do arquivo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
Caminho exclusivo do arquivo |
Devoluções
Metadados de Blob
- Body
- BlobMetadata
Acionadores
| Quando um arquivo é adicionado ou modificado (somente propriedades) [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Quando os arquivos são adicionados ou modificados (somente propriedades).
|
| Quando um arquivo é adicionado ou modificado [DEPRECATED] |
Esta ação foi preterida. Por favor, use Quando um arquivo é adicionado ou modificado em vez disso.
|
Quando um arquivo é adicionado ou modificado (somente propriedades) [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Quando os arquivos são adicionados ou modificados (somente propriedades).
Esta operação dispara um fluxo quando um arquivo é adicionado ou modificado 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.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Selecione uma pasta |
|
Número de arquivos a serem retornados do gatilho
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por uma única execução de gatilho (1-100). Observe que a configuração 'Dividir em' pode forçar o gatilho a processar cada item individualmente. |
Devoluções
Metadados de Blob
- Lista de ficheiros
- BlobMetadata
Quando um arquivo é adicionado ou modificado [DEPRECATED]
Esta ação foi preterida. Por favor, use Quando um arquivo é adicionado ou modificado em vez disso.
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.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Especificar uma pasta |
|
Incluir conteúdo de arquivo
|
includeFileContent | boolean |
Se definido como true, o conteúdo do arquivo também será recuperado junto com a resposta do gatilho |
|
|
Inferir tipo de conteúdo
|
inferContentType | boolean |
Inferir tipo de conteúdo com base na extensão |
Devoluções
O conteúdo do arquivo.
- Conteúdo do Ficheiro
- binary
Definições
BlobMetadata
Metadados de Blob
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
A ID exclusiva do arquivo ou pasta. |
|
Nome
|
Name | string |
O nome do arquivo ou pasta. |
|
Nome de Exibição
|
DisplayName | string |
O nome para exibição do arquivo ou pasta. |
|
Caminho
|
Path | string |
O caminho do arquivo ou pasta. |
|
Última modificação
|
LastModified | date-time |
A data e a hora em que o arquivo ou pasta foi modificado pela última vez. |
|
Tamanho
|
Size | integer |
O tamanho do arquivo ou pasta. |
|
MediaType
|
MediaType | string |
O tipo de mídia do arquivo ou pasta. |
|
IsFolder
|
IsFolder | boolean |
Um valor booleano (true, false) para indicar se o blob é ou não uma pasta. |
|
ETag
|
ETag | string |
O etag do arquivo ou pasta. |
|
Localizador de arquivos
|
FileLocator | string |
O localizador de arquivos do arquivo ou pasta. |
binário
Este é o tipo de dados básico 'binário'.