tencent cloud

Cloud Object Storage

버킷 태그 - 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


도움말 및 지원

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

피드백