tencent cloud

Cloud Object Storage

문서Cloud Object Storage툴 가이드COSCLI 툴자주 쓰는 명령어버킷 정책 - bucket-policy

버킷 정책 - bucket-policy

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

명령어 형식

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

버킷 정책 설정

작업 예시

버킷 별칭이 example-alias인 버킷 정책을 설정합니다. 명령어는 다음과 같습니다(버킷 정책 설정 참조).
./coscli bucket-policy --method put cos://example-alias --policy="{\\"Statement\\":[...]}"

버킷 정책 조회

작업 예시

버킷 별칭이 example-alias인 정책 정보를 조회합니다.
./coscli bucket-policy --method get cos://example-alias
다음 결과를 출력합니다.
 SECTION      | KEY       | VALUE                                                          
---------------+-----------+----------------------------------------------------------------
 Policy       | Version   | 2.0                                                            
+--------------+-----------+---------------------------------------------------------------+
              |           |                                                                
+--------------+-----------+---------------------------------------------------------------+
 Statement #1 | SID       | costs-12331231231123123-80285-3                           
+              +-----------+---------------------------------------------------------------+
              | Effect    | allow                                                          
+              +-----------+---------------------------------------------------------------+
              | Principal | qcs:                                                           
              |           |   - qcs::cam::uin/1000000000:uin/1000000000                  
              |           |   - qcs::cam::uin/1000000000:uin/1000000000                  
              |           |                                                                
+              +-----------+---------------------------------------------------------------+
              | Action    | name/cos:GetBucket                                             
+              +-----------+---------------------------------------------------------------+
              | Resource  | qcs::cos:ap-nanjing:uid/1240000000:test-1240000000/*  
+              +-----------+---------------------------------------------------------------+
              | Condition | ip_equal:                                                      
              |           |   qcs:ip:                                                      
              |           |     - 11.9.10.8                                             
              |           |                                                                
---------------+-----------+----------------------------------------------------------------
Bucket Policy Information

버킷 정책 삭제

작업 예시

버킷 별칭이 example-alias인 버킷 정책을 삭제합니다. 명령어는 다음과 같습니다.
./coscli bucket-policy --method delete cos://example-alias

이전 주제: 객체 ACL 관리 - object-acl다음 주제: 버킷 암호화 정책 - bucket-encryption

도움말 및 지원

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

피드백