다음을 통해 공유

SFTP - SSH

SFTP(SSH 파일 전송 프로토콜)는 신뢰할 수 있는 데이터 스트림에 대한 파일 액세스, 파일 전송 및 파일 관리를 제공하는 네트워크 프로토콜입니다. IETF(Internet Engineering Task Force)는 보안 파일 전송 기능을 제공하기 위해 SSH(Secure Shell 프로토콜) 버전 2.0의 확장으로 설계되었습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 국방부(DoD)
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps 스탠다드 다음을 제외한 모든 Power Apps 지역 :
     - 미국 국방부(DoD)
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 미국 국방부(DoD)
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft

커넥터 방법 가이드

이 문서에서는 Azure Logic Apps, Power Automate 및 Power Apps에 사용할 수 있는 SFTP-SSH 관리 되는 커넥터에 대한 작업을 설명합니다. SFTP 기본 제공 커넥터는 Azure Logic Apps의 표준 논리 앱 워크플로에만 사용할 수 있습니다. 자세한 내용은 Azure Logic Apps에서 SSH를 사용하여 SFTP 서버에 연결하고 Azure Logic Apps에대한 SFTP 기본 제공 커넥터 참조를 참조하세요.

사용되지 않는 SFTP 관리 커넥터의 차이점

사용되지 않는 SFTP 관리 커넥터에 비해 SFTP-SSH 관리 커넥터는 다음과 같은 주요 기능을 제공합니다.

  • .NET을 지원하는 오픈 소스 SSH(Secure Shell) 라이브러리인 SSH.NET 라이브러리를 사용합니다.

  • SFTP 서버의 지정된 경로에 폴더를 만드는 폴더 만들기 작업을 제공합니다.

  • SFTP 서버의 파일 이름을 바꾸는 파일 이름 바꾸기 작업을 제공합니다.

  • 최대 1시간 동안 SFTP 서버에 대한 연결을 캐시합니다. 이 기능은 성능을 향상시키고 커넥터가 서버에 연결을 시도하는 빈도를 줄입니다. 이 캐싱 동작의 기간을 설정하려면 SFTP 서버의 SSH 구성에서 ClientAliveInterval 속성을 편집합니다.

인증 및 권한

  • SFTP 서버에 대한 연결을 만들 때 SFTP 서버 주소, 계정 자격 증명, SSH 프라이빗 키 및 SSH 프라이빗 키 암호를 제공해야 합니다. 플랫폼에서 청크를 사용하여 대용량 파일 업로드를 지원하는 경우 SFTP 서버의 루트 폴더에 대한 읽기 및 쓰기 액세스도 모두 필요합니다.

  • SFTP-SSH 커넥터는 프라이빗 키 인증과 암호 인증을 모두 지원합니다. 그러나 SFTP-SSH 커넥터는 다음과 같은 프라이빗 키 형식, 키 교환 알고리즘, 암호화 알고리즘 및 지문만 지원합니다.

    • 프라이빗 키 형식: OpenSSH 및 ssh.com 형식의 RSA(Rivest Shamir Adleman) 및 DSA(디지털 서명 알고리즘) 키. 프라이빗 키가 PuTTY(.ppk) 파일 형식인 경우 먼저 키를 OpenSSH(.pem) 파일 형식으로 변환합니다.
    • 키 교환 알고리즘:
      • 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
    • 암호화 알고리즘:
      • 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
    • 호스트 키 알고리즘:
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • 지문: MD5. 자세한 내용은 MD5 지문 찾기를 참조하세요.

  • 연결에 SSH 프라이빗 키를 제공하는 경우 키를 수동으로 입력하거나 편집하지 마세요. 이로 인해 연결이 실패할 수 있습니다. 대신 SSH 프라이빗 키 파일에서 키를 복사하고 해당 키를 연결 정보 상자에 붙여넣습니다.

    SSH 프라이빗 키를 올바르게 복사하여 붙여넣려면 다음 단계를 수행합니다.

    1. 텍스트 편집기에서 SSH 프라이빗 키 파일을 엽니다. 이러한 단계는 메모장을 예로 계속 사용합니다.

    2. 메모장에서 [편집] 메뉴에서 [ 모두 선택]을 선택합니다. (Ctrl+ A를 누릅니다.)

    3. 편집 메뉴에서 복사를 선택합니다.

    4. SFTP-SSH 연결 정보 상자에서 복사한 전체 키를 여러 줄을 지원하는 SSH 프라이빗 키 속성에 붙여넣습니다. 키를 수동으로 입력하거나 편집하지 마세요.

    5. 연결 세부 정보 입력을 마친 후 만들기를 선택합니다.

