Sdílet prostřednictvím

SFTP – SSH

SFTP (SSH File Transfer Protocol) je síťový protokol, který poskytuje přístup k souborům, přenos souborů a správu souborů přes jakýkoli spolehlivý datový proud. Byla navržena protokolem IETF (Internet Engineering Task Force) jako rozšíření protokolu SSH (Secure Shell) verze 2.0, aby poskytovala možnosti zabezpečeného přenosu souborů.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Standard Všechny oblasti Power Automate s výjimkou následujících:
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps
Power Apps Standard Všechny oblasti Power Apps s výjimkou následujících:
     - Ministerstvo obrany USA (DoD)
Power Automate Standard Všechny oblasti Power Automate s výjimkou následujících:
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Microsoft
URL Podpora Microsoft LogicApps
Podpora microsoft Power Automate
Podpora Microsoft Power Apps
Metadata konektoru
Vydavatel Microsoft

Průvodce návodem ke konektoru

Tento článek popisuje operace pro SFTP-SSH spravovaný konektor, který je k dispozici pro Azure Logic Apps, Power Automate a Power Apps. Integrovaný konektor SFTP je k dispozici pouze pro pracovní postupy standardní aplikace logiky v Azure Logic Apps. Další informace najdete v tématu Připojení k serveru SFTP pomocí SSH v Azure Logic Apps a SFTP integrovaného konektoru pro Azure Logic Apps.

Rozdíly oproti zastaralému spravovanému konektoru SFTP

V porovnání s zastaralým spravovaným konektorem SFTP poskytuje spravovaný konektor SFTP-SSH následující klíčové funkce:

  • Používá knihovnu SSH.NET, což je opensourcová knihovna SSH (Secure Shell), která podporuje .NET.

  • Poskytuje akci Vytvořit složku , která vytvoří složku na zadané cestě na serveru SFTP.

  • Poskytuje akci Přejmenovat soubor , která přejmenuje soubor na serveru SFTP.

  • Ukládá připojení k serveru SFTP do mezipaměti po dobu až 1 hodiny. Tato funkce zlepšuje výkon a snižuje počet pokusů o připojení konektoru k serveru. Chcete-li nastavit dobu trvání tohoto chování ukládání do mezipaměti, upravte vlastnost ClientAliveInterval v konfiguraci SSH na serveru SFTP.

