SFTP [PRETERIDO]
O SFTP (Protocolo de Transferência de Arquivo SSH) é um protocolo de rede que fornece acesso a arquivos, transferência de arquivo e gerenciamento de arquivos em qualquer fluxo de dados confiável. Ele foi projetado pelo IETF (Internet Engineering Task Force) como uma extensão do protocolo SSH (Secure Shell protocol) versão 2.0 para fornecer recursos seguros de transferência de arquivo.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , 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 | |
|---|---|
| Publicador | Microsoft |
Esse conector está em seu caminho de substituição, use o novo conector SFTP-SSH . Leia mais sobre como usar o novo conector aqui.
Para usar esse conector, você precisará de acesso a uma chave privada SSH e à senha de chave privada SSH.
Há suporte para 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. Veja abaixo as etapas de exemplo 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 no botão direito do mouse e clique em Colar. Não edite o campo "Chave privada SSH" manualmente.
Limites de gatilho
Os gatilhos funcionam sondando o sistema de arquivos SFTP e procurando qualquer arquivo que tenha sido modificado desde a última pesquisa, comparando arquivos por tempo de modificação. Determinadas ferramentas permitem que o tempo de modificação do arquivo seja preservado. Nesses casos, você precisa desabilitar o recurso para que o gatilho funcione. Aqui estão algumas configurações comuns:
| Cliente SFTP | Ação |
|---|---|
| WinSCP | Opções → preferências... → Transfer → Editar... → Preservar o carimbo de data/hora → Desabilitar |
| FileZilla | Transferir → Preservar carimbos de data/hora de arquivos transferidos → Desabilitar |
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 as atualizações estejam sendo feitas no momento em que o gatilho pesquisou o servidor de arquivos. Para evitar o retorno de 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 sondar 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 o retorno de todos os arquivos em uma única execução quando a opção "Split On" está desabilitada.
O gatilho não pegará arquivos acima de 50 MB se o conteúdo for solicitado.
O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Conector aprofundado
Para obter mais informações sobre o conector, consulte a seção detalhada.
Problemas e limitações conhecidos
- Esse conector pode enviar uma solicitação no-op para o back-end.
Limites Gerais
| Nome | Value |
|---|---|
| Número total máximo de solicitações por endereço do servidor SFTP por minuto | 600 |
| 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 | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 | Endereço do servidor host | Verdade |
| Nome do usuário | cadeia | Nome do usuário | Verdade |
| Senha | secureString | Senha | |
| Chave privada SSH | secureString | Chave privada SSH (o conteúdo do arquivo deve ser fornecido inteiramente como está, no formato multilinha) | |
| Frase secreta de chave privada SSH | secureString | Frase secreta de chave privada SSH (se a chave privada estiver protegida por uma frase secreta) | |
| Número da porta | int | Número da porta SFTP (exemplo: 22) | |
| Desabilitar a validação da chave de host SSH | bool | Desabilitar a validação da chave de host SSH? (True/False) | |
| Impressão de dedo da chave do host SSH | cadeia | Impressão de dedo da chave do host SSH | |
| Desabilitar a funcionalidade de retomada | bool | Desabilitar a funcionalidade de retomada? (True/False) |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar arquivo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use o arquivo De atualização .
|
| Copiar arquivo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use o arquivo Copy .
|
| Criar arquivo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Criar arquivo .
|
| Excluir arquivo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Excluir arquivo .
|
| Extrair arquivo morto para pasta [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Extrair arquivo para pasta .
|
| Listar arquivos na pasta [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use arquivos de lista na pasta .
|
| Listar arquivos na pasta raiz [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use arquivos de lista na pasta raiz .
|
| Obter conteúdo do arquivo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo .
|
| Obter conteúdo do arquivo usando o caminho [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo usando o caminho .
|
| Obter metadados de arquivo [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo .
|
| Obter metadados de arquivo usando o caminho [PRETERIDO] |
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo usando o caminho .
|
Atualizar arquivo [PRETERIDO]
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 ser atualizado, o conector poderá retornar o erro HTTP 404 por seu design. Use um atraso de 1 minuto antes de excluir ou renomear o arquivo atualizado recentemente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo |
|
Conteúdo do ficheiro
|
body | True | binary |
Conteúdo do arquivo a ser atualizado |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Copiar arquivo [PRETERIDO]
Esta ação foi preterida. Em vez disso, use o arquivo Copy .
Essa 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 poderá retornar o erro HTTP 404 por seu design. Use um atraso por 1 minuto antes de excluir ou renomear o arquivo recém-criado.
Parâmetros
| Nome | Chave | Obrigató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 |
|
Sobrescrever?
|
overwrite | boolean |
Substitui o arquivo de destino se definido como 'true' |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Criar arquivo [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Criar arquivo .
Essa operação carrega um arquivo em um servidor SFTP. Se um arquivo estiver sendo excluído/renomeado no servidor logo após ter sido criado, o conector poderá retornar o erro HTTP 404 pelo design. Use um atraso por 1 minuto antes de excluir ou renomear o arquivo recém-criado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho da pasta
|
folderPath | True | string |
Caminho exclusivo da pasta |
|
Nome do arquivo
|
name | True | string |
Nome do arquivo |
|
Conteúdo do ficheiro
|
body | True | binary |
Conteúdo do arquivo a ser criado |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Excluir arquivo [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Excluir arquivo .
Essa operação exclui um arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo |
Extrair arquivo morto para pasta [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Extrair arquivo 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 |
Caminho para o arquivo morto |
|
Caminho da pasta de destino
|
destination | True | string |
Caminho para a pasta de destino |
|
Sobrescrever?
|
overwrite | boolean |
Substitui os arquivos de destino se definido como 'true' |
Retornos
- response
- array of BlobMetadata
Listar arquivos na pasta [PRETERIDO]
Esta ação foi preterida. Em vez disso, use arquivos de lista na pasta .
Essa operação obtém arquivos contidos em uma pasta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
id | True | string |
Especificar a pasta |
Retornos
- response
- array of BlobMetadata
Listar arquivos na pasta raiz [PRETERIDO]
Esta ação foi preterida. Em vez disso, use arquivos de lista na pasta raiz .
Essa operação obtém os arquivos na pasta raiz.
Retornos
- response
- array of BlobMetadata
Obter conteúdo do arquivo [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo .
Essa operação obtém o conteúdo do arquivo usando a ID do arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar 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 conteúdo do arquivo usando o caminho [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Obter conteúdo do arquivo usando o caminho .
Essa operação obtém o conteúdo do arquivo usando o caminho do arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
Caminho exclusivo do 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 [PRETERIDO]
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
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Especificar o arquivo |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Obter metadados de arquivo usando o caminho [PRETERIDO]
Esta ação foi preterida. Em vez disso, use Obter metadados de arquivo usando o caminho .
Esta operação obtém metadados de arquivo usando o caminho do arquivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Caminho do arquivo
|
path | True | string |
Caminho exclusivo do arquivo |
Retornos
Metadados de blob
- Corpo
- BlobMetadata
Gatilhos
| Quando um arquivo é adicionado ou modificado (somente propriedades) [PRETERIDO] |
Esta ação foi preterida. Use quando os arquivos forem adicionados ou modificados (somente propriedades).
|
| Quando um arquivo é adicionado ou modificado [PRETERIDO] |
Esta ação foi preterida. Use quando um arquivo for adicionado ou modificado .
|
Quando um arquivo é adicionado ou modificado (somente propriedades) [PRETERIDO]
Esta ação foi preterida. Use quando os arquivos forem adicionados ou modificados (somente propriedades).
Essa 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 deverá ser desabilitada no cliente. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
folderId | True | string |
Selecionar uma pasta |
|
Número de arquivos a serem retornados do gatilho
|
maxFileCount | integer |
Número máximo de arquivos a serem retornados por execução de gatilho único (1 a 100). Observe que a configuração 'Split On' pode forçar o gatilho a processar cada item individualmente. |
Retornos
Metadados de blob
- Lista de arquivos
- BlobMetadata
Quando um arquivo é adicionado ou modificado [PRETERIDO]
Esta ação foi preterida. Use quando um arquivo for adicionado ou modificado .
Essa 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 deverá ser desabilitada no cliente. Arquivos maiores que 50 megabytes são ignorados pelo gatilho. O gatilho não será acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos deverão ser criados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pasta
|
folderId | True | string |
Especificar uma pasta |
|
Incluir conteúdo do 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 o tipo de conteúdo com base na extensão |
Retornos
O conteúdo do ficheiro.
- Conteúdo do arquivo
- binary
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. |
binário
Esse é o tipo de dados básico 'binary'.