tencent cloud

Cloud Object Storage

オブジェクトタグ - object-tagging

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-10-28 15:46:31
object-tagging コマンドは、オブジェクトタグの作成(変更)、照会、削除に使用されます。各オブジェクトは最大10個のタグを設定できます。
注意:
オブジェクトタグを照会する場合、ポリシー許可を設定する際に、actionをcos:GetObjectTaggingに設定する必要があります。
オブジェクトタグを設定するには、ポリシー許可を設定する際に、actionをcos:PutObjectTaggingに設定する必要があります。
オブジェクトタグを削除する場合、ポリシー許可を設定する際に、actionをcos:DeleteObjectTaggingに設定する必要があります。
その他の権限付与については、CAM対応APIをご参照ください。

コマンド形式

./coscli object-tagging --method [method] cos://<bucket-name>/object [tag_key]#[tag_value]
object-taggingコマンドには以下のパラメータが含まれています。
パラメータ形式
パラメータ用途
cos://<bucket-name>
アクセスしたいバケットを指定します。パラメータ設定で設定したバケットエイリアス、またはバケット名でアクセスできます。バケット名でアクセスする場合は、追加でendpoint flagを指定する必要があります。
バケットエイリアスでアクセス:cos://example-alias
バケット名でアクセス:cos://examplebucket-1250000000
object-taggingコマンドには、以下のオプションflagが含まれます。
flag(短縮形)
flag(完全形)
flag(使用)
-h
--help
コマンドの具体的な使用方法
なし
--method
実行する操作を指定します。put(タグ設定)、get(タグ照会)、delete(タグ削除)、add(タグ追加)が含まれます
なし
--version-id
操作対象の特定バージョン
説明:
このコマンドのその他の共通オプション(バケットの切り替え、ユーザーアカウントの切り替えなど)については、共通オプションドキュメントをご参照ください。

オブジェクトタグの変更

オブジェクトタグはドキュメント(Key-Value)で表されます。オブジェクトの所有者およびPutObjectTagging権限を持つユーザーのみが追加または変更でき、それ以外の場合はエラーコード403 AccessDeniedが返されます。

コマンド形式

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

操作例

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

オブジェクトタグの照会

コマンド形式

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

操作例

./coscli object-tagging --method get cos://example-alias/object
以下の出力結果は、バケットエイリアスexample-alias配下のobjectオブジェクトに2つのタグが設定されていることを示します。1つ目のキーは1、バリューは111、2つ目のキーは2、バリューは222です。
KEY | VALUE
------+--------
1 | 111
2 | 222

オブジェクトの指定タグの削除

コマンド形式

./coscli object-tagging --method delete cos://bucketAlias/object key1#value1

操作例

./coscli object-tagging --method delete cos://example-alias/object 1#111

オブジェクトの全タグの削除

コマンド形式

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

操作例

./coscli object-tagging --method delete cos://example-alias/object

オブジェクトタグの追加

オブジェクトタグはキーバリューペア(Key-Value)で表されます。オブジェクトの所有者およびPutObjectTagging権限を持つユーザーのみが追加または変更でき、それ以外の場合はエラーコード403 AccessDeniedが返されます。

コマンド形式

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

操作例

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


ヘルプとサポート

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

フィードバック