PuTTY 기반 키를 OpenSSH로 변환

PuTTY 형식 및 OpenSSH 형식은 다른 파일 이름 확장명을 사용합니다. PuTTY 형식은 .ppk 또는 PuTTY 프라이빗 키, 파일 이름 확장명을 사용합니다. OpenSSH 형식은 .pem 또는 개인 정보 보호 고급 메일, 파일 이름 확장명을 사용합니다. 프라이빗 키가 PuTTY 형식이고 OpenSSH 형식을 사용해야 하는 경우 먼저 다음 단계에 따라 키를 OpenSSH 형식으로 변환합니다.

  • Unix 기반 OS

    1. 시스템에 PuTTY 도구가 설치되어 있지 않은 경우 다음과 같이 지금 수행합니다.

      sudo apt-get install -y putty

    2. 다음 명령을 실행하여 SFTP-SSH 커넥터와 함께 사용할 수 있는 파일을 만듭니다.

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

      예를 들어

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

  • 윈도우 운영 체제

    1. 아직 수행하지 않은 경우 최신 PuTTY 생성기(puttygen.exe) 도구를 다운로드한 다음 도구를 엽니다.

    2. PuTTY 키 생성기 도구(puttygen.exe)의 작업에서 로드를 선택합니다.

    3. PuTTY 형식의 프라이빗 키 파일로 이동하고 열기를 선택합니다.

    4. 변환 메뉴에서 OpenSSH 키 내보내기를 선택합니다.

    5. 프라이빗 키 파일을 .pem 파일 이름 확장명을 사용하여 저장합니다.

MD5 지문 찾기

SFTP-SSH 커넥터는 SFTP 서버의 지문과 예상된 지문이 모두 일치하지 않으면 연결을 거부합니다. 16쌍의 16진수 숫자가 콜론으로 구분된 시퀀스인 MD5 지문을 얻으려면 다음 옵션을 시도해 보세요.

키가 있습니다.

MD5 키는 콜론으로 구분된 47자 문자열입니다. 키가 있을 때 MD5 지문을 얻으려면 ssh-keygen과 같은 도구를 사용할 수 있습니다.

예를 들어 Bash 프롬프트에서 다음 명령을 입력합니다.

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

키가 없습니다.

키가 없는 경우 MD5 지문을 얻으려면 WinSCP에서 최신 서버 및 프로토콜 정보 대화 상자 도구를 사용하거나 PuTTY 구성 도구를 대신 사용할 수 있습니다.

  1. PuTTY 구성 도구(putty.exe)의 범주 창에서 연결>SSH>호스트 키를 확장합니다.

  2. 호스트 키 알고리즘 기본 설정에서 알고리즘 선택 정책 목록을 열고 RSA가 맨 위에 표시되는지 확인합니다.

  3. RSA가 맨 위에 표시되지 않으면 RSA를 선택한 다음 RSA가 위쪽으로 이동할 때까지 위쪽을 선택합니다.

  4. PuTTY를 사용하여 SFTP 서버에 연결합니다. 연결을 만든 후 PUTTY 보안 경고가 나타나면 추가 정보를 선택합니다.

    비고

    보안 경고가 표시되지 않으면 SshHostKeys 항목을 지웁니다. Windows 레지스트리 편집기를 열고 다음 항목으로 찾습니다.

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. PuTTY: 서버의 호스트 키 상자에 대한 정보가 나타나면 MD5 지문 속성을 찾고 다음 예제와 같은 47자 문자열 값을 복사합니다.

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

