원격 디렉터리 콘텐츠 목록

원격 SFTP 서버에서 파일을 검색하기 전에 원격 SFTP 서버에 있는 디렉토리의 내용을 검색할 수 있습니다. 이 작업을 수행하려면 StartDirectoryListingAPI 호출을 사용합니다.

다음 예제는 커넥터의 컨피그레이션에 지정된 원격 SFTP 서버의 home 폴더 내용을 나열합니다. 결과는 Amazon S3 위치와 /DOC-EXAMPLE-BUCKET/connector-files 이름이 지정된 파일에 저장됩니다c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json.

aws transfer start-directory-listing  \
   --connector-id c-AAAA1111BBBB2222C  \ 
   --output-directory-path /DOC-EXAMPLE-BUCKET/example/connector-files  \
   --remote-directory-path /home 

이 AWS CLI 명령은 목록 ID와 결과를 포함하는 파일 이름을 반환합니다.

{
    "ListingId": "6666abcd-11aa-22bb-cc33-0000aaaa3333",
    "OutputFileName": "c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json"
}

참고

출력 파일의 명명 규칙은 다음과 connector-ID-listing-ID.json 같습니다.

JSON 파일에는 다음 정보가 포함됩니다.

• filePath: 원격 서버의 SFTP 커넥터에 대한 목록 요청 디렉토리를 기준으로 한 원격 파일의 전체 경로입니다.

• modifiedTimestamp: 파일이 마지막으로 수정된 시간 (초), 협정 세계시 (UTC) 형식. 이 필드는 선택 사항입니다. 원격 파일 속성에 타임스탬프가 없는 경우 파일 목록에서 제외됩니다.

• size: 파일 크기 (바이트). 이 필드는 선택 사항입니다. 원격 파일 속성에 파일 크기가 포함되지 않은 경우 파일 목록에서 제외됩니다.

• path: 원격 서버의 SFTP 커넥터에 대한 목록 작성 요청 디렉터리를 기준으로 한 원격 디렉터리의 전체 경로입니다.

• truncated: 목록 출력에 원격 디렉터리에 포함된 모든 항목이 포함되는지 여부를 나타내는 플래그입니다. truncated출력 값이 true인 경우 선택적 max-items 입력 속성에 제공된 값을 늘려 더 많은 항목을 나열할 수 있습니다 (최대 허용 목록 크기인 10,000개 항목).

다음은 출력 파일 (c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json) 의 내용 예제입니다. 여기서 원격 디렉터리에는 두 개의 파일과 두 개의 하위 디렉터리 (경로) 가 있습니다.

{
    "files": [
        {
            "filePath": "/home/what.txt",
            "modifiedTimestamp": "2024-01-30T20:34:54Z",
            "size" : 2323
        },
        {
            "filePath": "/home/how.pgp",
            "modifiedTimestamp": "2024-01-30T20:34:54Z",
            "size" : 4691
        }
    ],
    "paths": [
        {
            "path": "/home/magic"
        },
        {
            "path": "/home/aws"
        },
    ],
    "truncated": "false"
}