Aracılığıyla paylaş

SFTP - SSH

SFTP (SSH Dosya Aktarım Protokolü), herhangi bir güvenilir veri akışı üzerinden dosya erişimi, dosya aktarımı ve dosya yönetimi sağlayan bir ağ protokolüdür. İnternet Mühendisliği Görev Gücü (IETF) tarafından güvenli dosya aktarımı özellikleri sağlamak için Secure Shell protokolü (SSH) sürüm 2.0'ın bir uzantısı olarak tasarlanmıştır.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Tüm Logic Apps bölgeleri
Power Apps Standart Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Savunma Bakanlığı (DoD)
Power Automate Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Microsoft
URL Microsoft LogicApps Desteği
Microsoft Power Automate Desteği
Microsoft Power Apps Desteği
Bağlayıcı Meta Verileri
Publisher Microsoft

Bağlayıcı nasıl yapılır kılavuzu

Bu makalede Azure Logic Apps, Power Automate ve Power Apps için kullanılabilen SFTP-SSH yönetilen bağlayıcının işlemleri açıklanmaktadır. SFTP yerleşik bağlayıcısı yalnızca Azure Logic Apps'teki Standart mantıksal uygulama iş akışları için kullanılabilir. Daha fazla bilgi için bkz. Azure Logic Apps'te SSH kullanarak SFTP sunucusuna bağlanma ve Azure Logic Appsiçin SFTP yerleşik bağlayıcı başvurusu.

Kullanım dışı bırakılan SFTP yönetilen bağlayıcısından farklar

Kullanım dışı bırakılan SFTP yönetilen bağlayıcısı ile karşılaştırıldığında, yönetilen SFTP-SSH bağlayıcı aşağıdaki temel özellikleri sağlar:

  • .NET'i destekleyen bir açık kaynak Secure Shell (SSH) kitaplığı olan SSH.NET kitaplığını kullanır.

  • SFTP sunucusunda belirtilen yolda bir klasör oluşturan Klasör oluştur eylemini sağlar.

  • SFTP sunucusundaki bir dosyayı yeniden adlandıran Dosyayı yeniden adlandır eylemini sağlar.

  • SFTP sunucusu bağlantısını 1 saate kadar önbelleğe alır. Bu özellik performansı artırır ve bağlayıcının sunucuya bağlanmayı deneme sıklığını azaltır. Bu önbelleğe alma davranışının süresini ayarlamak için SFTP sunucunuzdaki SSH yapılandırmasında ClientAliveInterval özelliğini düzenleyin.

Kimlik doğrulaması ve izinler

  • SFTP sunucunuzla bağlantı oluşturduğunuzda, SFTP sunucu adresinizi, hesap kimlik bilgilerinizi, bir SSH özel anahtarını ve SSH özel anahtar parolasını sağlamanız gerekir. Platformunuz öbekleme kullanarak büyük dosyaları karşıya yüklemeyi destekliyorsa, SFTP sunucunuzdaki kök klasör için hem okuma hem de yazma erişimine de ihtiyacınız vardır.

  • SFTP-SSH bağlayıcısı hem özel anahtar kimlik doğrulamasını hem de parola kimlik doğrulamasını destekler. Ancak SFTP-SSH bağlayıcısı yalnızca aşağıdaki özel anahtar biçimlerini, anahtar değişim algoritmalarını, şifreleme algoritmalarını ve parmak izlerini destekler:

    • Özel anahtar biçimleri: OpenSSH ve ssh.com biçimlerinde RSA (Rivest Shamir Adleman) ve DSA (Dijital İmza Algoritması) anahtarları. Özel anahtarınız PuTTY (.ppk) dosya biçimindeyse, önce anahtarı OpenSSH (.pem) dosya biçimine dönüştürün.
    • Anahtar değişimi algoritmaları:
      • eğri25519-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
    • Şifreleme algoritmaları:
      • 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
    • Konak anahtar algoritmaları:
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • Parmak izi: MD5. Daha fazla bilgi için bkz. MD5 parmak izini bulma.

  • Bağlantınız için SSH özel anahtarınızı sağladığınızda, anahtarı el ile girmeyin veya düzenlemeyin; bu da bağlantının başarısız olmasına neden olabilir. Bunun yerine, anahtarı SSH özel anahtar dosyanızdan kopyaladığınızdan ve bu anahtarı bağlantı bilgileri kutusuna yapıştırdığınızdan emin olun.

    SSH özel anahtarınızı doğru şekilde kopyalayıp yapıştırmak için aşağıdaki adımları izleyin.

    1. SSH özel anahtar dosyanızı herhangi bir metin düzenleyicisinde açın. Bu adımlar örnek olarak Not Defteri'ne devam ediyor.

    2. Not Defteri'ndeki Düzenle menüsünde Tümünü seç'i seçin. (Ctrl + A tuşlarına basın)

    3. Düzenle menüsünde Kopyala'yı seçin.

    4. SFTP-SSH bağlantı bilgileri kutusunda, kopyalanan anahtarın tamamını birden çok satırı destekleyen SSH özel anahtar özelliğine yapıştırın. Anahtarı el ile girmeyin veya düzenlemeyin.

    5. Bağlantı ayrıntılarını girmeyi tamamladıktan sonra Oluştur'u seçin.