Ověřování a oprávnění

  • Při vytváření připojení k serveru SFTP musíte zadat adresu serveru SFTP, přihlašovací údaje účtu, privátní klíč SSH a heslo privátního klíče SSH. Pokud vaše platforma podporuje nahrávání velkých souborů pomocí bloků dat, potřebujete ke kořenové složce na serveru SFTP přístup pro čtení i zápis.

  • Konektor SFTP-SSH podporuje ověřování privátního klíče i ověřování heslem. Konektor SFTP-SSH ale podporuje pouze následující formáty privátního klíče, algoritmy výměny klíčů, šifrovací algoritmy a otisky prstů:

    • Formáty privátních klíčů: KLÍČE RSA (Rivest Shamir Adleman) a DSA (Digital Signature Algorithm) ve formátech OpenSSH i ssh.com. Pokud je váš privátní klíč ve formátu souboru PuTTY (.ppk), nejprve převeďte klíč do formátu souboru OpenSSH (.pem).
    • Algoritmy výměny klíčů:
      • křivka25519-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
    • Šifrovací algoritmy:
      • 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
    • Algoritmy klíče hostitele:
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • Otisk prstu: MD5. Další informace najdete v tématu Vyhledání otisku prstu MD5.

  • Pokud zadáte privátní klíč SSH pro vaše připojení, nezadávejte ani ručně neupravujte klíč, což může způsobit selhání připojení. Místo toho se ujistěte, že zkopírujete klíč ze souboru privátního klíče SSH a tento klíč vložíte do pole s informacemi o připojení.

    Chcete-li správně zkopírovat a vložit privátní klíč SSH, postupujte takto.

    1. Otevřete soubor privátního klíče SSH v libovolném textovém editoru. Tyto kroky dál používají Poznámkový blok jako příklad.

    2. V Poznámkovém bloku v nabídce Upravit vyberte Vybrat vše. (Stiskněte Ctrl+A.

    3. V nabídce Upravit vyberte Kopírovat.

    4. Do pole s informacemi o připojení SFTP-SSH vložte úplný zkopírovaný klíč do vlastnosti privátního klíče SSH , která podporuje více řádků. Nezadávejte ani neupravujte klíč ručně.

    5. Po zadání podrobností o připojení vyberte Vytvořit.

Převod klíče založeného na PuTTY na OpenSSH

Formát PuTTY a formát OpenSSH používají různé přípony názvů souborů. Formát PuTTY používá příponu názvu souboru .ppk nebo PuTTY Private Key. Formát OpenSSH používá příponu .pem nebo Privacy Enhanced Mail. Pokud je váš privátní klíč ve formátu PuTTY a musíte použít formát OpenSSH, nejprve pomocí následujícího postupu převeďte klíč do formátu OpenSSH:

  • Operační systém založený na unixovém systému

    1. Pokud v systému nemáte nainstalované nástroje PuTTY, udělejte to teď, například:

      sudo apt-get install -y putty

    2. Spusťte následující příkaz, který vytvoří soubor, který můžete použít s konektorem SFTP-SSH:

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

      Například

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

  • Operační systém Windows

    1. Pokud jste to ještě neudělali, stáhněte si nejnovější nástroj PuTTY Generator (puttygen.exe) a pak nástroj otevřete.

    2. V nástroji PuTTY Key Generator (puttygen.exe) v části Akce vyberte Načíst.

    3. Přejděte k souboru privátního klíče ve formátu PuTTY a vyberte Otevřít.

    4. V nabídce Převody vyberte Exportovat klíč OpenSSH.

    5. Uložte soubor privátního klíče s příponou názvu souboru .pem .

Vyhledání otisku prstu MD5

Konektor SFTP-SSH odmítne připojení, pokud se otisk prstu serveru SFTP i očekávaný otisk prstu neshodují. Pokud chcete získat otisk prstu MD5, což je posloupnost s 16 páry šestnáctkových číslic oddělených dvojtečkami, vyzkoušejte následující možnosti.

Klíč máte

Klíč MD5 je 47místný řetězec oddělený dvojtečkami. Pokud chcete získat otisk prstu MD5, když máte klíč, můžete použít nástroje, jako je ssh-keygen.

Například z příkazového řádku Bash zadejte následující příkaz:

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

Klíč nemáte.

Pokud chcete získat otisk prstu MD5 v případě, že nemáte klíč, můžete použít nejnovější nástroj Pro přístup k informacím o serveru a protokolu nástrojem WinSCP nebo můžete použít nástroj PuTTY Configuration:

  1. V nástroji Konfigurace PuTTY (putty.exe), v okně Kategorie rozbaltepoložku Klíče hostiteleSSH>připojení>.

  2. V části Předvolba algoritmu klíče hostitele otevřete seznam zásad výběru algoritmu a zkontrolujte, že se rsA zobrazí v horní části.

  3. Pokud se RSA nezobrazí v horní části, vyberte RSA a pak vyberte Nahoru , dokud se RSA nepřesune na začátek.

  4. Připojte se k serveru SFTP pomocí PuTTY. Po vytvoření připojení vyberte po zobrazení výstrahy zabezpečení PUTTY další informace.

    Poznámka:

    Pokud se výstraha zabezpečení nezobrazí, zkuste vymazat položku SshHostKeys . Otevřete editor registru Systému Windows a přejděte k následující položce:

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. Po puTTY: zobrazí se informace o klíči hostitele serveru , najděte vlastnost otisku prstu MD5 a zkopírujte hodnotu řetězce 47 znaků, která vypadá jako v následujícím příkladu:

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

Známé problémy a omezení triggerů

  • Triggery spravovaného konektoru SFTP můžou mít chybějící, neúplné nebo zpožděné výsledky.

    • Chybějící výsledky

      Triggery SFTP fungují dotazováním nebo kontrolou systému souborů SFTP a hledají všechny soubory, které se od posledního hlasování změnily. Triggery spravovaného konektoru SFTP porovnávají verze souborů pomocí časového razítka poslední změny souboru.

      Pokud vytvoříte, přidáte nebo aktualizujete soubor s časovým razítkem, které je dřívější než aktuálně sledované časové razítko poslední změny, trigger spravovaného konektoru SFTP tento soubor nerozpozná.

      Pokud tedy používáte externí nástroj nebo klienta, který vytváří, přidává nebo aktualizuje soubory na serveru SFTP, ujistěte se, že jste zakázali jakoukoli funkci nástroje nebo klienta, která zachovává časové razítko poslední změny souboru.

      Následující tabulka uvádí některé běžně používané nástroje, které zachová toto časové razítko, a postup pro zakázání této funkce:

      Klient SFTP Činnost
      WinSCP Přejděte na Možnosti>Předvolby>Převést Upravit>Zachovat>časové razítko>Zakázat.
      FileZilla Přejděte na Možnost Přenést>zachovat časová razítka přenesených souborů>Zakázat.

    • Neúplné nebo zpožděné výsledky

      Když trigger SFTP zkontroluje nově vytvořený, přidaný nebo aktualizovaný soubor, trigger také zkontroluje, jestli je soubor dokončený. Například soubor může mít probíhající změny, když trigger zkontroluje server SFTP. Aby se zabránilo vrácení neúplného souboru, aktivační událost zaznamená časové razítko souboru, ale nevrátí soubor okamžitě. Místo toho trigger vrátí soubor pouze tehdy, když trigger znovu zkontroluje server.

      Někdy toto chování může způsobit zpoždění, které trvá téměř dvakrát interval dotazování triggeru. Pokud kvůli tomuto chování zakážete nastavení Split On triggeru SFTP, trigger SFTP nemusí vrátit všechny soubory najednou.

Obecné známé problémy a omezení

  • Spravovaný konektor SFTP-SSH aktuálně nepodporuje následující servery SFTP:

    • Akamai NetStorage
    • Brána FileMage
    • Globalscape
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • SFTP pro Azure Blob Storage
    • Server zabezpečeného přenosu souborů VShellu
    • AWS SFTP

  • Pro zpracování a nahrávání souborů použijte samostatné složky SFTP.

    Nezapomeňte pro trigger použít samostatné složky na serveru SFTP k monitorování souborů pro zpracování a ukládání nahraných souborů. Jinak se trigger neaktivuje a chová se nepředvídatelně. Trigger může například přeskočit náhodný počet souborů, které potřebují zpracovat.

    Toto omezení znamená, že potřebujete způsob, jak přesouvat soubory mezi těmito složkami. Pokud narazíte na tento problém, odeberte soubory z monitorované složky a k ukládání nahraných souborů použijte jinou složku.

  • Pokud chcete spravovat zatížení sdílených služeb spravovaného konektoru s více tenanty, může spravovaný konektor SFTP-SSH vytvořit více připojení ze stejné zdrojové IP adresy, tj. IP adresy konektoru, k cíli, což je váš server SFTP. Některé oblasti s nízkým provozem můžou za IP adresou konektoru používat jenom tři instance virtuálních počítačů, což znamená, že tyto oblasti můžou vytvořit maximálně tři připojení. Jiné oblasti můžou používat až 20 připojení, protože mají stejný počet virtuálních počítačů za IP adresou konektoru.

    Pokud váš server SFTP omezuje počet připojení, nemusí váš server dobře fungovat se spravovaným konektorem SFTP-SSH. Můžete ale vytvořit pracovní postup standardní aplikace logiky, který místo toho používá integrované operace SFTP. Můžete řídit limity horizontálního navýšení kapacity a v důsledku toho počet připojení.

  • Pokud narazíte na problémy s interoperabilitou šifrovacích sad mezi SFTP-SSH spravovaným konektorem a serverem SFTP, zkuste vytvořit pracovní postup standardní aplikace logiky a místo toho použít integrované operace SFTP. Integrované operace SFTP podporují širší škálu šifrovacích sad.

  • Tento konektor může odeslat no-op požadavek na back-end.

Chunking

  • V Azure Logic Apps a Power Automate podporují následující spravované akce konektoru SFTP-SSH bloky, kde akce umožňuje zpracování velkých souborů v menších částech. Další informace o vytváření bloků dat v Azure Logic Apps najdete v tématu [Zpracování velkých zpráv pomocí bloků]](/azure/logic-apps/logic-apps-handle-large-messages).

    Činnost Podpora vytváření bloků dat Podpora přepsání velikosti bloků dat
    Kopírovat soubor Ne Není relevantní
    Vytvoření souboru Ano Ano
    Vytvořit složku Není relevantní Není relevantní
    Odstranit soubor Není relevantní Není relevantní
    Extrahování archivu do složky Není relevantní Není relevantní
    Získání obsahu souboru Ano Ano
    Získání obsahu souboru pomocí cesty Ano Ano
    Získání metadat souborů Není relevantní Není relevantní
    Získání metadat souboru pomocí cesty Není relevantní Není relevantní
    Výpis souborů ve složce Není relevantní Není relevantní
    Přejmenování souboru Není relevantní Není relevantní
    Aktualizace souboru Ne Není relevantní

    SFTP-SSH akce, které podporují bloky dat, můžou zpracovávat soubory až 1 GB, zatímco SFTP-SSH akce, které nepodporují bloky dat, můžou zpracovávat soubory až 50 MB. Výchozí velikost bloku dat je 15 MB. Tato velikost se ale může dynamicky měnit, počínaje 5 MB a postupně se zvyšuje na maximum 50 MB. Dynamická velikost je založená na faktorech, jako je latence sítě, doba odezvy serveru atd.

    Toto adaptivní chování můžete přepsat, když místo toho zadáte velikost konstantního bloku dat. Tato velikost může být v rozsahu od 5 MB do 50 MB. Předpokládejme například, že máte soubor o velikosti 45 MB a síť, která tuto velikost souboru podporuje bez latence. Adaptivní blokování vede k několika voláním, spíše k jednomu volání. Pokud chcete snížit počet volání, můžete zkusit nastavit velikost bloku o velikosti 50 MB. Pokud v jiném scénáři dochází k vypršení časového limitu pracovního postupu aplikace logiky, například při použití bloků dat o velikosti 15 MB, můžete zkusit zmenšit velikost na 5 MB.

    Velikost bloku dat je přidružená k připojení. Tento atribut znamená, že pro obě akce, které podporují bloky dat, i akce, které nepodporují bloky dat, můžete použít stejné připojení. V tomto případě je velikost bloku dat pro akce, které podporují bloky dat, rozsahy od 5 MB do 50 MB.

    Pokud chcete přepsat výchozí adaptivní chování, které bloky dat používají u akce SFTP-SSH, můžete zadat konstantní velikost bloku dat od 5 MB do 50 MB.

    1. V návrháři v pravém horním rohu akce SFTP-SSH vyberte tlačítko se třemi tečkami (...) a pak vyberte Nastavení.

    2. V části Content Transfer ve vlastnosti Velikost bloku dat zadejte celočíselnou hodnotu od 5 do 50.

    3. Po dokončení vyberte Hotovo.

  • SFTP-SSH triggery nepodporují vytváření bloků zpráv. Když se aktivuje obsah souboru požadavku, vyberou jenom soubory, které jsou 15 MB nebo menší. Pokud chcete získat soubory větší než 15 MB, postupujte podle tohoto vzoru:

    1. Použijte aktivační událost SFTP-SSH, která vrací pouze vlastnosti souboru. Tyto triggery mají názvy, které obsahují popis (pouze vlastnosti).

    2. Postupujte podle triggeru s akcí SFTP-SSH Získat obsah souboru . Tato akce přečte celý soubor a implicitně používá blok zpráv.

