SFTP [EN DESUSO]
SFTP (protocolo de transferencia de archivos SSH) es un protocolo de red que proporciona acceso a archivos, transferencia de archivos y administración de archivos a través de cualquier flujo de datos confiable. Fue diseñado por el Grupo de tareas de ingeniería de Internet (IETF) como una extensión del protocolo Secure Shell (SSH) versión 2.0 para proporcionar funcionalidades seguras de transferencia de archivos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC High) - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
Este conector está en su ruta de acceso de desuso, use el nuevo conector SFTP-SSH . Obtenga más información sobre cómo usar el nuevo conector aquí.
Para usar este conector, necesitará acceso a una clave privada SSH y a la frase de contraseña de clave privada SSH.
Se admiten los siguientes formatos de clave privada:
OpenSSHssh.comPuTTY
El contenido de la clave privada SSH debe copiarse o pegarse completamente en el campo "Clave privada SSH" en el formato de varias líneas. A continuación se muestran los pasos de ejemplo para proporcionar la clave privada SSH mediante Notepad.exe:
- Abra el archivo de clave privada SSH en Notepad.exe;
- Haga clic en Editar → Seleccionar todo;
- Haga clic en Editar → Copiar;
- En el campo "Clave privada SSH" (al crear una conexión), haga clic con el botón derecho del mouse y haga clic en Pegar. No edite manualmente el campo "Clave privada SSH".
Límites de desencadenador
Los desencadenadores funcionan sondeando el sistema de archivos SFTP y buscando cualquier archivo que se haya modificado desde el último sondeo, comparando los archivos por tiempo de modificación. Algunas herramientas permiten conservar el tiempo de modificación del archivo. En tales casos, debe deshabilitar la característica para que el desencadenador funcione. Estos son algunos valores comunes:
| Cliente SFTP | Acción |
|---|---|
| WinSCP | Opciones → Preferencias... → transferencia → Editar... → conservar la marca de tiempo → Deshabilitar |
| FileZilla | Transferir → conservar las marcas de tiempo de los archivos transferidos → Deshabilitar |
Cuando los desencadenadores encuentran un nuevo archivo, intentará asegurarse de que el nuevo archivo está completamente escrito. Por ejemplo, es posible que el archivo se escriba o modifique y que las actualizaciones se realicen en el momento en que el desencadenador sondeó el servidor de archivos. Para evitar devolver un archivo con contenido parcial, el desencadenador tomará nota de la marca de tiempo de estos archivos que se han modificado recientemente, pero no devolverá inmediatamente esos archivos. Esos archivos solo se devolverán cuando el desencadenador vuelva a sondear. A veces, esto puede provocar un retraso hasta dos veces el intervalo de sondeo del desencadenador. Esto también significa que el desencadenador no garantiza que devuelva todos los archivos de una sola ejecución cuando la opción "Dividir activado" está deshabilitada.
El desencadenador no recoge archivos de más de 50 MB si se solicita el contenido.
El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Conector en profundidad
Para más información sobre el conector, consulte la sección en profundidad.
Problemas y limitaciones conocidos
- Este conector puede enviar una solicitud de no-op al back-end.
Límites generales
| Nombre | Importancia |
|---|---|
| Número total máximo de solicitudes por dirección del servidor SFTP por minuto | 600 |
| Número máximo de megabytes que se transfieren hacia o desde el conector dentro de un intervalo de tiempo de ancho de banda (por conexión) | 1 000 |
| Intervalo de tiempo de ancho de banda (en milisegundos) | 60000 |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Dirección del servidor host | cuerda / cadena | Dirección del servidor host | Cierto |
| Nombre de usuario | cuerda / cadena | Nombre de usuario | Cierto |
| Contraseña | securestring | Contraseña | |
| Clave privada SSH | securestring | Clave privada SSH (el contenido del archivo debe proporcionarse completamente tal cual, en formato multilínea) | |
| Frase de contraseña de clave privada SSH | securestring | Frase de contraseña de clave privada SSH (si la clave privada está protegida por una frase de contraseña) | |
| Número de puerto | int | Número de puerto SFTP (ejemplo: 22) | |
| Deshabilitación de la validación de claves de host SSH | bool | ¿Deshabilita la validación de claves de host SSH? (True/False) | |
| Impresión de dedo de clave de host SSH | cuerda / cadena | Impresión de dedo de clave de host SSH | |
| Deshabilitar la funcionalidad reanudar | bool | ¿Deshabilita la funcionalidad reanudar? (True/False) |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar archivo [EN DESUSO] |
Esta acción ha quedado en desuso. Use el archivo Update en su lugar.
|
| Copiar archivo [EN DESUSO] |
Esta acción ha quedado en desuso. Use copiar archivo en su lugar.
|
| Crear archivo [EN DESUSO] |
Esta acción ha quedado en desuso. En su lugar, use Create file (Crear archivo ).
|
| Eliminar archivo [EN DESUSO] |
Esta acción ha quedado en desuso. Use eliminar archivo en su lugar.
|
| Enumerar archivos en la carpeta [EN DESUSO] |
Esta acción ha quedado en desuso. En su lugar, use List files in folder (Enumerar archivos en la carpeta ).
|
| Enumerar archivos en la carpeta raíz [EN DESUSO] |
Esta acción ha quedado en desuso. En su lugar, use List files in root folder (Enumerar archivos en la carpeta raíz ).
|
| Extraer archivo en la carpeta [EN DESUSO] |
Esta acción ha quedado en desuso. Use Extraer archivo en la carpeta en su lugar.
|
| Obtener contenido de archivo [EN DESUSO] |
Esta acción ha quedado en desuso. Use obtener contenido del archivo en su lugar.
|
| Obtener contenido de archivo mediante la ruta de acceso [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener contenido de archivo mediante la ruta de acceso en su lugar.
|
| Obtener metadatos de archivo [EN DESUSO] |
Esta acción ha quedado en desuso. Use obtener metadatos de archivo en su lugar.
|
| Obtener metadatos de archivo mediante la ruta de acceso [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener metadatos de archivo mediante la ruta de acceso en su lugar.
|
Actualizar archivo [EN DESUSO]
Esta acción ha quedado en desuso. Use el archivo Update en su lugar.
Esta operación actualiza el contenido del archivo. Si se elimina o cambia el nombre de un archivo en el servidor justo después de actualizarlo, el conector puede devolver el error HTTP 404 por su diseño. Use un retraso durante 1 minuto antes de eliminar o cambiar el nombre del archivo actualizado recientemente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivo
|
id | True | string |
Especificar el archivo |
|
Contenido del archivo
|
body | True | binary |
Contenido del archivo que se va a actualizar |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Copiar archivo [EN DESUSO]
Esta acción ha quedado en desuso. Use copiar archivo en su lugar.
Esta operación copia un archivo en un servidor SFTP. Si se elimina o cambia el nombre de un archivo en el servidor justo después de copiarlo, el conector puede devolver el error HTTP 404 por su diseño. Use un retraso durante 1 minuto antes de eliminar o cambiar el nombre del archivo recién creado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo de origen
|
source | True | string |
Ruta de acceso al archivo de origen |
|
Ruta de acceso del archivo de destino
|
destination | True | string |
Ruta de acceso al archivo de destino, incluido el nombre de archivo |
|
¿Sobrescribir?
|
overwrite | boolean |
Sobrescribe el archivo de destino si se establece en "true" |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Crear archivo [EN DESUSO]
Esta acción ha quedado en desuso. En su lugar, use Create file (Crear archivo ).
Esta operación carga un archivo en un servidor SFTP. Si se elimina o cambia el nombre de un archivo en el servidor justo después de crearlo, el conector puede devolver el error HTTP 404 por su diseño. Use un retraso durante 1 minuto antes de eliminar o cambiar el nombre del archivo recién creado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Folder path (Ruta de acceso a la carpeta)
|
folderPath | True | string |
Ruta de acceso única de la carpeta |
|
Nombre del archivo
|
name | True | string |
Nombre del archivo |
|
Contenido del archivo
|
body | True | binary |
Contenido del archivo que se va a crear |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Eliminar archivo [EN DESUSO]
Esta acción ha quedado en desuso. Use eliminar archivo en su lugar.
Esta operación elimina un archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivo
|
id | True | string |
Especificar el archivo |
Enumerar archivos en la carpeta [EN DESUSO]
Esta acción ha quedado en desuso. En su lugar, use List files in folder (Enumerar archivos en la carpeta ).
Esta operación obtiene los archivos contenidos en una carpeta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
id | True | string |
Especificar la carpeta |
Devoluciones
- response
- array of BlobMetadata
Enumerar archivos en la carpeta raíz [EN DESUSO]
Esta acción ha quedado en desuso. En su lugar, use List files in root folder (Enumerar archivos en la carpeta raíz ).
Esta operación obtiene los archivos de la carpeta raíz.
Devoluciones
- response
- array of BlobMetadata
Extraer archivo en la carpeta [EN DESUSO]
Esta acción ha quedado en desuso. Use Extraer archivo en la carpeta en su lugar.
Esta operación extrae un archivo de archivo en una carpeta (ejemplo: .zip).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo de origen
|
source | True | string |
Ruta de acceso al archivo de archivo |
|
Ruta de acceso de la carpeta de destino
|
destination | True | string |
Ruta de acceso a la carpeta de destino |
|
¿Sobrescribir?
|
overwrite | boolean |
Sobrescribe los archivos de destino si se establece en "true" |
Devoluciones
- response
- array of BlobMetadata
Obtener contenido de archivo [EN DESUSO]
Esta acción ha quedado en desuso. Use obtener contenido del archivo en su lugar.
Esta operación obtiene el contenido del archivo mediante el identificador de archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivo
|
id | True | string |
Especificar el archivo |
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Inferir el tipo de contenido basado en la extensión |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Obtener contenido de archivo mediante la ruta de acceso [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener contenido de archivo mediante la ruta de acceso en su lugar.
Esta operación obtiene el contenido del archivo mediante la ruta de acceso del archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo
|
path | True | string |
Ruta de acceso única del archivo |
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Inferir el tipo de contenido basado en la extensión |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Obtener metadatos de archivo [EN DESUSO]
Esta acción ha quedado en desuso. Use obtener metadatos de archivo en su lugar.
Esta operación obtiene metadatos de archivo mediante el identificador de archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivo
|
id | True | string |
Especificar el archivo |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Obtener metadatos de archivo mediante la ruta de acceso [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener metadatos de archivo mediante la ruta de acceso en su lugar.
Esta operación obtiene metadatos de archivo mediante la ruta de acceso del archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Ruta de acceso del archivo
|
path | True | string |
Ruta de acceso única del archivo |
Devoluciones
Metadatos de blob
- Body
- BlobMetadata
Desencadenadores
| Cuando se agrega o modifica un archivo (solo propiedades) [EN DESUSO] |
Esta acción ha quedado en desuso. Use cuando los archivos se agreguen o modifiquen (solo propiedades) en su lugar.
|
| Cuando se agrega o modifica un archivo [EN DESUSO] |
Esta acción ha quedado en desuso. Use cuando se agregue o modifique un archivo en su lugar.
|
Cuando se agrega o modifica un archivo (solo propiedades) [EN DESUSO]
Esta acción ha quedado en desuso. Use cuando los archivos se agreguen o modifiquen (solo propiedades) en su lugar.
Esta operación desencadena un flujo cuando se agrega o modifica un archivo en una carpeta. Este desencadenador solo capturará los metadatos del archivo. Para obtener el contenido del archivo, puede usar la operación "Obtener contenido de archivo". El desencadenador se basa en la hora de última modificación de un archivo. Si un cliente de terceros crea un archivo, la conservación de la hora de la última modificación debe deshabilitarse en el cliente. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
folderId | True | string |
Selección de una carpeta |
|
Número de archivos que se van a devolver desde el desencadenador
|
maxFileCount | integer |
Número máximo de archivos devueltos por una sola ejecución de desencadenador (1-100). Tenga en cuenta que la configuración "Dividir activado" puede forzar el desencadenador para procesar cada elemento individualmente. |
Devoluciones
Metadatos de blob
- Lista de archivos
- BlobMetadata
Cuando se agrega o modifica un archivo [EN DESUSO]
Esta acción ha quedado en desuso. Use cuando se agregue o modifique un archivo en su lugar.
Esta operación desencadena un flujo cuando se agrega o modifica un archivo en una carpeta. El desencadenador capturará los metadatos del archivo, así como el contenido del archivo. El desencadenador se basa en la hora de última modificación de un archivo. Si un cliente de terceros crea un archivo, la conservación de la hora de la última modificación debe deshabilitarse en el cliente. El desencadenador omite los archivos de más de 50 megabytes. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Carpeta
|
folderId | True | string |
Especificar una carpeta |
|
Incluir contenido de archivo
|
includeFileContent | boolean |
Si se establece en true, el contenido del archivo también se recuperará junto con la respuesta del desencadenador. |
|
|
Inferencia de tipo de contenido
|
inferContentType | boolean |
Inferir el tipo de contenido basado en la extensión |
Devoluciones
Contenido del archivo.
- Contenido del archivo
- binary
Definiciones
BlobMetadata
Metadatos de blob
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Identificador único del archivo o carpeta. |
|
Nombre
|
Name | string |
Nombre del archivo o carpeta. |
|
DisplayName (Nombre para mostrar)
|
DisplayName | string |
Nombre para mostrar del archivo o carpeta. |
|
Ruta
|
Path | string |
Ruta de acceso del archivo o carpeta. |
|
ÚltimaModificación
|
LastModified | date-time |
Fecha y hora en que se modificó por última vez el archivo o carpeta. |
|
Tamaño
|
Size | integer |
Tamaño del archivo o carpeta. |
|
Tipo de medio
|
MediaType | string |
Tipo de medio del archivo o carpeta. |
|
IsFolder
|
IsFolder | boolean |
Valor booleano (true, false) para indicar si el blob es una carpeta o no. |
|
ETag
|
ETag | string |
Etiqueta etag del archivo o carpeta. |
|
FileLocator
|
FileLocator | string |
Filelocator del archivo o carpeta. |
binary
Este es el tipo de datos básico "binary".