PuTTY tabanlı anahtarı OpenSSH'ye dönüştürme

PuTTY biçimi ve OpenSSH biçimi farklı dosya adı uzantıları kullanır. PuTTY biçimi .ppk veya PuTTY Özel Anahtarı, dosya adı uzantısını kullanır. OpenSSH biçimi .pem veya Gizlilikle Geliştirilmiş Posta, dosya adı uzantısını kullanır. Özel anahtarınız PuTTY biçimindeyse ve OpenSSH biçimini kullanmanız gerekiyorsa, aşağıdaki adımları izleyerek anahtarı OpenSSH biçimine dönüştürün:

  • Unix tabanlı işletim sistemi

    1. Sisteminizde PuTTY araçları yüklü değilse, bunu şimdi yapın, örneğin:

      sudo apt-get install -y putty

    2. SFTP-SSH bağlayıcısı ile kullanabileceğiniz bir dosya oluşturan aşağıdaki komutu çalıştırın:

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

      Örneğin:

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

  • Windows İşletim Sistemi

    1. Henüz yapmadıysanız en son PuTTY Oluşturucu (puttygen.exe) aracını indirin ve ardından aracı açın.

    2. PuTTY Anahtar Oluşturucu aracında (puttygen.exe), Eylemler'in altında Yükle'yi seçin.

    3. PuTTY biçiminde özel anahtar dosyanıza göz atın ve Aç'ı seçin.

    4. Dönüştürmeler menüsünde OpenSSH anahtarını dışarı aktar'ı seçin.

    5. Özel anahtar dosyasını .pem dosya adı uzantısıyla kaydedin.

MD5 parmak izini bulma

hem SFTP sunucusunun parmak izi hem de beklenen parmak izi eşleşmiyorsa SFTP-SSH bağlayıcısı bağlantıyı reddeder. İki nokta üst üste ile ayrılmış 16 çift onaltılık basamak içeren bir dizi olan MD5 parmak izini almak için aşağıdaki seçenekleri deneyin.

Anahtarın sahibi sizsiniz

MD5 anahtarı, iki nokta üst üste ile ayrılmış 47 karakterlik bir dizedir. Anahtara sahip olduğunuzda MD5 parmak izini almak için ssh-keygen gibi araçları kullanabilirsiniz.

Örneğin, bash isteminden aşağıdaki komutu girin:

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

Anahtarınız yok

Anahtarınız olmadığında MD5 parmak izi almak için WinSCP'nin en son Sunucu ve Protokol Bilgileri İletişim Kutusu aracını kullanabilir veya bunun yerine PuTTY Yapılandırma aracını kullanabilirsiniz:

  1. PuTTY Yapılandırma aracında (putty.exe), Kategori penceresinde Bağlantı>SSH>Ana Bilgisayar anahtarları'nı genişletin.

  2. Konak anahtar algoritması tercihi'nin altında Algoritma seçim ilkesi listesini açın ve en üstte RSA'nın görünüp görünmediğini denetleyin.

  3. RSA en üstte görünmüyorsa RSA'yı seçin ve ardından RSA en üste taşınana kadar Yukarı'yı seçin.

  4. PuTTY ile SFTP sunucunuza bağlanın. Bağlantı oluşturulduktan sonra PUTTY güvenlik uyarısı görüntülendiğinde Daha fazla bilgi'yi seçin.

    Uyarı

    Güvenlik uyarısı görünmüyorsa SshHostKeys girdisini temizlemeyi deneyin. Windows kayıt defteri düzenleyicisini açın ve aşağıdaki girişe göz atın:

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. PuTTY: sunucunun ana bilgisayar anahtarı kutusu hakkındaki bilgiler göründükten sonra MD5 parmak izi özelliğini bulun ve aşağıdaki örneğe benzer şekilde 47 karakterlik dize değerini kopyalayın:

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

