タグ・ネームスペースの作成と管理

タグ・ネームスペースの作成

テナンシには、最大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 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コマンドと同じ出力を返します。

タグ・ネームスペースの更新

タグ・ネームスペースの説明を変更したり、タグ・ネームスペースのタグを追加または変更できます。

「コンピュート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オプションを使用します。