파일 목록 가져오기 활동

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 1분
  • 파일 목록 가져오기 활동은 SFTP 서버(소스 호스트)의 지정된 디렉터리와 해당 하위 디렉터리에서 파일 목록을 반환합니다.

    입력 변수

    표 1. 파일 목록 입력 변수 가져오기
    변수 설명
    소스 호스트 나열할 파일을 포함하는 서버의 이름 또는 IP 주소입니다.
    sourcePort 대상 서버와 통신하는 데 사용할 포트 번호입니다. 기본 포트 번호는 22입니다.
    소스 디렉터리 나열할 파일이 포함된 대상 디렉터리의 경로입니다.
    소스 파일 반환할 대상 파일의 목록입니다. *.txt와 같은 와일드카드를 허용하는 쉼표로 구분된 목록입니다.
    제외된 파일 제외할 대상 파일의 목록입니다. *.txt와 같은 와일드카드를 허용하는 쉼표로 구분된 목록입니다.
    includeSubfolders 하위 폴더의 파일이 목록에 포함되는지 여부를 결정하는 예/아니오 변수입니다. 이 변수의 기본값은 false입니다.
    소스 자격 증명 태그 호스트에서 SSH 명령을 실행하기 위해 이 활동이 사용해야 하는 오케스트레이션 활동에 대한 특정 자격 증명 별칭 입니다.

    출력 변수

    표 2. 파일 목록 출력 변수 가져오기
    변수 설명
    errorMessage executionResult.errorMessages활동 디자이너 구문 분석 소스에서 . 이 변수가 null이 아니면 작업이 실패한 것입니다. 활동은 오류 메시지를 검사하여 조건을 사용자 지정할 수 있습니다. 예를 들어 오류 메시지 NO_SUCH_FILE에 포함된 경우 상황에 따라 활동을 성공한 것으로 간주할 수 있습니다.
    결과 JSON 문자열로 반환되는 요청된 파일 목록입니다.

    조건

    표 3. 파일 목록 조건 가져오기
    조건 설명
    성공 활동에서 요청된 파일을 나열하는 데 성공했습니다.
    장애 활동에서 요청된 파일을 나열하지 못했습니다.