tencent cloud

Cloud Object Storage

버킷 또는 파일 리스트 쿼리 - ls

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-02-12 17:52:22
ls 명령은 버킷, 버킷의 객체 및 디렉터리의 객체 목록을 쿼리하는 데 사용됩니다.
주의:
버킷 내 파일 목록을 조회하려면권한 정책 설정 시 action을 cos:HeadBucket,cos:GetBucket으로 지정해야 합니다.
이력 버전 정보를 조회하려면(--all-versions 전달 시) 권한 정책 설정 시 action을 cos:HeadBucket,cos:GetBucketVersioning,cos:GetBucketObjectVersions으로 지정해야 합니다.
계정 내 모든 버킷 목록을 조회하려면 권한 정책 설정 시 action을 cos:GetService으로 지정해야 합니다.
자세한 내용은 CAM 지원 API를 참조하십시오.

명령어 형식

./coscli ls [cos://<bucket-name>[/prefix/]] [flag]
ls 명령어에는 다음과 같은 매개변수 옵션이 포함됩니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>
선택적 매개변수.접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias
버킷 이름으로 접근: cos://examplebucket-1250000000
/prefix/
선택적 매개변수.폴더 지정
/picture/
ls 명령어는 다음과 같은 flag 옵션을 포함합니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
없음
--include
특정 패턴 파일 포함
없음
--exclude
특정 패턴 파일 제외
-r
--recursive
폴더를 재귀적으로 탐색하여 모든 파일을 나열할지 여부
없음
--limit
나열할 최대 수 지정(지정하지 않거나 0으로 설정하면 기본 제한은 10,000개 파일입니다. -1로 설정하면 모든 COS 파일을 가져올 수 있습니다)
없음
--all-versions
객체의 모든 버전 목록 표시(버전 관리 활성화된 bucket에서만 사용 가능). 이력 버전 조회 시 VersionId, IsLatest, Delete Marker 필드 추가 표시.
설명:
--include--exclude는 표준 정규식 구문을 지원하므로, 파일 특정 조건 필터링에 사용할 수 있습니다.
zsh를 사용할 때 pattern 문자열의 양쪽 끝에 큰따옴표를 넣어야 할 수도 있습니다.
./coscli ls cos://bucket1 -r --include ".*\\.mp4$"
이 명령의 다른 일반 옵션(예시: 버킷 및 사용자 계정 전환)은 범용 옵션을 참고하십시오.

작업 예시

현재 계정의 모든 버킷 나열

./coscli ls
반환되는 정보에는 버킷 이름, 리전, 생성 시간, 버킷 총 개수가 포함됩니다. 예시:
BUCKET NAME | REGION | CREATE DATE
--------------------------------+-----------------+-----------------------
examplebucket-1250000000 | ap-nanjing | 2022-01-01T00:00:00Z
--------------------------------+-----------------+-----------------------
TOTAL BUCKETS: | 2
------------------+-----------------------

파일 나열

bucket1의 모든 파일 나열

./coscli ls cos://bucket1
반환되는 정보에는 객체 키(버킷 내에서 객체의 고유 식별자), 스토리지 유형, 최근 업데이트 시간, 객체 크기, 객체 총 개수가 포함됩니다. 예시:
KEY | TYPE | LAST MODIFIED | ETAG | SIZE | RESTORESTATUS
-------------+----------+---------------------------+------------------------------------+-----------------+----------------
test.txt | STANDARD | 2024-06-05T15:03:37+08:00 | "a3bc6c9058109f8da48d41a5ab9abc7c" | 4.88 KB |
-------------+----------+---------------------------+------------------------------------+-----------------+----------------
TOTAL OBJECTS: | 1
------------------+----------------

bucket1의 picture 폴더에 있는 모든 파일 및 폴더 나열

./coscli ls cos://bucket1/picture/
일반 나열은 해당 조회 경로에 있는 데이터만 반환하며, 하위 경로 데이터는 나열하지 않습니다. 예시:
KEY | TYPE | LAST MODIFIED | ETAG | SIZE | RESTORESTATUS
-------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
picture/a4431470f55662 | STANDARD | 2024-06-05T15:03:58+08:00 | "ed0430c5f27e76605e0555c260478112" | 358.00 B |
picture/e98c6cefa4abd6 | STANDARD | 2024-06-05T15:03:58+08:00 | "bd5a4bd7248e7dfdb796383bee60470b" | 53.00 B |
-------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
TOTAL OBJECTS: | 3
------------------+----------------

bucket1 버킷의 picture 폴더 아래 모든 파일 재귀 나열

./coscli ls cos://bucket1/picture/ -r
조회 경로에 하위 경로가 있는 경우, 재귀 나열은 모든 하위 경로를 스캔하여 해당 경로 레벨의 모든 파일을 반환합니다. 예시:

KEY | TYPE | LAST MODIFIED | ETAG | SIZE | RESTORESTATUS
------------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
picture/subfolder | DIR | | | |
picture/subfolder/pic2.png | STANDARD | 2024-06-05T15:03:58+08:00 | "bd5a4bd7248e7dfdb796383bee60470b" | 53.00 B |
------------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
TOTAL OBJECTS: | 3
------------------+----------------

bucket1 버킷 내 모든 .mp4 유형의 파일 재귀 나열

./coscli ls cos://bucket1 -r --include ".*\\.mp4$"

bucket1 버킷 내 .mp4 유형이 아닌 모든 파일 재귀 나열

./coscli ls cos://bucket1 -r --exclude ".*\\.mp4$"

bucket1 버킷의 picture 폴더 내 test로 시작하고 .jpg 유형이 아닌 모든 파일 재귀 나열

./coscli ls cos://bucket1/picture -r --include "^picture/test.*" --exclude ".*\\.jpg$"

이력 버전 조회

bucket1 버킷의 모든 이력 버전 조회

./coscli ls cos://bucket1/ -r --all-versions
조회 경로에 하위 경로가 있는 경우, 재귀 조회 시 모든 하위 경로를 스캔하여 해당 경로 레벨의 모든 파일 이력 버전 반환. 예시:
KEY | TYPE | VERSIONID | ISLATEST | DELETE MARKER | LAST MODIFIED | ETAG | SIZE
--------------------------------+----------+-----------------------------+----------+---------------+---------------------------+------------------------------------+----------
cmd/cmd/abort.go | STANDARD | MTg0NDUwMDM1MjIxMDM3MDI1MDM | false | false | 2025-02-26T14:33:25+08:00 | "c9bfc40db6669e9a7aee03abcd8b66e8" | 1.89 KB
cmd/cmd/abort_test.go | STANDARD | MTg0NDUwMDM1MjIxMDM3MjgxODI | false | false | 2025-02-26T14:33:25+08:00 | "52166b1c60e4089a4652546c0350d2c7" | 4.89 KB
cmd/cmd/bucket_tagging.go | STANDARD | MTg0NDUwMDM1MjIxMDM3MjY3MDI | false | false | 2025-02-26T14:33:25+08:00 | "edad62e08bf65a5bff81304e2b40ac1a" | 3.82 KB
cmd/cmd/bucket_versioning.go | STANDARD | MTg0NDUwMDM1MjIxMDM2MTkzMzU | false | false | 2025-02-26T14:33:25+08:00 | "50a6b0e2e218c437ccdabe2c762aaef1" | 1.86 KB
cmd/cmd/buket_tagging_test.go | STANDARD | MTg0NDUwMDM1MjIxMDM2MTY4MDc | false | false | 2025-02-26T14:33:25+08:00 | "cd11257b22c9816df105da15f3ceb70f" | 8.23 KB
cmd/cmd/abort.go | | MTg0NDUwMDM1MjIwNjcyNTcxMDA | true | true | 2025-02-26T14:34:02+08:00 | |
cmd/cmd/abort_test.go | | MTg0NDUwMDM1MjIwNjcxNzE5NDY | true | true | 2025-02-26T14:34:02+08:00 | |
cmd/cmd/bucket_tagging.go | | MTg0NDUwMDM1MjIwNjcyNjczNzI | true | true | 2025-02-26T14:34:02+08:00 | |
cmd/cmd/bucket_versioning.go | | MTg0NDUwMDM1MjIwNjY3ODc4NzM | true | true | 2025-02-26T14:34:02+08:00 | |
cmd/cmd/buket_tagging_test.go | | MTg0NDUwMDM1MjIwNjY3ODYyMDI | true | true | 2025-02-26T14:34:02+08:00 | |
--------------------------------+----------+-----------------------------+----------+---------------+---------------------------+------------------------------------+----------
TOTAL OBJECTS: | 10
-------------------------------------+----------


도움말 및 지원

문제 해결에 도움이 되었나요?

피드백