tencent cloud

Cloud Object Storage

ドキュメントCloud Object StorageツールガイドCOSCLIツールよく使用するコマンドバケットACLの管理 - bucket-acl

バケットACLの管理 - bucket-acl

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-10-28 15:53:27
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>
アクセスしたいバケットを指定します。パラメータ設定で設定したバケットエイリアス、またはバケット名でアクセスできます。バケット名でアクセスする場合は、追加でendpointflagを指定する必要があります。
バケットエイリアスでアクセス：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の設定

操作例

ユーザー100000000013および100000000012に、バケットエイリアスがexample-aliasのバケットに対する読み取り権限を付与します。コマンドは以下の通りです。
./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
前の記事へ: オブジェクトタグ - object-tagging次の記事へ: オブジェクトACLの管理 - object-acl

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック