SFTP [INAKTUELL]
SFTP (SSH File Transfer Protocol) är ett nätverksprotokoll som ger filåtkomst, filöverföring och filhantering över alla tillförlitliga dataströmmar. Den designades av IETF (Internet Engineering Task Force) som en förlängning av SSH-protokollet (Secure Shell Protocol) version 2.0 för att tillhandahålla säkra filöverföringsfunktioner.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Norm | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC High) - US Department of Defense (DoD) |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: - US Department of Defense (DoD) |
| Power Apps | Norm | Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC High) - US Department of Defense (DoD) |
| Power Automate | Norm | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC High) - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | Microsoft |
| URL |
Microsoft LogicApps Support Microsoft Power Automate-support Microsoft Power Apps Support |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Microsoft |
Den här anslutningsappen är på utfasningssökvägen. Använd den nya SFTP-SSH-anslutningsappen . Läs mer om hur du använder den nya anslutningsappen här.
Om du vill använda den här anslutningsappen behöver du åtkomst till en privat SSH-nyckel och lösenfrasen för den privata SSH-nyckeln.
Följande privata nyckelformat stöds:
OpenSSHssh.comPuTTY
Innehållet i den privata SSH-nyckeln ska kopieras/klistras in helt i fältet "privat SSH-nyckel" i flerradsformat. Nedan visas exempelsteg för hur du anger den privata SSH-nyckeln med hjälp av Notepad.exe:
- Öppna den privata SSH-nyckelfilen i Notepad.exe;
- Klicka på Redigera → Markera alla.
- Klicka på Redigera → Kopiera.
- I fältet "Privat SSH-nyckel" (när du skapar en anslutning) klickar du på höger musknapp och klickar på Klistra in. Redigera inte fältet "privat SSH-nyckel" manuellt.
Utlösargränser
Utlösarna fungerar genom att avsöka SFTP-filsystemet och leta efter alla filer som har ändrats sedan den senaste undersökningen och jämföra filer efter ändringstid. Vissa verktyg tillåter att filändringstiden bevaras. I sådana fall måste du inaktivera funktionen för att utlösaren ska fungera. Här är några vanliga inställningar:
| SFTP-klient | Åtgärd |
|---|---|
| WinSCP | Alternativ → inställningar... → Överför → Redigera... → Bevara tidsstämpel → Inaktivera |
| FileZilla | Överför → Bevara tidsstämplar för överförda filer → Inaktivera |
När utlösarna stöter på en ny fil försöker den se till att den nya filen är helt skriven. Det är till exempel möjligt att filen skrivs eller ändras, och uppdateringar görs när utlösaren avsöker filservern. För att undvika att returnera en fil med partiellt innehåll noterar utlösaren tidsstämpeln sådana filer som nyligen har ändrats, men returnerar inte omedelbart filerna. Dessa filer returneras endast när utlösaren avsöker igen. Ibland kan detta leda till en fördröjning på upp till två gånger intervallet för utlösarens avsökning. Det innebär också att utlösaren inte garanterar att alla filer returneras i en enda körning när alternativet "Dela på" är inaktiverat.
Utlösaren hämtar inte filer över 50 MB om innehållet efterfrågas.
Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
Anslutningsprogram på djupet
Mer information om anslutningsappen finns i avsnittet djupgående.
Kända problem och begränsningar
- Den här anslutningsappen kan skicka en no-op begäran till serverdelen.
Allmänna gränser
| Namn | Värde |
|---|---|
| Maximalt totalt antal begäranden per SFTP-serveradress per minut | 600 |
| Maximalt antal megabyte som överförs till/från anslutningsappen inom ett bandbreddsintervall (per anslutning) | 1 000 |
| Bandbreddstidsintervall (i miliseconds) | 60000 |
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Värdserveradress | snöre | Värdserveradress | Sann |
| Användarnamn | snöre | Användarnamn | Sann |
| Lösenord | securestring | Lösenord | |
| Privat SSH-nyckel | securestring | Privat SSH-nyckel (innehållet i filen ska anges helt som det är i flerradsformat) | |
| Lösenfras för privat SSH-nyckel | securestring | Lösenfras för SSH-privat nyckel (om den privata nyckeln skyddas av en lösenfras) | |
| Portnummer | int | SFTP-portnummer (exempel: 22) | |
| Inaktivera validering av SSH-värdnyckel | bool | Vill du inaktivera validering av SSH-värdnyckel? (Sant/falskt) | |
| Fingerutskrift av SSH-värdnyckel | snöre | Fingerutskrift av SSH-värdnyckel | |
| Inaktivera återuppta-funktionen | bool | Vill du inaktivera funktionen Återuppta? (Sant/falskt) |
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
Åtgärder
| Extrahera arkiv till mapp [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Extrahera arkiv till mapp i stället.
|
| Hämta filinnehåll [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta filinnehåll i stället.
|
| Hämta filinnehåll med sökvägen [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta filinnehåll med sökvägen i stället.
|
| Hämta filmetadata [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta filmetadata i stället.
|
| Hämta filmetadata med hjälp av sökvägen [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta filmetadata med sökvägen i stället.
|
| Kopiera filen [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Kopiera fil i stället.
|
| Skapa fil [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Skapa fil i stället.
|
| Ta bort fil [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Ta bort fil i stället.
|
| Uppdatera filen [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Uppdatera fil i stället.
|
| Visa en lista över filer i mappen [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Listfiler i mappen i stället.
|
| Visa en lista över filer i rotmappen [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Listfiler i rotmappen i stället.
|
Extrahera arkiv till mapp [INAKTUELL]
Den här åtgärden är inaktuell. Använd Extrahera arkiv till mapp i stället.
Den här åtgärden extraherar en arkivfil till en mapp (exempel: .zip).
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sökväg till källarkivfil
|
source | True | string |
Sökväg till arkivfilen |
|
Sökväg till målmapp
|
destination | True | string |
Sökväg till målmappen |
|
Skriver du över?
|
overwrite | boolean |
Skriver över målfilerna om de är inställda på "true" |
Returer
- response
- array of BlobMetadata
Hämta filinnehåll [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta filinnehåll i stället.
Den här åtgärden hämtar filinnehåll med hjälp av fil-ID:t.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Ange filen |
|
Härled innehållstyp
|
inferContentType | boolean |
Härled innehållstyp baserat på tillägg |
Returer
Innehållet i filen.
- Filinnehåll
- binary
Hämta filinnehåll med sökvägen [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta filinnehåll med sökvägen i stället.
Den här åtgärden hämtar filinnehåll med hjälp av filsökvägen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Filväg
|
path | True | string |
Unik sökväg för filen |
|
Härled innehållstyp
|
inferContentType | boolean |
Härled innehållstyp baserat på tillägg |
Returer
Innehållet i filen.
- Filinnehåll
- binary
Hämta filmetadata [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta filmetadata i stället.
Den här åtgärden hämtar filmetadata med hjälp av fil-ID:t.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Ange filen |
Returer
Blob-metadata
- Body
- BlobMetadata
Hämta filmetadata med hjälp av sökvägen [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta filmetadata med sökvägen i stället.
Den här åtgärden hämtar filmetadata med hjälp av filsökvägen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Filväg
|
path | True | string |
Unik sökväg för filen |
Returer
Blob-metadata
- Body
- BlobMetadata
Kopiera filen [INAKTUELL]
Den här åtgärden är inaktuell. Använd Kopiera fil i stället.
Den här åtgärden kopierar en fil till en SFTP-server. Om en fil tas bort/byt namn på servern direkt efter att den har kopierats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen skapade filen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Källfilsökväg
|
source | True | string |
Sökväg till källfilen |
|
Målfilsökväg
|
destination | True | string |
Sökväg till målfilen, inklusive filnamn |
|
Skriver du över?
|
overwrite | boolean |
Skriver över målfilen om den är inställd på "true" |
Returer
Blob-metadata
- Body
- BlobMetadata
Skapa fil [INAKTUELL]
Den här åtgärden är inaktuell. Använd Skapa fil i stället.
Den här åtgärden laddar upp en fil till en SFTP-server. Om en fil tas bort/byt namn på servern direkt efter att den har skapats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen skapade filen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mappsökväg
|
folderPath | True | string |
Unik sökväg för mappen |
|
Filnamn
|
name | True | string |
Filens namn |
|
Filinnehåll
|
body | True | binary |
Innehållet i filen som ska skapas |
Returer
Blob-metadata
- Body
- BlobMetadata
Ta bort fil [INAKTUELL]
Den här åtgärden är inaktuell. Använd Ta bort fil i stället.
Den här åtgärden tar bort en fil.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Ange filen |
Uppdatera filen [INAKTUELL]
Den här åtgärden är inaktuell. Använd Uppdatera fil i stället.
Den här åtgärden uppdaterar filinnehållet. Om en fil tas bort/byt namn på servern direkt efter att den har uppdaterats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen uppdaterade filen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Ange filen |
|
Filinnehåll
|
body | True | binary |
Innehållet i filen som ska uppdateras |
Returer
Blob-metadata
- Body
- BlobMetadata
Visa en lista över filer i mappen [INAKTUELL]
Den här åtgärden är inaktuell. Använd Listfiler i mappen i stället.
Den här åtgärden hämtar filer som finns i en mapp.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mapp
|
id | True | string |
Ange mappen |
Returer
- response
- array of BlobMetadata
Visa en lista över filer i rotmappen [INAKTUELL]
Den här åtgärden är inaktuell. Använd Listfiler i rotmappen i stället.
Den här åtgärden hämtar filerna i rotmappen.
Returer
- response
- array of BlobMetadata
Utlösare
| När en fil läggs till eller ändras (endast egenskaper) [INAKTUELL] |
Den här åtgärden är inaktuell. Använd När filer läggs till eller ändras (endast egenskaper) i stället.
|
| När en fil läggs till eller ändras [INAKTUELL] |
Den här åtgärden är inaktuell. Använd När en fil läggs till eller ändras i stället.
|
När en fil läggs till eller ändras (endast egenskaper) [INAKTUELL]
Den här åtgärden är inaktuell. Använd När filer läggs till eller ändras (endast egenskaper) i stället.
Den här åtgärden utlöser ett flöde när en fil läggs till eller ändras i en mapp. Den här utlösaren hämtar endast filmetadata. Om du vill hämta filinnehållet kan du använda åtgärden Hämta filinnehåll. Utlösaren förlitar sig på den senaste ändrade tiden för en fil. Om en fil skapas av en klient från tredje part bör bevarandet av den senaste ändrade tiden inaktiveras i klienten. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mapp
|
folderId | True | string |
Välj en mapp |
|
Antal filer som ska returneras från utlösaren
|
maxFileCount | integer |
Maximalt antal filer som ska returneras av en utlösarkörning (1–100). Observera att inställningen "Dela på" kan tvinga utlösaren att bearbeta varje objekt individuellt. |
Returer
Blob-metadata
- Lista över filer
- BlobMetadata
När en fil läggs till eller ändras [INAKTUELL]
Den här åtgärden är inaktuell. Använd När en fil läggs till eller ändras i stället.
Den här åtgärden utlöser ett flöde när en fil läggs till eller ändras i en mapp. Utlösaren hämtar både filmetadata och innehållet i filen. Utlösaren förlitar sig på den senaste ändrade tiden för en fil. Om en fil skapas av en klient från tredje part bör bevarandet av den senaste ändrade tiden inaktiveras i klienten. Filer som är större än 50 megabyte hoppas över av utlösaren. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mapp
|
folderId | True | string |
Ange en mapp |
|
Inkludera filinnehåll
|
includeFileContent | boolean |
Om värdet är true hämtas även filinnehållet tillsammans med utlösarsvaret |
|
|
Härled innehållstyp
|
inferContentType | boolean |
Härled innehållstyp baserat på tillägg |
Returer
Innehållet i filen.
- Filinnehåll
- binary
Definitioner
BlobMetadata
Blob-metadata
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Id
|
Id | string |
Det unika ID:t för filen eller mappen. |
|
Namn
|
Name | string |
Namnet på filen eller mappen. |
|
visningsnamn
|
DisplayName | string |
Visningsnamnet för filen eller mappen. |
|
Väg
|
Path | string |
Sökvägen till filen eller mappen. |
|
Senast ändrad
|
LastModified | date-time |
Datum och tid då filen eller mappen senast ändrades. |
|
Storlek
|
Size | integer |
Storleken på filen eller mappen. |
|
Mediatyp
|
MediaType | string |
Medietypen för filen eller mappen. |
|
IsFolder
|
IsFolder | boolean |
Ett booleskt värde (sant, falskt) som anger om bloben är en mapp eller inte. |
|
ETag (ETag)
|
ETag | string |
Etag för filen eller mappen. |
|
FileLocator
|
FileLocator | string |
Fillokaliseraren för filen eller mappen. |
binär
Det här är den grundläggande datatypen "binär".