Tetikleyicilerle ilgili bilinen sorunlar ve sınırlamalar

  • SFTP yönetilen bağlayıcı tetikleyicileri eksik, eksik veya gecikmeli sonuçlarla karşılaşabilir.

    • Eksik sonuçlar

      SFTP tetikleyicileri, SFTP dosya sistemini yoklayarak veya denetleyerek ve son yoklamadan sonra değişen dosyaları arayarak çalışır. SFTP yönetilen bağlayıcı tetikleyicileri, dosyanın son değiştirilen zaman damgasını kullanarak dosya sürümlerini karşılaştırır.

      Şu anda izlenen son değiştirilen zaman damgasından önceki bir zaman damgasıyla dosya oluşturur, ekler veya güncelleştirirseniz, SFTP yönetilen bağlayıcı tetikleyicisi bu dosyayı algılamaz.

      Bu nedenle, SFTP sunucusunda dosya oluşturan, ekleyen veya güncelleştiren bir dış araç veya istemci kullanıyorsanız, araçta veya istemcide dosyanın son değiştirilen zaman damgasını koruyan herhangi bir özelliği devre dışı bırakın.

      Aşağıdaki tabloda, bu zaman damgasını koruyan bazı yaygın kullanılan araçlar ve bu özelliği devre dışı bırakma adımları listelenir:

      SFTP istemcisi Eylem
      WinSCP Seçenekler>Tercihleri>Aktarım>Düzenleme>Koruma zaman damgası>devre dışı bırak'a gidin.
      FileZilla Aktarılan> dosyaların >Devre Dışı Bırak'a gidin.

    • Eksik veya gecikmeli sonuçlar

      SFTP tetikleyicisi yeni oluşturulan, eklenen veya güncelleştirilen bir dosyayı denetlediğinde, tetikleyici dosyanın tamamlanıp tamamlanmadığını da denetler. Örneğin, tetikleyici SFTP sunucusunu denetlediğinde dosyada devam eden değişiklikler olabilir. Tamamlanmamış bir dosyanın döndürülmesi önlemek için tetikleyici dosyanın zaman damgasını not alır, ancak dosyayı hemen döndürmez. Bunun yerine tetikleyici, dosyayı yalnızca tetikleyici sunucuyu yeniden denetlediğinde döndürür.

      Bazen bu davranış tetikleyicinin yoklama aralığının neredeyse iki katı kadar uzun süren bir gecikmeye neden olabilir. Bu davranış nedeniyle, SFTP tetikleyicisinin Bölünmüş ayarını devre dışı bırakırsanız, SFTP tetikleyicisi tüm dosyaları aynı anda döndürmeyebilir.

