3 リソース・タグ管理
Oracle Private Cloud Applianceタグ付けでは、定義済タグまたはフリー・フォーム・タグと呼ばれるキー/バリューのペアを適用して、メタデータをリソースに追加できます。 タグ付けされたコンパートメント内の新しく作成されたすべてのリソースに自動的に適用されるタグであるコンパートメントにタグのデフォルトを作成できます。 タグの使用法は次のとおりです:
-
リソースへのアクセス・ポリシーの適用。 たとえば、リソース・アクセス・ポリシーを直接変更するのではなく、リソースのタグ値を変更することによって、リソースの所有権を別の製品グループに変更できます。 「条件での定義済タグの使用」を参照してください)。
-
「コンピュートWeb UI」内のリソース・リストのフィルタリング。
概念の詳細は、「Oracle Private Cloud Appliance概要ガイド」の「Identity and Access Management概要」にある「タグ付けの概要」および「ポリシーの仕組み」を参照してください。
タグ・ネームスペースの作成と管理
タグ・ネームスペースを使用すると、関連するタグのコレクションを作成できます。 タグ・ネームスペースを作成した後、そのタグ・ネームスペース内にタグ・キー定義を作成します。 「タグ・キー定義の作成と管理」を参照してください。 ユーザーが定義済タグをリソースに適用するには、タグ・キー定義を含むタグ・ネームスペースがテナンシに存在する必要があります。
タグ・ネームスペースの作成
テナンシには、最大100個のタグ・ネームスペースを含めることができます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・ネームスペースのリストの上で、ネームスペース定義の作成ボタンをクリックします。
-
ネームスペース定義の作成ウィンドウで、次の情報を入力します:
-
コンパートメントに作成: ネームスペース定義を作成するコンパートメント。
-
ネームスペース定義名: このタグ・ネームスペースの名前。 タグ・ネームスペース名には次の特性があります:
-
テナンシ内で一意である必要があります。
-
大文字と小文字は区別されません。
-
後で変更できません。
-
100文字以下にしてください。
-
ピリオド(.)または空白文字を含めることはできません。
-
-
摘要: このタグ・セットの説明。 この説明は256文字以下にしてください。
-
タグ付け: (オプション) リソース作成時のタグの追加の説明に従って、このタグ・ネームスペースの定義済タグまたはフリー・フォーム・タグを追加します。 タグは後で適用することもできます。
-
-
ネームスペース定義の作成をクリックします。
新しいタグ・ネームスペース定義が「タグ・ネームスペース」ページに表示されます。
OCI CLIの使用
-
タグ・ネームスペースを作成するコンパートメントのOCIDを取得します。
$ oci iam compartment list --compartment-id-in-subtree true
-
タグ・ネームスペースcreateコマンドを実行します。
構文:
oci iam tag-namespace create --compartment-id compartment_OCID --name tag_namespace_name \ --description "text"
「リソース作成時のタグの追加」で説明されているオプションを追加することで、作成時に新しいタグ・ネームスペースにタグ付けできます。
例:
$ oci iam tag-namespace create --compartment-id ocid1.compartment.unique_ID --name Products \ --description "Identify resources used in product development."
このコマンドは、
tag-namespace get
コマンドと同じ出力を返します。
タグ・ネームスペースの更新
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
変更するタグ・ネームスペースがリストされていない場合は、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
変更するネームスペースについて、アクション・メニューをクリックし、編集オプションをクリックします。
「編集」ダイアログが表示されます。
-
タグ・ネームスペースを更新します。
タグ・ネームスペースの説明を変更したり、タグ・ネームスペースのタグを追加または変更できます。
-
タグ・ネームスペースの更新をクリックします。
OCI CLIの使用
-
タグ・ネームスペースOCIDを取得します。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・ネームスペース更新コマンドを実行します。
構文:
oci iam tag-namespace update --tag-namespace-id tag_namespace_OCID --description "text"
タグ・ネームスペースでタグを追加または変更するには、「既存のリソースへのタグの適用」で説明されているオプションを追加します。
例:
$ oci iam tag-namespace update --tag-namespace-id ocid1.tagnamespace.unique_ID \ --description "Identify resources used to develop different products."
このコマンドは、
tag-namespace get
コマンドと同じ出力を返します。
タグ・ネームスペースの廃止
タグ・ネームスペースを廃止すると、そのタグ・ネームスペース内のすべてのタグ・キー定義およびタグは廃止され、そのタグ・ネームスペースに新しいタグ・キー定義を作成することはできません。 廃止されたタグはリソースに適用できません。 ただし、廃止されたタグは、すでに適用されたリソースに適用されたままであり、リスト、ソート、フィルタリングなどの操作でも使用できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
廃止するタグ・ネームスペースがリストされていない場合は、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
廃止するタグ・ネームスペースについて、アクション・メニューをクリックし、廃止オプションをクリックします。
-
タグ・ネームスペースの廃止確認プロンプトで、確認をクリックします。
タグ・ネームスペースの状態が非アクティブに変わります。 タグ・ネームスペースの詳細ページでは、タグ・キー定義も非アクティブ状態になります。
OCI CLIの使用
-
タグ・ネームスペースOCIDを取得します。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・ネームスペースのretireコマンドを実行します。
構文:
oci iam tag-namespace retire --tag-namespace-id tag_namespace_OCID
このコマンドは、
tag-namespace get
コマンドと同じ出力を返します。
タグ・ネームスペースの再アクティブ化
廃止されたタグ・ネームスペースを再アクティブ化できます。 タグ・ネームスペースを再アクティブ化すると、そのタグ・ネームスペースに新しいタグ・キー定義を作成できます。
廃止されたタグ・ネームスペースを再アクティブ化すると、タグ・キー定義およびタグが再アクティブ化されません。 ネームスペースで廃止されたタグ・キー定義を使用するには、各タグ・キー定義を明示的に再アクティブ化する必要があります。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
再アクティブ化するタグ・ネームスペースがリストされていない場合は、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
再アクティブ化するタグ・ネームスペースについて、アクション・メニューをクリックし、再アクティブ化オプションをクリックします。
-
タグ・ネームスペースの再アクティブ化確認プロンプトで、確認をクリックします。
タグ・ネームスペースの状態がアクティブに変わります。 タグ・ネームスペースの詳細ページでは、タグ・キー定義は非アクティブのまま表示されます。
OCI CLIの使用
-
タグ・ネームスペースOCIDを取得します。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・ネームスペース再アクティブ化コマンドを実行します。
構文:
oci iam tag-namespace reactivate --tag-namespace-id tag_namespace_OCID
このコマンドは、
tag-namespace get
コマンドと同じ出力を返します。
別のコンパートメントへのタグ・ネームスペースの移動
アクティブまたはリタイアしたタグ・ネームスペースとそのタグ・キー定義を同じテナンシ内の別のコンパートメントに移動できます。
タグ・ネームスペースを移動するには、両方のコンパートメントでmanage tag-namespaces
アクセス権が付与されている必要があります。
タグ・ネームスペースを移動するには、OCI CLIを使用する必要があります。
OCI CLIの使用
-
次の情報を取得します:
-
タグ・ネームスペースを移動するコンパートメントのOCID。
$ oci iam compartment list --compartment-id-in-subtree true
-
タグ・ネームスペースOCID。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
-
タグ・ネームスペースのmoveコマンドを実行します。
構文:
oci iam tag-namespace change-compartment --compartment-id destination_compartment_OCID \ --tag-namespace-id tag_namespace_OCID
tag-namespace get
コマンドを使用して、新しいcompartment-id
を確認します。
タグ・ネームスペースの削除
タグ・ネームスペースを削除する前に、廃止する必要があります。 「タグ・ネームスペースの廃止」を参照してください。
タグ・ネームスペースを削除するには、そのネームスペース内のすべてのタグ・キー定義を削除する必要があります。 「タグ・キー定義の削除」を参照してください。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
削除するタグ・ネームスペースがリストされていない場合は、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
削除するタグ・ネームスペースが(非アクティブな状態で)廃止されていることを確認します。
-
削除するタグ・ネームスペースの名前をクリックします。
-
タグ・ネームスペースの詳細ページのリソース・ボックスで、タグ・キー定義をクリックします。
-
すべてのタグ・キー定義が削除されていることを確認します。
-
詳細ページの上部にあるControls(管理)メニューで、Delete(削除)オプションをクリックします。
-
タグ・ネームスペースの削除確認プロンプトで、確認をクリックします。
タグ・ネームスペースはタグ・ネームスペース・リストから削除され、そのタグ・ネームスペースのタグはリソースから削除されます。
OCI CLIの使用
-
タグ・ネームスペースOCIDを取得します。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
削除するタグ・ネームスペースが(非アクティブな状態で)廃止されていることを確認します。
$ oci iam tag-namespace get --tag-namespace-id tag_namespace_OCID
-
このタグ・ネームスペースのすべてのタグ・キー定義が削除されていることを確認します。
$ oci iam tag list --tag-namespace-id tag_namespace_OCID
-
タグ・ネームスペースの削除コマンドを実行します。
構文:
oci iam tag-namespace delete --tag-namespace-id tag_namespace_OCID
例:
$ oci iam tag-namespace delete --tag-namespace-id ocid1.tagnamespace.unique_ID Are you sure you want to delete this resource? [y/N]: y { "opc-work-request-id": "ocid1.workrequest.unique_ID" }
タグ・ネームスペースの削除のステータスを確認するには、次のコマンドを使用します:
$ oci iam tagging-work-request get --work-request-id ocid1.workrequest.unique_ID
確認せずにタグ・ネームスペースを削除するには、
--force
オプションを使用します。
タグ・キー定義の作成と管理
タグ・ネームスペースにはタグ・キー定義が含まれます。 リソースに適用されるタグ・キー定義のインスタンスは、「定義済タグ」と呼ばれます。
タグ・キー定義には、タグ・キー名およびタグ値タイプが含まれます。 タグ・キー定義には、タグ値タイプに応じて値が含まれる場合があります。 タグ値タイプは、タグ・ユーザーが値を入力するか、リソースにタグを適用するときに事前定義済の値を選択します。
必要な権限を含むタグ・キー定義の詳細は、「Oracle Private Cloud Appliance概要ガイド」の「タグ付けの概要」を参照してください。
タグ・キー定義の作成
タグ・ネームスペース内にタグ・キー定義を作成します。 タグ・ネームスペースには、最大100個のタグ・キー定義を含めることができます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・キー定義を追加するタグ・ネームスペースがリストされていない場合、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
タグ・キー定義を追加するタグ・ネームスペースの名前をクリックします。
-
タグ・ネームスペースの詳細ページのリソース・ボックスで、タグ・キー定義をクリックします。
-
タグ・キー定義領域で、タグ・キー定義の作成ボタンをクリックします。
-
タグ・キー定義の作成ウィンドウで、次の情報を入力します:
-
名前: キー名。 タグ・キー名には次の特性があります:
-
名前空間内で一意である必要があります。
同じタグ・キー名は、異なるタグ・ネームスペースで使用できます。
-
大文字と小文字は区別されません。
-
後で変更できません。
-
100文字以下にしてください。
-
ピリオド(.)または空白文字を含めることはできません。
-
-
摘要: タグ・キー定義の説明。 この説明は256文字以下にしてください。
-
-
タグ値のタイプを選択します。
-
静的値: 移入されていません。 ユーザーは、タグがリソースに適用されるときに値を入力する必要があります。 これはデフォルト選択です。
-
値リスト: 事前定義済の値リスト。 少なくとも1つの値を入力してください ユーザーは、リソースに適用するこれらの事前定義値のいずれかを選択する必要があります。
複数の値は改行で区切ります 重複した値と空白行が無効です。 値は大/小文字が区別され、256文字以下にする必要があります。
値には、次のいずれかの変数を含めることができます:
-
${iam.principal.name}
-
リソースにタグ付けしたユーザーの名前。
-
${iam.principal.type}
-
リソースにタグ付けされたプリンシパルのタイプ。 次のいずれか: rootユーザー、IAMユーザーまたはインスタンス・プリンシパル。
-
${oci.datetime}
-
タグが作成された日時。
-
-
-
タグ・キー定義の作成をクリックします。
新しいタグ・キー定義が、タグ・ネームスペースの詳細ページに表示されます。
OCI CLIの使用
-
タグ・ネームスペースOCIDを取得します。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・キー定義createコマンドを実行します。
次のコマンドは、タグがリソースに適用されるときにユーザーがタグ値を入力する必要があるタグ・キー定義を作成します。
--validator
オプションを省略することは、「コンピュートWeb UI」で「静的値」値タイプを選択することと同等です。構文:
oci iam tag create --tag-namespace-id tag_namespace_OCID --name text --description "text"
例:
$ oci iam tag create --tag-namespace-id ocid1.tagnamespace.unique_ID --name VolumeType \ --description "Identify volumes by type"
次のコマンドは、タグの適用時にユーザーが選択する必要がある値のリストを含むタグ・キー定義を作成します。
構文:
oci iam tag create --tag-namespace-id tag_namespace_OCID --name text --description "text" \ --validator values
--validator
オプション引数の値は、タグ値のJSON定義です。 このJSON定義は、コマンドラインまたはファイルで文字列として指定できます。リソースへのタグ付けに使用するベース・コマンドとともに
--generate-param-json-input
オプションを使用して、指定する正しいJSONのテンプレートを生成できます。--generate-param-json-input
オプションの引数は、次の例に示すように、オプション・インジケータ(--
)なしでタグ値(--validator
)を指定するために使用するオプションの名前です:$ oci iam tag create --generate-param-json-input validator > volume_types.json
出力
volume_types.json
ファイルの内容は次のとおりです:{ "validatorType": "ENUM", "values": [ "string", "string" ] }
このテンプレートを編集して、新しいタグ値を指定します。
values
の値は、単一の文字列または文字列の配列です。validator-type
はENUM
である必要があります。 最終コマンドの--validator
オプションに結果を指定します。次の例では、タグ値がインラインJSON文字列で指定されています。
$ oci iam tag create --tag-namespace-id ocid1.tagnamespace.unique_ID --name VolumeType \ --description "Identify volumes by type" \ --validator '{"validator-type": "ENUM", "values": ["typeA","typeB","typeC"]}'
次の例では、変数値が含まれています:
$ oci iam tag create --tag-namespace-id ocid1.tagnamespace.unique_ID --name Product-XYZ \ --description "Identify resources assigned to XYZ development." \ --validator '{"validator-type": "ENUM", "values": ["Assigned by: ${iam.principal.name}"]}'
次の例では、タグ値がJSONファイルに指定されています。
file://
構文を使用して、ファイルをオプション引数として指定します。$ oci iam tag create --tag-namespace-id ocid1.tagnamespace.unique_ID --name VolumeType \ --validator file://volume_types.json
このコマンドは、
tag get
コマンドと同じ出力を返します。
タグ・キー定義の更新
タグ・キー定義の説明を更新し、タグ値のタイプと値を変更できます。 廃止されているタグ・キー定義は更新できません。
更新するタグ・キー定義の値が事前定義済リストである場合、タグのデフォルトの値である値を削除または変更することはできません。 タグのデフォルトの値であるタグ・キー定義値を削除または変更するには、まず、異なる値を使用するようにタグのデフォルトを更新します。 「タグのデフォルトの構成」を参照してください。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・キー定義を更新するタグ・ネームスペースがリストされていない場合、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
タグ・キー定義を更新するタグ・ネームスペースの名前をクリックします。
-
タグ・ネームスペースの詳細ページのリソース・ボックスで、タグ・キー定義をクリックします。
-
更新するタグ・キー定義について、アクション・メニューをクリックし、編集オプションをクリックします。
-
「タグ・キー定義の編集」ダイアログで、説明を変更したり、タグ値タイプを変更できます。 タイプに値リストを選択した場合は、値ボックスに少なくとも1つの値を追加する必要があります。 複数の値は改行で区切ります 重複した値と空白行が無効です。 値は大/小文字が区別され、256文字以下にする必要があります。
-
「変更の保存」をクリックします。
OCI CLIの使用
-
次の情報を取得します:
-
タグ・ネームスペースOCID。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・キーの名前。
$ oci iam tag list --tag-namespace-id tag_namespace_OCID
-
-
タグ・キー定義更新コマンドを実行します。
次のコマンドは、タグ・キーの説明のみを更新します。 値設定は同じままです。
構文:
oci iam tag update --tag-namespace-id tag_namespace_OCID --tag-name text --description "text"
例:
$ oci iam tag update --tag-namespace-id ocid1.tagnamespace.unique_ID --tag-name VolumeType \ --description "Identify the type of the volume."
次のコマンドは、値のみを更新します。
$ oci iam tag update --tag-namespace-id ocid1.tagnamespace.unique_ID --tag-name VolumeType \ --validator file://volume_types.json WARNING: Updates to freeform-tags and defined-tags and validator will replace any existing values. Are you sure you want to continue? [y/N]: y
volume_types.json
ファイルの内容については、「タグ・キー定義の作成」を参照してください。--validator
オプションに指定した値は、既存の値を置き換えます。 値を追加したり、値の一部のみを変更するには、この更新の完全なリストを指定します。次のコマンドは、値タイプを更新して、事前定義済の値リストから選択するのではなく値を入力できるようにします。
$ oci iam tag update --tag-namespace-id ocid1.tagnamespace.unique_ID --tag-name VolumeType \ --validator '{}'
このコマンドは、
tag get
コマンドと同じ出力を返します。
タグ・キー定義の廃止
タグ・キー定義をリタイアすると、このタグ・キー定義に基づくタグはリソースに適用できません。 このタグ・キー定義に基づく既存のタグのデフォルトは、新しく作成されたリソースに自動的に適用されません。 ただし、タグはすでに適用されているリソースからは削除されません。 タグは、これらのリソースのメタデータとして存在し、リスト、ソートおよびレポートなどの操作で廃止されたタグを使用できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・キー定義を廃止するタグ・ネームスペースがリストされていない場合は、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
タグ・キー定義をリタイアするタグ・ネームスペースの名前をクリックします。
-
タグ・ネームスペースの詳細ページのリソース・ボックスで、タグ・キー定義をクリックします。
-
廃止するタグ・キー定義について、アクション・メニューをクリックし、廃止オプションをクリックします。
-
Retire Tag Key Definition確認プロンプトで、Confirmをクリックします。
OCI CLIの使用
-
次の情報を取得します:
-
タグ・ネームスペースOCID。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・キーの名前。
$ oci iam tag list --tag-namespace-id tag_namespace_OCID
-
-
タグ・キー定義retireコマンドを実行します。
構文:
oci iam tag retire --tag-name text --tag-namespace-id tag_namespace_OCID
タグ・キー定義の再アクティブ化
タグ・キー定義を再アクティブ化すると、再度リソースに適用できるようになります。 親タグ・ネームスペースが廃止されている場合、タグ・キー定義を再アクティブ化することはできません。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・キー定義を再アクティブ化するタグ・ネームスペースがリストされていない場合、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
タグ・キー定義を再アクティブ化するタグ・ネームスペースの名前をクリックします。
-
タグ・ネームスペースの詳細ページのリソース・ボックスで、タグ・キー定義をクリックします。
-
再アクティブ化するタグ・キー定義について、アクション・メニューをクリックし、再アクティブ化オプションをクリックします。
-
タグ・ネームスペースの再アクティブ化確認プロンプトで、確認をクリックします。
OCI CLIの使用
-
次の情報を取得します:
-
タグ・ネームスペースOCID。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・キーの名前。
$ oci iam tag list --tag-namespace-id tag_namespace_OCID
-
-
タグ・キー定義reactivateコマンドを実行します。
構文:
oci iam tag reactivate --tag-name text --tag-namespace-id tag_namespace_OCID
タグ・キー定義の削除
タグ・キー定義は、削除する前に廃止する必要があります。 「タグ・キー定義の廃止」を参照してください。
タグ・キー定義を削除すると、このタグ・キー定義に基づくタグがすべてのリソースから削除されます。 このタグ・キー定義に基づくタグのデフォルトは、コンパートメントから削除されません。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・キー定義を削除するタグ・ネームスペースがリストされていない場合は、タグ・ネームスペース・リストの上にあるコンパートメント・ドロップ・ダウン・メニューを使用して、正しいコンパートメントを選択します。
-
タグ・キー定義を削除するタグ・ネームスペースの名前をクリックします。
-
タグ・ネームスペースの詳細ページのリソース・ボックスで、タグ・キー定義をクリックします。
-
削除するタグ・キー定義が廃止されていることを確認します(状態が無効です)。
-
削除するタグ・キー定義について、アクション・メニューをクリックし、削除オプションをクリックします。
削除されたタグ・キー定義はリストアできません。
-
Delete Tag Key Definitionプロンプトで、Confirmをクリックします。
タグ・キー定義ステータスが削除中に変わり、このタグ・キー定義に基づくすべてのタグがリソースから削除されます。
タグの削除プロセスが完了すると、タグ・キー定義ステータスが削除済に変わります。 削除されたタグ・キー定義と同じ名前で、新しいタグ・キー定義を作成できます。
OCI CLIの使用
-
次の情報を取得します:
-
タグ・ネームスペースOCID。
$ oci iam tag-namespace list --compartment-id compartment_OCID
-
タグ・キーの名前。
$ oci iam tag list --tag-namespace-id tag_namespace_OCID
-
-
削除するタグ・キー定義が廃止されていることを確認します(状態が無効です)。
$ oci iam tag get --tag-namespace-id tag_namespace_OCID
-
タグ・キー定義削除コマンドを実行します。
構文:
oci iam tag delete --tag-name text --tag-namespace-id tag_namespace_OCID
例:
$ oci iam tag delete --tag-name volume-types --tag-namespace-id ocid1.tagnamespace.unique_ID Are you sure you want to delete this resource? [y/N]: y { "opc-work-request-id": "ocid1.workrequest.unique_ID" }
タグの削除のステータスを確認するには、次のコマンドを使用します:
$ oci iam tagging-work-request get --work-request-id ocid1.workrequest.unique_ID
確認せずにタグ・キー定義を削除するには、
--force
オプションを使用します。
タグのデフォルトの構成
タグのデフォルトは、指定されたコンパートメントに作成されるリソースに自動的に適用される定義済タグです。
タグのデフォルトには次の特性があります:
-
タグのデフォルトは、そのコンパートメントで作成されたすべての新しいリソース(子コンパートメントなど)に適用されます。
-
タグのデフォルトは、タグのデフォルトの作成前にすでに存在するリソースには適用されません。
-
リソースを作成または編集してタグのデフォルトを変更することはできません。 タグ・ネームスペースを使用する権限により、リソースの作成または変更時にタグの値を変更できます。 コンパートメント内のすべての新しいリソースに適用されるタグのデフォルトを変更するには、コンパートメント上のタグのデフォルトを更新する必要があります。
-
タグのデフォルトの値を変更しても、そのタグのデフォルトがリソース上で既存の出現しても更新されません。
-
値が定義済リストであるタグ・キー定義の値を変更した場合、またはタグ・キー定義を削除した場合、そのタグ・キー定義に基づくタグ・デフォルトが既存の出現しても更新されません。 タグのデフォルト値は個別に更新する必要があります。
タグ・キー定義の廃止または削除のタグのデフォルトへの影響については、「タグ・キー定義の作成と管理」を参照してください。 タグのデフォルトの詳細は、「Oracle Private Cloud Appliance概要ガイド」の「タグ付けの概要」の"Tag Defaults"を参照してください。
タグのデフォルトの作成
タグのデフォルトを作成するには、コンパートメント、タグ・キー定義および値を指定します。 選択したタグ・キー定義の値が「静的値」の場合、タグのデフォルトの値として「ユーザー定義値」を選択できます。
コンパートメントには、最大5つのタグのデフォルトを設定できます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、アイデンティティ、コンパートメントの順にクリックします。
-
タグのデフォルトを追加するコンパートメントがリストされていない場合は、正しいコンパートメントに移動します。
最上位の親コンパートメントの名前をクリックし、コンパートメントの詳細ページで子コンパートメント・ボックスにスクロールします。 必要に応じて、別のコンパートメントの名前をクリックして、それらの子コンパートメントを表示します。
-
タグのデフォルトを追加するコンパートメントの名前をクリックします。
-
コンパートメントの詳細ページのリソース・セクションで、タグのデフォルトをクリックします。
このコンパートメントにすでに存在するタグのデフォルトが4つ以下であることを確認してください。
-
タグのデフォルトの作成ボタンをクリックします。
-
「タグのデフォルト」ダイアログで、タグ・ネームスペースとタグ・キーを選択します。
-
必須タグ値オプションで、次のいずれかの値タイプを選択します:
-
デフォルト値: このタグのデフォルトの値を入力します。 選択したタグ・キーの値リストが定義されている場合、この「デフォルト値」はそのリストのメンバーである必要があります。
-
ユーザー定義値: ユーザーは、リソースの作成時に値を入力する必要があります。 選択したタグ・キー定義に事前定義の値リストがある場合、「ユーザー定義値」の選択は無効です。
-
-
「送信」をクリックします。
新しいタグのデフォルトがコンパートメントの詳細ページに表示されます。
OCI CLIの使用
-
次の情報を取得します:
-
タグのデフォルトを作成するコンパートメントのOCID。
$ oci iam compartment list --compartment-id-in-subtree true
-
タグ・キー定義のOCID。
$ oci iam tag list --tag-namespace-id tag_namespace_OCID
-
-
このコンパートメントにすでに存在するタグのデフォルトが4つ以下であることを確認してください。
oci iam tag-default list --compartment-id compartment_OCID
-
タグのデフォルト作成コマンドを実行します。
構文:
oci iam tag-default create --compartment-id compartment_OCID \ --tag-definition-id tag_definition_OCID --value text
例:
$ oci iam tag-default create --compartment-id ocid1.compartment.unique_ID \ --tag-definition-id ocid1.tag.unique_ID --value 789
シェルによっては、ドル記号をエスケープして変数値を指定する必要がある場合があります:
$ oci iam tag-default create --compartment-id ocid1.compartment.unique_ID \ --tag-definition-id ocid1.tag.unique_ID --value "Assigned by: \${iam.principal.name}"
このコマンドは、
tag-default get
コマンドと同じ出力を返します。
例: Oracle-Tagsタグのデフォルトの作成
Oracle Cloud Infrastructureでは、すべてのリソースに、リソースを作成したユーザーの名前およびリソースが作成された時間でタグ付けされます。 この例では、Private Cloud Applianceで同じ結果を取得する方法を示します。
このタスクは、「コンピュートWeb UI」またはOCI CLIを使用して実行できます。 OCI CLIのみが表示されます。
OCI CLIの使用
-
Oracle-Tagsタグ・ネームスペースを作成します。
タグ・ネームスペースを作成するコンパートメントのOCIDを取得します。 この例の目的は、これらのタグのデフォルトが各コンパートメントのすべてのリソースに適用されることであるため、テナンシにタグ・ネームスペースを作成します。 次のコマンドを使用して、テナンシのOCIDを検索します:
$ oci iam compartment list --include-root
タグ・ネームスペースを作成します。
$ oci iam tag-namespace create -c ocid1.tenancy.unique_ID --name "Oracle-Tags" \ --description "OCI compatibility: add creator and create date of resource" { "data": { "compartment-id": "ocid1.tenancy.unique_ID", "defined-tags": {}, "description": "OCI compatibility: add creator and create date of resource", "freeform-tags": {}, "id": "ocid1.tag_namespace.unique_ID", "is-retired": false, "lifecycle-state": "ACTIVE", "name": "Oracle-Tags", "time-created": "2022-06-07T14:51:23.256790+00:00" }, "etag": "a000d250-3aea-4faf-b0e6-b6db486ffb42" }
-
Oracle-Tagsタグ・ネームスペースにCreatedByタグを作成します。
タグ・ネームスペースIDには、
tag-namespace create
コマンドのid
プロパティの値を使用します。--validator
オプションは必要ありません。$ oci iam tag create --tag-namespace-id ocid1.tag_namespace.unique_ID \ --name CreatedBy --description "user that created this resource" \ --validator '{"validator-type":"ENUM","values":["${iam.principal.name}"]}' { "data": { "compartment-id": "ocid1.tenancy.unique_ID", "defined-tags": {}, "description": "user that created this resource", "freeform-tags": {}, "id": "ocid1.tag.unique_ID", "is-cost-tracking": false, "is-retired": false, "lifecycle-state": "ACTIVE", "name": "CreatedBy", "tag-namespace-id": "ocid1.tag_namespace.unique_ID", "tag-namespace-name": "Oracle-Tags", "time-created": "2022-06-07T15:32:22.226554+00:00", "validator": { "validator-type": "ENUM", "values": [ "${iam.principal.name}" ] } }, "etag": "fa18d128-fc7b-420d-87d6-c44a574e522a" }
-
Oracle-Tagsタグ・ネームスペースにCreatedOnタグを作成します。
$ oci iam tag create --tag-namespace-id ocid1.tag_namespace.unique_ID \ --name CreatedOn --description "date this resource was created" \ --validator '{"validator-type":"ENUM","values":["${oci.datetime}"]}'
-
CreatedByタグのデフォルトを作成します。
このタグのデフォルトを任意のコンパートメントに作成されたすべての新規リソースに適用するには、テナンシにタグのデフォルトを作成します。
タグ定義IDには、ステップ2の
id
プロパティの値を使用します。--value
オプションは必須です。$ oci iam tag-default create -c ocid1.tenancy.unique_ID --tag-definition-id ocid1.tag.unique_ID --value "\${iam.principal.name}" { "data": { "compartment-id": "ocid1.tenancy.unique_ID", "id": "ocid1.tag_default.unique_ID", "is-required": null, "lifecycle-state": "ACTIVE", "tag-definition-id": "ocid1.tag.unique_ID", "tag-definition-name": "CreatedBy", "tag-namespace-id": "ocid1.tag_namespace.unique_ID", "time-created": null, "value": "${iam.principal.name}" }, "etag": "None" }
-
CreatedOnタグのデフォルトを作成します。
タグ定義IDには、ステップ3の
id
プロパティの値を使用します。$ oci iam tag-default create -c ocid1.tenancy.unique_ID --tag-definition-id ocid1.tag.unique_ID --value "\${oci.datetime}"
テナンシまたはテナンシの任意のサブコンパートメントに新しいリソースが作成されるたびに、リソースの作成時にタグが指定されていない場合でも、次のタグが適用されます:
"defined-tags": { "Oracle-Tags": { "CreatedBy": "flast", "CreatedOn": "2022-06-07T16:09:47.01Z" } }
タグのデフォルト値の更新
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、アイデンティティ、コンパートメントの順にクリックします。
-
タグのデフォルトを更新するコンパートメントがリストされていない場合は、正しいコンパートメントに移動します。
最上位の親コンパートメントの名前をクリックし、コンパートメントの詳細ページで子コンパートメント・ボックスにスクロールします。 必要に応じて、別のコンパートメントの名前をクリックして、それらの子コンパートメントを表示します。
-
値を変更するタグのデフォルトを持つコンパートメントの名前をクリックします。
-
コンパートメントの詳細ページのリソース・セクションで、タグのデフォルトをクリックします。
-
変更するタグのデフォルトについて、アクション・メニューをクリックし、編集オプションをクリックします。
-
「タグのデフォルト」ダイアログで、タグのデフォルトに設定する値のタイプを指定します:
-
デフォルト値: このタグのデフォルトの値を入力します。 選択したタグ・キーの値リストが定義されている場合、この「デフォルト値」はそのリストのメンバーである必要があります。
-
ユーザー定義値: ユーザーは、リソースの作成時に値を入力する必要があります。 選択したタグ・キー定義に事前定義の値リストがある場合、「ユーザー定義値」の選択は無効です。
-
-
「送信」をクリックします。
更新されたタグのデフォルトがコンパートメントの詳細ページに表示されます。
OCI CLIの使用
-
変更するタグのデフォルトOCIDを取得します。
$ oci iam tag-default list --compartment-id compartment_OCID
-
タグのデフォルト更新コマンドを実行します。
構文:
oci iam tag-default update --tag-default-id tag_default_OCID --value text
このコマンドは、
tag-default get
コマンドと同じ出力を返します。
タグのデフォルトの削除
コンパートメントからタグのデフォルトを削除しても、タグの既存のオカレンスはリソースから削除されません。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、アイデンティティ、コンパートメントの順にクリックします。
-
タグのデフォルトを削除するコンパートメントがリストされていない場合は、正しいコンパートメントに移動します。
最上位の親コンパートメントの名前をクリックし、コンパートメントの詳細ページで子コンパートメント・ボックスにスクロールします。 必要に応じて、別のコンパートメントの名前をクリックして、それらの子コンパートメントを表示します。
-
削除するタグのデフォルトを持つコンパートメントの名前をクリックします。
-
コンパートメントの詳細ページのリソース・セクションで、タグのデフォルトをクリックします。
-
削除するタグのデフォルトについて、アクション・メニューをクリックし、削除オプションをクリックします。
-
Delete Default Tag確認プロンプトで、Confirmをクリックします。
コンパートメントの詳細ページで、タグのデフォルトの状態は削除中です。
OCI CLIの使用
-
削除するタグのデフォルトOCIDを取得します。
$ oci iam tag-default list --compartment-id compartment_OCID
-
タグのデフォルト削除コマンドを実行します。
構文:
oci iam tag-default delete --tag-default-id tag_default_OCID
例:
$ oci iam tag-default delete --tag-default-id ocid1.tag-default.unique_ID Are you sure you want to delete this resource? [y/N]: y
確認せずにタグのデフォルトを削除するには、
--force
オプションを使用します。
リソース・タグの操作
リソースのタグ付けにより、リソースの特性を識別し、同じポリシーをリソースのグループに適用できます。 ポリシーの詳細は、「条件での定義済タグの使用」を参照してください。
次の要件に注意してください。
-
リソースのタグを適用、変更または削除するには、リソースを更新する権限が必要です。
-
リソースに定義されたタグを適用、変更または削除するには、タグ・ネームスペースに対する
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つの値を入力します。 同じネームスペースおよびキーに複数の値を指定するには、EnterまたはReturnを入力し、新しい値を入力します。 各値がテキスト・ボックスの下に表示されます。
-
-
Filter by Tagをクリックします。
現在適用されているフィルタは、タグの選択ボタンに表示されます。
-
-
複数のタグでフィルタするには、タグの選択ボタンの+をクリックし、前のステップを繰り返します。
-
フィルタを削除するには、タグの選択ボタンをクリックします。
OCI CLIの使用
-
リソースに対して
list
コマンドを使用して、指定したコンパートメント内の各リソースを表示します。各リソースの情報には、既存の定義済タグおよびフリー・フォーム・タグが表示されます。
-
オペレーティング・システムのツールを使用してリストをフィルタします。