Dela via

SFTP – SSH

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:
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner
Power Apps Norm Alla Power Apps-regioner utom följande:
     - US Department of Defense (DoD)
Power Automate Norm Alla Power Automate-regioner utom följande:
     - 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

Guide för anslutningsprogram

Den här artikeln beskriver åtgärderna för SFTP-SSH hanterad anslutningsapp, som är tillgänglig för Azure Logic Apps, Power Automate och Power Apps. Den inbyggda SFTP-anslutningsappen är endast tillgänglig för arbetsflöden för standardlogikappar i Azure Logic Apps. Mer information finns i Ansluta till en SFTP-server med hjälp av SSH i Azure Logic Apps och inbyggd SFTP-anslutningsreferens för Azure Logic Apps.

Skillnader från den inaktuella SFTP-hanterade anslutningsappen

Jämfört med den inaktuella SFTP-hanterade anslutningsappen har SFTP-SSH hanterad anslutningsapp följande viktiga funktioner:

  • Använder SSH.NET-biblioteket, som är ett SSH-bibliotek (Secure Shell) med öppen källkod som stöder .NET.

  • Innehåller åtgärden Skapa mapp , som skapar en mapp på den angivna sökvägen på SFTP-servern.

  • Innehåller åtgärden Byt namn på fil , som byter namn på en fil på SFTP-servern.

  • Cachelagrar anslutningen till SFTP-servern i upp till 1 timme. Den här funktionen förbättrar prestandan och minskar hur ofta anslutningsappen försöker ansluta till servern. Om du vill ange varaktigheten för det här cachelagringsbeteendet redigerar du egenskapen ClientAliveInterval i SSH-konfigurationen på SFTP-servern.

Autentisering och behörigheter

  • När du skapar en anslutning till SFTP-servern måste du ange SFTP-serveradressen, autentiseringsuppgifterna för kontot, en privat SSH-nyckel och lösenordet för den privata SSH-nyckeln. Om din plattform stöder uppladdning av stora filer med segmentering behöver du även både läs- och skrivåtkomst för rotmappen på SFTP-servern.

  • SFTP-SSH-anslutningsappen stöder både autentisering av privata nycklar och lösenordsautentisering. Men SFTP-SSH-anslutningsappen stöder endast följande privata nyckelformat, algoritmer för nyckelutbyte, krypteringsalgoritmer och fingeravtryck:

    • Privata nyckelformat: RSA-nycklar (Rivest Shamir Adleman) och DSA-nycklar (algoritm för digital signatur) i både OpenSSH- och ssh.com-format. Om din privata nyckel är i PuTTY-filformat (.ppk) konverterar du först nyckeln till filformatet OpenSSH (.pem).
    • Algoritmer för nyckelutbyte:
      • curve25519-sha256
      • curve25519-sha256@libssh.org
      • ecdh-sha2-nistp256
      • ecdh-sha2-nistp384
      • ecdh-sha2-nistp521
      • diffie-hellman-group-exchange-sha256
      • diffie-hellman-group-exchange-sha1
      • diffie-hellman-group16-sha512
      • diffie-hellman-group14-sha256
      • diffie-hellman-group14-sha1
      • diffie-hellman-group1-sha1
    • Krypteringsalgoritmer:
      • aes256-ctr
      • 3des-cbc
      • aes128-cbc
      • aes192-cbc
      • aes256-cbc
      • blowfish-cbc
      • twofish-cbc
      • twofish192-cbc
      • twofish128-cbc
      • twofish256-cbc
      • arcfour
      • arcfour128
      • arcfour256
      • cast128-cbc
      • aes128-ctr
      • aes192-ctr
    • Värdnyckelalgoritmer:
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • Fingeravtryck: MD5. Mer information finns i Hitta MD5-fingeravtrycket.

  • När du anger din privata SSH-nyckel för anslutningen ska du inte ange eller redigera nyckeln manuellt, vilket kan leda till att anslutningen misslyckas. Kontrollera i stället att du kopierar nyckeln från din privata SSH-nyckelfil och klistrar in nyckeln i rutan anslutningsinformation.

    Följ dessa steg om du vill kopiera och klistra in din privata SSH-nyckel korrekt.

    1. Öppna din privata SSH-nyckelfil i valfri textredigerare. De här stegen fortsätter att använda Anteckningar som exempel.

    2. I Anteckningar går du till menyn Redigera och väljer Välj alla. (Tryck på Ctrl + A)

    3. På menyn Redigera väljer du Kopiera.

    4. I rutan SFTP-SSH anslutningsinformation klistrar du in den fullständiga kopierade nyckeln i egenskapen för den privata SSH-nyckeln , som stöder flera rader. Ange eller redigera inte nyckeln manuellt.

    5. När du har angett anslutningsinformationen väljer du Skapa.

