Classic/VPC 환경에서 이용 가능합니다 .
버킷, 폴더 또는 객체 리스트를 조회합니다.명령어
명령어 구문은 다음과 같습니다.
aws s3 ls <target> --endpoint-url <value> [--options]
파라미터
파라미터에 대한 설명은 다음과 같습니다.
| 파라미터 | 타입 | 필수 여부 | 설명 | 제약 사항 |
|---|---|---|---|---|
| --endpoint-url <value> | string | Y | 명령 호출의 기본 URL 지정 | kr 리전만 가능, 호출 도메인 정보는 Ncloud Storage 개요 참고 |
| --recursive | boolean | N | 명령 적용 범위를 하위 디렉토리까지 적용 | - |
| --page-size <value> | integer | N | - | |
| --human-readable | boolean | N | 파일 사이즈를 Bytes/MiB/KiB/GiB 등의 단위로 제공 | - |
| --summarize | boolean | N | 총 오브젝트 개수와 크기 표시 | - |
| --debug | boolean | N | 디버그 로깅 사용 | - |
| --no-verify-ssl | boolean | N | SSL 인증서를 검증하는 기본 동작 재정의 | - |
| --no-paginate | boolean | N | 자동 pagination 비활성화, 결과에 대해 첫 번째 페이지 한 번만 호출됨 | - |
| --output <value> | string | N | 응답값의 포맷 지정 | 선택한 가능한 옵션 - json - text - table - yaml - yaml-stream |
| --query <value> | string | N | 응답 데이터를 필터링하는 데 사용할 JMESPath 쿼리 | - |
| --profile <value> | string | N | 자격 증명 파일에서 특정 profile 사용 | - |
| --region <value> | string | N | 리전 지정 | kr만 지원 |
| --color <value> | string | N | output color 설정 | 선택한 가능한 옵션 - on - off - auto |
| --no-sign-request | boolean | N | 자격 증명 로드 비활성화 | - |
| --ca-bundle <value> | string | N | SSL 인증서를 확인할 때 사용할 CA 인증서 지정 | - |
| --cli-read-timeout <value> | int | N | 최대 읽기 시간, 0으로 입력시 타임아웃이 아닌 차단 상태로 변경됨 | default는 60초로 설정 |
| --cli-connect-timeout <value> | int | N | 최대 연결 시간, 0으로 입력시 타임아웃이 아닌 차단 상태로 변경됨 | default는 60초로 설정 |
| --no-cli-pager | boolean | N | 응답값의 cli pager 비활성화 | - |
| --cli-auto-prompt | boolean | N | CLI 입력 파라미터 자동 프롬프트 설정 | - |
| --no-cli-auto-prompt | boolean | N | CLI 입력 파라미터 자동 프롬프트 비활성화 | - |
예시
ls 명령어의 호출과 응답 예시를 설명합니다.
버킷 리스트 조회
호출 예시
대상이나 옵션 없이 명령어를 사용하면 계정이 소유한 모든 버킷이 나열됩니다. 호출 예시는 다음과 같습니다.
aws s3 ls --endpoint-url=http://kr.ncloudstorage.com
응답 예시
응답 예시는 다음과 같습니다.
2024-12-24 16:37:28 bucket-a
2024-12-24 16:37:44 bucket-aa
2024-11-22 01:27:16 bucket-log
특정 버킷의 객체 리스트 조회
호출 예시
조회하고자 하는 버킷을 지정하여 명령어를 사용하면 버킷 내에 있는 모든 prefix와 객체 리스트가 나열됩니다. 만약 특정 prefix 하위의 객체를 조회하고 싶은 경우, 버킷 경로 마지막에 /를 추가합니다. 호출 예시는 다음과 같습니다.
aws s3 ls s3://bucket-aa --endpoint-url=http://kr.ncloudstorage.com
응답 예시
응답 예시는 다음과 같습니다.
PRE log-2412/
2024-12-24 17:10:34 2077405 document1.pdf
2024-12-24 17:10:34 1747272 document2.pdf
2024-12-24 16:55:08 79238 image.png
2024-12-24 16:55:10 69182 image5.png
2024-12-24 16:55:10 858176 ncloudstorage.pptx
특정 버킷의 prefix와 하위의 모든 객체 조회
호출 예시
--recursive 옵션을 사용하면 prefix 하위의 모든 객체를 포함하여 조회가 가능하며 --summarize 옵션을 사용하면 해당 버킷 또는 특정 prefix 하위에 저장된 오브젝트의 총 개수와 크기를 확인할 수 있습니다. 호출 예시는 다음과 같습니다.
aws s3 ls s3://bucket-aa --endpoint-url=http://kr.ncloudstorage.com --recursive --human-readable --summarize
응답 예시
응답 예시는 다음과 같습니다.
2024-12-24 17:10:34 2.0 MiB document1.pdf
2024-12-24 17:10:34 1.7 MiB document2.pdf
2024-12-24 16:55:08 77.4 KiB image.png
2024-12-24 16:55:10 67.6 KiB image5.png
2024-12-27 11:46:17 0 Bytes log-2412/
2024-12-27 11:48:47 387 Bytes log-2412/241201120224.txt
2024-12-27 11:48:47 387 Bytes log-2412/241202120123.txt
2024-12-27 11:48:47 387 Bytes log-2412/241203120012.txt
2024-12-24 16:55:10 838.1 KiB ncloudstorage.pptx
Total Objects: 9
Total Size: 4.8 MiB