オブジェクトのタグ付け

オブジェクトを記述するタグの管理は、さまざまなインターフェースおよびアーキテクチャーを介して行うことができます。 「コンソール」 を使用すると、グラフィカル・ユーザー・インターフェースが提供されます。 コマンド・ラインを使用するには、 curl のようなツールと、それが Object Storageとどのように対話するかの知識が必要です。

開始前に

以下が必要です。

• IBM Cloud® プラットフォーム・アカウント
• IBM Cloud Object Storage のインスタンス と、この目的のために作成されたバケット
• Object Storage のバケットまたはインスタンスに対するライターのアクセス権限を持つ IAM API キー
• タグが適用される既存のオブジェクトまたは新規オブジェクトのいずれか。

タグの読み取り

タグは、適切な権限を持つインスタンス全体でアクセス可能です。 組織の原則としてタグを使用するという真の組織的能力はあなたと共に拡大しますが、個別にタグにアクセスすることもできます。

コンソールにログインし、 IBM Cloud Object Storage のインスタンスと、データが表示されるバケットを選択します。 ファイルをバケットにアップロードした後、タグを表示して管理することができます。 データ (オブジェクトとして保管されている) を表す行の末尾にある省略符号の上にカーソルを置き、メニューのオプションから「タグの管理」を選択します。

curl を使用してオブジェクトのタグにアクセスするために必要なのは、 ?tagging 照会パラメーターを指定した正しい形式で認証済みの「GET」要求のみです。 ここに示す例では、 この例 を使用して生成されたベアラー・トークンを使用します。 バケット ID とオブジェクト・キーのほかに、正しい エンドポイント も必要になります。 結果の XML オブジェクトも表示されます。「Tag」エレメントは、オブジェクトに割り当てられたタグごとに繰り返されます。 タグがない場合、応答は空のエレメント <TagSet /> を含む XML を返します。

curl 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <TagSet>
    <Tag>
      <Key>Example Key</Key>
      <Value>Value Example</Value>
    </Tag>
  </TagSet>
</Tagging>

もちろん、タグを表示する前に、それらのタグを作成する必要があります。次に進みます。

タグの作成

タグは、以下の制約事項に従う必要があります。

• オブジェクトは最大 10 個のタグを持つことができます
• オブジェクトごとに、各タグ・キーは固有でなければならず、各タグ・キーは 1 つの値のみを持つことができます。
• 最小キー長-1 Unicode 文字 ( UTF-8 )
• キーの最大長- UTF-8 では 128 文字の Unicode 文字
• 最大鍵バイト・サイズ-256 バイト
• 最小値の長さ-0 Unicode 文字 ( UTF-8 ) (タグ値は空にすることができます)
• 値の最大長- UTF-8 では 256 文字の Unicode 文字
• 最大値バイト・サイズ-512 バイト
• タグ・キーと値は、US 英数字 (a-z、A-Z、0-9)、および UTF-8で表現可能なスペースと、記号 _、 .、 *、 '、 -、 : で構成されます。
• タグのキーと値には大/小文字の区別があります
• ibm: をタグのキー接頭部として使用することはできません

前述のように、インスタンスにログインし、「タグ付け」するバケットとオブジェクトにナビゲートします。 「タグの管理」を選択すると表示されるパネルで、「タグの追加 +」ボタンをクリックして開始します。 その後、必要に応じて key フィールドと value フィールドにテキストを入力することで、タグを追加できます。 完了したばかりのステップを繰り返すことにより、一度に 1 つずつタグを追加します。

変更の完了時に「保存」をクリックしないと、ダイアログ・ボックスに結果が表示されます。 つまり、変更は保存されない限り破棄されます。

前述のように、データにタグを追加するには、認証を受ける必要があります。 ベアラー・トークンについて質問がある場合は、 この例 を参照してください。 ここでも、タグを処理するための照会ストリング ?tagging に注意してください。

curl -X "PUT" 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \
-H "content-type: text/plain" \
--data "<Tagging><TagSet><Tag><Key>your key</Key><Value>your text</Value></Tag></TagSet></Tagging>"

この例では、要求の本体でデータとして送信される XML 内の key が「source」、 value が「text」であるタグについて説明します。 XML の スキーマ は、実行時に妥当性検査を行う必要があります。 複数のタグを追加する場合は、「タグ」ノードを複製し、各キーおよび値エレメントの内容を仕様に合わせて変更します。 オブジェクトごとに 1 つの「TagSet」エレメントのみが存在し、「PUT」コマンドは既存のメタデータを指定された値に置き換えます。

curl -X "PUT" "https://s3.test.cloud-object-storage.sample.appdomain.cloud/taggingtest/example-file.csv?tagging" -H "Authorization: bearer ...iOiIyMDIwMTIwNzE0NDkiLCJh..." -H "ibm-service-instance-id: 7nnnnn52-2nn0-nna9-bann-7nnnnn4cc4e7" --data "<Tagging><TagSet><Tag><Key>source</Key><Value>text</Value></Tag></TagSet></Tagging>"

タグの編集

オブジェクトがタグ付けされると、時間の経過とともにそれらの変更が必要になる場合があります。

グラフィック・インターフェースを使用してタグを編集するには、前述のように、コンソールにログインしてオブジェクトにアクセスする必要があります。 「タグの管理」オプションをクリックしたら、フォーム・フィールドの内容を変更するだけです。 完了したら、必ず「保存」を押してください。

データにタグを付けるには、要求を認証する必要があります。 また、新しい情報でオブジェクトを更新する際には、古いタグをプログラムで保持する必要があります。 示されている例では、新しいタグを追加しながら、前の例のタグを繰り返します。

タグを含む「PUT」操作を実行すると、現在のタグが上書きされることに注意してください。

curl -X "PUT" 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \
-H "content-type: text/plain" \
--data "<Tagging><TagSet><Tag><Key>source</Key><Value>text</Value></Tag><Tag><Key>source1</Key><Value>text1</Value></Tag></TagSet></Tagging>"

タグの削除

オブジェクトにタグを追加した後、それらを削除することが必要になる場合があります。

グラフィック・インターフェースを使用してタグを削除するには、前述のように、コンソールにログインしてオブジェクトにアクセスする必要があります。 再度、「タグの管理」オプションをクリックし、表示されるパネルで、タグと同じ行にある「ごみ箱」アイコンをクリックして、「すべて削除」するか、一度に 1 つのタグを削除するかを選択します。

完了したら、必ず「保存」を押してください。

データからタグを削除するには、認証を受ける必要があります。 単に、 ?tagging 照会パラメーターを指定した「DELETE」HTTP メソッドを使用して、すべてのタグを削除します。 1 つ以上のタグを同時に保持しながら 1 つ以上のタグを削除する場合は、「編集」手順を使用して変更を行います。

curl -X "DELETE" 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \
-H "content-type: text/plain"