Konvertera PuTTY-baserad nyckel till OpenSSH

PuTTY-formatet och OpenSSH-formatet använder olika filnamnstillägg. PuTTY-formatet använder filnamnstillägget .ppk eller PuTTY Private Key. OpenSSH-formatet använder filnamnstillägget .pem eller Privacy Enhanced Mail. Om din privata nyckel är i PuTTY-format och du måste använda OpenSSH-format, konverterar du först nyckeln till OpenSSH-formatet genom att följa dessa steg:

  • Unix-baserat operativsystem

    1. Om du inte har Installerat PuTTY-verktygen på systemet gör du det nu, till exempel:

      sudo apt-get install -y putty

    2. Kör följande kommando, som skapar en fil som du kan använda med SFTP-SSH-anslutningsappen:

      puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

      Till exempel

      puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

  • Windows operativsystem

    1. Om du inte redan har gjort det laddar du ned det senaste Verktyget PuTTY Generator (puttygen.exe) och öppnar sedan verktyget.

    2. I verktyget PuTTY Key Generator (puttygen.exe) under Åtgärder väljer du Läs in.

    3. Bläddra till din privata nyckelfil i PuTTY-format och välj Öppna.

    4. På menyn Konverteringar väljer du Exportera OpenSSH-nyckel.

    5. Spara den privata nyckelfilen med filnamnstillägget .pem .

Hitta MD5-fingeravtrycket

SFTP-SSH-anslutningsappen avvisar en anslutning om både SFTP-serverns fingeravtryck och förväntade fingeravtryck inte matchar. Prova följande alternativ för att hämta MD5-fingeravtrycket, som är en sekvens med 16 par hexsiffror avgränsade med kolon.

Du har nyckeln

MD5-nyckeln är en sträng på 47 tecken som avgränsas av kolon. Om du vill hämta MD5-fingeravtrycket när du har nyckeln kan du använda verktyg som ssh-keygen.

Från en Bash-prompt anger du till exempel följande kommando:

ssh-keygen -l -f id_rsa.pub -E md5

Du har inte nyckeln

Om du vill hämta ett MD5-fingeravtryck när du inte har en nyckel kan du använda det senaste verktyget server- och protokollinformationsdialogruta av WinSCP, eller så kan du använda verktyget PuTTY-konfiguration i stället:

  1. I putty-konfigurationsverktyget (putty.exe) i fönstret Kategori expanderar duAnslutnings-SSH-värdnycklar>>.

  2. Under Inställningar för värdnyckelalgoritm öppnar du listan Algoritmvalsprincip och kontrollerar att RSA visas högst upp.

  3. Om RSA inte visas överst väljer du RSA och sedan Upp tills RSA flyttas överst.

  4. Anslut till SFTP-servern med PuTTY. När anslutningen har skapats väljer du Mer information när PUTTY-säkerhetsaviseringen visas.

    Anmärkning

    Om säkerhetsaviseringen inte visas kan du prova att rensa posten SshHostKeys . Öppna Windows-registereditorn och bläddra till följande post:

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. När PuTTY: information om serverns värdnyckelruta visas letar du reda på egenskapen MD5-fingeravtryck och kopierar strängvärdet på 47 tecken, vilket ser ut som i följande exempel:

    **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

