タグ管理機能

タグ定義の廃止と再アクティブ化

タグ・キー定義またはタグ・ネームスペース定義を廃止できます。

タグ・キー定義をリタイアすると、リソースに適用できなくなります。ただし、タグは適用されたリソースから削除されません。タグは、これらのリソースにメタデータとして存在し、検索、リスト、ソート、レポートなどの操作で廃止されたタグをコールできます。

廃止されたタグ・キー定義およびタグ・ネームスペース定義を再アクティブ化できます。

タグ・キーを再アクティブ化すると、リソースへの適用が再度可能になります。
タグ・ネームスペースを再アクティブ化すると、そのネームスペースに新しいタグ・キー定義を作成できます。ただし、ネームスペースで廃止されたタグ・キー定義を使用する場合は、各タグ・キー定義を明示的に再アクティブ化する必要があります。

タグ・ネームスペースの移動

タグ・ネームスペースを別のコンパートメントに移動できます。タグ・ネームスペースは、移動するときにアクティブまたはリタイアできます。タグ・ネームスペースを移動すると、そのタグ・キー定義がすべて移動されます。

この機能は、コンパートメント階層を再編成する必要がある場合や、廃止されたタグ・ネームスペースを含むコンパートメントを削除する必要がある場合に便利です。リソースを含むコンパートメントは削除できません。廃止されたタグ・ネームスペースは、廃止されても既存のリソースです。廃止されたタグ・ネームスペースを別のコンパートメントに移動すると、元の包含コンパートメントを削除できます。

タグ・ネームスペースを移動するには、両方のコンパートメントでmanage tag-namespacesを許可する必要があります。

タグ定義の削除

タグ・キー定義およびタグ・ネームスペースを削除できます。

タグ・キー定義を削除すると、テナンシ内のすべてのリソースからタグを削除するプロセスが開始されます。削除アクションは非同期であり、作業リクエストを開始します。削除操作を開始すると、タグの状態が削除に変更され、リソースからのタグの削除が開始されます。このプロセスは、タグ付けされたリソースの数によっては数時間かかる場合があります。すべてのタグが削除されると、状態は削除済に変わります。削除されたタグはリストアできません。タグの状態が「削除済」に変わったら、同じタグ名を再度使用できます。

タグ・キー定義を削除するには、まずこれを廃止する必要があります。タグ・ネームスペースを削除するには、まずタグ・ネームスペースを廃止する必要があります。タグ・キー定義を含むタグ・ネームスペースを廃止すると、ネームスペース内のすべてのタグ・キーが廃止され、タグ・キーを削除できます。タグ・ネームスペースを削除できるのは、そのすべてのタグ・キー定義が削除された後のみです。

事前定義済の値の使用

値リストを作成し、そのリストをタグ・キー定義に関連付けることができます。ユーザーがそのタグをリソースに適用する場合、事前定義済の値のリストから値を選択する必要があります。事前定義済の値リストを使用して、ユーザーがタグに適用できる値に制限を適用します。

OCI CLIおよび「コンピュートAPI」では、事前定義された値は「バリデータ」と呼ばれます。バリデータは定義済タグのパラメータで、JSON形式で事前定義済の値を指定するために使用されます。「コンピュートWeb UI」には「バリデータ」という語は記載されていませんが、同じ原則に従います。

既存のタグを更新して、事前定義済の値を使用できます。作成する事前定義済の値のすべてのリストには、少なくとも1つの値が含まれている必要があります。リストに重複する値または空白のエントリを含めることはできません。事前定義済の値では、タグを適用するユーザーは、タグの値をnullに設定できません。

定義済タグとデフォルト・タグで事前定義値を使用できます。デフォルト・タグと組み合せて、ユーザーは、デフォルト・タグが使用されるコンパートメント内に作成する各リソースの事前定義済リストからタグ値を選択する必要があります。これにより、新しいリソースに期待される値を持つメタデータが含まれ、信頼できます。

タグ変数の使用

変数を使用して、定義されたタグの値を設定できます。ユーザーがリソースにタグを追加すると、変数はそれが表すデータに解決されます。定義済タグおよびデフォルト・タグでタグ変数を使用できます。

次のケースについて検討します。

Operations.CostCenter="${iam.principal.name} at ${oci.datetime}"

操作はネームスペース、CostCenterはタグ・キー、タグ値には2つのタグ変数${iam.principal.name}と${oci.datetime}が含まれます。このタグをリソースに追加すると、変数はユーザー名に解決されます - タグを適用したプリンシパルの名前 - タグを追加したときのタイムスタンプ。

user-name at 2021-04-18T14:32:57.604Z

変数は、タグが特定のリソースに適用される時点でデータに置き換えられます。後でタグを編集した場合、変数は失われ、データのみが残ります。他のタグ値を編集するすべての方法で、タグ値を編集できます。

タグ変数を作成するには、特定の書式を使用する必要があります。次のタグ変数がサポートされています:

変数	説明
`${iam.principal.name}`	リソースにタグを適用するプリンシパルの名前。
`${iam.principal.type}`	リソースにタグを適用するプリンシパルのタイプ。
`${oci.datetime}`	タグが作成された日時。