tencent cloud

Cloud Object Storage

버킷 ACL 관리 - bucket-acl

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

명령어 형식

./coscli bucket-acl --method [method] cos://<bucket-name>
bucket-acl 명령어에는 다음 매개변수가 포함됩니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>
접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias
버킷 이름으로 접근: cos://examplebucket-1250000000
bucket-acl 명령어에는 다음 flag 옵션이 포함됩니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
없음
--method
put(버킷 ACL 설정), get(버킷 ACL 조회) 등 수행할 작업 지정
없음
--acl
버킷의 ACL 설정, 예: private, public-read, public-read-write
없음
--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에 대해 100000000013, 100000000012에게 읽기 권한을 부여합니다. 명령어는 다음과 같습니다.
./coscli bucket-acl --method put cos://example-alias --grant-read="id=\\"100000000013\\",id=\\"100000000012\\""

버킷 ACL 조회

작업 예시

버킷 별칭이 example-alias인 권한 목록을 조회합니다.
./coscli bucket-acl --method get cos://example-alias
다음 결과를 출력합니다.
SECTION | KEY | VALUE
-----------+--------------+----------------------------------------------
Owner | UIN |
+ +--------------+---------------------------------------------+
| ID | qcs::cam::uin/100000000:uin/100000000
+ +--------------+ +
| 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/100000000:uin/100000000 (UIN: )
- Total Grants: 2
- Permissions:
- READ: 2 grants


도움말 및 지원

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

피드백