Kända problem och begränsningar med utlösare

  • SFTP-hanterade anslutningsutlösare kan uppleva saknade, ofullständiga eller fördröjda resultat.

    • Resultat saknas

      SFTP utlöser arbete genom avsökning eller kontroll av SFTP-filsystemet och letar efter filer som har ändrats sedan den senaste undersökningen. SFTP-utlösare för hanterade anslutningsappar jämför filversioner med hjälp av filens senaste ändrade tidsstämpel.

      Om du skapar, lägger till eller uppdaterar en fil med en tidsstämpel som är tidigare än den senast spårade senast ändrade tidsstämpeln identifierar inte utlösaren för SFTP-hanterad anslutningsapp den här filen.

      Om du använder ett externt verktyg eller en klient som skapar, lägger till eller uppdaterar filer på SFTP-servern ska du därför inaktivera alla funktioner i verktyget eller klienten som bevarar en fils senast ändrade tidsstämpel.

      I följande tabell visas några vanliga verktyg som bevarar den här tidsstämpeln och stegen för att inaktivera den här funktionen:

      SFTP-klient Åtgärd
      WinSCP Gå till AlternativInställningar>>Överför Redigera>>Bevara tidsstämpel>Inaktivera.
      FileZilla Gå till Överför>Bevara tidsstämplar för överförda filer>Inaktivera.

    • Ofullständiga eller fördröjda resultat

      När en SFTP-utlösare söker efter en nyligen skapad, tillagd eller uppdaterad fil kontrollerar utlösaren även om filen är klar. En fil kan till exempel ha ändringar som pågår när utlösaren kontrollerar SFTP-servern. För att undvika att returnera en ofullständig fil noterar utlösaren filens tidsstämpel, men returnerar inte filen omedelbart. I stället returnerar utlösaren endast filen när utlösaren kontrollerar servern igen.

      Ibland kan det här beteendet orsaka en fördröjning som varar så länge som nästan dubbelt så mycket som utlösarens avsökningsintervall. På grund av det här beteendet kanske SFTP-utlösaren inte returnerar alla filer samtidigt om du inaktiverar SFTP-utlösarens delningsinställning .

Allmänna kända problem och begränsningar

  • Den SFTP-SSH hanterade anslutningsappen stöder för närvarande inte följande SFTP-servrar:

    • Akamai NetStorage
    • FileMage Gateway
    • Globalscape
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • SFTP för Azure Blob Storage
    • VShell Säker filöverföringsserver
    • AWS SFTP

  • Använd separata SFTP-mappar för filbearbetning och uppladdning.

    Se till att använda separata mappar på SFTP-servern för utlösaren för att övervaka filer för bearbetning och lagring av uppladdade filer. Annars utlöses inte utlösaren och beter sig oförutsägbart. Utlösaren kan till exempel hoppa över ett slumpmässigt antal filer som behöver bearbetas.

    Den här begränsningen innebär att du behöver ett sätt att flytta filer mellan dessa mappar. Om det här problemet uppstår tar du bort filerna från den övervakade mappen och använder en annan mapp för att lagra uppladdade filer.

  • För att hantera belastningen på delade hanterade anslutningstjänster för flera klientorganisationer kan den hanterade SFTP-SSH-anslutningsappen skapa flera anslutningar från samma käll-IP-adress, d.v.s. anslutningsadressens IP-adress, till målet, som är din SFTP-server. Vissa regioner med låg trafik kanske bara använder tre instanser av virtuella datorer bakom anslutningsappens IP-adress, vilket innebär att dessa regioner kan skapa högst tre anslutningar. Andra regioner kan använda upp till 20 anslutningar eftersom de har samma antal virtuella datorer bakom anslutnings-IP-adressen.

    Om SFTP-servern begränsar antalet anslutningar kanske servern inte fungerar bra med den hanterade SFTP-SSH-anslutningsappen. Du kan dock skapa ett standardarbetsflöde för logikappar som använder de inbyggda SFTP-åtgärderna i stället. Du kan styra utskalningsgränserna och därmed antalet anslutningar.

  • Om du stöter på problem med krypteringssvitens samverkan mellan den SFTP-SSH hanterade anslutningsappen och SFTP-servern kan du prova att skapa ett standardarbetsflöde för logikappar och använda de inbyggda SFTP-åtgärderna i stället. De inbyggda SFTP-åtgärderna stöder ett bredare utbud av chiffersviter.

  • Den här anslutningsappen kan skicka en no-op begäran till serverdelen.

