タグ・ネームスペースの作成と管理
タグ・ネームスペースを使用すると、関連するタグのコレクションを作成できます。 タグ・ネームスペースを作成した後、そのタグ・ネームスペース内にタグ・キー定義を作成します。 「タグ・キー定義の作成と管理」を参照してください。 ユーザーが定義済タグをリソースに適用するには、タグ・キー定義を含むタグ・ネームスペースがテナンシに存在する必要があります。
タグ・ネームスペースの作成
テナンシには、最大100個のタグ・ネームスペースを含めることができます。
「コンピュートWeb UI」の使用
-
ナビゲーション・メニューで、ガバナンスをクリックし、タグ・ネームスペースをクリックします。
-
タグ・ネームスペースのリストの上で、ネームスペース定義の作成ボタンをクリックします。
-
ネームスペース定義の作成ウィンドウで、次の情報を入力します:
-
コンパートメントに作成: ネームスペース定義を作成するコンパートメント。
-
ネームスペース定義名: このタグ・ネームスペースの名前。 タグ・ネームスペース名には次の特性があります:
-
テナンシ内で一意である必要があります。
OraclePCAという名前は使用しないでください。 OraclePCAネームスペースは、予約されたネームスペースです。
-
大文字と小文字は区別されません。
-
後で変更できません。
-
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"
OraclePCAという名前は使用しないでください。 OraclePCAネームスペースは、予約されたネームスペースです。
次のコマンドを使用して、使用する名前がテナンシ内で一意であることを確認します:
$ oci iam tag-namespace list --compartment-id tenancy_OCID
「リソース作成時のタグの追加」で説明されているオプションを追加することで、作成時に新しいタグ・ネームスペースにタグ付けできます。
例:
$ oci iam tag-namespace create --compartment-id ocid1.compartment.unique_ID --name Products \ --description "Identify resources used in product development."
このコマンドは、
tag-namespace get
コマンドと同じ出力を返します。
タグ・ネームスペースの更新
OraclePCAタグ・ネームスペースの更新を試行しないでください。 OraclePCAネームスペースは、予約されたネームスペースです。 OraclePCAネームスペースのタグを変更したり、そのネームスペースに独自のタグを追加することはできません。
「コンピュート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
オプションを使用します。