Genel bilinen sorunlar ve sınırlamalar

  • yönetilen SFTP-SSH bağlayıcısı şu anda aşağıdaki SFTP sunucularını desteklemez:

    • Akamai NetStorage
    • FileMage Ağ Geçidi
    • Genel manzara
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • Azure Blob Depolama için SFTP
    • VShell Güvenli Dosya Aktarım Sunucusu
    • AWS SFTP

  • Dosya işleme ve karşıya yükleme için ayrı SFTP klasörleri kullanın.

    Dosyaları işlemek ve karşıya yüklenen dosyaları depolamak için tetikleyici için SFTP sunucunuzda ayrı klasörler kullandığınızdan emin olun. Aksi takdirde tetikleyici tetiklenmez ve öngörülemez şekilde davranır. Örneğin tetikleyici, işlenmesi gereken rastgele sayıda dosyayı atlayabilir.

    Bu sınırlama, dosyaları bu klasörler arasında taşımak için bir yönteme ihtiyacınız olduğu anlamına gelir. Bu sorunla karşılaşırsanız, izlenen klasörden dosyaları kaldırın ve karşıya yüklenen dosyaları depolamak için farklı bir klasör kullanın.

  • Paylaşılan çok kiracılı yönetilen bağlayıcı hizmetlerindeki yükü yönetmek için, yönetilen SFTP-SSH bağlayıcısı aynı kaynak IP adresinden ,yani bağlayıcı IP adresinden SFTP sunucunuz olan hedefe birden çok bağlantı oluşturabilir. Bazı düşük trafikli bölgeler bağlayıcı IP adresinin arkasında yalnızca üç sanal makine örneği kullanabilir ve bu da bu bölgelerin en fazla üç bağlantı oluşturabileceği anlamına gelir. Bağlayıcı IP adresinin arkasında aynı sayıda sanal makine olduğundan diğer bölgeler en fazla 20 bağlantı kullanabilir.

    SFTP sunucunuz bağlantı sayısını sınırlıyorsa, sunucunuz yönetilen SFTP-SSH bağlayıcısıyla iyi çalışmayabilir. Ancak, bunun yerine yerleşik SFTP işlemlerini kullanan bir Standart mantıksal uygulama iş akışı oluşturabilirsiniz. Ölçeği genişletme sınırlarını ve sonuç olarak bağlantı sayısını denetleyebilirsiniz.

  • SFTP-SSH yönetilen bağlayıcınız ile SFTP sunucunuz arasında şifreleme paketi birlikte çalışabilirliği sorunlarıyla karşılaşırsanız Standart mantıksal uygulama iş akışı oluşturmayı deneyin ve bunun yerine SFTP yerleşik işlemlerini kullanın. SFTP yerleşik işlemleri daha geniş bir şifreleme paketlerini destekler.

  • Bu bağlayıcı arka uçtan bir no-op isteği gönderebilir.

Chunking

  • Azure Logic Apps ve Power Automate'te aşağıdaki yönetilen SFTP-SSH bağlayıcı eylemleri, bir eylemin büyük dosyaları daha küçük parçalar halinde işlemeyi etkinleştirebileceği öbeklemeyi destekler. Azure Logic Apps'te öbekleme hakkında daha fazla bilgi için bkz. [Öbekleme kullanarak büyük iletileri işleme](/azure/logic-apps/logic-apps-handle-large-messages).

    Eylem Öbekleme desteği Öbek boyutu desteğini geçersiz kıl
    Dosyayı kopyalama Hayı Uygulanamaz
    Dosya oluşturma Yes Yes
    Klasör oluştur Uygulanamaz Uygulanamaz
    Dosyayı silmel Uygulanamaz Uygulanamaz
    Arşivi klasöre ayıkla Uygulanamaz Uygulanamaz
    Dosya içeriğini alma Yes Yes
    Yolu kullanarak dosya içeriği alma Yes Yes
    Dosya meta verilerini alma Uygulanamaz Uygulanamaz
    Yolu kullanarak dosya meta verilerini alma Uygulanamaz Uygulanamaz
    Klasördeki dosyaları listeleme Uygulanamaz Uygulanamaz
    Dosyayı yeniden adlandır Uygulanamaz Uygulanamaz
    Dosyayı güncelleştirme Hayı Uygulanamaz

    Öbeklemeye yönelik SFTP-SSH eylemler 1 GB'a kadar olan dosyaları işleyebilirken, öbeklemeye destek olmayan SFTP-SSH eylemler 50 MB'a kadar olan dosyaları işleyebilir. Varsayılan öbek boyutu 15 MB'tır. Ancak bu boyut, 5 MB'tan başlayıp kademeli olarak en fazla 50 MB'a çıkarılarak dinamik olarak değişebilir. Dinamik boyutlandırma, ağ gecikme süresi, sunucu yanıt süresi vb. gibi faktörleri temel alır.

    Bunun yerine kullanılacak sabit bir öbek boyutu belirttiğinizde bu uyarlamalı davranışı geçersiz kılabilirsiniz. Bu boyut 5 MB ile 50 MB arasında olabilir. Örneğin, 45 MB'lık bir dosyanız ve gecikme olmadan bu dosya boyutunu destekleyebilecek bir ağınız olduğunu varsayalım. Uyarlamalı öbekleme, tek bir çağrı yerine birkaç çağrıyla sonuçlanır. Çağrı sayısını azaltmak için 50 MB öbek boyutu ayarlamayı deneyebilirsiniz. Farklı senaryoda, mantıksal uygulama iş akışınız zaman aşımına uğradıysa (örneğin, 15 MB öbekleri kullanırken) boyutu 5 MB'a düşürmeyi deneyebilirsiniz.

    Öbek boyutu bir bağlantıyla ilişkilendirilir. Bu öznitelik, hem öbekleyi destekleyen eylemler hem de öbekleme desteği olmayan eylemler için aynı bağlantıyı kullanabileceğiniz anlamına gelir. Bu durumda, öbeklemeye yönelik eylemlerin öbek boyutu 5 MB ile 50 MB arasında değişir.

    Öbeklemenin bir SFTP-SSH eyleminde kullandığı varsayılan uyarlamalı davranışı geçersiz kılmak için 5 MB ile 50 MB arası sabit bir öbek boyutu belirtebilirsiniz.

    1. Tasarımcıda, SFTP-SSH eyleminin sağ üst köşesinde üç nokta düğmesini (...) ve ardından Ayarlar'ı seçin.

    2. İçerik Aktarımı'nın altında, Öbek boyutu özelliğine , için 550bir tamsayı değeri girin.

    3. bitirdikten sonra Bitti'yi seçin.

  • SFTP-SSH tetikleyicileri ileti öbekle işlemini desteklemez. Tetikleyiciler dosya içeriği istediğinde, yalnızca 15 MB veya daha küçük dosyaları seçer. 15 MB'tan büyük dosyaları almak için bunun yerine şu deseni izleyin:

    1. Yalnızca dosya özelliklerini döndüren bir SFTP-SSH tetikleyicisi kullanın. Bu tetikleyiciler, açıklamayı (yalnızca özellikler) içeren adlara sahiptir.

    2. SFTP-SSH Dosya içeriği al eylemiyle tetikleyiciyi izleyin. Bu eylem dosyanın tamamını okur ve örtük olarak ileti öbekleme kullanır.

