tencent cloud

Cloud Object Storage

ドキュメントCloud Object StorageツールガイドCOSCLIツールよく使用するコマンドストレージバケットタグ－bucket－tagging

ストレージバケットタグ－bucket－tagging

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-11-14 15:30:17
bucket-taggingコマンドは、ストレージバケットタグの作成（変更）取得削除に使用されます。各ストレージバケットごとに最大50組のタグがサポートされています。
注意：
ストレージバケットタグを取得するには、ポリシー許可 を設定する際に、actionをcos:GetBucketTaggingに設定する必要があります。
ストレージバケットタグを設定するには、ポリシー許可 を設定する際に、actionをcos:PutBucketTaggingに設定する必要があります。
ストレージバケットタグを削除するには、ポリシー許可 を設定する際に、actionをcos:DeleteBucketTaggingに設定する必要があります。
詳しい権限許可については、CAM対応API をご参照ください。

コマンド形式

./coscli bucket-tagging --method [method] cos://<bucket-name> [tag_key]#[tag_value]
bucket-taggingコマンドには以下のパラメータが含まれています：
パラメータ形式
パラメータ用途
例
cos://<bucket-name>
アクセスするストレージバケットを指定します。パラメータ設定 内のバケット別名またはバケット名からアクセスできます。バケット名からアクセスする場合は、endpointflagを追加する必要があります。
バケット別名からアクセス：cos://example-alias
バケット名からアクセス：cos://examplebucket-1250000000
bucket-taggingコマンドには以下の選択可能なflagが含まれています：
flag略語
flag全称
flag用途
-h
--help
コマンドの具体的な使用方法
なし
--method
実行する操作を指定します。put（タグ設定）、get（タグ照会）、delete（タグ削除）、add（タグ追加）が含まれます。
説明：
このコマンドに関するその他の一般オプション（ストレージバケット・ユーザーアカウントの切り替えなど）については、一般オプション をご参照ください。

バケットタグの設定

バケットタグはキーバリューペア（Key-Value）で表されます。バケットの所有者およびPutBucketTagging権限を持つユーザーのみが設定でき、それ以外の場合はエラーコード403 AccessDeniedが返されます。

コマンド形式

./coscli bucket-tagging --method put cos://bucketAlias key1#value1 key2#value2
key#valueはキーバリューペアを示し、キーとバリューは#で区切られます。ストレージバケットにタグが設定されていない場合、このコマンドはストレージバケットに指定されたタグを追加します。ストレージバケットに既にタグが設定されている場合、このコマンドは既存のタグに上書きします。

操作例

バケットエイリアスがexample-aliasのバケットに2つのタグを設定します。1つ目のキーは1、バリューは111、2つ目のキーは2、バリューは222とします。コマンドは以下の通りです。
./coscli bucket-tagging --method put cos://exmaple-alias 1#111 2#222

ストレージバケットタグの検索

コマンド形式

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

操作例

./coscli bucket-tagging --method get cos://exmaple-alias
以下の出力結果は、バケット別名がexample-aliasのストレージバケットに2組のタグが設定されていることを示しています。その中で、1組はタグのキーが1、値が111で、もう1組はタグのキーが2、値が222です。
  KEY | VALUE  
------+--------
    1 |   111  
    2 |   222

バケットの全タグの削除

コマンド形式

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

操作例

./coscli bucket-tagging --method delete cos://exmaple-alias

バケットタグの追加

バケットタグはキーバリューペア（Key-Value）で表されます。バケットの所有者およびPutBucketTagging権限を持つユーザーのみが追加でき、それ以外の場合はエラーコード 403 AccessDeniedが返されます。

コマンド形式

./coscli bucket-tagging --method add cos://bucketAlias key1#value1 key2#value2
key#valueはキーバリューペアを示し、キーとバリューは#で区切られます。

操作例

バケットエイリアスがexample-aliasのバケットに1つのタグを追加します。キーは1、バリューは111とします。コマンドは以下の通りです。
./coscli bucket-tagging --method add cos://example-alias 1#111

前の記事へ: バケットの削除 - rb次の記事へ: バケットまたはファイルリストの照会 - ls

ヘルプとサポート

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

フィードバック