bucket-taggingコマンドを実行して、バケットタグを追加、削除、変更、または照会します。 - Object Storage Service

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

使用上の注意

バケットタグを追加または変更するには、oss:PutBucketTagging権限が必要です。バケットタグをクエリするには、oss:GetBucketTagging権限が必要です。バケットタグを削除するには、oss:DeleteBucketTagging権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
このトピックでは、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つのタグがあることを示しています。1つはtag1のキーとtest1の値を持ち、もう1つは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 secretを指定します。

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

./ossutil64 bucket-tagging -- メソッドput oss:// examplebucket key#value -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

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