リソース制限テンプレートの操作

リソース制限テンプレートを使用すると、一連のリソース制限を簡単に適用できます。 たとえば、あるセットのリソース制限を2つの異なるテナンシに適用するテンプレートを作成し、別のテンプレートを作成して、2番目のセットのリソース制限を他の3つのテナンシに適用できます。 1つのタグに適用できるテンプレートは1つのみです。

テンプレートでは、デフォルトとは異なる制限値のみを指定する必要があります。 制限を指定しない場合、テンプレートのデフォルト値の動作がINHERITに設定されている場合、その値は制限定義からのデフォルト値になります。

このトピックのコマンドでは、リソース制限テンプレートの作成、使用可能なテンプレートのリスト、指定したテンプレートの詳細の表示、タグへのテンプレートの割当て、テンプレートの割当て解除、およびテンプレートの削除を行います。

リソース制限テンプレートの表示

このトピックでは、使用可能な制限テンプレートをリストし、指定したテンプレートの詳細を表示する方法について説明します。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「制限」、「制限テンプレート」の順に選択します。

    表には、各制限テンプレートについて、テンプレートの名前、テンプレートでタグの上書きが許可されているかどうか、およびデフォルト値の動作が表示されます: 継承またはゼロ。

  2. 特定の制限テンプレートの詳細を表示するには、リストで制限オーバーライドの名前を選択するか、その制限オーバーライドの「アクション」メニューを選択して「詳細の表示」を選択します。

    詳細ページの「リソース」セクションには、この制限テンプレートに対してすでに作成されたオーバーライドが表示されます。 そのリストの上書きを編集または削除したり、上書きの詳細を表示したり、リストの上のボタンを使用してこのテンプレートの新しい上書きを作成できます。 「リソース制限上書きの作成」を参照してください。

「サービスCLI」の使用

list LimitTemplateコマンドは、使用可能なすべてのリソース制限テンプレートをリストします。 次の例に示すどちらのテンプレートでも、テンプレート内の制限値を上書きできます。 

PCA-ADMIN> list LimitTemplate
Command: list LimitTemplate
Status: Success
Time: 2025-05-06 16:57:24,796 UTC
Data: 
  id           Name         Allows Overrides   Default Value Behavior
  --           ----         ----------------   ----------------------
  template1    template1    true               INHERIT
  template2    template2    true               ZERO

show LimitTemplateコマンドは、指定されたテンプレートの詳細情報(特にオーバーライド)を表示します。 list LimitTemplateコマンドの出力からテンプレートidを指定します。

次の例では、identity~usersのデフォルト値の100が、create LimitOverrideを使用してオーバーライドされました(「リソース制限の上書きの設定」を参照)。 

PCA-ADMIN> show LimitTemplate id=template1
Command: show LimitTemplate id=template1
Status: Success
Time: 2025-05-06 16:58:02,694 UTC
Data: 
  Id = template1
  Type = LimitTemplate
  Name = template1
  Allows Overrides = true
  Default Value Behavior = INHERIT
  Overrides 1 - Limit Name = users
  Overrides 1 - Service Name = identity
  Overrides 1 - Value = 200

リソース制限テンプレートの作成

このトピックでは、リソース制限テンプレートの作成方法について説明します。

デフォルトでは(上書きの許可はTrue)、同じ制限がテンプレートとタグの両方で直接設定されている場合は、タグに直接設定されている制限が使用されます。

「オーバーライドの許可」がfalseの場合、テンプレートによって設定された制限が使用されます。タグに直接設定された制限は無視されます。 テンプレートが割り当てられているタグの制限がテンプレートで明示的に設定されていない場合、デフォルト値動作の値に応じて、その制限のデフォルト値が使用されるか、0が使用されます。

デフォルト(デフォルト値動作の値が「継承」の場合)では、このテンプレートで明示的に設定されていない制限値は、その制限定義からデフォルト値を継承します。

