すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:バケットのタグ付け

最終更新日:Feb 05, 2025

Object Storage Service (OSS) では、バケットのタグ付けを設定して、バケットを分類および管理できます。 たとえば、バケットタグ機能を使用して、特定のタグを持つバケットを一覧表示したり、特定のタグを持つバケットのアクセス制御リスト (ACL) を設定したりできます。 このトピックでは、bucket-taggingコマンドを実行してバケットタグを追加、変更、クエリ、または削除する方法について説明します。

使用上の注意

  • バケットタグを追加または変更するには、oss:PutBucketTagging権限が必要です。 バケットタグをクエリするには、oss:GetBucketTagging権限が必要です。 バケットタグを削除するには、oss:DeleteBucketTagging権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

  • ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。

  • バケットタグの詳細については、「バケットタグの管理」をご参照ください。

バケットへのタグの追加またはバケットのタグの変更

バケットのタグ付けでは、キーと値のペアをタグとして使用してバケットを識別します。 バケットにタグを追加したり、バケットのタグを変更したりできるのは、PutBucketTags権限を付与されたバケット所有者とユーザーだけです。 他のユーザーがバケットにタグを追加したり、バケットのタグを変更したりすると、403 ForbiddenがエラーコードAccessDeniedと共に返されます。

  • コマンド構文

    ossutil bucket-tagging --method put oss://bucketname key#value

    次の表に、上記のパラメーターを示します。

    パラメーター

    説明

    bucketname

    タグを追加するバケットまたはタグを変更するバケットの名前。

    キー# 値

    タグのキーと値のペア。

    • タグのキーと値は数字記号 (#) で区切られており、UTF-8でエンコードする必要があります。

    • キーの長さは最大64文字で、http://https://Aliyunは使用できません。 プレフィックスを使用します。 キーを空のままにすることはできません。

    • 値の長さは、最大 128 文字です。 値は空のままにすることができます。

    コマンドで指定したタグが存在しない場合、指定したタグがバケットに追加されます。 コマンドで指定したタグが既に存在する場合は, 既存のタグが上書きされます。

  • 次のサンプルコマンドは、examplebucketという名前のバケットに2つのタグを追加します。 一方のタグはtag1のキーとtest1の値を持ち、他方のタグはtag2のキーとtest2の値を持つ。

    ossutil bucket-tagging --method put oss://examplebucket  tag1#test1 tag2#test2

    次のサンプル出力は、タグが追加されていることを示します。

    0.300600(s) elapsed

バケットタグの照会

  • コマンド構文

    ossutil bucket-tagging --method get oss://bucketname
  • 次のサンプルコマンドは、examplebucketという名前のバケットのタグを照会します。

    ossutil bucket-tagging --method get oss://examplebucket

    次のサンプル出力は、examplebucketバケットに2つのタグがあることを示しています。 1つはtag1のキーとtest1の値を持ち、もう1つはtag2のキーとtest2の値を持ちます。

    index     tag key       tag value
    ---------------------------------------------------
    0         "tag1"        "test1"
    1         "tag2"        "test2"
    
    0.283359(s) elapsed

バケットタグの削除

  • コマンド構文

    ossutil bucket-tagging --method delete oss://bucketname 
  • 次のサンプルコマンドは、examplebucketという名前のバケットのすべてのタグを削除します。

    説明

    ossutilを使用すると、バケットのすべてのタグを削除できます。 ossutilを使用してバケットの特定のタグのみを削除することはできません。 バケットの特定のタグを削除するには、DeleteBucketTags操作を呼び出します。

    ossutil bucket-tagging --method delete oss://examplebucket

    次のサンプル出力は、examplebucketのすべてのタグが削除されたことを示します。

    0.530750(s) elapsed

一般的なオプション

ossutilを使用して別のリージョンにあるバケットに切り替える場合は、-eオプションを追加して、バケットが配置されているリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、-iオプションを追加して指定されたアカウントのAccessKey IDを指定し、-kオプションを追加して指定されたアカウントのAccessKey secretを指定します。

たとえば、次のコマンドを実行して、中国 (杭州) リージョンにあり、別のAlibaba Cloudアカウントが所有するexamplebucketという名前のバケットのタグを設定できます。

ossutil bucket-tagging--method put oss://examplebucket key#value -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

共通オプションの詳細については、「共通オプション」をご参照ください。