트리거의 알려진 문제 및 제한 사항

  • SFTP 관리형 커넥터 트리거는 누락되거나 불완전하거나 지연된 결과를 경험할 수 있습니다.

    • 누락된 결과

      SFTP 트리거는 SFTP 파일 시스템을 폴링하거나 확인하고 마지막 폴링 이후 변경된 파일을 검색하여 작동합니다. SFTP 관리 커넥터 트리거는 파일의 마지막으로 수정된 타임스탬프를 사용하여 파일 버전을 비교합니다.

      현재 추적된 마지막 수정된 타임스탬프보다 이전의 타임스탬프를 사용하여 파일을 만들거나 추가하거나 업데이트하는 경우 SFTP 관리 커넥터 트리거는 이 파일을 검색하지 않습니다.

      따라서 SFTP 서버에서 파일을 만들거나 추가하거나 업데이트하는 외부 도구 또는 클라이언트를 사용하는 경우 파일의 마지막으로 수정된 타임스탬프를 유지하는 도구 또는 클라이언트의 기능을 사용하지 않도록 설정해야 합니다.

      다음 표에서는 이 타임스탬프를 유지하는 몇 가지 일반적으로 사용되는 도구와 이 기능을 사용하지 않도록 설정하는 단계를 나열합니다.

      SFTP 클라이언트 조치
      WinSCP 옵션>기본 설정>전송 편집>>보존 타임스탬프>사용 안 함으로 이동합니다.
      FileZilla 전송된 파일 > 의 전송 >사용 안 함으로 이동합니다.

    • 불완전하거나 지연된 결과

      SFTP 트리거가 새로 생성, 추가 또는 업데이트된 파일을 확인하는 경우 트리거는 파일이 완료되었는지 여부도 확인합니다. 예를 들어 트리거가 SFTP 서버를 검사할 때 파일이 변경될 수 있습니다. 불완전한 파일을 반환하지 않도록 트리거는 파일의 타임스탬프를 기록하지만 파일을 즉시 반환하지는 않습니다. 대신 트리거는 트리거가 서버를 다시 확인하는 경우에만 파일을 반환합니다.

      경우에 따라 이 동작으로 인해 트리거 폴링 간격의 거의 두 배까지 지속되는 지연이 발생할 수 있습니다. 이 동작으로 인해 SFTP 트리거의 Split On 설정을 사용하지 않도록 설정하면 SFTP 트리거가 모든 파일을 동시에 반환하지 않을 수 있습니다.

일반적인 알려진 문제 및 제한 사항

  • SFTP-SSH 관리 커넥터는 현재 다음 SFTP 서버를 지원하지 않습니다.

    • Akamai NetStorage
    • FileMage 게이트웨이
    • 글로벌스케이프
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • Azure Blob Storage용 SFTP
    • VShell 보안 파일 전송 서버
    • AWS SFTP

  • 파일 처리 및 업로드에 별도의 SFTP 폴더를 사용합니다.

    트리거에 대해 SFTP 서버에서 별도의 폴더를 사용하여 업로드된 파일을 처리하고 저장하기 위해 파일을 모니터링해야 합니다. 그렇지 않으면 트리거가 실행되지 않고 예측 불가능하게 동작합니다. 예를 들어 트리거는 처리가 필요한 난수의 파일을 건너뛸 수 있습니다.

    이 제한은 해당 폴더 간에 파일을 이동하는 방법이 필요하다는 것을 의미합니다. 이 문제가 발생하면 모니터링되는 폴더에서 파일을 제거하고 다른 폴더를 사용하여 업로드된 파일을 저장합니다.

  • 공유 다중 테넌트 관리 커넥터 서비스의 부하를 관리하기 위해 관리되는 SFTP-SSH 커넥터는 동일한 원본 IP 주소, 즉 커넥터 IP 주소에서 SFTP 서버인 대상에 대한 여러 연결을 만들 수 있습니다. 트래픽이 적은 일부 지역에서는 커넥터 IP 주소 뒤에 3개의 가상 머신 인스턴스만 사용할 수 있습니다. 즉, 해당 지역은 최대 3개의 연결을 만들 수 있습니다. 다른 지역은 커넥터 IP 주소 뒤에 동일한 수의 가상 머신이 있기 때문에 최대 20개의 연결을 사용할 수 있습니다.

    SFTP 서버에서 연결 수를 제한하는 경우 서버가 관리되는 SFTP-SSH 커넥터에서 제대로 작동하지 않을 수 있습니다. 그러나 기본 제공 SFTP 작업을 대신 사용하는 표준 논리 앱 워크플로를 만들 수 있습니다. 스케일 아웃 제한 및 결과적으로 연결 수를 제어할 수 있습니다.

  • SFTP-SSH 관리형 커넥터와 SFTP 서버 간에 암호 그룹 상호 운용성 문제가 발생하는 경우 표준 논리 앱 워크플로를 만들고 대신 SFTP 기본 제공 작업을 사용하세요. SFTP 기본 제공 작업은 광범위한 암호 그룹을 지원합니다.

  • 이 커넥터는 백 엔드에 no-op 요청을 보낼 수 있습니다.

