リソース・タグの操作

リソースのタグ付けにより、リソースの特性を識別し、同じポリシーをリソースのグループに適用できます。ポリシーの詳細は、「条件での定義済タグの使用」を参照してください。

次の要件に注意してください。

リソースのタグを適用、変更または削除するには、リソースを更新する権限が必要です。
リソースに定義されたタグを適用、変更または削除するには、タグ・ネームスペースに対するuseアクセス権も必要です。
リソースには、最大64個の定義済タグと10個のフリー・フォーム・タグを含めることができます。

リソース作成時のタグの追加

コンパートメントに定義されているタグのデフォルトはすべて、タグのデフォルトが定義された後に、そのコンパートメントまたはそのコンパートメントのすべての子コンパートメントで作成されたすべてのリソースに自動的に追加されます。タグのデフォルトでは、リソースを作成するためにタグの値を入力する必要があります。「タグのデフォルトの構成」を参照してください。

「コンピュートWeb UI」の使用

リソースの作成ダイアログで、タグ付けセクションまでスクロールします。
タグ・ネームスペースを選択するか、なし(フリー・フォーム・タグの適用)を選択します。
- タグ・ネームスペースを選択した場合は、タグ・キーを選択し、値を入力するか、リストから値を選択します。
- なし(フリー・フォーム・タグの適用)を選択した場合は、タグ・キーを入力し、値を入力します。
別のタグを適用するには、追加タグ・ボタンをクリックします。

同じタグ・ネームスペース、定義済のタグに同じタグ・キー、またはフリー・フォーム・タグに同じタグ・キーを持つ複数のタグを指定することはできません。
リソースのタグを確認するには、新しいリソースの詳細ページに移動します。

リソース詳細ページで、タグ・タブをクリックして、このリソースに適用されるタグを表示します。

OCI CLIの使用

リソースの作成時にリソースにタグを追加するには、リソースcreateまたはlaunchコマンドを使用します。

リソースに追加する各タグの情報を取得します。
- リソースに追加する定義済タグごとに、ネームスペース、キーおよび値を取得します。
  
  --defined-tagsオプションの引数を作成します。各タグ・ネームスペースとタグ・キーのペアは1回のみ指定します。
- リソースに追加するフリー・フォーム・タグのキーと値を取得します。
  
  --freeform-tagsオプションの引数を作成します。各タグ・キーは1回のみ指定します。
--defined-tagsオプション引数と--freeform-tagsオプション引数の値は、タグのJSON定義です。このJSON定義は、コマンドラインまたはファイルで文字列として指定できます。

リソースへのタグ付けに使用するベース・コマンドとともに--generate-param-json-inputオプションを使用して、指定する正しいJSONのテンプレートを生成できます。 --generate-param-json-inputオプションの引数は、次の例に示すように、オプション・インジケータ(--)なしでタグ(この例では--defined-tags)を指定するために使用するオプションの名前です:
```
$ oci service resource create \
--generate-param-json-input defined-tags > defined_tags.json
```
出力defined_tags.jsonファイルの内容は、次のとおりです:
```
{
  "tagNamespace1": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "tagNamespace2": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  }
}
```
前述のコマンドでdefined-tagsのかわりにfreeform-tagsを指定すると、次の出力が表示されます:
```
{
  "tagKey1": "tagValue1",
  "tagKey2": "tagValue2"
}
```
これらのテンプレートを編集して、目的のタグを指定します。次のステップに示すように、最終コマンドの結果を指定します。
リソース作成または起動コマンドを実行します。

定義済タグを1つ以上追加する場合は、--defined-tagsオプションを使用します。フリー・フォーム・タグを1つ以上追加する場合は、--freeform-tagsオプションを使用します。

構文:
```
oci service resource create --compartment-id compartment_OCID \
--defined-tags defined_tags_json --freeform-tags freeform_tags_json \
other_resource_create_options
```
例:

次の例では、ファイルを使用して1つ以上の定義済タグを追加し、文字列引数を使用してフリー・フォーム・タグを追加します。 file://構文を使用して、ファイルをオプション引数として指定します。
```
$ oci service resource create --compartment-id ocid1.compartment.unique_ID \
--defined-tags file://defined_tags.json --freeform-tags '{"MyTag":"val-u"}' \
other_resource_create_options
```
リソースcreateまたはlaunchコマンドの出力は、リソースgetコマンドの出力と同じです。出力には、定義済のフリー・フォーム・タグが表示されます。

