SFTP – SSH

Az SFTP (SSH File Transfer Protocol) egy hálózati protokoll, amely bármilyen megbízható adatfolyamon keresztül biztosít fájlhozzáférést, fájlátvitelt és fájlkezelést. Az Internet Engineering Task Force (IETF) tervezte a Secure Shell protokoll (SSH) 2.0-s verziójának kiterjesztéseként, hogy biztonságos fájlátviteli képességeket biztosítson.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service Class Régiók
Copilot Studio Standard Az összes Power Automate-régió, kivéve a következőket:
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Minden Logic Apps-régió
Power Alkalmazások Standard Az összes Power Apps-régió , kivéve a következőket:
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate Standard Az összes Power Automate-régió, kivéve a következőket:
     - Amerikai Védelmi Minisztérium (DoD)
Érintkezés
Név Microsoft
URL Microsoft LogicApps-támogatás
Microsoft Power Automate-támogatás
Microsoft Power Apps-támogatás
Összekötő metaadatai
Kiadó Microsoft

Útmutató az összekötőkhöz

Ez a cikk az Azure Logic Appshez, a Power Automate-hez és a Power Appshez elérhető SFTP-SSH felügyelt összekötő műveleteit ismerteti. A beépített SFTP-összekötő csak az Azure Logic Apps standard logikaialkalmazás-munkafolyamataihoz érhető el. További információ: Csatlakozás SFTP-kiszolgálóhoz SSH használatával az Azure Logic Appsben és az Azure Logic Apps beépített SFTP-összekötői referenciája.

Különbségek az elavult SFTP által felügyelt összekötőtől

Az elavult SFTP által felügyelt összekötőhöz képest a SFTP-SSH felügyelt összekötő a következő fő képességeket biztosítja:

  • A SSH.NET kódtárat használja, amely egy nyílt forráskódú Secure Shell-kódtár (SSH), amely támogatja a .NET-et.

  • Megadja a Mappa létrehozása műveletet, amely létrehoz egy mappát az SFTP-kiszolgálón megadott elérési úton.

  • Megadja a Fájl átnevezése műveletet, amely átnevez egy fájlt az SFTP-kiszolgálón.

  • Legfeljebb 1 óráig gyorsítótárazza az SFTP-kiszolgálóhoz való kapcsolatot. Ez a funkció javítja a teljesítményt, és csökkenti, hogy az összekötő milyen gyakran próbál csatlakozni a kiszolgálóhoz. A gyorsítótárazási viselkedés időtartamának beállításához szerkessze a ClientAliveInterval tulajdonságot az SSH-konfigurációban az SFTP-kiszolgálón.

Hitelesítés és engedélyek

  • Amikor kapcsolatot hoz létre az SFTP-kiszolgálóval, meg kell adnia az SFTP-kiszolgáló címét, a fiók hitelesítő adatait, az SSH titkos kulcsát és az SSH titkos kulcs jelszavát. Ha a platform támogatja a nagy fájlok adattömbökkel való feltöltését, olvasási és írási hozzáférésre is szükség van az SFTP-kiszolgálón található gyökérmappához.

  • A SFTP-SSH-összekötő támogatja a titkos kulcsok hitelesítését és a jelszó-hitelesítést is. A SFTP-SSH-összekötő azonban csak a következő titkos kulcsformátumokat, kulcscserélő algoritmusokat, titkosítási algoritmusokat és ujjlenyomatokat támogatja:

    • Titkos kulcsformátumok: RSA (Rivest Shamir Adleman) és DSA (Digitális aláírási algoritmus) kulcsok OpenSSH és ssh.com formátumban is. Ha a titkos kulcs PuTTY (.ppk) fájlformátumban van, először konvertálja a kulcsot OpenSSH (.pem) fájlformátumba.
    • Kulcscsere-algoritmusok:
      • görbe25519-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
    • Titkosítási algoritmusok:
      • aes256-ctr
      • 3des-cbc
      • aes128-cbc
      • aes192-cbc
      • aes256-cbc
      • blowfish-cbc
      • twofish-cbc
      • kéthal192-cbc
      • kéthal128-cbc
      • twofish256-cbc
      • arcfour
      • arcfour128
      • arcfour256
      • cast128-cbc
      • aes128-ctr
      • aes192-ctr
    • Gazdagépkulcs-algoritmusok:
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • Ujjlenyomat: MD5. További információ: Az MD5 ujjlenyomatának megkeresése.

  • Ha megadja az SSH titkos kulcsát a kapcsolathoz, ne írja be vagy szerkessze manuálisan a kulcsot, ami a kapcsolat meghiúsulását okozhatja. Ehelyett győződjön meg arról, hogy a kulcsot az SSH titkos kulcsfájljából másolja, és illessze be a kulcsot a kapcsolati adatok mezőbe.

    Az SSH titkos kulcsának helyes másolásához és beillesztéséhez kövesse az alábbi lépéseket.

    1. Nyissa meg az SSH titkoskulcs-fájlját bármely szövegszerkesztőben. Ezek a lépések továbbra is példaként használják a Jegyzettömbet.

    2. A Jegyzettömb szerkesztési menüjében válassza az Összes kijelölése lehetőséget. (Nyomja le a Ctrl + A billentyűkombinációt)

    3. A Szerkesztés menüben válassza a Másolás lehetőséget.

    4. A SFTP-SSH kapcsolatinformációs mezőben illessze be a teljes másolt kulcsot az SSH titkos kulcs tulajdonságába, amely több sort is támogat. Ne írja be vagy szerkessze manuálisan a kulcsot.

    5. Miután megadta a kapcsolat részleteit, válassza a Létrehozás lehetőséget.