Řešení problémů

Chyba 401: 401 Neautorizováno

K této chybě může dojít, protože nemáte správné přihlašovací údaje nebo oprávnění. Další informace najdete v tématu Ověřování a oprávnění.

Chyba 404: "Odkaz byl proveden na soubor nebo složku, která neexistuje"

K této chybě může dojít, když použijete akci Vytvořit soubor . Když akce na serveru SFTP vytvoří soubor, akce také automaticky odešle volání serveru SFTP, aby získala metadata souboru.

Pokud před voláním okamžitě přesunete nově vytvořený soubor, nebude soubor již v očekávaném umístění existovat a zobrazí se chybová zpráva 404, odkaz byl proveden na soubor nebo složku, která neexistuje.

Pokud se nemůžete vyhnout přesunutí souboru nebo ho zpozdit, můžete po vytvoření souboru přeskočit čtení metadat souboru pomocí následujícího postupu:

  1. V akci Vytvořit soubor otevřete seznam přidat nový parametr , vyberte vlastnost Získat všechna metadata souboru a nastavte hodnotu na Ne.

  2. Pokud budete později potřebovat metadata tohoto souboru, můžete použít akci Získat metadata souboru .

Chyba 504: Pokus o připojení selhal, protože připojená strana po určité době neodpověděla správně nebo se nepodařilo navázat připojení, protože se nepodařilo odpovědět připojenému hostiteli, nebo požadavek na server SFTP trvalo déle než 00:00:30 sekund.