Chunking

  • Azure Logic Apps 및 Power Automate에서 다음과 같은 관리형 SFTP-SSH 커넥터 작업은 작업이 작은 부분에서 큰 파일을 처리할 수 있는 청크를 지원합니다. Azure Logic Apps의 청크 분할에 대한 자세한 내용은 [청크를 사용하여 대용량 메시지 처리](/azure/logic-apps/logic-apps-handle-large-messages)를 참조하세요.

    조치 청크 분할 지원 청크 크기 지원 재정의
    파일 복사 아니오 해당 없음
    파일 만들기 Yes Yes
    폴더 만들기 해당 없음 해당 없음
    파일 삭제 해당 없음 해당 없음
    폴더에 보관 추출 해당 없음 해당 없음
    파일 콘텐츠 가져오기 Yes Yes
    경로를 사용하여 파일 콘텐츠 가져오기 Yes Yes
    파일 메타데이터 가져오기 해당 없음 해당 없음
    경로를 사용하여 파일 메타데이터 가져오기 해당 없음 해당 없음
    폴더의 파일 나열 해당 없음 해당 없음
    파일 이름 바꾸기 해당 없음 해당 없음
    파일 업데이트 아니오 해당 없음

    청크를 지원하는 SFTP-SSH 작업은 최대 1GB의 파일을 처리할 수 있지만 청크를 지원하지 않는 SFTP-SSH 작업은 최대 50MB의 파일을 처리할 수 있습니다. 기본 청크 크기는 15MB입니다. 그러나 이 크기는 동적으로 변경되어 5MB에서 시작하여 점차 최대 50MB까지 증가할 수 있습니다. 동적 크기 조정은 네트워크 대기 시간, 서버 응답 시간 등의 요인을 기반으로 합니다.

    대신 사용할 상수 청크 크기를 지정할 때 이 적응 동작을 재정의할 수 있습니다. 이 크기는 5MB에서 50MB까지 다양할 수 있습니다. 예를 들어 45MB 파일과 대기 시간 없이 해당 파일 크기를 지원할 수 있는 네트워크가 있다고 가정합니다. 적응 청크 분할은 한 번의 호출이 아니라 여러 호출로 발생합니다. 호출 수를 줄이려면 50MB 청크 크기를 설정해 볼 수 있습니다. 예를 들어 15MB 청크를 사용하는 경우와 같이 논리 앱 워크플로가 시간 초과되는 경우 크기를 5MB로 줄일 수 있습니다.

    청크 크기는 연결과 연결됩니다. 이 특성은 청크를 지원하는 작업과 청크를 지원하지 않는 작업에 대해 동일한 연결을 사용할 수 있음을 의미합니다. 이 경우 청크 분할을 지원하는 작업의 청크 크기는 5MB에서 50MB까지입니다.

    청크가 SFTP-SSH 작업에 사용하는 기본 적응 동작을 재정의하려면 5MB에서 50MB까지의 상수 청크 크기를 지정할 수 있습니다.

    1. 디자이너의 SFTP-SSH 동작의 오른쪽 위 모서리에서 줄임표 단추(...)를 선택한 다음 설정을 선택합니다.

    2. 콘텐츠 전송의 청크 크기 속성에서 정수 값을 5 입력합니다50.

    3. 완료한 후 완료를 선택합니다.

  • SFTP-SSH 트리거는 메시지 청크를 지원하지 않습니다. 요청 파일 콘텐츠를 트리거하는 경우 15MB 이하의 파일만 선택합니다. 15MB보다 큰 파일을 얻으려면 다음 패턴을 따르세요.

    1. 파일 속성만 반환하는 SFTP-SSH 트리거를 사용합니다. 이러한 트리거에는 설명을 포함하는 이름이 있습니다 (속성에만 해당).

    2. 파일 콘텐츠 가져오기 작업을 SFTP-SSH 트리거를 따릅니다. 이 작업은 전체 파일을 읽고 메시지 청크를 암시적으로 사용합니다.

