다음을 통해 공유

SFTP [사용되지 않음]

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

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

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

이 커넥터는 사용 중단 경로에 있습니다. 새 SFTP-SSH 커넥터를 사용하세요. 여기에서 새 커넥터를 사용하는 방법을 자세히 알아보세요.

이 커넥터를 사용하려면 SSH 프라이빗 키 및 SSH 프라이빗 키 암호에 액세스해야 합니다.

다음 개인 키 형식이 지원됩니다.

  • OpenSSH
  • ssh.com
  • PuTTY

SSH 프라이빗 키의 콘텐츠는 다중 줄 형식의 "SSH 프라이빗 키" 필드에 완전히 복사/붙여넣어야 합니다. 다음은 Notepad.exe사용하여 SSH 프라이빗 키를 제공하는 샘플 단계입니다.

  1. Notepad.exeSSH 프라이빗 키 파일을 엽니다.
  2. 편집 → 모두 선택;
  3. 편집 → 복사를 클릭합니다.
  4. "SSH 프라이빗 키" 필드에서(연결을 만드는 동안) 마우스 오른쪽 단추를 클릭하고 붙여넣기를 클릭합니다. "SSH 프라이빗 키" 필드를 수동으로 편집하지 마세요.

트리거 제한

트리거는 SFTP 파일 시스템을 폴링하고 마지막 폴링 이후 수정된 파일을 찾아 수정 시간별로 파일을 비교하여 작동합니다. 특정 도구를 사용하면 파일 수정 시간을 보존할 수 있습니다. 이러한 경우 트리거가 작동하도록 기능을 사용하지 않도록 설정해야 합니다. 다음은 몇 가지 일반적인 설정입니다.

SFTP 클라이언트 조치
WinSCP 옵션 → 기본 설정... → 전송 → 편집... → 타임스탬프 → 사용 안 함 유지
FileZilla 전송 → 전송된 파일의 타임스탬프 유지 → 사용 안 함

트리거가 새 파일을 발견하면 새 파일이 완전히 기록되었는지 확인합니다. 예를 들어 파일이 작성되거나 수정될 수 있으며 트리거가 파일 서버를 폴링할 때 업데이트가 이루어지고 있습니다. 부분 콘텐츠가 있는 파일을 반환하지 않으려면 트리거는 최근에 수정된 이러한 파일과 같은 타임스탬프를 기록해 두지만 해당 파일을 즉시 반환하지는 않습니다. 이러한 파일은 트리거가 다시 폴링될 때만 반환됩니다. 경우에 따라 트리거 폴링 간격의 최대 두 배까지 지연될 수 있습니다. 이는 또한 트리거가 "분할 켜기" 옵션을 사용하지 않도록 설정된 경우 단일 실행의 모든 파일을 반환하도록 보장하지 않음을 의미합니다.

콘텐츠를 요청하는 경우 트리거는 50MB를 넘는 파일을 선택하지 않습니다.

하위 폴더에서 파일이 추가/업데이트되면 트리거가 실행되지 않습니다. 하위 폴더에서 트리거해야 하는 경우 여러 트리거를 만들어야 합니다.

커넥터 심층 분석

커넥터에 대한 자세한 내용은 자세한 섹션을 참조하세요.

알려진 문제 및 제한 사항

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

일반 제한

이름 가치
분당 SFTP 서버 주소당 최대 총 요청 수 600
대역폭 시간 간격(연결당) 내에서 커넥터 간 전송되는 최대 메가바이트 수 1000
대역폭 시간 간격(밀리초) 60000

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

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

제한 한도

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

동작

경로를 사용하여 파일 메타데이터 가져오기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 경로를 사용하여 파일 메타데이터 가져오기를 사용하세요.

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

이 작업은 더 이상 사용되지 않습니다. 대신 경로를 사용하여 파일 콘텐츠 가져오기를 사용하세요.

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

이 작업은 더 이상 사용되지 않습니다. 대신 루트 폴더의 목록 파일을 사용하세요.

이 작업은 루트 폴더의 파일을 가져옵니다.
파일 만들기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 파일 만들기 를 사용하세요.

이 작업은 SFTP 서버에 파일을 업로드합니다. 파일을 만든 직후 서버에서 삭제/이름을 바꾸는 경우 커넥터는 디자인상 HTTP 404 오류를 반환할 수 있습니다. 새로 만든 파일을 삭제하거나 이름을 바꾸기 전에 1분 동안 지연을 사용하세요.
파일 메타데이터 가져오기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 파일 메타데이터 가져오기 를 사용하세요.

이 작업은 파일 ID를 사용하여 파일 메타데이터를 가져옵니다.
파일 복사 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 복사 파일을 사용하세요.