PuTTY-alapú kulcs konvertálása OpenSSH-ra

A PuTTY és az OpenSSH formátum különböző fájlnévkiterjesztéseket használ. A PuTTY formátum a .ppk vagy a PuTTY Titkos kulcs fájlnévkiterjesztést használja. Az OpenSSH formátum a .pem vagy a Privacy Enhanced Mail fájlnévkiterjesztést használja. Ha a titkos kulcs PuTTY formátumban van, és OpenSSH formátumot kell használnia, először konvertálja a kulcsot OpenSSH formátumba az alábbi lépések végrehajtásával:

  • Unix-alapú operációs rendszer

    1. Ha nincs telepítve a PuTTY-eszközök a rendszeren, tegye ezt most, például:

      sudo apt-get install -y putty

    2. Futtassa a következő parancsot, amely létrehoz egy fájlt, amelyet a SFTP-SSH összekötővel használhat:

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

      Például

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

  • Windows operációs rendszer

    1. Ha még nem tette meg, töltse le a legújabb PuTTY Generator (puttygen.exe) eszközt, majd nyissa meg az eszközt.

    2. A PuTTY Kulcsgenerátor eszközben (puttygen.exe) válassza a Műveletek területen a Betöltés lehetőséget.

    3. Keresse meg a titkos kulcsfájlt PuTTY formátumban, és válassza a Megnyitás lehetőséget.

    4. A Konvertálások menüben válassza az OpenSSH-kulcs exportálása lehetőséget.

    5. Mentse a titkos kulcsfájlt a .pem fájlnévkiterjesztéssel.

Az MD5 ujjlenyomatának megkeresése

A SFTP-SSH-összekötő elutasítja a kapcsolatot, ha az SFTP-kiszolgáló ujjlenyomata és a várt ujjlenyomat nem egyezik. Az MD5 ujjlenyomat lekéréséhez, amely egy 16 pár hexa számjegyből álló sorozat, kettősponttal tagolt, próbálkozzon az alábbi lehetőségekkel.

Önnél van a kulcs

Az MD5-kulcs egy 47 karakterből áll, kettőspontokkal tagolt sztring. Az MD5 ujjlenyomatának lekéréséhez, ha rendelkezik a kulccsal, használhat olyan eszközöket, mint az ssh-keygen.

Egy Bash-parancssorból például adja meg a következő parancsot:

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

Nincs meg a kulcs

Ha MD5-ujjlenyomatot szeretne kapni, ha nincs kulcsa, használhatja a legújabb Kiszolgáló- és protokollinformációs párbeszédpanel eszközt a WinSCP-vel, vagy használhatja helyette a PuTTY Configuration eszközt:

  1. A PuTTY Configuration eszköz (putty.exe) Kategória ablakában bontsa ki a Kapcsolat>SSH-gazdagépkulcsait>.

  2. A Gazdagépkulcs-algoritmus beállításai területen nyissa meg az Algoritmusválasztási szabályzatok listáját, és ellenőrizze, hogy az RSA megjelenik-e a tetején.

  3. Ha az RSA nem jelenik meg a tetején, válassza az RSA lehetőséget, majd a Fel lehetőséget, amíg az RSA fel nem kerül a lap tetejére.

  4. Csatlakozzon az SFTP-kiszolgálóhoz a PuTTY használatával. A kapcsolat létrehozása után, amikor megjelenik a PUTTY biztonsági riasztás, válassza a További információ lehetőséget.

    Megjegyzés:

    Ha a biztonsági riasztás nem jelenik meg, törölje az SshHostKeys bejegyzést. Nyissa meg a Windows beállításszerkesztőt, és keresse meg a következő bejegyzést:

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. A PuTTY után megjelenik a kiszolgáló gazdagépkulcs-mezője , keresse meg az MD5 ujjlenyomat tulajdonságot, és másolja a 47 karakterből álló sztring értékét, amely a következő példához hasonlóan néz ki:

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