既存のリソースへのタグの適用

「コンピュートWeb UI」の使用

リソースの編集ダイアログで、タグ付けセクションまでスクロールします。

タグを追加することも、すでに存在するタグを変更または削除することもできます。
タグを追加するには、必要に応じて追加タグ・ボタンをクリックし、タグ・ネームスペースを選択するか、なし(フリー・フォーム・タグの適用)を選択します。
- タグ・ネームスペースを選択した場合は、タグ・キーを選択し、値を入力するか、リストから値を選択します。
- なし(フリー・フォーム・タグの適用)を選択した場合は、タグ・キーを入力し、値を入力します。
同じタグ・ネームスペース、定義済のタグに同じタグ・キー、またはフリー・フォーム・タグに同じタグ・キーを持つ複数のタグを指定することはできません。
既存のタグを変更するには、選択を変更するか、別の値を入力します。
タグを削除するには、ごみ箱をクリックします。
タグの追加と変更が終了したら、Save Changesをクリックします。
リソースのタグを確認するには、リソースの詳細ページに移動します。

リソース詳細ページで、タグ・タブをクリックして、このリソースに適用されるタグのリストを表示します。

OCI CLIの使用

既存のリソースにタグを追加し、すでに存在するタグを変更または削除するには、リソースupdateコマンドを使用します。

リソースに追加する各タグのネームスペース、キーおよび値の情報を取得します。
適用するタグのJSON定義を作成します。正しいJSONの作成方法の詳細は、「リソース作成時のタグの追加」を参照してください。

ノート:

このリソースにすでに存在する定義済タグは、--defined-tags引数で置き換えられます。このリソースにすでに存在するフリー・フォーム・タグは、--freeform-tags引数に置き換えられます。これらのオプションの新しい引数に保持する既存のタグを必ず含めてください。

リソースgetコマンドを使用して、現在定義されているタグとフリー・フォーム・タグを表示します。
リソース更新コマンドを実行します。

定義済タグを1つ以上適用する場合は、--defined-tagsオプションを使用します。 1つ以上のフリー・フォーム・タグを適用する場合は、--freeform-tagsオプションを使用します。

リソースupdateコマンドの出力は、リソースgetコマンドの出力と同じです。出力には、定義済のフリー・フォーム・タグが表示されます。

タグによるリソース・リストのフィルタリング

「コンピュートWeb UI」の使用

リソースのリストを表示します。
Filter by Tagで、Select Tagをクリックします。
タグによるフィルタ・ダイアログで次を実行します:
1. 定義済タグまたはフリー・フォーム・タグのいずれかを選択します。
  - 定義済タグを選択した場合は、タグ・ネームスペースとタグ・キーを選択します。
  - フリー・フォーム・タグを選択した場合は、タグ・キーを入力します。
2. オプションで、値の選択(オプション)フィールドに値を入力します。
  - 値の選択(オプション)フィールドは空白のままにします。このオプションは、タグ値に関係なく、選択したネームスペースおよびキーでタグ付けされたすべてのリソース(定義済タグの場合)を返すか、指定したキーでタグ付けされているすべてのリソース(フリー・フォーム・タグの場合)を返します。
  - 値の選択(オプション)フィールドに値を入力します。このオプションは、入力したいずれかのタグ値でタグ付けされたすべてのリソースを返します。値を選択するか、テキスト・ボックスに1つの値を入力します。同じネームスペースおよびキーに複数の値を指定するには、EnterまたはReturnを入力し、新しい値を入力します。各値がテキスト・ボックスの下に表示されます。
3. Filter by Tagをクリックします。
  
  現在適用されているフィルタは、タグの選択ボタンに表示されます。
複数のタグでフィルタするには、タグの選択ボタンの+をクリックし、前のステップを繰り返します。
フィルタを削除するには、タグの選択ボタンをクリックします。

OCI CLIの使用

リソースに対してlistコマンドを使用して、指定したコンパートメント内の各リソースを表示します。

各リソースの情報には、既存の定義済タグおよびフリー・フォーム・タグが表示されます。
オペレーティング・システムのツールを使用してリストをフィルタします。