Chunking

  • I Azure Logic Apps och Power Automate stöder följande hanterade SFTP-SSH-anslutningsåtgärder segmentering där en åtgärd kan aktivera hantering av stora filer i mindre delar. Mer information om segmentering i Azure Logic Apps finns i [Hantera stora meddelanden med segmentering]](/azure/logic-apps/logic-apps-handle-large-messages).

    Åtgärd Stöd för segmentering Åsidosätt stöd för segmentstorlek
    Kopiera fil Nej Ej tillämpligt
    Skapa fil Yes Yes
    Skapa mapp Ej tillämpligt Ej tillämpligt
    Ta bort fil Ej tillämpligt Ej tillämpligt
    Extrahera arkiv till mapp Ej tillämpligt Ej tillämpligt
    Hämta filinnehåll Yes Yes
    Hämta filinnehåll med hjälp av sökvägen Yes Yes
    Hämta filmetadata Ej tillämpligt Ej tillämpligt
    Hämta filmetadata med hjälp av sökvägen Ej tillämpligt Ej tillämpligt
    Visa en lista över filer i mappen Ej tillämpligt Ej tillämpligt
    Byt namn på fil Ej tillämpligt Ej tillämpligt
    Uppdatera fil Nej Ej tillämpligt

    SFTP-SSH åtgärder som stöder segmentering kan hantera filer upp till 1 GB, medan SFTP-SSH åtgärder som inte stöder segmentering kan hantera filer upp till 50 MB. Standardstorleken för segment är 15 MB. Den här storleken kan dock ändras dynamiskt från 5 MB och gradvis ökas till maximalt 50 MB. Dynamisk storleksändring baseras på faktorer som nätverksfördröjning, serversvarstid och så vidare.

    Du kan åsidosätta det här anpassningsbara beteendet när du anger en konstant segmentstorlek som ska användas i stället. Den här storleken kan vara mellan 5 MB och 50 MB. Anta till exempel att du har en fil på 45 MB och ett nätverk som stöder filstorleken utan svarstid. Anpassningsbar segmentering resulterar i flera anrop, snarare än ett anrop. Om du vill minska antalet anrop kan du prova att ange en segmentstorlek på 50 MB. I ett annat scenario kan du prova att minska storleken till 5 MB om arbetsflödet för logikappen överskrider tidsgränsen, till exempel när du använder segment på 15 MB.

    Segmentstorleken är associerad med en anslutning. Det här attributet innebär att du kan använda samma anslutning för båda åtgärderna som stöder segmentering och åtgärder som inte stöder segmentering. I det här fallet varierar segmentstorleken för åtgärder som stöder segmentering från 5 MB till 50 MB.

    Om du vill åsidosätta det anpassningsbara standardbeteende som segmentering använder på en SFTP-SSH åtgärd kan du ange en konstant segmentstorlek från 5 MB till 50 MB.

    1. I designern går du till SFTP-SSH-åtgärdens övre högra hörn, väljer knappen ellipser (...) och väljer sedan Inställningar.

    2. Under Innehållsöverföring i egenskapen Segmentstorlek anger du ett heltalsvärde från 5 till 50.

    3. När du är klar väljer du Klar.

  • SFTP-SSH utlösare stöder inte segmentering av meddelanden. När utlösare begär filinnehåll väljer de endast filer som är 15 MB eller mindre. Om du vill hämta filer som är större än 15 MB följer du det här mönstret i stället:

    1. Använd en SFTP-SSH utlösare som endast returnerar filegenskaper. Dessa utlösare har namn som innehåller beskrivningen (endast egenskaper).

    2. Följ utlösaren med åtgärden SFTP-SSH Hämta filinnehåll . Den här åtgärden läser den fullständiga filen och använder implicit meddelandesegmentering.

