object-tagging コマンドは、オブジェクトのタグ設定を追加、変更、クエリ、または削除する場合に使用します。

オブジェクトのタグの詳細は、「オブジェクトのタグ付け」をご参照ください。

コマンド構文

  • オブジェクトのタグ設定を追加または変更する
    ./ossutil object-tagging --method put oss://bucket[/prefix] key#value [--encoding-type url] [-r] [--payer requester] [--version-id versionId] [-c file]
    オブジェクトにタグが設定されていない場合、このコマンドを実行して、タグをオブジェクトに追加できます。 オブジェクトにタグが設定されている場合、このコマンドを実行して既存のタグを上書きできます。
    • オブジェクトごとに最大 10 個のタグを設定できます。 各オブジェクトタグには一意のタグキーが必要です。
    • タグキーは最大 128 文字です。 タグの値は最大 256 文字です。
    • キーと値は大文字と小文字が区別されます。
    • タグのキーと値には、文字、数字、スペース、および次の特殊文字を含めることができます。

      + = . _ : /

    • オブジェクトのタグの読み書き権限を持っているのは、バケット所有者と許可されたユーザーのみです。 これらの権限は、オブジェクトの ACL に依存しません。
    • リージョン間レプリケーション時に、オブジェクトタグもターゲットバケットにレプリケートされます。
  • オブジェクトのタグ設定をクエリする
    ./ossutil object-tagging --method get oss://bucket[/prefix] [--encoding-type url] [-r]  [--payer requester] [--version-id versionId] [-c file]
  • オブジェクトのタグ設定を削除する
    ./ossuitl object-tagging --method delete oss://bucket[/prefix] [--encoding-type url] [-r] [--payer requester] [--version-id versionId] [-c file]

  • オブジェクトのタグ設定を追加する
    ./ossutil object-tagging --method put oss://bucket1/test.jpg a#1 b#2 c#3
    0.168034(s) elapsed
  • オブジェクトのタグ設定をクエリする
    ./ossutil object-tagging --method get oss://bucket1/test.jpg
    object index   tag index      tag key   tag value       object
    ---------------------------------------------------------------------------
    1              0              "a"       "1"     123/test.jpg
    1              1              "b"       "2"     123/test.jpg
    1              2              "c"       "3"     123/test.jpg
    
    0.228023(s) elapsed
  • オブジェクトのタグ設定を削除する
    ./ossutil object-tagging --method delete oss://bucket1/test.jpg
    0.200020(s) elapsed

一般的なオプション

次の表に、object-tagging コマンドに追加できるオプションを示します。
オプション 説明
--method HTTP リクエストメソッドを指定します。 有効値:
  • put:オブジェクトのタグ設定を追加または変更します。
  • get:オブジェクトのタグ設定を取得します。
  • delete:オブジェクトのタグ設定を削除します。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
  • info:プロンプトログを生成します。
  • debug:対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
--proxy-host プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例:http://120.79.**.**:3128、socks5://120.79.**.**:1080 など。
--proxy-user プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。
--proxy-pwd プロキシサーバーのパスワードを指定します。 デフォルト値は null です。
--payer リクエストの支払者を指定します。 pay-by-requester モードを有効にするには、このオプションを requester に設定します。
-j、--jobs 複数のオブジェクトが操作される場合の同時タスク数を指定します。 有効値:1~10000。 デフォルト値:3。
-r、--recursive バケット内のオブジェクトに対して操作を再帰的に実行します。 このオプションが指定されている場合、このオプションをサポートするコマンドは、指定された条件を満たすバケット内のすべてのオブジェクトに対して操作を実行します。 このオプションが指定されていない場合、コマンドは指定された 1 つのオブジェクトに対してのみ操作を実行します。
--encoding-type オブジェクト名のエンコードタイプを指定します。 このオプションを指定する場合、値は url でなければなりません。 このオプションが指定されていない場合、オブジェクト名はエンコードされません。 バケット名は URL エンコードできません。
一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。