Az eseményindítókkal kapcsolatos ismert problémák és korlátozások

  • Az SFTP által felügyelt összekötő eseményindítói hiányzó, hiányos vagy késleltetett eredményeket tapasztalhatnak.

    • Hiányzó eredmények

      Az SFTP-eseményindítók az SFTP fájlrendszerének lekérdezésével vagy ellenőrzésével működnek, és a legutóbbi szavazás óta megváltozott fájlokat keresik. Az SFTP által felügyelt összekötő eseményindítói összehasonlítják a fájlverziókat a fájl utolsó módosított időbélyegével.

      Ha a legutóbb követett időbélyegnél korábbi időbélyeggel hoz létre, vehet fel vagy frissíthet fájlokat, az SFTP által felügyelt összekötő eseményindítója nem fogja észlelni ezt a fájlt.

      Ha tehát olyan külső eszközt vagy ügyfelet használ, amely fájlokat hoz létre, ad hozzá vagy frissít az SFTP-kiszolgálón, győződjön meg arról, hogy letiltja az eszköz vagy ügyfél azon funkcióit, amelyek megőrzik a fájl utolsó módosított időbélyegét.

      Az alábbi táblázat felsorol néhány gyakran használt eszközt, amelyek megőrzik ezt az időbélyeget, valamint a funkció letiltásának lépéseit:

      SFTP-ügyfél Tevékenység
      WinSCP Nyissa meg a Beállítások>beállítások>átadása –>Szerkesztés>megőrzése időbélyeg>letiltása lehetőséget.
      FileZilla Nyissa meg azátvitt fájlok> időbélyegeinek átvitele>– Letiltás.

    • Hiányos vagy késleltetett eredmények

      Amikor egy SFTP-eseményindító egy újonnan létrehozott, hozzáadott vagy frissített fájlt keres, az eseményindító azt is ellenőrzi, hogy a fájl elkészült-e. Előfordulhat például, hogy egy fájl módosul, amikor az eseményindító ellenőrzi az SFTP-kiszolgálót. A hiányos fájlok visszaadásának elkerülése érdekében az eseményindító megjegyzi a fájl időbélyegét, de nem adja vissza azonnal a fájlt. Ehelyett az eseményindító csak akkor adja vissza a fájlt, ha az eseményindító ismét ellenőrzi a kiszolgálót.

      Előfordulhat, hogy ez a viselkedés olyan késleltetést okoz, amely akár a trigger lekérdezési időközének majdnem kétszerese is lehet. Ennek a viselkedésnek köszönhetően, ha letiltja az SFTP-eseményindító Split On beállítását, előfordulhat, hogy az SFTP-eseményindító nem minden fájlt ad vissza egyszerre.

