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
개인 정보 보호 정책
데이터 처리 및 보안 계약
연락처
용어집
문서Cloud Object Storage툴 가이드COSCLI 툴자주 쓰는 명령어버킷 태그 - bucket-tagging

버킷 태그 - bucket-tagging

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-11-14 15:30:17
bucket-tagging 명령은 버킷 태그 생성(수정), 가져오기 및 삭제에 사용됩니다.각 버킷 최대 50개의 태그 그룹을 지원합니다.
주의:
버킷 태그를 조회하려면권한 정책 설정 시 action을 cos:GetBucketTagging으로 지정해야 합니다.
버킷 태그를 설정하려면권한 정책 설정 시 action을 cos:PutBucketTagging으로 지정해야 합니다.
버킷 태그를 삭제하려면권한 정책 설정 시 action을 cos:DeleteBucketTagging으로 지정해야 합니다.
자세한 내용은 CAM 지원 API를 참조하십시오.

명령 옵션

./coscli bucket-tagging --method [method] cos://<bucket-name> [tag_key]#[tag_value]
bucket-tagging 명령어는 다음과 같은 매개변수를 포함합니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>
접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias
버킷 이름으로 접근: cos://examplebucket-1250000000
bucket-tagging 명령에는 다음과 같은 flag 옵션이 포함됩니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
없음
--method
put(태그 설정), get(태그 조회), delete(태그 삭제), add(태그 추가) 등 수행할 작업 지정
설명:
이 명령의 다른 일반 옵션(예시: 버킷 및 사용자 계정 전환)은 Common Options를 참고하십시오.

버킷 태그 설정

버킷 태그는 키-값(Key-Value)으로 표시되며, 버킷 소유자 및 PutBucketTagging 권한이 있는 사용자만 버킷 태그를 설정할 수 있습니다. 그렇지 않으면 오류 코드 403 AccessDenied가 반환됩니다.

명령어 형식

./coscli bucket-tagging --method put cos://bucketAlias key1#value1 key2#value2
여기서 key#value는 태그 키-값 Key-Value를 나타내며, key와 value는 #로 구분됩니다. 버킷에 태그가 없는 경우 이 명령은 지정된 태그를 버킷에 추가합니다. 그렇지 않으면 기존 태그를 덮어씁니다.

작업 예시

버킷 별칭이 example-alias인 버킷에 두 개의 태그를 구성합니다. 하나는 key가 1이고 value가 111이며, 다른 하나는 key가 2이고 value가 222입니다. 명령은 다음과 같습니다.
./coscli bucket-tagging --method put cos://exmaple-alias 1#111 2#222

버킷 태그 조회

명령어 형식

./coscli bucket-tagging --method get cos://bucketAlias

작업 예시

./coscli bucket-tagging --method get cos://exmaple-alias
다음 출력 결과는 버킷 별칭이 example-alias인 버킷에 두 개의 태그가 구성되어 있음을 나타냅니다. 이 중 한 그룹의 key는 1, value는 111, 한 그룹의 key는 2, value는 222입니다.
  KEY | VALUE  
------+--------
    1 |   111  
    2 |   222

버킷 모든 태그 삭제

명령어 형식

./coscli bucket-tagging --method delete cos://bucketAlias

작업 예시

./coscli bucket-tagging --method delete cos://exmaple-alias

버킷 태그 추가

버킷 태그는 키-값(Key-Value)으로 표시되며, 버킷 소유자 및 PutBucketTagging 권한이 있는 사용자만 버킷 태그를 추가할 수 있습니다. 그렇지 않으면 오류 코드 403 AccessDenied가 반환됩니다.

명령어 형식

./coscli bucket-tagging --method add cos://bucketAlias key1#value1 key2#value2
여기서 key#value는 태그 키-값 Key-Value를 나타내며, key와 value는 #로 구분됩니다.

작업 예시

버킷 별칭이 example-alias인 버킷에 key가 1이고 value가 111인 태그를 추가합니다. 명령은 다음과 같습니다.
./coscli bucket-tagging --method add cos://example-alias 1#111

이전 주제: 버킷 삭제 - rb다음 주제: 버킷 또는 파일 리스트 쿼리 - ls

도움말 및 지원

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

피드백