Felsökning

401-fel: "401 Obehörig"

Det här felet kan inträffa eftersom du inte har rätt autentiseringsuppgifter eller behörigheter. Mer information finns i Autentisering och behörigheter.

404-fel: "En referens gjordes till en fil eller mapp som inte finns"

Det här felet kan inträffa när du använder åtgärden Skapa fil . När åtgärden skapar en fil på SFTP-servern skickar åtgärden också automatiskt ett anrop till SFTP-servern för att hämta filens metadata.

Om du omedelbart flyttar den nyligen skapade filen innan anropet kan hämta metadata finns filen inte längre på den förväntade platsen och du får ett 404-felmeddelande, En referens gjordes till en fil eller mapp som inte finns.

Om du inte kan undvika eller fördröja flytten av filen kan du hoppa över att läsa filens metadata efter att filen har skapats genom att följa dessa steg:

  1. I åtgärden Skapa fil öppnar du listan Lägg till ny parameter , väljer egenskapen Hämta alla filmetadata och anger värdet till Nej.

  2. Om du behöver dessa filmetadata senare kan du använda åtgärden Hämta filmetadata .

504-fel: "Ett anslutningsförsök misslyckades på grund av att den anslutna parten inte svarade korrekt efter en viss tidsperiod eller upprättad anslutning misslyckades eftersom den anslutna värden inte svarade" eller "Begäran till SFTP-servern har tagit mer än 00:00:30 sekunder"

Det här felet kan inträffa när du inte kan upprätta en anslutning till SFTP-servern. Det kan finnas olika orsaker till det här problemet, så prova följande felsökningsalternativ:

  • Tidsgränsen för anslutningen är 20 sekunder. Kontrollera att SFTP-servern har bra prestanda och att mellanliggande enheter, till exempel brandväggar, inte lägger till mer omkostnader.

  • Kontrollera om SFTP-servern sätter en gräns för antalet anslutningar från varje IP-adress. En sådan gräns hindrar kommunikationen mellan anslutningsappen och SFTP-servern. Ta bort den här gränsen.

  • Om du har konfigurerat en brandvägg kontrollerar du att du lägger till IP-adresserna för den hanterade anslutningsappen för din region i listan över godkända anslutningar.

  • Om felet inträffar tillfälligt ändrar du inställningen Återförsöksprincip för den SFTP-SSH åtgärden till ett återförsöksantal som är högre än de fyra standardförsöken.

  • För att minska kostnaden för anslutningsetablering ökar du egenskapen ClientAliveInterval till cirka en timme i SSH-konfigurationen för SFTP-servern.

  • Granska SFTP-serverloggen för att kontrollera om anrop som skickas till SFTP-servern anländer korrekt. Om du vill ha mer information om anslutningsproblemet kan du även köra en nätverksspårning i brandväggen och SFTP-servern.

Allmänna gränser

Namn Värde
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ärdnyckeln? (Sant/falskt)
Fingerutskrift av SSH-värdnyckel snöre Fingerutskrift av SSH-värdnyckel
Sökväg till rotmapp snöre Sökväg till rotmapp.

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 150 60 sekunder

Åtgärder

Byt namn på fil

Den här åtgärden byter namn på en fil.
Extrahera arkiv till mapp

Den här åtgärden extraherar en arkivfil till en mapp (exempel: .zip).
Hämta filinnehåll

Den här åtgärden hämtar filinnehåll med hjälp av fil-ID:t.
Hämta filinnehåll med hjälp av sökvägen

Den här åtgärden hämtar filinnehåll med hjälp av filsökvägen.
Hämta filmetadata med hjälp av sökvägen

Den här åtgärden hämtar filmetadata med hjälp av filsökvägen.
Hämta metadata för filen

Den här åtgärden hämtar filmetadata med hjälp av fil-ID:t.
Kopiera fil

Den här åtgärden kopierar en fil.
Skapa fil

Den här åtgärden laddar upp en fil.
Skapa mapp

