tencent cloud

Cloud Object Storage

문서Cloud Object Storage툴 가이드COSCLI 툴자주 쓰는 명령어아카이브 파일 검색 - restore

아카이브 파일 검색 - restore

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-05-19 15:52:09
restore 명령어는 아카이브 파일을 검색하는 데 사용됩니다.
주의:
해당 명령어를 사용하려면 권한 정책 설정 시 action을 cos:HeadBucket,cos:GetBucket,cos:PostObjectRestore으로 지정해야 합니다. 자세한 내용은 CAM 지원 API를 참조하십시오.

명령어 형식

./coscli restore cos://<bucket-name>[/prefix/] [flag]
restore 명령어에는 다음과 같은 매개변수 옵션이 포함됩니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>
접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias
버킷 이름으로 접근: cos://examplebucket-1250000000
/prefix/
선택적 매개변수.폴더 지정
/picture/
restore 명령어에는 다음과 같은 flag 옵션이 포함됩니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
없음
--include
특정 패턴 파일 포함
없음
--exclude
특정 패턴 파일 제외
-d
--days
임시 파일의 만료 시간 지정(기본 값: 3일)
-m
--mode
복구 모드 지정(기본 값: Standard）
ARCHIVE 데이터 복구 시 옵션값: Expedited (신속 복구 모드), Standard (표준 복구 모드), Bulk (대량 복구 모드).
DEEP ARCHIVE 데이터 복구 시 옵션값: Standard, Bulk.
-r
--recursive
재귀적으로 폴더 순회
없음
--fail-output
해당 flag 기능: 복구 실패 시 오류 출력 여부(기본값: true, 활성화). 활성화 시 지정 디렉터리에 기록 (미지정 시 기본 디렉터리: ./coscli_output). 비활성화 시 콘솔에 오류 파일 수량만 출력.
없음
--fail-output-path
해당 flag 기능: 복구 실패 오류 로그 저장 폴더 경로 지정. 사용자 정의 폴더 경로 사용 가능(폴더의 위치 및 이름). 미설정 시 기본 오류 로그 저장 폴더 ./coscli_output 사용.
설명：
--include 및 --exclude는 표준 정규식 구문을 지원하므로, 파일 특정 조건 필터링에 사용할 수 있습니다.
zsh를 사용할 때 pattern 문자열의 양쪽 끝에 큰따옴표를 넣어야 할 수도 있습니다.
./coscli restore cos://bucket1/example/ -r --include ".*\\.mp4$"
이 명령의 다른 범용 옵션(예시: 버킷 전환, 사용자 계정 전환 등)은 범용 옵션 문서를 참고하십시오.
아카이브 파일 복구에 대한 자세한 내용은 POST Object restore 문서를 참조하십시오.

작업 예시

bucket1 버킷의 아카이브 파일 표준 모드로 검색

./coscli restore cos://bucket1/picture.jpg

bucket1 버킷의 picture 폴더에 있는 모든 아카이브 파일 초고속 모드로 검색

./coscli restore cos://bucket1/picture/ -r --mode Expedited
이전 주제: 조각 정리 - abort다음 주제: 소프트 링크 생성/획득 - symlink

도움말 및 지원

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

피드백