Sorun giderme

401 hatası: "401 Yetkisiz"

Doğru kimlik bilgilerine veya izinlere sahip olmadığınız için bu hata oluşabilir. Daha fazla bilgi için bkz. Kimlik doğrulaması ve izinler.

404 hatası: "Var olmayan bir dosya veya klasöre başvuru yapıldı"

Dosya oluştur eylemini kullandığınızda bu hata oluşabilir. Eylem SFTP sunucunuzda bir dosya oluşturduğunda, eylem ayrıca dosyanın meta verilerini almak için SFTP sunucunuza otomatik olarak bir çağrı gönderir.

Çağrının meta verileri alabilmesi için yeni oluşturulan dosyayı hemen taşırsanız, dosya artık beklenen konumda bulunmaz ve 404 hata iletisini alırsanız, var olmayan bir dosyaya veya klasöre başvuru yapılmıştır.

Dosyanın taşınmasını önleyemez veya geciktiremiyorsanız, aşağıdaki adımları izleyerek dosya oluşturulduktan sonra dosyanın meta verilerini okumayı atlayabilirsiniz:

  1. Dosya oluştur eyleminde Yeni parametre ekle listesini açın, Tüm dosya meta verilerini al özelliğini seçin ve değeri Hayır olarak ayarlayın.

  2. Bu dosya meta verilerine daha sonra ihtiyacınız olursa , Dosya meta verilerini al eylemini kullanabilirsiniz.

504 hatası: "Bağlı taraf belirli bir süre sonra düzgün yanıt vermediğinden veya bağlı ana bilgisayar yanıt vermediğinden bağlantı kurulamadığından bağlantı girişimi başarısız oldu" veya "SFTP sunucusuna istek '00:00:30' saniyeden uzun sürdü"

SFTP sunucusuyla başarıyla bağlantı kuramıyorsanız bu hata oluşabilir. Bu sorunun farklı nedenleri olabilir, bu nedenle şu sorun giderme seçeneklerini deneyin:

  • Bağlantı zaman aşımı 20 saniyedir. SFTP sunucunuzun iyi performansa sahip olup olmadığını ve güvenlik duvarları gibi ara cihazların ek yük eklemediğini denetleyin.

  • SFTP sunucunuzun her IP adresinden gelen bağlantı sayısına bir sınır koyup eklemediğini denetleyin. Bu tür bir sınır bağlayıcı ile SFTP sunucusu arasındaki iletişimi engeller. Bu sınırı kaldırdığınızdan emin olun.

  • Ayarlanmış bir güvenlik duvarınız varsa, bölgeniz için yönetilen bağlayıcı IP adreslerini onaylananlar listesine eklediğinizden emin olun.

  • Hata aralıklı olarak oluşursa, SFTP-SSH eylemindeki Yeniden Dene ilkesi ayarını varsayılan dört yeniden denemeden daha yüksek bir yeniden deneme sayısıyla değiştirin.

  • Bağlantı kurma maliyetini azaltmak için SFTP sunucunuzun SSH yapılandırmasında ClientAliveInterval özelliğini yaklaşık bir saate yükseltin.

  • SFTP sunucunuza gönderilen çağrıların başarıyla ulaşıp ulaşmadığını denetlemek için SFTP sunucu günlüğünü gözden geçirin. Bağlantı sorunu hakkında daha fazla bilgi edinmek için güvenlik duvarınızda ve SFTP sunucunuzda bir ağ izlemesi de çalıştırabilirsiniz.