Den här åtgärden skapar en ny mapp.
Ta bort fil

Den här åtgärden tar bort en fil.
Uppdatera fil

Den här åtgärden uppdaterar filinnehållet.
Visa en lista över filer i mappen

Den här åtgärden hämtar filer som finns i en mapp.
Visa en lista över filer i rotmappen

Den här åtgärden hämtar filerna i rotmappen.

Byt namn på fil

Åtgärds-ID:
RenameFile

Den här åtgärden byter namn på en fil.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Välj en fil
Nytt namn
 newName True string

Nytt namn på filen
Hämta alla filmetadata
 ReadFileMetadataFromServer boolean

Hämta alla filmetadata från SFTP-servern när filen har skapats. Om detta är falskt kanske vissa metadataegenskaper inte returneras, till exempel senast ändrad tid osv.

Returer

Representerar metadatasvar för blobdatauppsättningar

Body
BlobMetadataResponse

Extrahera arkiv till mapp

Åtgärds-ID:
ExtractFolderV2

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

Åtgärds-ID:
GetFileContent

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 fil-ID
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 hjälp av sökvägen

Åtgärds-ID:
GetFileContentByPath

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 med hjälp av sökvägen

Åtgärds-ID:
GetFileMetadataByPath

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

Hämta metadata för filen

Åtgärds-ID:
GetFileMetadata

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 fil-ID

Returer

Blob-metadata

Body
BlobMetadata

Kopiera fil

Åtgärds-ID:
CopyFile

Den här åtgärden kopierar en fil.

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"
Hämta alla filmetadata
 ReadFileMetadataFromServer boolean

Hämta alla filmetadata från SFTP-servern när filen har skapats. Om detta är falskt kanske vissa metadataegenskaper inte returneras, till exempel senast ändrad tid osv.

Returer

Blob-metadata

Body
BlobMetadata

Skapa fil

Åtgärds-ID:
CreateFile

Den här åtgärden laddar upp en fil.

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
Hämta alla filmetadata
 ReadFileMetadataFromServer boolean

Hämta alla filmetadata från SFTP-servern när filen har skapats. Om detta är falskt kanske vissa metadataegenskaper inte returneras, till exempel senast ändrad tid osv.

Returer

Blob-metadata

Body
BlobMetadata

Skapa mapp

Åtgärds-ID:
CreateFolder

Den här åtgärden skapar en ny mapp.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderPath True string

Välj en mapp
Namn
 name True string

Namnet på mappen

Returer

Blob-metadata

Body
BlobMetadata

Ta bort fil

Åtgärds-ID:
DeleteFile

Den här åtgärden tar bort en fil.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Ange filen
Hoppa över borttagning om filen inte hittas
 SkipDeleteIfFileNotFoundOnServer boolean

Hoppar över borttagning om en fil inte hittas utan att åtgärden misslyckas.

Uppdatera fil

Åtgärds-ID:
UpdateFile

Den här åtgärden uppdaterar filinnehållet.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Ange filen
Filinnehåll
 body True binary

Innehållet i filen som ska uppdateras
Hämta alla filmetadata
 ReadFileMetadataFromServer boolean

Hämta alla filmetadata från SFTP-servern när filen har skapats. Om detta är falskt kanske vissa metadataegenskaper inte returneras, till exempel senast ändrad tid osv.

Returer

Blob-metadata

Body
BlobMetadata

Visa en lista över filer i mappen

Åtgärds-ID:
ListFolder

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

Åtgärds-ID:
ListRootFolder

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

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.
När filer läggs till eller ändras (endast egenskaper)

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.

När en fil läggs till eller ändras

Åtgärds-ID:
OnUpdatedFile

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

När filer läggs till eller ändras (endast egenskaper)

Åtgärds-ID:
OnUpdatedFiles

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
 maxFileCount integer

Antal filer som returneras från utlösaren (1–100)

Returer

Blob-metadata

Lista över filer
BlobMetadata

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.

BlobMetadataResponse

Representerar metadatasvar för blobdatauppsättningar

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".