タグ付けの概要

タグ付けサービスでは、リソースにタグを追加する2つの方法が提供されます。

それぞれの方法で、次のように操作できるタグのタイプが異なります。

• 定義済タグ - タグ管理者はリソース・メタデータを管理します。
• フリーフォーム・タグ - ユーザーによってリソースに適用される管理対象外メタデータ。

1つの方法では、ユーザーがリソースに適用するすべてのタグの作成と管理を管理者が行います。IAMポリシーを使用して、タグを作成できるタグ管理者を選択します。テナンシ内の他のすべてのユーザーには、タグを適用する権限のみを付与します。この方法の利点は、リソースのタグ付けに使用されるキーおよび値を作成して管理できることです。これにより、タグに基づいた自動化を損なう入力ミスを回避し、タグに基づいたレポートの品質を向上させることができます。

この他に、ユーザーがリソースにタグを追加する方法があります。各タグは、自分またはユーザーがリソースを作成または変更することによって、リソースで編集または適用されます。テナンシ全体で両方のタイプのタグを使用できます。

ほとんどのタグ付け機能には、定義済タグが必要です。「タグ」は、定義済のタグを参照するために一般的に使用されます。リソースの管理およびデータの収集のために信頼できるメタデータを作成するには、定義済のタグを使用します。定義済のタグを使用すると、次のシナリオが発生する可能性があります:

• コンパートメントのすべてのリソースに適用されるデフォルト・タグを作成します。タグのデフォルトの管理を参照してください。
• ユーザーがタグをリソースに適用して、リソースがコンパートメントに正常に作成されるように指定します。
• 定義済のタグを使用して入力ミスになった場合、タグを編集または削除して修正します。定義済のタグを削除すると、そのタグのキーとすべての値がすべてのリソースから削除されます。タグ・キー定義およびネームスペースの削除を参照してください。
• 定義済タグの事前定義済の値のリストを関連付けます。事前定義済の値の使用を参照してください。
• システム変数を使用して、定義済のタグまたはタグのデフォルトの値を自動的に生成します。タグ変数の使用を参照してください。
• タグに基づいてコストをトラッキングします。このユースケースでは、定義済タグの使用をお薦めします。

基本的なタグ付けの概念について説明します。

次に、基本的なタグ付けの概念のリストを示します。

タグ・ネームスペース

タグ・ネームスペースは、タグ・キーのコンテナと考えることができます。これは名前と、ゼロ個以上のタグ・キー定義で構成されます。タグ・ネームスペースでは大文字と小文字は区別されません。また、テナンシ全体で一意である必要があります。ネームスペースは、管理者がポリシーを適用できる自然なグループ化にもなります。タグ・ネームスペースに対する1つのポリシーは、そのネームスペースに含まれるすべてのタグ定義に適用されます。

ノート

• OCIDsはタグ・ネームスペースの命名に必要な形式に従わないため、OCIDを使用してタグ・ネームスペースに名前を付けることはできません。
• タグ・ネームスペースの名前は変更できません。ただし、廃止できます。

タグ・キー

タグを参照するために使用する名前。タグ・キーでは大文字と小文字は区別されません。たとえば、mytagkeyはMyTagKeyと重複します。ネームスペース内の定義済タグに対してタグ・キーを作成する必要があります。各タグ・キーはネームスペース内で一意である必要があります。

タグ値のタイプ

タグ値のタイプにより、その値に許可されるデータ・タイプが指定されます。現在、文字列と文字列のリストの2つのデータ・タイプがサポートされています。

キー定義

キー定義はタグのスキーマを定義し、ネームスペース、タグ・キーおよびタグ値のタイプを含みます。

ノート

タグ・キー定義の名前は変更できません。ただし、廃止できます。

タグ値