Troubleshooting

401 오류: "401 권한 없음"

이 오류는 올바른 자격 증명 또는 권한이 없기 때문에 발생할 수 있습니다. 자세한 내용은 인증 및 사용 권한을 참조하세요.

404 오류: "존재하지 않는 파일 또는 폴더에 대한 참조가 발생했습니다."

이 오류는 파일 만들기 작업을 사용할 때 발생할 수 있습니다. 작업이 SFTP 서버에 파일을 만들면 작업에서 자동으로 SFTP 서버에 호출을 보내 파일의 메타데이터를 가져옵니다.

호출에서 메타데이터를 가져오기 전에 새로 만든 파일을 즉시 이동하면 파일이 더 이상 예상 위치에 존재하지 않으며 404 오류 메시지가 표시되면 존재하지 않는 파일이나 폴더에 대한 참조가 생성됩니다.

파일 이동을 방지하거나 지연할 수 없는 경우 다음 단계를 수행하여 파일을 만든 후 파일의 메타데이터 읽기를 건너뛸 수 있습니다.

  1. 파일 만들기 작업에서 새 매개 변수 추가 목록을 열고 모든 파일 메타데이터 가져오기 속성을 선택하고 값을 아니요로 설정합니다.

  2. 나중에 이 파일 메타데이터가 필요한 경우 파일 메타데이터 가져오기 작업을 사용할 수 있습니다.

504 오류: "연결된 당사자가 일정 기간 후에 제대로 응답하지 않았거나 연결된 호스트가 응답하지 않아 연결이 설정되지 않아 연결 시도가 실패했습니다." 또는 "SFTP 서버에 대한 요청이 '00:00:30' 초 이상 걸렸습니다."

이 오류는 SFTP 서버와의 연결을 성공적으로 설정할 수 없는 경우에 발생할 수 있습니다. 이 문제에 대한 다른 이유가 있을 수 있으므로 다음 문제 해결 옵션을 시도해 보세요.

  • 연결 시간 제한은 20초입니다. SFTP 서버의 성능이 양호하고 방화벽과 같은 중간 디바이스가 오버헤드를 추가하지 않는지 확인합니다.

  • SFTP 서버가 각 IP 주소의 연결 수에 제한을 두는지 확인합니다. 이러한 제한은 커넥터와 SFTP 서버 간의 통신을 방해합니다. 이 제한을 제거해야 합니다.

  • 방화벽이 설정된 경우 해당 지역의 관리형 커넥터 IP 주소를 승인된 목록에 추가해야 합니다.

  • 오류가 간헐적으로 발생하는 경우 SFTP-SSH 작업의 재시도 정책 설정을 기본 4번의 재시도보다 높은 재시도 횟수로 변경합니다.

  • 연결 설정 비용을 줄이려면 SFTP 서버에 대한 SSH 구성에서 ClientAliveInterval 속성을 약 1시간으로 늘입니다.

  • SFTP 서버 로그를 검토하여 SFTP 서버로 전송된 호출이 성공적으로 도착했는지 확인합니다. 연결 문제에 대한 자세한 내용을 보려면 방화벽 및 SFTP 서버에서 네트워크 추적을 실행할 수도 있습니다.

일반 제한