デフォルト値の動作の値がゼロの場合、このテンプレートで明示的に設定されていない制限値は0に設定されます: そのタイプの新規リソースは作成できません。 既存のリソースは影響を受けません。 このテンプレートを割当て解除すると、タグの新しいリソースを作成する機能がリストアされます。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「制限」、「制限テンプレート」の順に選択します。

  2. リストの上にある「制限テンプレートの作成」ボタンを選択します。

  3. 「限度テンプレートの作成」ダイアログで、次の情報を入力します:

    • 名前: 最大40文字。

    • デフォルト値の動作: 「継承」または「ゼロ」を選択します。 「継承」はデフォルトで選択されています。

    • 上書きの許可: 「True」または「False」を選択します。 デフォルトでは、Trueが選択されています。

  4. ダイアログで「制限テンプレートの作成」ボタンを選択します。

    このテンプレートの詳細ページで、「リソース」セクションにスクロールして、このテンプレートの制限の上書きを定義します。 「リソース制限上書きの作成」を参照してください。

「サービスCLI」の使用

create LimitTemplateコマンドを使用して、指定したテンプレート名で新しいテンプレートを作成します。

次の例では、リソース制限テンプレートを作成します。 create LimitTemplateコマンドでは、制限値は設定されません。 指定したテンプレートの制限値を設定するには、create LimitOverrideコマンドを使用して、タグのかわりにテンプレートを指定します。 「リソース制限の上書きの設定」を参照してください。

次の例では、defaultValueBehaviorがデフォルトでINHERITに設定されています: 

PCA-ADMIN> create LimitTemplate name=template1
Command: create LimitTemplate name=template1
Status: Success
Time: 2025-05-06 16:59:13,531 UTC
JobId: a2f6df33-e70e-408b-aee5-7583b24e53ce

次の例では、defaultValueBehaviorが明示的にZEROに設定されています: 

PCA-ADMIN> create LimitTemplate name=template2 defaultValueBehavior=ZERO
Command: create LimitTemplate name=template2
Status: Success
Time: 2025-05-06 16:59:13,531 UTC
JobId: a2f6df33-e70e-408b-aee5-7583b24e53ce

リソース制限テンプレートの割当

このトピックでは、制限テンプレートをタグに割り当てる方法について説明します。

特定のタグに割り当てることができる制限テンプレートは最大1つです。 2番目のテンプレートをタグに割り当てる場合、2番目のテンプレートが1番目のテンプレートに置き換わります。最初のテンプレートの割り当てを解除する必要はありません。

テンプレートをタグに割り当て、そのタグの制限がタグに直接適用される場合、「オーバーライドの許可」設定によって、使用される制限値が決まります:

  • テンプレートの「上書きの許可」がfalseの場合は、テンプレートで指定された制限値が使用されます。 テンプレートで制限値が明示的に設定されていない場合は、デフォルト値動作の値に応じて、その制限のデフォルト値が使用されるか、0が使用されます。

  • テンプレートに対して「上書きの許可」がtrueの場合、タグにすでに指定されている制限値が使用されます。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「制限」を選択し、「テンプレート割当ての制限」を選択します。

    制限テンプレート割当てごとに、テンプレート名とタグが表示されます。

  2. 限度テンプレートを割り当てるには、テンプレート割当リストの上にある「限度テンプレートの割当」ボタンを選択します。

  3. 「限度テンプレート割当の作成」ダイアログで、次の情報を入力します:

    • テンプレート名: ドロップダウン・メニューからテンプレート名を選択します。

    • タグ: ドロップダウン・メニューからタグを選択します。

    • 上書きの許可: 「True」または「False」を選択します。 デフォルトでは、Trueが選択されています。

  4. ダイアログの「制限テンプレート割当の作成」ボタンを選択します。

「サービスCLI」の使用

assignLimitTemplateコマンドを使用して、指定されたテンプレートを指定されたタグに割り当てます。 