이 작업은 SFTP 서버에 파일을 복사합니다. 파일이 복사된 직후 서버에서 삭제/이름을 바꾸는 경우 커넥터는 디자인상 HTTP 404 오류를 반환할 수 있습니다. 새로 만든 파일을 삭제하거나 이름을 바꾸기 전에 1분 동안 지연을 사용하세요.
파일 삭제 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 삭제 파일을 사용하세요.

이 작업은 파일을 삭제합니다.
파일 업데이트 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 업데이트 파일을 사용하세요.

이 작업은 파일 콘텐츠를 업데이트합니다. 파일이 업데이트된 직후 서버에서 삭제/이름을 바꾸는 경우 커넥터는 디자인상 HTTP 404 오류를 반환할 수 있습니다. 최근에 업데이트된 파일을 삭제하거나 이름을 바꾸기 전에 1분 동안 지연을 사용하세요.
파일 콘텐츠 가져오기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 파일 콘텐츠 가져오기를 사용하세요.

이 작업은 파일 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

이 작업은 더 이상 사용되지 않습니다. 대신 파일 만들기 를 사용하세요.

이 작업은 SFTP 서버에 파일을 업로드합니다. 파일을 만든 직후 서버에서 삭제/이름을 바꾸는 경우 커넥터는 디자인상 HTTP 404 오류를 반환할 수 있습니다. 새로 만든 파일을 삭제하거나 이름을 바꾸기 전에 1분 동안 지연을 사용하세요.

매개 변수

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

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

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

만들 파일의 콘텐츠

반환

Blob 메타데이터

몸
BlobMetadata

파일 메타데이터 가져오기 [사용되지 않음]

작업 ID:
GetFileMetadata

이 작업은 더 이상 사용되지 않습니다. 대신 파일 메타데이터 가져오기 를 사용하세요.

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

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 지정

반환

Blob 메타데이터

몸
BlobMetadata

파일 복사 [사용되지 않음]

작업 ID:
CopyFile

이 작업은 더 이상 사용되지 않습니다. 대신 복사 파일을 사용하세요.

이 작업은 SFTP 서버에 파일을 복사합니다. 파일이 복사된 직후 서버에서 삭제/이름을 바꾸는 경우 커넥터는 디자인상 HTTP 404 오류를 반환할 수 있습니다. 새로 만든 파일을 삭제하거나 이름을 바꾸기 전에 1분 동안 지연을 사용하세요.

매개 변수

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

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

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

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

반환

Blob 메타데이터

몸
BlobMetadata

파일 삭제 [사용되지 않음]

작업 ID:
DeleteFile

이 작업은 더 이상 사용되지 않습니다. 대신 삭제 파일을 사용하세요.

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

매개 변수

Name 키 필수 형식 Description
File
 id True string

파일 지정

파일 업데이트 [사용되지 않음]

작업 ID:
UpdateFile

이 작업은 더 이상 사용되지 않습니다. 대신 업데이트 파일을 사용하세요.

이 작업은 파일 콘텐츠를 업데이트합니다. 파일이 업데이트된 직후 서버에서 삭제/이름을 바꾸는 경우 커넥터는 디자인상 HTTP 404 오류를 반환할 수 있습니다. 최근에 업데이트된 파일을 삭제하거나 이름을 바꾸기 전에 1분 동안 지연을 사용하세요.

매개 변수

Name 키 필수 형식 Description
File
 id True string

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

업데이트할 파일의 콘텐츠

반환

Blob 메타데이터

몸
BlobMetadata

파일 콘텐츠 가져오기 [사용되지 않음]

작업 ID:
GetFileContent

이 작업은 더 이상 사용되지 않습니다. 대신 파일 콘텐츠 가져오기를 사용하세요.

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

매개 변수

Name 키 필수 형식 Description
File
 id True string

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

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

반환

파일의 내용입니다.

File Content(파일 내용)
binary

폴더에 보관 추출 [사용되지 않음]

작업 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:
OnUpdatedFiles

이 작업은 더 이상 사용되지 않습니다. 파일을 추가하거나 수정하는 경우(속성에만 해당)를 대신 사용하세요.

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

매개 변수

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

폴더 선택
트리거에서 반환할 파일 수
 maxFileCount integer

단일 트리거 실행(1-100)으로 반환할 최대 파일 수입니다. '분할 켜기' 설정은 트리거가 각 항목을 개별적으로 처리하도록 강제할 수 있습니다.

반환

Blob 메타데이터

파일 목록
BlobMetadata

파일이 추가되거나 수정되는 경우 [사용되지 않음]

작업 ID:
OnUpdatedFile

이 작업은 더 이상 사용되지 않습니다. 대신 파일을 추가하거나 수정할 때 사용하세요.

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

매개 변수

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

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

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

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

반환

파일의 내용입니다.

File Content(파일 내용)
binary

정의

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

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

이진법

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