K této chybě může dojít, když nemůžete úspěšně navázat připojení k serveru SFTP. K tomuto problému může dojít z různých důvodů, proto zkuste tyto možnosti řešení potíží:

  • Časový limit připojení je 20 sekund. Zkontrolujte, jestli má váš server SFTP dobrý výkon a zprostředkující zařízení, jako jsou brány firewall, nepřidá režijní náklady.

  • Zkontrolujte, jestli váš server SFTP omezuje počet připojení z každé IP adresy. Jakýkoli takový limit brání komunikaci mezi konektorem a serverem SFTP. Nezapomeňte tento limit odebrat.

  • Pokud máte nastavenou bránu firewall, nezapomeňte do schváleného seznamu přidat IP adresy spravovaného konektoru pro vaši oblast .

  • Pokud k chybě dochází přerušovaně, změňte nastavení zásad opakování u akce SFTP-SSH na počet opakování vyšší než výchozí čtyři opakování.

  • Pokud chcete snížit náklady na zřízení připojení, v konfiguraci SSH pro váš server SFTP zvyšte vlastnost ClientAliveInterval přibližně na hodinu.

  • Zkontrolujte protokol serveru SFTP a zkontrolujte, jestli se volání odesílaná na server SFTP úspěšně dorazí, a získejte další informace o problému s připojením, můžete také spustit trasování sítě na bráně firewall a serveru SFTP.