Genel Sınırlar

İsim Değer
Bir bant genişliği zaman aralığı içinde (bağlantı başına) bağlayıcıya/bağlayıcıdan aktarılan megabayt sayısı üst sınırı 1000
Bant genişliği zaman aralığı (milisaniye cinsinden) 60000

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Ana bilgisayar sunucusu adresi String Ana bilgisayar sunucusu adresi Doğru
Kullanıcı adı String Kullanıcı adı Doğru
Şifre securestring Şifre
SSH özel anahtarı securestring SSH özel anahtarı (dosyanın içeriği tamamen çok satırlı biçimde sağlanmalıdır)
SSH özel anahtar parolası securestring SSH özel anahtar parolası (özel anahtar parolayla korunuyorsa)
Bağlantı noktası numarası int SFTP bağlantı noktası numarası (örnek: 22)
SSH ana bilgisayar anahtarı doğrulamasını devre dışı bırakma bool SSH ana bilgisayar anahtarı doğrulaması devre dışı bırakılasın mı? (Doğru/Yanlış)
SSH ana bilgisayar anahtarı parmak izi String SSH ana bilgisayar anahtarı parmak izi
Kök klasör yolu String Kök klasör yolu.

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 150 60 saniye

Eylemler

Arşivi klasöre ayıkla

Bu işlem bir arşiv dosyasını bir klasöre ayıklar (örnek: .zip).
Dosya içeriğini alma

Bu işlem, dosya kimliğini kullanarak dosya içeriğini alır.
Dosya meta verilerini alma

Bu işlem, dosya kimliğini kullanarak dosya meta verilerini alır.
Dosya oluşturma

Bu işlem bir dosyayı karşıya yükler.
Dosyayı kopyalama

Bu işlem bir dosyayı kopyalar.
Dosyayı sil

Bu işlem bir dosyayı siler.
Dosyayı Yeniden Adlandır

Bu işlem bir dosyayı yeniden adlandırır.
JSON dosyasını güncelleştirme

Bu işlem dosya içeriğini güncelleştirir.
Klasör oluştur

Bu işlem yeni bir klasör oluşturur.
Klasördeki dosyaları listeleme

Bu işlem bir klasörde bulunan dosyaları alır.
Kök klasördeki dosyaları listeleme

Bu işlem, kök klasördeki dosyaları alır.
Yolu kullanarak dosya içeriği alma

Bu işlem dosya yolunu kullanarak dosya içeriğini alır.
Yolu kullanarak dosya meta verilerini alma

Bu işlem dosya yolunu kullanarak dosya meta verilerini alır.

Arşivi klasöre ayıkla

İşlem Kimliği:
ExtractFolderV2

Bu işlem bir arşiv dosyasını bir klasöre ayıklar (örnek: .zip).

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak arşiv dosyası yolu
 source True string

Arşiv dosyasının yolu
Hedef klasör yolu
 destination True string

Hedef klasörün yolu
Üzerine?
 overwrite boolean

'true' olarak ayarlanırsa hedef dosyaların üzerine yazar

Döndürülenler

response
array of BlobMetadata

Dosya içeriğini alma

İşlem Kimliği:
GetFileContent

Bu işlem, dosya kimliğini kullanarak dosya içeriğini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya
 id True string

Dosya kimliğini belirtin
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsama

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Dosya meta verilerini alma

İşlem Kimliği:
GetFileMetadata

Bu işlem, dosya kimliğini kullanarak dosya meta verilerini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya
 id True string

Dosya kimliğini belirtin

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Dosya oluşturma

İşlem Kimliği:
CreateFile

Bu işlem bir dosyayı karşıya yükler.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör yolu
 folderPath True string

Klasörün benzersiz yolu
Dosya adı
 name True string