Általános ismert problémák és korlátozások

  • A SFTP-SSH felügyelt összekötő jelenleg nem támogatja a következő SFTP-kiszolgálókat:

    • Akamai NetStorage
    • FileMage Gateway
    • Globalscape
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • SFTP az Azure Blob Storage-hoz
    • VShell biztonságos fájlátviteli kiszolgáló
    • AWS SFTP

  • A fájlok feldolgozásához és feltöltéséhez használjon különálló SFTP-mappákat.

    Ügyeljen arra, hogy az eseményindítóhoz külön mappákat használjon az SFTP-kiszolgálón a fájlok feldolgozásához és tárolásához. Ellenkező esetben a trigger nem aktiválódik, és kiszámíthatatlanul viselkedik. Az eseményindító például kihagyhatja a feldolgozásra szoruló fájlok véletlenszerű számát.

    Ez a korlátozás azt jelenti, hogy szükség van a fájlok mappák közötti áthelyezésére. Ha ez a probléma jelentkezik, távolítsa el a fájlokat a figyelt mappából, és használjon egy másik mappát a feltöltött fájlok tárolásához.

  • A megosztott több-bérlős felügyelt összekötő-szolgáltatások terhelésének kezeléséhez a felügyelt SFTP-SSH összekötő több kapcsolatot is létrehozhat ugyanabból a forrás IP-címből, vagyis az összekötő IP-címéről a célhelyre, amely az SFTP-kiszolgáló. Egyes alacsony forgalmú régiók csak három virtuálisgép-példányt használhatnak az összekötő IP-címe mögött, ami azt jelenti, hogy ezek a régiók legfeljebb három kapcsolatot hozhatnak létre. Más régiók legfeljebb 20 kapcsolatot használhatnak, mert ugyanannyi virtuális gép áll az összekötő IP-címe mögött.

    Ha az SFTP-kiszolgáló korlátozza a kapcsolatok számát, előfordulhat, hogy a kiszolgáló nem működik megfelelően a felügyelt SFTP-SSH összekötővel. Létrehozhat azonban egy standard logikai alkalmazás munkafolyamatot, amely ehelyett a beépített SFTP-műveleteket használja. Szabályozhatja a vertikális felskálázási korlátokat, és ennek eredményeképpen a kapcsolatok számát.

  • Ha titkosítási csomag együttműködési problémáiba ütközik a SFTP-SSH felügyelt összekötő és az SFTP-kiszolgáló között, hozzon létre egy standard logikai alkalmazás munkafolyamatot, és használja helyette a beépített SFTP-műveleteket. Az SFTP beépített műveletei a titkosítási csomagok szélesebb körét támogatják.

  • Ez az összekötő no-op kérést küldhet a háttérrendszernek.

Chunking

  • Az Azure Logic Appsben és a Power Automate-ben az alábbi felügyelt SFTP-SSH összekötőműveletek támogatják az adattömb-kezelést, ahol egy művelet lehetővé teszi a nagyobb méretű fájlok kisebb részekben való kezelését. További információ az Azure Logic Appsben történő adattömbkezelésről: [Nagyméretű üzenetek kezelése adattömb használatával]](/azure/logic-apps/logic-apps-handle-large-messages).

    Tevékenység Adattömb-támogatás Az adattömb méretének támogatásának felülbírálása
    Fájl másolása Nem Nem alkalmazható
    Fájl létrehozása Igen Igen
    Mappa létrehozása Nem alkalmazható Nem alkalmazható
    Fájl törlése Nem alkalmazható Nem alkalmazható
    Archívum kinyerés mappába Nem alkalmazható Nem alkalmazható
    Fájltartalom lekérése Igen Igen
    Fájltartalom lekérése elérési úttal Igen Igen
    Fájl metaadatainak lekérése Nem alkalmazható Nem alkalmazható
    Fájl metaadatainak lekérése elérési úttal Nem alkalmazható Nem alkalmazható
    Fájlok listázása a mappában Nem alkalmazható Nem alkalmazható
    Fájl átnevezése Nem alkalmazható Nem alkalmazható
    Fájl frissítése Nem Nem alkalmazható

    SFTP-SSH darabolást támogató műveletek legfeljebb 1 GB méretű fájlokat kezelhetnek, míg SFTP-SSH az adattömbkezelést nem támogató műveletek legfeljebb 50 MB méretű fájlokat kezelhetnek. Az alapértelmezett adattömbméret 15 MB. Ez a méret azonban dinamikusan változhat 5 MB-tól kezdve, és fokozatosan növekedhet az 50 MB-os maximális értékre. A dinamikus méretezés olyan tényezőkön alapul, mint a hálózati késés, a kiszolgáló válaszideje stb.

    Ezt az adaptív viselkedést felülbírálhatja, ha konstans adattömbméretet ad meg helyette. Ez a méret 5 MB és 50 MB közötti lehet. Tegyük fel például, hogy rendelkezik egy 45 MB-os fájllal és egy olyan hálózattal, amely késés nélkül támogatja ezt a fájlméretet. Az adaptív adattömb-készítés több hívást eredményez, nem pedig egyetlen hívást. A hívások számának csökkentéséhez próbáljon meg 50 MB-os adattömbméretet beállítani. Ha például 15 MB-os adattömbök használata esetén a logikai alkalmazás munkafolyamata túllépi az időkorlátot, megpróbálhatja 5 MB-ra csökkenteni a méretet.

    Az adattömb mérete egy kapcsolathoz van társítva. Ez az attribútum azt jelenti, hogy ugyanazt a kapcsolatot használhatja mindkét olyan művelethez, amely támogatja az adattömb-készítést és az adattömb-készítést nem támogató műveleteket. Ebben az esetben az adattömb mérete az adattömböt támogató műveletek esetében 5 MB és 50 MB között mozog.

    Ha felül szeretné bírálni az SFTP-SSH művelethez használt alapértelmezett adaptív viselkedést, 5 MB és 50 MB közötti állandó adattömbméretet adhat meg.

    1. A tervezőn a SFTP-SSH művelet jobb felső sarkában kattintson a három pontra (...), majd válassza a Beállítások lehetőséget.

    2. A Tartalomátvitel csoportban az Adattömb mérete tulajdonságban adjon meg egy egész számot a következőtől 5 a következőig 50.

    3. A befejezés után válassza a Kész lehetőséget.

  • SFTP-SSH eseményindítók nem támogatják az üzenettömböket. Amikor az eseményindítók fájltartalmat kérnek, csak a 15 MB-os vagy annál kisebb fájlokat választják ki. A 15 MB-nál nagyobb fájlok lekéréséhez kövesse a következő mintát:

    1. Használjon SFTP-SSH eseményindítót, amely csak fájltulajdonságokat ad vissza. Ezek az eseményindítók olyan neveket tartalmaznak, amelyek tartalmazzák a leírást (csak tulajdonságok).

    2. Kövesse az eseményindítót a SFTP-SSH Fájltartalom lekérése művelettel. Ez a művelet beolvassa a teljes fájlt, és implicit módon üzenettömböket használ.

Hibaelhárítás

401-hiba: "401 Jogosulatlan"

Ez a hiba azért fordulhat elő, mert nem rendelkezik a megfelelő hitelesítő adatokkal vagy engedélyekkel. További információ: Hitelesítés és engedélyek.

404-hiba: "Nem létező fájlra vagy mappára mutató hivatkozás történt"

Ez a hiba a Fájl létrehozása művelet használatakor fordulhat elő. Amikor a művelet létrehoz egy fájlt az SFTP-kiszolgálón, a művelet automatikusan meghívja az SFTP-kiszolgálót a fájl metaadatainak lekéréséhez.

Ha azonnal áthelyezi az újonnan létrehozott fájlt, mielőtt a hívás lekérheti a metaadatokat, a fájl már nem létezik a várt helyen, és egy 404-ben megjelenő hibaüzenet jelenik meg, egy nem létező fájlra vagy mappára mutató hivatkozás történt.

Ha nem tudja elkerülni vagy késleltetni a fájl áthelyezését, az alábbi lépések végrehajtásával kihagyhatja a fájl metaadatainak olvasását a fájl létrehozása után:

  1. A Fájl létrehozása műveletben nyissa meg az Új paraméter hozzáadása listát, válassza az Összes fájl metaadatának lekérése tulajdonságot , és állítsa az értéket Nem értékre.

  2. Ha később szüksége van erre a fájl metaadataira, használhatja a Fájl metaadatainak lekérése műveletet.

504-hiba: "A kapcsolati kísérlet meghiúsult, mert a csatlakoztatott fél egy idő után nem válaszolt megfelelően, vagy a létrejött kapcsolat meghiúsult, mert a csatlakoztatott gazdagép nem tudott válaszolni", vagy "Az SFTP-kiszolgáló kérése több mint 00:00:30 másodpercet vett igénybe"

Ez a hiba akkor fordulhat elő, ha nem sikerül kapcsolatot létesíteni az SFTP-kiszolgálóval. Ennek a problémának különböző okai lehetnek, ezért próbálkozzon az alábbi hibaelhárítási lehetőségekkel:

  • A kapcsolat időtúllépése 20 másodperc. Ellenőrizze, hogy az SFTP-kiszolgáló jó teljesítménnyel rendelkezik-e, és a köztes eszközök, például a tűzfalak nem okoznak többletterhelést.

  • Ellenőrizze, hogy az SFTP-kiszolgáló korlátozza-e az egyes IP-címekről érkező kapcsolatok számát. Az ilyen korlátok akadályozzák az összekötő és az SFTP-kiszolgáló közötti kommunikációt. Távolítsa el ezt a korlátot.

  • Ha tűzfal van beállítva, győződjön meg arról, hogy hozzáadja a régióhoz tartozó felügyelt összekötő IP-címeit a jóváhagyott listához.

  • Ha a hiba időnként jelentkezik, módosítsa a SFTP-SSH művelet újrapróbálkoztatási házirend-beállítását az alapértelmezett négy újrapróbálkozásnál magasabb újrapróbálkozás-számra.

  • A kapcsolat létrehozásának költségeinek csökkentése érdekében az SFTP-kiszolgáló SSH-konfigurációjában növelje a ClientAliveInterval tulajdonságot körülbelül egy órára.

  • Tekintse át az SFTP-kiszolgáló naplóját annak ellenőrzéséhez, hogy az SFTP-kiszolgálónak küldött hívások sikeresen érkeznek-e. A csatlakozási problémáról további információt a tűzfalon és az SFTP-kiszolgálón is futtathat.