Obecné limity

Název Hodnota
Maximální počet megabajtů přenášených do/z konektoru v časovém intervalu šířky pásma (na připojení) 1 000
Časový interval šířky pásma (v milisekundách) 60000

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
Adresa hostitelského serveru řetězec Adresa hostitelského serveru Pravdivé
Jméno uživatele řetězec Jméno uživatele Pravdivé
Heslo securestring Heslo
Privátní klíč SSH securestring Privátní klíč SSH (obsah souboru by měl být poskytován zcela stejně jako ve víceřádkovém formátu).
Heslo privátního klíče SSH securestring Heslo privátního klíče SSH (pokud je privátní klíč chráněný heslem)
Číslo portu int Číslo portu SFTP (příklad: 22)
Zakázání ověřování klíče hostitele SSH Booleova hodnota Chcete zakázat ověření klíče hostitele SSH? (Pravda nebo nepravda)
Tisk prstem na klíč hostitele SSH řetězec Tisk prstem na klíč hostitele SSH
Cesta ke kořenové složce řetězec Cesta ke kořenové složce

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 150 60 sekund

Akce

Aktualizovat soubor

Tato operace aktualizuje obsah souboru.
Extrahování archivu do složky

Tato operace extrahuje soubor archivu do složky (příklad: .zip).
Kopírování souboru

Tato operace zkopíruje soubor.
Odstranit soubor

Tato operace odstraní soubor.
Přejmenovat soubor

Tato operace přejmenuje soubor.
Vytvořit složku

Tato operace vytvoří novou složku.
Vytvořit soubor

Tato operace nahraje soubor.
Výpis souborů v kořenové složce

Tato operace získá soubory v kořenové složce.
Výpis souborů ve složce

Tato operace získá soubory obsažené ve složce.
Získat obsah souboru

Tato operace získá obsah souboru pomocí ID souboru.
Získání metadat souboru

Tato operace získá metadata souboru pomocí ID souboru.
Získání metadat souboru pomocí cesty

Tato operace získá metadata souboru pomocí cesty k souboru.
Získání obsahu souboru pomocí cesty

Tato operace získá obsah souboru pomocí cesty k souboru.

Aktualizovat soubor

ID operace:
UpdateFile

Tato operace aktualizuje obsah souboru.

Parametry

Name Klíč Vyžadováno Typ Description
File
 id True string

Zadání souboru
Obsah souboru
 body True binary

Obsah souboru, který se má aktualizovat
Získání všech metadat souborů
 ReadFileMetadataFromServer boolean

Po vytvoření souboru získejte všechna metadata souborů ze serveru SFTP. Pokud je tato hodnota false, některé vlastnosti metadat nemusí být vráceny, například čas poslední změny atd.

Návraty

Metadata objektů blob

Body
BlobMetadata

Extrahování archivu do složky

ID operace:
ExtractFolderV2

Tato operace extrahuje soubor archivu do složky (příklad: .zip).

