tencent cloud

Cloud Object Storage

동향 및 공지
릴리스 노트
제품 공지
제품 소개
제품 개요
기능 개요
적용 시나리오
제품 장점
기본 개념
리전 및 액세스 도메인
규격 및 제한
제품 요금
과금 개요
과금 방식
과금 항목
프리 티어
과금 예시
청구서 보기 및 다운로드
연체 안내
FAQ
빠른 시작
콘솔 시작하기
COSBrowser 시작하기
사용자 가이드
요청 생성
버킷
객체
데이터 관리
일괄 프로세스
글로벌 가속
모니터링 및 알람
운영 센터
데이터 처리
스마트 툴 박스 사용 가이드
데이터 워크플로
애플리케이션 통합
툴 가이드
툴 개요
환경 설치 및 설정
COSBrowser 툴
COSCLI 툴
COSCMD 툴
COS Migration 툴
FTP Server 툴
Hadoop 툴
COSDistCp 툴
HDFS TO COS 툴
온라인 도구 (Onrain Dogu)
자가 진단 도구
실습 튜토리얼
개요
액세스 제어 및 권한 관리
성능 최적화
AWS S3 SDK를 사용하여 COS에 액세스하기
데이터 재해 복구 백업
도메인 관리 사례
이미지 처리 사례
COS 오디오/비디오 플레이어 사례
데이터 다이렉트 업로드
데이터 보안
데이터 검증
빅 데이터 사례
COS 비용 최적화 솔루션
3rd party 애플리케이션에서 COS 사용
마이그레이션 가이드
로컬 데이터 COS로 마이그레이션
타사 클라우드 스토리지 데이터를 COS로 마이그레이션
URL이 소스 주소인 데이터를 COS로 마이그레이션
COS 간 데이터 마이그레이션
Hadoop 파일 시스템과 COS 간 데이터 마이그레이션
데이터 레이크 스토리지
클라우드 네이티브 데이터 레이크
메타데이터 가속
데이터 레이크 가속기 GooseFS
데이터 처리
데이터 처리 개요
이미지 처리
미디어 처리
콘텐츠 조정
파일 처리
문서 미리보기
장애 처리
RequestId 가져오기
공용 네트워크로 COS에 파일 업로드 시 속도가 느린 문제
COS 액세스 시 403 에러 코드 반환
리소스 액세스 오류
POST Object 자주 발생하는 오류
보안 및 컴플라이언스
데이터 재해 복구
데이터 보안
액세스 관리
자주 묻는 질문
인기 질문
일반 문제
과금
도메인 규정 준수 문제
버킷 설정 문제
도메인 및 CDN 문제
파일 작업 문제
로그 모니터링 문제
권한 관리
데이터 처리 문제
데이터 보안 문제
사전 서명 URL 관련 문제
SDK FAQ
툴 관련 문제
API 관련 문제
Agreements
Service Level Agreement
개인 정보 보호 정책
데이터 처리 및 보안 계약
연락처
용어집

범용 옵션

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-12 16:22:47
./coscli --help 또는 ./coscli -h 명령을 사용하여 COSCLI에서 지원하는 공통 옵션을 볼 수 있습니다.

옵션 설명

다음은 모든 명령에서 사용할 수 있는 COSCLI의 공통 옵션입니다.
주의:
보안을 위해 임시 키 생성 및 사용 가이드의 안내에 따라 임시 키를 사용하여 SDK를 호출하는 것을 권장합니다. 임시 키 신청 시 최소 권한의 원칙 설명에 따라 버킷과 객체 이외의 리소스가 유출되지 않도록 하십시오.
영구 키를 사용해야 하는 경우 최소 권한의 원칙 설명에 따라 영구 키에 대한 권한 범위를 제한하는 것이 좋습니다.
옵션
설명
-h, --help
도움말 정보를 출력합니다. -h 또는 --help 명령을 사용하여 도구의 help 정보 및 사용법을 볼 수 있습니다. 매개변수를 추가하지 않고 각 명령 뒤에 -h를 입력하여 명령 사용 방법을 확인할 수도 있습니다. 예를 들어 버킷 생성 명령의 특정 사용법을 보려면 coscli mb -h를 입력합니다
-c, --config-path
기본적으로 COSCLI의 경우 ~/.cos.yaml인 구성 파일 경로입니다. 명령 뒤에 -c를 추가하여 사용자 정의 구성 파일을 지정합니다
-e, --endpoint
구성 파일에서 버킷의 리전을 미리 구성하는 것 외에도 COSCLI에서 -e를 사용하여 cos.<region>.myqcloud.com 형식으로 버킷 endpoint를 지정할 수도 있습니다. 여기서 <region>ap-guangzhouap-beijing과 같은 버킷 리전을 나타냅니다. COS에서 지원하는 리전 목록은 리전 및 액세스 도메인을 참고하십시오
-i, --sercret-id
COS에 액세스하는 데 사용되는 SecretId 지정
-k, --sercret-key
COS에 액세스하는 데 사용되는 SecretKey 지정
--token
임시 키로 COS에 액세스하는 경우 -t를 사용하여 해당 token 지정
-v, --version
COSCLI 버전 표시
-p, --protocol
네트워크 전송 프로토콜로 기본값은 https입니다.
--init-skip
기본값은 false입니다. true(--init-skip=true)로 설정된 경우 config init 인터랙티브를 건너뛰고 직접 매개변수 중의 SecretId, SecretKey 및 endpoint를 사용하여 api를 요청하며, 이 매개변수를 사용하는 경우 -i, -k, -e 매개변수는 필수입니다.
--log-path
coscli.log 파일 위치 사용자 정의, 기본값은 COSCLI와 동일한 디렉터리입니다. 폴더 또는 특정 파일(파일은 .log로 끝나야 함)을 지정할 수 있습니다. 예: /data/ 또는 /data/coscli.log
--customized
기본값은 false이며, true로 설정한 경우 사용자 정의 도메인을 활성화하고 --endpoint(-e) 매개변수를 통해 사용자 정의 도메인을 지정해야 합니다.
--disable-log
기본값은 false이며, true로 설정한 경우 coscli.log 생성 및 해당 로그 출력을 비활성화합니다.
--bucket-type
현재 액세스 버킷 유형(COS/OFS) 지정

작업 예시

예시1: 버킷을 전환하여 객체 업로드

COSCLI를 통해 다른 리전의 버킷으로 전환해야 하는 경우 -e 옵션을 사용하여 버킷의 Endpoint를 지정할 수 있습니다.
예를 들어, 로컬 파일 test.txt를 엔드포인트가 cos.ap-chengdu.myqcloud.com인 청두 리전의 examplebucket-1250000000 버킷에 업로드하려면 다음 명령을 실행합니다.
./coscli cp test.txt cos://examplebucket-1250000000/test.txt -e cos.ap-chengdu.myqcloud.com

예시2: 파일 목록을 보기 위해 사용자 계정 전환

다른 계정의 ID를 사용해야 하는 경우 -i 및 -k 옵션을 사용하여 키의 SecretId 및 SecretKey를 각각 지정할 수 있습니다.
예를 들어 다른 계정의 ID를 사용하여 청두 리전의 examplebucket-1250000000 버킷에 있는 파일을 나열하려면 다음 명령을 실행합니다.
./coscli ls cos://examplebucket-1250000000 -e cos.ap-chengdu.myqcloud.com -i ******************************** -k ********************************


도움말 및 지원

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

피드백