tencent cloud

Cloud Object Storage

객체 태그 - object-tagging

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-10-28 15:46:31
object-tagging 명령어는 객체 태그 생성(수정), 조회, 삭제에 사용됩니다. 각 객체는 최대 10개의 태그 세트를 지원합니다.
주의:
객체 태그를 조회하려면 권한 정책 설정 시 action을 cos:GetObjectTagging으로 설정해야 합니다.
객체 태그를 설정하려면 권한 정책 설정 시 action을 cos:PutObjectTagging으로 설정해야 합니다.
객체 태그를 삭제하려면 권한 정책 설정 시 action을 cos:DeleteObjectTagging으로 설정해야 합니다.
더 많은 권한 관련 내용은 CAM 지원 API를 참고하십시오.

명령어 형식

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

객체 태그 수정

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

명령어 형식

./coscli object-tagging --method put cos://bucketAlias/object key1#value1 key2#value2
key#value는 태그 키-값 Key-Value를 나타내며, key와 value는 #으로 구분됩니다. 객체에 태그가 설정되지 않은 경우 이 명령어는 객체에 지정된 태그를 추가하고, 객체에 태그가 이미 설정된 경우 이 명령어는 기존 태그를 덮어씁니다.

작업 예시

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

객체 태그 조회

명령어 형식

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

작업 예시

./coscli object-tagging --method get cos://example-alias/object
다음 출력 결과는 버킷 별칭 example-alias의 object 객체에 두 개의 태그가 설정되어 있음을 나타냅니다. 하나는 key가 1이고 value가 111이며, 다른 하나는 key가 2이고 value가 222입니다.
KEY | VALUE
------+--------
1 | 111
2 | 222

객체 지정 태그 삭제

명령어 형식

./coscli object-tagging --method delete cos://bucketAlias/object key1#value1

작업 예시

./coscli object-tagging --method delete cos://example-alias/object 1#111

객체 모든 태그 삭제

명령어 형식

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

작업 예시

./coscli object-tagging --method delete cos://example-alias/object

객체 태그 추가

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

명령어 형식

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

작업 예시

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


도움말 및 지원

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

피드백