Parametry

Name Klíč Vyžadováno Typ Description
Cesta k souboru zdrojového archivu
 source True string

Cesta k archivačnímu souboru
Cílová cesta ke složce
 destination True string

Cesta k cílové složce
Přepsat?
 overwrite boolean

Přepíše cílové soubory, pokud je nastavená hodnota true.

Návraty

response
array of BlobMetadata

Kopírování souboru

ID operace:
CopyFile

Tato operace zkopíruje soubor.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta ke zdrojovému souboru
 source True string

Cesta ke zdrojovému souboru
Cílová cesta k souboru
 destination True string

Cesta k cílovému souboru včetně názvu souboru
Přepsat?
 overwrite boolean

Přepíše cílový soubor, pokud je nastavený na true.
Získání všech metadat souborů
 ReadFileMetadataFromServer boolean

Po vytvoření souboru získejte všechna metadata souborů ze serveru SFTP. Pokud je tato hodnota false, některé vlastnosti metadat nemusí být vráceny, například čas poslední změny atd.

Návraty

Metadata objektů blob

Body
BlobMetadata

Odstranit soubor

ID operace:
DeleteFile

Tato operace odstraní soubor.

Parametry

Name Klíč Vyžadováno Typ Description
File
 id True string

Zadání souboru
Přeskočit odstranění, pokud nebyl nalezen soubor
 SkipDeleteIfFileNotFoundOnServer boolean

Přeskočí odstranění, pokud se soubor nenajde bez neúspěšné akce.

Přejmenovat soubor

ID operace:
RenameFile

Tato operace přejmenuje soubor.

Parametry

Name Klíč Vyžadováno Typ Description
File
 id True string

Výběr souboru
Nový název
 newName True string

Nový název souboru
Získání všech metadat souborů
 ReadFileMetadataFromServer boolean

Po vytvoření souboru získejte všechna metadata souborů ze serveru SFTP. Pokud je tato hodnota false, některé vlastnosti metadat nemusí být vráceny, například čas poslední změny atd.

Návraty

Představuje odpověď metadat datových sad objektů blob.

Body
BlobMetadataResponse

Vytvořit složku

ID operace:
CreateFolder

Tato operace vytvoří novou složku.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderPath True string

Výběr složky
Název
 name True string

Název složky

Návraty

Metadata objektů blob

Body
BlobMetadata

Vytvořit soubor

ID operace:
CreateFile

Tato operace nahraje soubor.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta ke složce
 folderPath True string

Jedinečná cesta ke složce
Název souboru
 name True string

Název souboru
Obsah souboru
 body True binary

Obsah souboru, který se má vytvořit
Získání všech metadat souborů
 ReadFileMetadataFromServer boolean

Po vytvoření souboru získejte všechna metadata souborů ze serveru SFTP. Pokud je tato hodnota false, některé vlastnosti metadat nemusí být vráceny, například čas poslední změny atd.

Návraty

Metadata objektů blob

Body
BlobMetadata

Výpis souborů v kořenové složce

ID operace:
ListRootFolder

Tato operace získá soubory v kořenové složce.

Návraty

response
array of BlobMetadata

Výpis souborů ve složce

ID operace:
ListFolder

Tato operace získá soubory obsažené ve složce.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 id True string

Zadání složky

Návraty

response
array of BlobMetadata

Získat obsah souboru

ID operace:
GetFileContent

Tato operace získá obsah souboru pomocí ID souboru.

Parametry

Name Klíč Vyžadováno Typ Description
File
 id True string

Zadejte ID souboru.
Odvození typu obsahu
 inferContentType boolean

Odvození typu obsahu na základě rozšíření

Návraty

Obsah souboru.

Obsah souboru
binary

Získání metadat souboru

ID operace:
GetFileMetadata

Tato operace získá metadata souboru pomocí ID souboru.

Parametry

Name Klíč Vyžadováno Typ Description
File
 id True string

Zadejte ID souboru.

Návraty

Metadata objektů blob

Body
BlobMetadata

Získání metadat souboru pomocí cesty

ID operace:
GetFileMetadataByPath

Tato operace získá metadata souboru pomocí cesty k souboru.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta k souboru
 path True string

Jedinečná cesta k souboru

Návraty

Metadata objektů blob

Body
BlobMetadata

Získání obsahu souboru pomocí cesty

ID operace:
GetFileContentByPath