タグ値は、タグを適用するユーザーがタグ・キーに追加する値です。タグ値は、文字列と文字列のリストの2つのデータ・タイプをサポートしています。タグ・キーの定義時に選択するユーザーの値リストを定義することも、タグをリソースに適用する際にユーザーが任意の値を入力することもできます。キーの作成時に文字列タグの値を選択すると、ユーザーはそのキーを適用するときに値を空白のままにできます。

次の例では:

Operations.CostCenter="42"

Operationsはネームスペース、CostCenterはタグ・キー、42はタグ値です。

タグ(または定義済タグ)

タグとは、リソースに適用されるキー定義のインスタンスです。ネームスペース、キーおよび値で構成されます。「タグ」は、定義済のタグを参照するために一般的に使用されます。

フリーフォーム・タグ

キーと値のみで構成される基本的なメタデータ関連付け。フリーフォーム・タグの機能は制限されています。フリーフォーム・タグの理解を参照してください。

コスト・トラッキング

コスト・トラッキングは、定義済タグで使用できる機能です。いつタグをコスト・トラッキング・タグとして指定する必要があるかを理解するには、コスト・トラッキング・タグの使用を参照してください。

タグのデフォルト

タグのデフォルトを使用すると、リソースを作成するユーザーの権限に関係なく、作成時に特定のコンパートメント内のすべてのリソースに自動的に適用されるタグを指定できます。タグのデフォルトの管理を参照してください。

廃止

タグ・キー定義またはタグ・ネームスペースを廃止できます。廃止済のタグ・ネームスペースおよびキー定義は、リソースに適用できなくなりました。ただし、廃止済のタグは、そのタグがすでに適用されているリソースからは削除されません。検索、フィルタ処理、レポートなどのときに、廃止済のタグを引き続き指定できます。

再アクティブ化

テナンシの使用状況を回復するために廃止されたタグ・ネームスペースまたはタグ・キー定義を再アクティブ化できます。

タグ変数

変数を使用してタグの値を設定できます。リソースのタグを追加または更新すると、変数はそれが表すデータに解決されます。タグ変数の使用を参照してください。

事前定義済の値

変数を使用してタグの値を設定できます。リソースのタグを追加または更新すると、変数はそれが表すデータに解決されます。事前定義済の値の使用を参照してください。

タグの例

{
  "compartmentId": "ocid.compartment.oc1..exampleuniquecompartmentID",
  "namespace": "ansh8lvru1zp",
  "objectEventsEnabled": true,
  "name": "my-test-1",
  "freeformTags": {"Department": "Finance"},
  "definedTags":
  {
    "MyTags":
    {
      "CostCenter": "42",
      "Project": "Stealth",
      "CreatedBy": "BillSmith",
      "CreatedDate": "9/21/2017T14:00"
    },
    "Audit":
    {
      "DataSensitivity": "PII",
      "CageSecurity": "High",
      "Simplicity": "complex"
    }
  }
}

管理者の場合:次のトピックを使用して、タグ付けのIAMポリシーの例を検索します:

• 定義済タグの作業に必要な権限
• タグのデフォルトの作業に必要な権限
• フリーフォーム・タグの作業に必要な権限

タグ付けは、現在すべてのリージョンで使用可能です。

タグのリソースごとの制限と、タグ文字列でサポートされている文字について学習します。

• テナンシ当たりのタグ数: 無制限
• リソース当たりのタグ: 10個のフリーフォーム・タグと64個の定義済タグ
• コスト・トラッキングが有効なタグ: テナンシごとに10個(アクティブおよび廃止の両方のタグを含む)
• 合計タグ・データ・サイズ: 5K (JSON)。合計タグ・データ・サイズには、1つのリソース(適用されたすべてのタグとタグ値)のすべてのタグ・データが含まれます。サイズの決定にはUTF-8が使用されます。
• タグ・キーの事前定義済値の数: リストごとに100個

タグ付けでサポートされているリソースのリストを提供します。

次の表に、タグ付けがサポートされているリソースを示します。タグ付けサポートが他のリソースに追加されると、この表が更新されます。