tencent cloud

Cloud Object Storage

프로파일 생성 및 수정 - config

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-14 15:30:16

명령어 형식

다음 config 명령어는 프로파일 생성 및 수정에 사용됩니다.
./coscli config [command] [flag]
설명:
구성 항목을 올바르게 설정한 후 ./coscli config show를 실행하여 구성을 볼 수 있습니다.
이 명령의 다른 일반 옵션(예시: 버킷 및 사용자 계정 전환)은 Common Options를 참고하십시오.
생성된 설정 파일은 기본적으로 HTTPS 전송 프로토콜을 사용합니다. HTTP로 변경하려면 설정 파일에서 직접 수정하시면 됩니다.
config 명령어에는 다음 하위 명령어가 포함됩니다.
command 이름
command 용도
add
새 버킷 설정 추가.
delete
기존 버킷 설정 삭제.
init
인터랙티브식으로 프로파일 생성.
set
프로파일의 base 그룹에서 하나 이상의 설정 항목 수정.base 그룹에는 secretid, secretkey, sessiontoken, mode, cvmrolename 정보가 포함됩니다.
show
지정된 프로파일의 정보 출력.
config 및 해당 하위 명령어에는 다음과 같은 flag 옵션이 포함됩니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
이 명령의 구체적인 사용법 보기
-c
--config-path
사용할 프로파일 경로 지정.
config add 하위 명령어에는 다음과 같은 flag 옵션이 포함되어 있습니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
이 명령의 구체적인 사용법 보기
-a
--alias
버킷 별칭.
-b
--bucket
버킷 이름.
-r
--region
버킷 리전.
-o
--ofs
메타데이터 가속화 버킷 태그 지정. 자세한 내용은 메타데이터 가속 개요 를 참조하십시오.
주의:
버킷 endpoint를 지정하려면 일반 flag -e 또는 --endpoint를 사용할 수 있습니다. 자세한 내용은 범용 옵션 소개 를 참조하십시오.
config delete 하위 명령어에는 다음과 같은 flag 옵션이 포함되어 있습니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
이 명령의 구체적인 사용법 보기
-a
--alias
버킷 별칭.
config set 하위 명령어에는 다음과 같은 flag 옵션이 포함되어 있습니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
이 명령의 구체적인 사용법 보기
없음
--secret_id
secret ID를 설정하십시오.액세스 관리 콘솔에서 생성하고 얻을 수 있습니다.
없음
--secret_key
secret key를 설정하십시오.액세스 관리 콘솔에서 생성하고 얻을 수 있습니다.
-t
--session_token
임시 키 token을 설정합니다. 임시 키에 대한 자세한 내용은 임시 키를 사용하여 COS에 접속하기를 참조하십시오.
없음
--mode
신원 모드 설정, 열거형 값 SecretKeyCvmRole 지원. 비워둘 수 있으며, 빈 값은 기본적으로 SecretKey로 설정되며, 이는 키를 사용하여 COS를 요청함을 의미합니다. mode가 CvmRole일 경우, 인스턴스 역할 관리를 통해 COS를 요청함을 의미합니다.
없음
--cvm_role_name
CVM 역할 인스턴스 이름 설정, 자세한 내용은 인스턴스 역할 관리를 참고하십시오.
없음
--close_auto_switch_host
자동 백업 도메인 전환 종료 여부 설정. 옵션값: true | false (빈 값 가능).
설정하지 않거나 값이 false인 경우 백업 도메인 전환이 수행됩니다.
true로 설정한 경우 백업 도메인 전환이 수행되지 않습니다.
없음
--disable_encryption
키 암호화 해제 여부 설정. 기본값: false (true 시 구성 파일의 키 정보 암호화 해제).
없음
--disable_auto_fetch_bucket_type
자동 버킷 유형 획득 비활성화 여부 설정. 옵션값: true, false.
설정하지 않거나 값이 false인 경우 자동으로 버킷 유형을 획득합니다(사용 중인 계정에 cos:HeadBucket 권한이 있는지 확인하십시오).
true로 설정하면 자동으로 버킷 유형을 획득하지 않고 사용자 구성 파일의 버킷 유형을 사용합니다(예: 구성 파일의 Bucket 구성 항목 ofs가 true로 설정된 경우 버킷 유형은 ofs이고, false로 설정된 경우 버킷 유형은 cos임).

작업 예시

새 버킷 설정 추가

./coscli config add -b examplebucket3-1250000000 -r ap-chengdu -e cos.ap-chengdu.myqcloud.com -a bucket3

기존 버킷 설정 삭제

./coscli config delete -a bucket3

기본 프로파일에서 session-token 수정

./coscli config set --session_token test-token123

지정된 프로파일의 정보 출력

./coscli config show -c /your/config/path.yaml

기본 구성 파일에서 mode 및 cvmrolename 수정

./coscli config set --mode CvmRole --cvm_role_name testName

도움말 및 지원

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

피드백