이름 가치
대역폭 시간 간격(연결당) 내에서 커넥터 간 전송되는 최대 메가바이트 수 1000
대역폭 시간 간격(밀리초) 60000

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
호스트 서버 주소 문자열 호스트 서버 주소 진실
사용자 이름 문자열 사용자 이름 진실
암호 시큐어스트링 (보안 문자열) 암호
SSH 프라이빗 키 시큐어스트링 (보안 문자열) SSH 프라이빗 키(파일의 콘텐츠는 다선 형식으로 그대로 제공되어야 합니다.)
SSH 프라이빗 키 암호 시큐어스트링 (보안 문자열) SSH 프라이빗 키 암호(프라이빗 키가 암호로 보호되는 경우)
포트 번호 정수 (int) SFTP 포트 번호(예: 22)
SSH 호스트 키 유효성 검사 사용 안 함 bool SSH 호스트 키 유효성 검사를 사용하지 않나요? (True/False)
SSH 호스트 키 손가락 인쇄 문자열 SSH 호스트 키 손가락 인쇄
루트 폴더 경로 문자열 루트 폴더 경로입니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 150 60초

동작

경로를 사용하여 파일 메타데이터 가져오기

이 작업은 파일 경로를 사용하여 파일 메타데이터를 가져옵니다.
경로를 사용하여 파일 콘텐츠 가져오기

이 작업은 파일 경로를 사용하여 파일 콘텐츠를 가져옵니다.
루트 폴더의 파일 나열

이 작업은 루트 폴더의 파일을 가져옵니다.
파일 만들기

이 작업은 파일을 업로드합니다.
파일 메타데이터 가져오기

이 작업은 파일 ID를 사용하여 파일 메타데이터를 가져옵니다.
파일 복사

이 작업은 파일을 복사합니다.
파일 삭제

이 작업은 파일을 삭제합니다.
파일 업데이트

이 작업은 파일 콘텐츠를 업데이트합니다.
파일 이름 바꾸기

이 작업은 파일의 이름을 바꿉니다.
파일 콘텐츠 가져오기

이 작업은 파일 ID를 사용하여 파일 콘텐츠를 가져옵니다.
폴더 만들기

이 작업은 새 폴더를 만듭니다.
폴더에 보관 추출

이 작업은 보관 파일을 폴더(예: .zip)로 추출합니다.
폴더의 파일 나열

이 작업은 폴더에 포함된 파일을 가져옵니다.

경로를 사용하여 파일 메타데이터 가져오기

작업 ID:
GetFileMetadataByPath

이 작업은 파일 경로를 사용하여 파일 메타데이터를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
파일 경로
 path True string

파일의 고유 경로

반환

Blob 메타데이터

몸
BlobMetadata

경로를 사용하여 파일 콘텐츠 가져오기

작업 ID:
GetFileContentByPath

이 작업은 파일 경로를 사용하여 파일 콘텐츠를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
파일 경로
 path True string

파일의 고유 경로
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식 유추

반환

파일의 내용입니다.

File Content(파일 내용)
binary

루트 폴더의 파일 나열

작업 ID:
ListRootFolder

이 작업은 루트 폴더의 파일을 가져옵니다.

반환

response
array of BlobMetadata

파일 만들기

작업 ID:
CreateFile

이 작업은 파일을 업로드합니다.

매개 변수

Name 키 필수 형식 Description
폴더 경로
 folderPath True string

폴더의 고유 경로
파일 이름
 name True string

파일의 이름
파일 콘텐츠
 body True binary

만들 파일의 콘텐츠
모든 파일 메타데이터 가져오기
 ReadFileMetadataFromServer boolean

파일 만들기가 완료된 후 SFTP 서버에서 모든 파일 메타데이터를 가져옵니다. false이면 마지막 수정 시간 등과 같은 일부 메타데이터 속성이 반환되지 않을 수 있습니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 메타데이터 가져오기

작업 ID:
GetFileMetadata

이 작업은 파일 ID를 사용하여 파일 메타데이터를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 ID 지정

반환

Blob 메타데이터

몸
BlobMetadata

파일 복사

작업 ID:
CopyFile

