tencent cloud

Cloud Object Storage

객체 ACL 관리 - object-acl

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-10-28 15:57:13
object-acl 명령은 객체 ACL을 설정하고 조회하는 데 사용됩니다.
주의:
객체 ACL을 조회하려면 권한 정책 설정 시 action을 cos:GetObjectACL으로 설정해야 합니다.
객체 ACL을 설정하려면 권한 정책 설정 시 action을 cos:PutObjectACL으로 설정해야 합니다.
더 많은 권한 관련 내용은 CAM 지원 API를 참고하십시오.

명령어 형식

./coscli object-acl --method [method] cos://<bucket-name>/object
object-acl 명령어는 다음 매개변수를 포함합니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>
접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias
버킷 이름으로 접근: cos://examplebucket-1250000000
object-acl 명령어에는 다음 flag 옵션이 포함됩니다:
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
없음
--method
put(객체 ACL 설정), get(객체 ACL 조회) 등 수행할 작업 지정
없음
--acl
파일의 ACL 설정, 예: private, public-read
없음
--grant-read
피승인자에게 객체 읽기 권한을 부여합니다. 형식은 id="[OwnerUin]"입니다(예: id="100000000001"). 반각 쉼표(,)를 사용하여 여러 피승인자를 구분할 수 있습니다(예: id="100000000001",id="100000000002").
없음
--grant-read-acp
피승인자에게 객체의 접근 제어 목록(ACL) 읽기 권한을 부여합니다. 형식은 id="[OwnerUin]"입니다(예: id="100000000001"). 반각 쉼표(,)를 사용하여 여러 피승인자를 구분할 수 있습니다(예: id="100000000001",id="100000000002").
없음
--grant-write-acp
피승인자에게 객체의 접근 제어 목록(ACL) 쓰기 권한을 부여합니다. 형식은 id="[OwnerUin]"입니다(예: id="100000000001"). 반각 쉼표(,)를 사용하여 여러 피승인자를 구분할 수 있습니다(예: id="100000000001",id="100000000002").
없음
--grant-full-control
피승인자에게 객체 작업 관련 모든 권한을 부여합니다. 형식은 id="[OwnerUin]"입니다(예: id="100000000001"). 반각 쉼표(,)를 사용하여 여러 피승인자를 구분할 수 있습니다(예: id="100000000001",id="100000000002").
설명:
이 명령어에 대한 기타 일반 옵션(예: 버킷 전환, 사용자 계정 전환 등)은 일반 옵션 문서를 참고하십시오.

작업 예시

객체 ACL 설정

버킷 별칭 example-alias의 object 객체에 대해 100000000013, 100000000012에게 읽기 권한을 부여합니다. 명령어는 다음과 같습니다.
./coscli object-acl --method put cos://example-alias/object --grant-read="id=\\"100000000013\\",id=\\"100000000012\\""

객체 ACL 조회

버킷 별칭 example-alias의 object 객체의 권한 목록을 조회합니다.
./coscli object-acl --method get cos://example-alias/object
다음 결과를 출력합니다.
SECTION | KEY | VALUE
-----------+--------------+----------------------------------------------
Owner | UIN |
+ +--------------+---------------------------------------------+
| ID | qcs::cam::uin/1000000000:uin/1000000000
+ +--------------+ +
| Display Name |
+----------+--------------+---------------------------------------------+
| |
+----------+--------------+---------------------------------------------+
Grant #1 | Permission | READ
+ +--------------+---------------------------------------------+
| Grantee Type | CanonicalUser
+ +--------------+---------------------------------------------+
| ID | qcs::cam::uin/100000000013:uin/100000000013
+ +--------------+ +
| Display Name |
+----------+--------------+---------------------------------------------+
| |
+----------+--------------+---------------------------------------------+
Grant #2 | Permission | READ
+ +--------------+---------------------------------------------+
| Grantee Type | CanonicalUser
+ +--------------+---------------------------------------------+
| ID | qcs::cam::uin/100000000012:uin/100000000012
+ +--------------+ +
| Display Name |
-----------+--------------+----------------------------------------------
Access Control List (ACL) Information

Summary:
- Owner: qcs::cam::uin/1000000000:uin/1000000000 (UIN: )
- Total Grants: 2
- Permissions:
- READ: 2 grants



도움말 및 지원

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

피드백