Tato operace získá obsah souboru pomocí cesty k souboru.

Parametry

Name Klíč Vyžadováno Typ Description
Cesta k souboru
 path True string

Jedinečná cesta k souboru
Odvození typu obsahu
 inferContentType boolean

Odvození typu obsahu na základě rozšíření

Návraty

Obsah souboru.

Obsah souboru
binary

Aktivační události

Při přidání nebo změně souboru

Tato operace aktivuje tok při přidání nebo změně souboru ve složce. Trigger načte metadata souboru i obsah souboru. Trigger spoléhá na čas poslední změny souboru. Pokud soubor vytváří klient třetí strany, zachování času poslední změny by mělo být v klientovi zakázané. Trigger přeskočí soubory větší než 50 megabajtů. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Při přidání nebo změně souborů (pouze vlastnosti)

Tato operace aktivuje tok při přidání nebo změně souboru ve složce. Tento trigger načte pouze metadata souboru. K získání obsahu souboru můžete použít operaci Získat obsah souboru. Trigger spoléhá na čas poslední změny souboru. Pokud soubor vytváří klient třetí strany, zachování času poslední změny by mělo být v klientovi zakázané. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Při přidání nebo změně souboru

ID operace:
OnUpdatedFile

Tato operace aktivuje tok při přidání nebo změně souboru ve složce. Trigger načte metadata souboru i obsah souboru. Trigger spoléhá na čas poslední změny souboru. Pokud soubor vytváří klient třetí strany, zachování času poslední změny by mělo být v klientovi zakázané. Trigger přeskočí soubory větší než 50 megabajtů. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderId True string

Zadání složky
Zahrnout obsah souboru
 includeFileContent boolean

Pokud je nastavená hodnota true, obsah souboru se také načte spolu s odpovědí triggeru.
Odvození typu obsahu
 inferContentType boolean

Odvození typu obsahu na základě rozšíření

Návraty

Obsah souboru.

Obsah souboru
binary

Při přidání nebo změně souborů (pouze vlastnosti)

ID operace:
OnUpdatedFiles

Tato operace aktivuje tok při přidání nebo změně souboru ve složce. Tento trigger načte pouze metadata souboru. K získání obsahu souboru můžete použít operaci Získat obsah souboru. Trigger spoléhá na čas poslední změny souboru. Pokud soubor vytváří klient třetí strany, zachování času poslední změny by mělo být v klientovi zakázané. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.

Parametry

Name Klíč Vyžadováno Typ Description
Složka
 folderId True string

Výběr složky
Počet souborů, které se mají vrátit
 maxFileCount integer

Počet souborů vrácených triggerem (1–100)

Návraty

Metadata objektů blob

Seznam souborů
BlobMetadata

Definice

BlobMetadata

Metadata objektů blob

Name Cesta Typ Description
identifikační číslo
 Id string

Jedinečné ID souboru nebo složky.
Název
 Name string

Název souboru nebo složky.
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název souboru nebo složky.
Cesta
 Path string

Cesta k souboru nebo složce.
Naposledy upraveno
 LastModified date-time

Datum a čas poslední změny souboru nebo složky.
Velikost
 Size integer

Velikost souboru nebo složky.
MediaType
 MediaType string

Typ média souboru nebo složky.
IsFolder
 IsFolder boolean

Logická hodnota (true, false) označující, jestli je objekt blob složkou nebo ne.
ETag
 ETag string

Etag souboru nebo složky.
FileLocator
 FileLocator string

Lokátor souboru nebo složky.

BlobMetadataResponse

Představuje odpověď metadat datových sad objektů blob.

Name Cesta Typ Description
identifikační číslo
 Id string

Jedinečné ID souboru nebo složky.
Název
 Name string

Název souboru nebo složky.
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název souboru nebo složky.
Cesta
 Path string

Cesta k souboru nebo složce.
Naposledy upraveno
 LastModified date-time

Datum a čas poslední změny souboru nebo složky.
Velikost
 Size integer

Velikost souboru nebo složky.
MediaType
 MediaType string

Typ média souboru nebo složky.
IsFolder
 IsFolder boolean

Logická hodnota (true, false) označující, jestli je objekt blob složkou nebo ne.
ETag
 ETag string

Etag souboru nebo složky.
FileLocator
 FileLocator string

Lokátor souboru nebo složky.

binární

Toto je základní datový typ Binary.