Általános korlátok

Név Érték
Az összekötőbe/onnan átvitt megabájtok maximális száma sávszélesség-időintervallumon belül (kapcsolatonként) 1000
Sávszélesség időintervalluma (ezredmásodpercben) 60000

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:
Alapértelmezett A kapcsolat létrehozásának paraméterei. Minden régió Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Description Kötelező
Gazdagépkiszolgáló címe karakterlánc Gazdagépkiszolgáló címe True
Felhasználónév karakterlánc Felhasználónév True
Jelszó securestring Jelszó
SSH titkos kulcs securestring SSH titkos kulcs (a fájl tartalmát teljes egészében, többsoros formátumban kell megadni)
SSH titkos kulcsjelszó securestring SSH titkos kulcsjelszó (ha a titkos kulcsot jelszó védi)
Portszám int SFTP-port száma (példa: 22)
Az SSH-gazdagépkulcs érvényesítésének letiltása bool Letiltja az SSH-gazdagépkulcs érvényesítését? (Igaz/Hamis)
SSH-gazdagép kulcsának ujjlenyomat-nyomtatása karakterlánc SSH-gazdagép kulcsának ujjlenyomat-nyomtatása
Gyökérmappa elérési útja karakterlánc Gyökérmappa elérési útja.

Szabályozási korlátok

Name Hívások Megújítási időszak
API-hívások kapcsolatonként 150 60 másodperc

Műveletek

Archívum kinyerés mappába

Ez a művelet kinyer egy archív fájlt egy mappába (például: .zip).
Fájl frissítése

Ez a művelet frissíti a fájl tartalmát.
Fájl létrehozása

Ez a művelet feltölt egy fájlt.
Fájl metaadatainak beolvasása

Ez a művelet lekéri a fájl metaadatait a fájlazonosító használatával.
Fájl metaadatainak lekérése elérési úttal

Ez a művelet lekéri a fájl metaadatait a fájl elérési útján.
Fájl másolása

Ez a művelet egy fájlt másol.
Fájl törlése

Ez a művelet töröl egy fájlt.
Fájl átnevezése

Ez a művelet átnevez egy fájlt.
Fájlok listázása a gyökérmappában

Ez a művelet lekéri a fájlokat a gyökérmappában.
Fájlok listázása a mappában

Ez a művelet egy mappában lévő fájlokat fog tartalmazni.
Fájltartalom lekérése

Ez a művelet a fájlazonosító használatával kéri le a fájl tartalmát.
Fájltartalom lekérése elérési úttal

Ez a művelet lekéri a fájl tartalmát a fájl elérési útján.
Mappa létrehozása

Ez a művelet létrehoz egy új mappát.

Archívum kinyerés mappába

Műveletazonosító:
ExtractFolderV2

Ez a művelet kinyer egy archív fájlt egy mappába (például: .zip).

Paraméterek

Name Kulcs Kötelező Típus Description
Forrásarchívum fájl elérési útja
 source True string

Az archív fájl elérési útja
Célmappa elérési útja
 destination True string

A célmappa elérési útja
Felülírja?
 overwrite boolean

Felülírja a célfájlokat, ha igaz értékre van állítva

Válaszok

response
array of BlobMetadata

Fájl frissítése

Műveletazonosító:
UpdateFile

Ez a művelet frissíti a fájl tartalmát.

Paraméterek

Name Kulcs Kötelező Típus Description
File
 id True string

A fájl megadása
Fájltartalom
 body True binary

A frissíteni kívánt fájl tartalma
Az összes fájl metaadatainak lekérése
 ReadFileMetadataFromServer boolean