이 작업은 파일을 복사합니다.

매개 변수

Name 키 필수 형식 Description
원본 파일 경로
 source True string

원본 파일의 경로
대상 파일 경로
 destination True string

파일 이름을 포함하여 대상 파일의 경로
덮어쓸?
 overwrite boolean

'true'로 설정된 경우 대상 파일을 덮어씁니다.
모든 파일 메타데이터 가져오기
 ReadFileMetadataFromServer boolean

파일 만들기가 완료된 후 SFTP 서버에서 모든 파일 메타데이터를 가져옵니다. false이면 마지막 수정 시간 등과 같은 일부 메타데이터 속성이 반환되지 않을 수 있습니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 삭제

작업 ID:
DeleteFile

이 작업은 파일을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 지정
파일을 찾을 수 없는 경우 삭제 건너뛰기
 SkipDeleteIfFileNotFoundOnServer boolean

실패한 작업 없이 파일을 찾을 수 없는 경우 삭제를 건너뜁니다.

파일 업데이트

작업 ID:
UpdateFile

이 작업은 파일 콘텐츠를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 지정
파일 콘텐츠
 body True binary

업데이트할 파일의 콘텐츠
모든 파일 메타데이터 가져오기
 ReadFileMetadataFromServer boolean

파일 만들기가 완료된 후 SFTP 서버에서 모든 파일 메타데이터를 가져옵니다. false이면 마지막 수정 시간 등과 같은 일부 메타데이터 속성이 반환되지 않을 수 있습니다.

반환

Blob 메타데이터

몸
BlobMetadata

파일 이름 바꾸기

작업 ID:
RenameFile

이 작업은 파일의 이름을 바꿉니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 선택
새 이름
 newName True string

파일의 새 이름
모든 파일 메타데이터 가져오기
 ReadFileMetadataFromServer boolean

파일 만들기가 완료된 후 SFTP 서버에서 모든 파일 메타데이터를 가져옵니다. false이면 마지막 수정 시간 등과 같은 일부 메타데이터 속성이 반환되지 않을 수 있습니다.

반환

Blob 데이터 세트 메타데이터 응답을 나타냅니다.

몸
BlobMetadataResponse

파일 콘텐츠 가져오기

작업 ID:
GetFileContent

이 작업은 파일 ID를 사용하여 파일 콘텐츠를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 ID 지정
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식 유추

반환

파일의 내용입니다.

File Content(파일 내용)
binary

폴더 만들기

작업 ID:
CreateFolder

이 작업은 새 폴더를 만듭니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderPath True string

폴더 선택
이름
 name True string

폴더의 이름

반환

Blob 메타데이터

몸
BlobMetadata

폴더에 보관 추출

작업 ID:
ExtractFolderV2

이 작업은 보관 파일을 폴더(예: .zip)로 추출합니다.

매개 변수

Name 키 필수 형식 Description
원본 보관 파일 경로
 source True string

보관 파일의 경로
대상 폴더 경로
 destination True string

대상 폴더의 경로
덮어쓸?
 overwrite boolean

'true'로 설정된 경우 대상 파일을 덮어씁니다.

반환

response
array of BlobMetadata

폴더의 파일 나열

작업 ID:
ListFolder

이 작업은 폴더에 포함된 파일을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
폴더
 id True string

폴더 지정

반환

response
array of BlobMetadata

트리거

파일을 추가하거나 수정하는 경우

이 작업은 폴더에서 파일을 추가하거나 수정할 때 흐름을 트리거합니다. 트리거는 파일 메타데이터와 파일 내용을 모두 가져옵니다. 트리거는 파일의 마지막으로 수정된 시간을 사용합니다. 타사 클라이언트에서 파일을 만드는 경우 클라이언트에서 마지막으로 수정한 시간 보존을 사용하지 않도록 설정해야 합니다. 50MB보다 큰 파일은 트리거에서 건너뜁니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.
파일이 추가되거나 수정되는 경우(속성에만 해당)