Dosyanın adı
Dosya içeriği
 body True binary

Oluşturulacak dosyanın içeriği
Tüm dosya meta verilerini alma
 ReadFileMetadataFromServer boolean

Dosya oluşturma tamamlandıktan sonra SFTP sunucusundan tüm dosya meta verilerini alın. Bu yanlışsa, son değiştirme zamanı gibi bazı meta veri özellikleri döndürülmeyebilir.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Dosyayı kopyalama

İşlem Kimliği:
CopyFile

Bu işlem bir dosyayı kopyalar.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak dosya yolu
 source True string

Kaynak dosyanın yolu
Hedef dosya yolu
 destination True string

Dosya adı da dahil olmak üzere hedef dosyanın yolu
Üzerine?
 overwrite boolean

'true' olarak ayarlanırsa hedef dosyanın üzerine yazar
Tüm dosya meta verilerini alma
 ReadFileMetadataFromServer boolean

Dosya oluşturma tamamlandıktan sonra SFTP sunucusundan tüm dosya meta verilerini alın. Bu yanlışsa, son değiştirme zamanı gibi bazı meta veri özellikleri döndürülmeyebilir.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Dosyayı sil

İşlem Kimliği:
DeleteFile

Bu işlem bir dosyayı siler.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya
 id True string

Dosyayı belirtin
Dosya bulunamazsa silmeyi atla
 SkipDeleteIfFileNotFoundOnServer boolean

Başarısız bir eylem olmadan dosya bulunamazsa silme işlemini atlar.

Dosyayı Yeniden Adlandır

İşlem Kimliği:
RenameFile

Bu işlem bir dosyayı yeniden adlandırır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya
 id True string

Dosya seçin
Yeni ad
 newName True string

Dosya için yeni ad
Tüm dosya meta verilerini alma
 ReadFileMetadataFromServer boolean

Dosya oluşturma tamamlandıktan sonra SFTP sunucusundan tüm dosya meta verilerini alın. Bu yanlışsa, son değiştirme zamanı gibi bazı meta veri özellikleri döndürülmeyebilir.

Döndürülenler

Blob veri kümeleri meta veri yanıtlarını temsil eder

Body
BlobMetadataResponse

JSON dosyasını güncelleştirme

İşlem Kimliği:
UpdateFile

Bu işlem dosya içeriğini güncelleştirir.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya
 id True string

Dosyayı belirtin
Dosya içeriği
 body True binary

Güncelleştirilecek dosyanın içeriği
Tüm dosya meta verilerini alma
 ReadFileMetadataFromServer boolean

Dosya oluşturma tamamlandıktan sonra SFTP sunucusundan tüm dosya meta verilerini alın. Bu yanlışsa, son değiştirme zamanı gibi bazı meta veri özellikleri döndürülmeyebilir.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Klasör oluştur

İşlem Kimliği:
CreateFolder

Bu işlem yeni bir klasör oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderPath True string

Klasör seçin
İsim
 name True string

Klasörün adı

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Klasördeki dosyaları listeleme

İşlem Kimliği:
ListFolder

Bu işlem bir klasörde bulunan dosyaları alır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 id True string

Klasörü belirtin

Döndürülenler

response
array of BlobMetadata

Kök klasördeki dosyaları listeleme

İşlem Kimliği:
ListRootFolder

Bu işlem, kök klasördeki dosyaları alır.

Döndürülenler

response
array of BlobMetadata

Yolu kullanarak dosya içeriği alma

İşlem Kimliği:
GetFileContentByPath

Bu işlem dosya yolunu kullanarak dosya içeriğini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya yolu
 path True string

Dosyanın benzersiz yolu
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsama

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Yolu kullanarak dosya meta verilerini alma

İşlem Kimliği:
GetFileMetadataByPath

Bu işlem dosya yolunu kullanarak dosya meta verilerini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya yolu
 path True string

Dosyanın benzersiz yolu

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Tetikleyiciler

Dosya eklendiğinde veya değiştirildiğinde

Bu işlem, klasöre dosya eklendiğinde veya değiştirildiğinde bir akışı tetikler. Tetikleyici hem dosya meta verilerini hem de dosyanın içeriğini getirir. Tetikleyici, dosyanın son değiştirme zamanına dayanır. Bir dosya üçüncü taraf istemci tarafından oluşturuluyorsa, son değiştirme zamanının korunması istemcide devre dışı bırakılmalıdır. 50 megabayttan büyük dosyalar tetikleyici tarafından atlanır. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.
Dosyalar eklendiğinde veya değiştirildiğinde (yalnızca özellikler)