A fájllétrehozás befejezése után kérje le az összes fájl metaadatait az SFTP-kiszolgálóról. Ha ez hamis, előfordulhat, hogy egyes metaadat-tulajdonságok nem lesznek visszaadva, például az utolsó módosítás időpontja stb.

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl létrehozása

Műveletazonosító:
CreateFile

Ez a művelet feltölt egy fájlt.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa útvonal
 folderPath True string

A mappa egyedi elérési útja
Fájlnév
 name True string

A fájl neve
Fájltartalom
 body True binary

A létrehozandó fájl tartalma
Az összes fájl metaadatainak lekérése
 ReadFileMetadataFromServer boolean

A fájllétrehozás befejezése után kérje le az összes fájl metaadatait az SFTP-kiszolgálóról. Ha ez hamis, előfordulhat, hogy egyes metaadat-tulajdonságok nem lesznek visszaadva, például az utolsó módosítás időpontja stb.

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl metaadatainak beolvasása

Műveletazonosító:
GetFileMetadata

Ez a művelet lekéri a fájl metaadatait a fájlazonosító használatával.

Paraméterek

Name Kulcs Kötelező Típus Description
File
 id True string

Adja meg a fájlazonosítót

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl metaadatainak lekérése elérési úttal

Műveletazonosító:
GetFileMetadataByPath

Ez a művelet lekéri a fájl metaadatait a fájl elérési útján.

Paraméterek

Name Kulcs Kötelező Típus Description
Fájl elérési útja
 path True string

A fájl egyedi elérési útja

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl másolása

Műveletazonosító:
CopyFile

Ez a művelet egy fájlt másol.

Paraméterek

Name Kulcs Kötelező Típus Description
Forrásfájl elérési útja
 source True string

A forrásfájl elérési útja
Célfájl elérési útja
 destination True string

A célfájl elérési útja, a fájlnévvel együtt
Felülírja?
 overwrite boolean

Felülírja a célfájlt, ha igaz értékre van állítva
Az összes fájl metaadatainak lekérése
 ReadFileMetadataFromServer boolean

A fájllétrehozás befejezése után kérje le az összes fájl metaadatait az SFTP-kiszolgálóról. Ha ez hamis, előfordulhat, hogy egyes metaadat-tulajdonságok nem lesznek visszaadva, például az utolsó módosítás időpontja stb.

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl törlése

Műveletazonosító:
DeleteFile

Ez a művelet töröl egy fájlt.

Paraméterek

Name Kulcs Kötelező Típus Description
File
 id True string

A fájl megadása
A törlés kihagyása, ha a fájl nem található
 SkipDeleteIfFileNotFoundOnServer boolean

Kihagyja a törlést, ha egy fájl sikertelen művelet nélkül nem található.

Fájl átnevezése

Műveletazonosító:
RenameFile

Ez a művelet átnevez egy fájlt.

Paraméterek

Name Kulcs Kötelező Típus Description
File
 id True string

Fájl kiválasztása
Új név
 newName True string

A fájl új neve
Az összes fájl metaadatainak lekérése
 ReadFileMetadataFromServer boolean

A fájllétrehozás befejezése után kérje le az összes fájl metaadatait az SFTP-kiszolgálóról. Ha ez hamis, előfordulhat, hogy egyes metaadat-tulajdonságok nem lesznek visszaadva, például az utolsó módosítás időpontja stb.

Válaszok

Blob-adathalmazok metaadat-válaszát jelöli

Törzs
BlobMetadataResponse

Fájlok listázása a gyökérmappában

Műveletazonosító:
ListRootFolder

Ez a művelet lekéri a fájlokat a gyökérmappában.

Válaszok

response
array of BlobMetadata

Fájlok listázása a mappában

Műveletazonosító:
ListFolder

Ez a művelet egy mappában lévő fájlokat fog tartalmazni.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
 id True string

A mappa megadása

Válaszok

response
array of BlobMetadata

Fájltartalom lekérése

Műveletazonosító:
GetFileContent

Ez a művelet a fájlazonosító használatával kéri le a fájl tartalmát.

Paraméterek

Name Kulcs Kötelező Típus Description
File
 id True string

Adja meg a fájlazonosítót
Tartalomtípus következtetése
 inferContentType boolean

Tartalomtípus következtetése bővítmény alapján

Válaszok

A fájl tartalma.

Fájl tartalma
binary

Fájltartalom lekérése elérési úttal

Műveletazonosító:
GetFileContentByPath

