tencent cloud

Cloud Object Storage

문서Cloud Object Storage툴 가이드COSCLI 툴자주 쓰는 명령어멀티파트 업로드에서 생성된 조각 나열 - lsparts

멀티파트 업로드에서 생성된 조각 나열 - lsparts

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-05-19 15:52:09
lsparts 명령어는 멀티파트 업로드에서 생성된 파일 조각을 나열합니다.
주의:
멀티파트 업로드 작업 목록을 조회하려면 권한 정책 설정 시 action을 cos:PutBucket으로 지정해야 합니다.
멀티파트 업로드 작업의 파일 조각을 조회하려면 권한 정책 설정 시 action을 cos:ListMultipartUploads,cos:ListParts으로 지정해야 합니다.
자세한 내용은 CAM 지원 API를 참조하십시오.

명령어 형식

./coscli lsparts cos://<bucket-name>[/prefix/] [flag]
lsparts 명령어에는 다음과 같은 매개변수 옵션이 포함됩니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>
접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias
버킷 이름으로 접근: cos://examplebucket-1250000000
/prefix/
선택적 매개변수.폴더 지정
/picture/
lsparts 명령어에는 다음과 같은 flag 옵션이 포함됩니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
없음
--include
특정 패턴 파일 포함
없음
--exclude
특정 패턴이 제외된 파일
없음
--limit
최대 나열 수량 지정(0-1000)
없음
--upload-id
기록 ID 업로드. uploadid 전달 시 특정 파일 지정 필요, uploadid 해당 파일 조각 정보만 표시. uploadid 미전달 시 지정 prefix 진행 중인 멀티파트 업로드 작업 표시.
설명:
멀티파트 업로드에 대한 자세한 내용은 멀티파트 업로드를 참조하십시오.
이 명령의 다른 범용 옵션(예시: 버킷 전환, 사용자 계정 전환 등)은 범용 옵션 문서를 참고하십시오.

작업 예시

bucket1 버킷의 진행 중인 모든 멀티파트 업로드 작업 조회

./coscli lsparts cos://bucket1
반환 결과 예시는 다음과 같으며, 반환 정보에는 객체 키(버킷 내에서 객체의 고유 식별자), 멀티파트 업로드 ID, 업로드 시작 시간, 버킷 내 조각 총 개수가 포함됩니다.
KEY | UPLOAD ID | INITIATE TIME
---------------+-------------------------------------+----------------------------
test.txt | 1671191183635d2b71b1d68a0********** | 2022-01-01T00:00:00.000Z
---------------+-------------------------------------+----------------------------
TOTAL: 1
----------------------------

bucket1 버킷 test.txt 파일 (upload_id=1671191183635d2b71b1d68a0**********) 모든 업로드 조각 조회

./coscli lsparts cos://bucket1/test.txt --upload-id="1671191183635d2b71b1d68a0**********"
결과 예시: PARTNUMBER(파트 번호), ETAG(파트 MD-5 체크섬), LastModified(파트 최근 수정 시간), SIZE(파트 크기) 출력.
PARTNUMBER | ETAG | LAST MODIFIED | SIZE
-------------+------------------------------------+---------------------------+------------
1 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB
2 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB
3 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB
4 | "58f06dd588d8ffb3beb46ada6309436b" | 2024-12-17T16:34:48+08:00 | 32.00 MB
-------------+------------------------------------+---------------------------+------------
TOTAL: 4
-------------


도움말 및 지원

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

피드백