Object Storage Service (OSS) では、バケットのタグ付けを設定して、バケットを分類および管理できます。 たとえば、バケットタグ機能を使用して、特定のタグを持つバケットを一覧表示したり、特定のタグを持つバケットのアクセス制御リスト (ACL) を設定したりできます。 このトピックでは、bucket-taggingコマンドを実行してバケットタグを追加、変更、クエリ、または削除する方法について説明します。
このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細については、「ossutilの使用を開始する」をご参照ください。
- バケットタグの詳細については、「バケットタグの管理」をご参照ください。
バケットへのタグの追加またはバケットのタグの変更
バケットタグ機能では、キーと値のペアをタグとして使用してバケットを識別します。 各バケットには最大10個のタグを付けることができます。 バケットにタグを追加したり、バケットのタグを変更したりできるのは、PutBucketTags権限を付与されたバケット所有者とユーザーだけです。 他のユーザーがバケットにタグを追加したり、バケットのタグを変更したりすると、403 ForbiddenがエラーコードAccessDeniedと共に返されます。
- コマンド構文
/ossutil64 bucket-tagging -- メソッドput oss:// bucketname key#value
次の表に、上記のステートメントで指定したパラメーターを示します。
パラメーター 説明 bucketname タグを追加するバケットまたはタグを変更するバケットの名前。 キー# 値 タグ情報を含むキーと値のペア。 - タグのキーと値は数字記号 (#) で区切られており、UTF-8でエンコードする必要があります。
- タグのキーの長さは最大64文字で、先頭を
http://
、https://
、Aliyun
にすることはできません。 タグのキーは空のままにすることはできません。 - タグの値は最大128文字で、空のままにすることができます。
バケットにタグがない場合は、このコマンドを実行してバケットにタグを追加できます。 バケットにタグがある場合、このコマンドを実行して既存のタグを上書きできます。
- 例:
次のコマンドを実行して、examplebucketという名前のバケットに2つのタグを追加できます。 一方のタグはtag1のキーとtest1の値を持ち、他方のタグはtag2のキーとtest2の値を持つ。
. /ossutil64 bucket-tagging -- メソッドput oss:// examplebucket tag1#test1 tag2#test2
同様の出力が表示されると、タグがバケットに追加されます。
0.300600経過
バケットのタグを照会する
- コマンド構文
/ossutil64 bucket-tagging -- メソッドget oss:// bucketname
- 例:
次のコマンドを実行して、examplebucketという名前のバケットのタグを照会できます。
. /ossutil64 bucket-tagging -- メソッドget oss:// examplebucket
同様の出力が表示される場合、examplebucketは2つのタグで構成されます。 一方のタグはtag1のキーとtest1の値を持ち、他方のタグはtag2のキーとtest2の値を持つ。
インデックスタグキータグ値 --------------------------------------------------- 0 "tag1" "test1" 1 "tag2" "test2" 0.283359経過
バケットのタグを削除する
- コマンド構文
/ossutil64 bucket-tagging -- メソッドdelete oss:// bucketname
- 例:
次のコマンドを実行して、examplebucketという名前のバケットのすべてのタグを削除します。
説明 ossutilを使用すると、バケットのすべてのタグを削除できます。 ossutilを使用してバケットの特定のタグのみを削除することはできません。 DeleteBucketTags操作を呼び出して、バケットの特定のタグを削除できます。. /ossutil64 bucket-tagging -- メソッドdelete oss:// examplebucket
同様の出力が表示された場合、examplebucketのすべてのタグが削除されます:0.530750経過
一般的なオプション
ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKeyシークレットを指定します。
。/ossutil64 bucket-tagging -- メソッドput oss:// examplebucket key#value -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****
同期コマンドに使用できるその他の一般的なオプションの詳細については、「オプションの表示」をご参照ください。