Ez a művelet lekéri a fájl tartalmát a fájl elérési útján.

Paraméterek

Name Kulcs Kötelező Típus Description
Fájl elérési útja
 path True string

A fájl egyedi elérési útja
Tartalomtípus következtetése
 inferContentType boolean

Tartalomtípus következtetése bővítmény alapján

Válaszok

A fájl tartalma.

Fájl tartalma
binary

Mappa létrehozása

Műveletazonosító:
CreateFolder

Ez a művelet létrehoz egy új mappát.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
 folderPath True string

Mappa kiválasztása
Név
 name True string

A mappa neve

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Triggerek

Fájl hozzáadásakor vagy módosításakor

Ez a művelet elindít egy folyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy mappában. Az eseményindító lekéri mind a fájl metaadatait, mind a fájl tartalmát. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító kihagyja az 50 megabájtnál nagyobb fájlokat. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.
Fájlok hozzáadásakor vagy módosításakor (csak tulajdonságok esetén)

Ez a művelet elindít egy folyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy mappában. Ez az eseményindító csak a fájl metaadatait fogja lekérni. A fájltartalom lekéréséhez használhatja a "Fájltartalom lekérése" műveletet. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Fájl hozzáadásakor vagy módosításakor

Műveletazonosító:
OnUpdatedFile

Ez a művelet elindít egy folyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy mappában. Az eseményindító lekéri mind a fájl metaadatait, mind a fájl tartalmát. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító kihagyja az 50 megabájtnál nagyobb fájlokat. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
 folderId True string

Mappa megadása
Fájltartalom belefoglalása
 includeFileContent boolean

Ha igaz értékre van állítva, a rendszer a fájltartalmat is lekéri az eseményindító válaszával együtt
Tartalomtípus következtetése
 inferContentType boolean

Tartalomtípus következtetése bővítmény alapján

Válaszok

A fájl tartalma.

Fájl tartalma
binary

Fájlok hozzáadásakor vagy módosításakor (csak tulajdonságok esetén)

Műveletazonosító:
OnUpdatedFiles

Ez a művelet elindít egy folyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy mappában. Ez az eseményindító csak a fájl metaadatait fogja lekérni. A fájltartalom lekéréséhez használhatja a "Fájltartalom lekérése" műveletet. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
 folderId True string

Mappa kiválasztása
Visszaadandó fájlok száma
 maxFileCount integer

Az eseményindítóból visszaadott fájlok száma (1-100)

Válaszok

Blob metaadatai

Fájlok listája
BlobMetadata

Definíciók

BlobMetadata

Blob metaadatai

Name Elérési út Típus Description
Azonosító
 Id string

A fájl vagy mappa egyedi azonosítója.
Név
 Name string

A fájl vagy mappa neve.
Megjelenítendő név
 DisplayName string

A fájl vagy mappa megjelenítendő neve.
Útvonal
 Path string

A fájl vagy mappa elérési útja.
Utolsó módosítás
 LastModified date-time

A fájl vagy mappa utolsó módosításának dátuma és időpontja.
Méret
 Size integer

A fájl vagy mappa mérete.
Médiatípus
 MediaType string

A fájl vagy mappa médiatípusa.
IsFolder
 IsFolder boolean

Logikai érték (igaz, hamis), amely jelzi, hogy a blob mappa-e.
ETag
 ETag string

A fájl vagy mappa etagje.
FileLocator
 FileLocator string

A fájl vagy mappa fájlkeresője.

BlobMetadataResponse

Blob-adathalmazok metaadat-válaszát jelöli

Name Elérési út Típus Description
Azonosító
 Id string

A fájl vagy mappa egyedi azonosítója.
Név
 Name string

A fájl vagy mappa neve.
Megjelenítendő név
 DisplayName string

A fájl vagy mappa megjelenítendő neve.
Útvonal
 Path string

A fájl vagy mappa elérési útja.
Utolsó módosítás
 LastModified date-time

A fájl vagy mappa utolsó módosításának dátuma és időpontja.
Méret
 Size integer

A fájl vagy mappa mérete.
Médiatípus
 MediaType string

A fájl vagy mappa médiatípusa.
IsFolder
 IsFolder boolean

Logikai érték (igaz, hamis), amely jelzi, hogy a blob mappa-e.
ETag
 ETag string

A fájl vagy mappa etagje.
FileLocator
 FileLocator string

A fájl vagy mappa fájlkeresője.

bináris

Ez a bináris alapszintű adattípus.