Bu işlem, klasöre dosya eklendiğinde veya değiştirildiğinde bir akışı tetikler. Bu tetikleyici yalnızca dosya meta verilerini getirir. Dosya içeriğini almak için "Dosya içeriğini al" işlemini kullanabilirsiniz. Tetikleyici, dosyanın son değiştirme zamanına dayanır. Bir dosya üçüncü taraf istemci tarafından oluşturuluyorsa, son değiştirme zamanının korunması istemcide devre dışı bırakılmalıdır. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Dosya eklendiğinde veya değiştirildiğinde

İşlem Kimliği:
OnUpdatedFile

Bu işlem, klasöre dosya eklendiğinde veya değiştirildiğinde bir akışı tetikler. Tetikleyici hem dosya meta verilerini hem de dosyanın içeriğini getirir. Tetikleyici, dosyanın son değiştirme zamanına dayanır. Bir dosya üçüncü taraf istemci tarafından oluşturuluyorsa, son değiştirme zamanının korunması istemcide devre dışı bırakılmalıdır. 50 megabayttan büyük dosyalar tetikleyici tarafından atlanır. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderId True string

Klasör belirtme
Dosya içeriği ekle
 includeFileContent boolean

True olarak ayarlanırsa, tetikleyici yanıtıyla birlikte dosya içeriği de alınır
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsama

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Dosyalar eklendiğinde veya değiştirildiğinde (yalnızca özellikler)

İşlem Kimliği:
OnUpdatedFiles

Bu işlem, klasöre dosya eklendiğinde veya değiştirildiğinde bir akışı tetikler. Bu tetikleyici yalnızca dosya meta verilerini getirir. Dosya içeriğini almak için "Dosya içeriğini al" işlemini kullanabilirsiniz. Tetikleyici, dosyanın son değiştirme zamanına dayanır. Bir dosya üçüncü taraf istemci tarafından oluşturuluyorsa, son değiştirme zamanının korunması istemcide devre dışı bırakılmalıdır. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderId True string

Klasör seçin
Döndürülecek dosya sayısı
 maxFileCount integer

Tetikleyiciden döndürülen dosya sayısı (1-100)

Döndürülenler

Blob meta verileri

Dosya Listesi
BlobMetadata

Tanımlar

BlobMetadata

Blob meta verileri

Name Yol Tür Description
Kimlik
 Id string

Dosya veya klasörün benzersiz kimliği.
İsim
 Name string

Dosya veya klasörün adı.
Gösterim Adı
 DisplayName string

Dosya veya klasörün görünen adı.
Yol
 Path string

Dosya veya klasörün yolu.
SonDeğiştirildi
 LastModified date-time

Dosya veya klasörün son değiştirildiği tarih ve saat.
Boyut
 Size integer

Dosya veya klasörün boyutu.
Medya Türü
 MediaType string

Dosya veya klasörün medya türü.
IsFolder
 IsFolder boolean

Blob'un bir klasör olup olmadığını belirten boole değeri (true, false).
ETag (İngilizce)
 ETag string

Dosya veya klasörün etiketi.
FileLocator
 FileLocator string

Dosya veya klasörün dosya bulucu.

BlobMetadataResponse

Blob veri kümeleri meta veri yanıtlarını temsil eder

Name Yol Tür Description
Kimlik
 Id string

Dosya veya klasörün benzersiz kimliği.
İsim
 Name string

Dosya veya klasörün adı.
Gösterim Adı
 DisplayName string

Dosya veya klasörün görünen adı.
Yol
 Path string

Dosya veya klasörün yolu.
SonDeğiştirildi
 LastModified date-time

Dosya veya klasörün son değiştirildiği tarih ve saat.
Boyut
 Size integer

Dosya veya klasörün boyutu.
Medya Türü
 MediaType string

Dosya veya klasörün medya türü.
IsFolder
 IsFolder boolean

Blob'un bir klasör olup olmadığını belirten boole değeri (true, false).
ETag (İngilizce)
 ETag string

Dosya veya klasörün etiketi.
FileLocator
 FileLocator string

Dosya veya klasörün dosya bulucu.

ikili

Bu, 'ikili' temel veri türüdür.