이 작업은 폴더에서 파일을 추가하거나 수정할 때 흐름을 트리거합니다. 이 트리거는 파일 메타데이터만 가져옵니다. 파일 콘텐츠를 가져오기 위해 "파일 콘텐츠 가져오기" 작업을 사용할 수 있습니다. 트리거는 파일의 마지막으로 수정된 시간을 사용합니다. 타사 클라이언트에서 파일을 만드는 경우 클라이언트에서 마지막으로 수정한 시간 보존을 사용하지 않도록 설정해야 합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

파일을 추가하거나 수정하는 경우

작업 ID:
OnUpdatedFile

이 작업은 폴더에서 파일을 추가하거나 수정할 때 흐름을 트리거합니다. 트리거는 파일 메타데이터와 파일 내용을 모두 가져옵니다. 트리거는 파일의 마지막으로 수정된 시간을 사용합니다. 타사 클라이언트에서 파일을 만드는 경우 클라이언트에서 마지막으로 수정한 시간 보존을 사용하지 않도록 설정해야 합니다. 50MB보다 큰 파일은 트리거에서 건너뜁니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderId True string

폴더 지정
파일 콘텐츠 포함
 includeFileContent boolean

true로 설정하면 트리거 응답과 함께 파일 콘텐츠도 검색됩니다.
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식 유추

반환

파일의 내용입니다.

File Content(파일 내용)
binary

파일이 추가되거나 수정되는 경우(속성에만 해당)

작업 ID:
OnUpdatedFiles

이 작업은 폴더에서 파일을 추가하거나 수정할 때 흐름을 트리거합니다. 이 트리거는 파일 메타데이터만 가져옵니다. 파일 콘텐츠를 가져오기 위해 "파일 콘텐츠 가져오기" 작업을 사용할 수 있습니다. 트리거는 파일의 마지막으로 수정된 시간을 사용합니다. 타사 클라이언트에서 파일을 만드는 경우 클라이언트에서 마지막으로 수정한 시간 보존을 사용하지 않도록 설정해야 합니다. 하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 folderId True string

폴더 선택
반환할 파일 수
 maxFileCount integer

트리거에서 반환된 파일 수(1-100)

반환

Blob 메타데이터

파일 목록
BlobMetadata

정의

BlobMetadata

Blob 메타데이터

Name 경로 형식 Description
아이디
 Id string

파일 또는 폴더의 고유 ID입니다.
이름
 Name string

파일 또는 폴더의 이름입니다.
디스플레이 이름
 DisplayName string

파일 또는 폴더의 표시 이름입니다.
경로
 Path string

파일 또는 폴더의 경로입니다.
마지막 수정
 LastModified date-time

파일 또는 폴더가 마지막으로 수정된 날짜와 시간입니다.
Size
 Size integer

파일 또는 폴더의 크기입니다.
미디어 유형
 MediaType string

파일 또는 폴더의 미디어 형식입니다.
IsFolder
 IsFolder boolean

Blob이 폴더인지 여부를 나타내는 부울 값(true, false)입니다.
ETag
 ETag string

파일 또는 폴더의 etag입니다.
FileLocator
 FileLocator string

파일 또는 폴더의 파일로케이터입니다.

BlobMetadataResponse

Blob 데이터 세트 메타데이터 응답을 나타냅니다.

Name 경로 형식 Description
아이디
 Id string

파일 또는 폴더의 고유 ID입니다.
이름
 Name string

파일 또는 폴더의 이름입니다.
디스플레이 이름
 DisplayName string

파일 또는 폴더의 표시 이름입니다.
경로
 Path string

파일 또는 폴더의 경로입니다.
마지막 수정
 LastModified date-time

파일 또는 폴더가 마지막으로 수정된 날짜와 시간입니다.
Size
 Size integer

파일 또는 폴더의 크기입니다.
미디어 유형
 MediaType string

파일 또는 폴더의 미디어 형식입니다.
IsFolder
 IsFolder boolean

Blob이 폴더인지 여부를 나타내는 부울 값(true, false)입니다.
ETag
 ETag string

파일 또는 폴더의 etag입니다.
FileLocator
 FileLocator string

파일 또는 폴더의 파일로케이터입니다.

이진법

기본 데이터 형식 'binary'입니다.