PCA-ADMIN> assignLimitTemplate templateName=template1 tag=ocid1.tenancy.unique_ID1
Command: assignLimitTemplate templateName=template1 tag=ocid1.tenancy.unique_ID1
Status: Success
Time: 2025-05-06 11:17:53,557 UTC
JobId: 4fe99f37-554d-4ce8-8084-639f6069cc44

list LimitTemplateAssignmentコマンドを使用して、すべてのテンプレートおよびそれらが割り当てられているタグをリストします。 次の例では、template1が2つの異なるタグに割り当てられています: 

PCA-ADMIN> list LimitTemplateAssignment
Status: Success
Time: 2025-05-06 11:18:01,309 UTC
Data: 
  Template Name   Tag     
  -------------   ---     
  template1       ocid1.tenancy.unique_ID1
  template1       ocid1.tenancy.unique_ID2
  template3       SYSTEM

リソース制限テンプレートの割当解除

このトピックでは、タグから制限テンプレートを割当て解除する方法について説明します。

テンプレートが割り当て解除されると、そのテンプレートで設定された制限が、影響を受けるタグから削除されます。

  • テンプレート名のみを指定した場合、そのテンプレートは割り当てられていたすべてのタグから割り当て解除されます。

  • テンプレート名とタグの両方を指定した場合、指定したテンプレートは指定したタグから割り当てられません。

  • タグのみを指定すると、そのタグに割り当てられていたテンプレートはそのタグから割り当てられなくなります。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「制限」を選択し、「テンプレート割当ての制限」を選択します。

    制限テンプレート割当てごとに、テンプレート名とタグが表示されます。

  2. 限度テンプレートを割当解除するには、そのテンプレートの「処理」メニューを選択してから「割当解除」オプションを選択するか、またはテンプレート割当リストの上にある「限度テンプレートの割当解除」ボタンを選択します。

  3. 「限度テンプレートの割当解除」ダイアログで、次の情報を入力します:

    • テンプレート名: ドロップダウン・メニューからテンプレート名を選択します。

    • タグ: ドロップダウン・メニューからタグを選択します。

    テンプレート名またはタグを少なくとも1つ指定する必要があります。 複数のテンプレート名またはタグを指定することも、複数のテンプレート名とタグのペアを指定することもできます。 このトピックの最初にあるルールを参照してください。

  4. ダイアログの「制限テンプレートの割当解除」ボタンを選択します。

「サービスCLI」の使用

unassignLimitTemplateコマンドを使用して、制限テンプレートの割当てを解除します。 

PCA-ADMIN> unassignLimitTemplate templateName=template1 tag=ocid1.tenancy.unique_ID2
Command: unassignLimitTemplate templateName=template1 tag=ocid1.tenancy.unique_ID2
Status: Success
Time: 2025-05-06 11:18:44,481 UTC
JobId: 48fa692d-a997-48da-8b60-309bc4be7ad1

リソース制限テンプレートの削除

このトピックでは、リソース制限テンプレートを削除する方法について説明します。 テンプレートがテナンシごとに設定されている制限をオーバーライドする場合は、テンプレートが割り当てられているテナンシを確認できます。 「リソース制限テンプレートの割当」を参照してください。

「サービスWeb UI」の使用

  1. ナビゲーション・メニューで、「制限」、「制限テンプレート」の順に選択します。

  2. 削除する制限テンプレートに対して、「アクション」メニューを選択し、「削除」オプションを選択します。

  3. 削除操作を確認します。

リソース制限テンプレートの削除

delete LimitTemplateコマンドを使用して、指定したテンプレートを削除します。 

PCA-ADMIN> delete LimitTemplate id=template2
Command: delete LimitTemplate id=template2
Status: Success
Time: 2025-05-06 17:01:36,806 UTC
JobId: 62ae5905-3150-4724-a921-727f61dcdcdc