Setting Resource Limit Overrides

A resource limit override is a value that replaces the limit value that is currently set in the specified template or for the specified tag. Before you create a limit override, see Viewing Resource Limits to see the current limit value and the default limit value. See Planning Resource Limit Settings to see the allowable limit values.

This section describes how to list all resource limit overrides, set and edit overrides, and delete overrides.

Listing Resource Limit Overrides

Using the Service Web UI

  1. On the navigation menu, select Limits, and then select Limit Overrides.

    For each limit override, the table shows the name of the limit, the name of the service, the limit value set by the override, the tag, and the template name if applicable.

  2. To show the details of a particular limit override, either select the name of the limit override in the list, or select the Actions menu for that limit override and select View Details.

Using the Service CLI

Use the list LimitOverride command to return all limit overrides, for both templates and tags. 

PCA-ADMIN> list LimitOverride
Command: list LimitOverride
Status: Success
Time: 2025-05-06 16:54:04,609 UTC
Data: 
  id                                          Limit Name      Service Name  Value  Tag                      Template Name
  --                                          ----------      ------------  -----  ---                      -------------
  identity~users~TAG~ocid1.tenancy.unique_ID  users           identity      200    ocid1.tenancy.unique_ID  null
  loadbalancer~load-balancers~TAG~SYSTEM      load-balancers  loadbalancer  10     SYSTEM                   null
  loadbalancer~listeners~TEMPLATE~template3   listeners       loadbalancer  10     null                     template3

Creating Resource Limit Overrides

This topic describes how to create a resource limit override. The new limit value can be fewer than the current number of resources. Existing resources are not affected by setting a new limit. If the new limit is fewer than the current number, you will not be able to create a new one of those resources until their number drops below the new, lower, limit.

When you create an override, you specify either a tag or a template. If the same limit is set by specifying a tag name and also by specifying a template name, see Assigning Resource Limit Templates for the rule for which limit value will be used.

See Planning Resource Limit Settings for limit default values and allowable values. You might not be able to set a limit override to the maximum allowable value. The limit you can set depends on other configuration, including limit overrides that you have already set for related resources. See Listing Resource Limit Overrides for the list of limits that are already overridden.

If creating a limit override fails because you have attempted to set the limit too high, you will receive an error message with information about why the limit is too high and what the limit can be. Using this information, you might decide to override a different limit as well as, or instead of, the limit you were attempting to override.

Using the Service Web UI

  1. On the navigation menu, select Limits, and then select Limit Overrides.

  2. Select the Create Limit Override button above the list.

  3. On the Create Limit Override dialog, enter the following information:

    • Select the service name from the menu.

    • Select the limit name from the menu.

    • Enter the new value for the resource limit.

    • Select either a tag from the Tag menu or a template from the Template menu. If both are selected, the override defaults to the selected template.

  4. Select the Create Limit Override button in the dialog.

Using the Service CLI

Use the create LimitOverride command to create a resource limit override for either a template or a tag.

Provide the name of the limit, the name of the service, and the new resource limit value. Provide either a template name or a tag name.

The following example sets a limit override for a tenancy tag:

PCA-ADMIN> create LimitOverride limitName=users serviceName=identity value=200 tag=ocid1.tenancy.unique_ID
Command: create LimitOverride limitName=users serviceName=identity value=200 tag=ocid1.tenancy.unique_ID
Status: Success
Time: 2025-05-06 16:52:35,132 UTC
JobId: a5d75c66-8708-4355-b5ef-1a3213f9b690

The following example sets a limit override for a SYSTEM tag: 

PCA-ADMIN> create LimitOverride limitName=load-balancers serviceName=loadbalancer value=10 tag=SYSTEM
Command: create LimitOverride limitName=load-balancers serviceName=loadbalancer value=10 tag=SYSTEM
Status: Success
Time: 2025-05-06 16:53:35,132 UTC
JobId: job_ID

The following example sets a limit override in a template:

PCA-ADMIN> create LimitOverride limitName=listeners serviceName=loadbalancer value=10 template=template3
Command: create LimitOverride limitName=listeners serviceName=loadbalancer value=10 template=template3
Status: Success
Time: 2025-05-06 16:54:53,132 UTC
JobId: job_ID

Updating Resource Limit Overrides

This topic describes how to edit a limit override value. See Planning Resource Limit Settings for limit default values and allowable values. You might not be able to set a limit override to the maximum allowable value. The limit you can set depends on other configuration, including limit overrides that you have already set for related resources.

If the current limit is set by a template, see Working with Resource Limit Templates to see what other limits are set in that template and what tags the template is assigned to.

Using the Service Web UI

  1. On the navigation menu, select Limits, and then select Limit Overrides.

  2. For the limit override that you want to edit, select the Actions menu, and select the Edit option.

  3. The Update Limit Override dialog displays the current limit value in a text field. You can change that displayed value.

  4. Select the Update Limit Override button in the dialog.

Using the Service CLI

Use the edit LimitOverride command to reset the value of the specified resource limit. Use the id from the list LimitOverride command output. See Listing Resource Limit Overrides. 

PCA-ADMIN> edit LimitOverride id=loadbalancer~listeners~TEMPLATE~template3 value=8
Command: edit LimitOverride id=loadbalancer~listeners~TEMPLATE~template3 value=8
Status: Success
Time: 2025-05-06 16:55:31,903 UTC
JobId: 37baa077-6d75-4901-86c5-82568c514b26

Deleting Resource Limit Overrides

This topic describes how to delete a resource limit override. Deleting the override deletes the limit value for the tag or template.

  • The following rules describe what the value of the limit will be when more than one limit value is set and one is deleted:

  • If you delete the limit value of a tag, and a template with an override for the same limit is assigned to that tag, then the limit value from the template is used.

  • If you delete the limit value of a tag, and no template is assigned to that tag, then the default limit value from the limit definition is used.

  • If you delete the limit value of a tag, and a template is assigned to that tag that does not include an override for the same limit, then the default limit value from the limit definition is used if defaultValueBehavior is INHERIT for the template.

  • If you delete the limit value of a template that is assigned to a tag, and an override for the same limit is assigned to that tag, then the limit value assigned to the tag is used if allowsOverrides is true for the template.

  • If you delete the limit value of a template that is assigned to a tag, and no other override for the same limit is assigned to that tag, then the default limit value from the limit definition is used if defaultValueBehavior is INHERIT for the template.

Using the Service Web UI

  1. On the navigation menu, select Limits, and then select Limit Overrides.

  2. For the limit override that you want to delete, select the Actions menu, and select the Delete option.

  3. Confirm the delete operation.

Using the Service CLI

Use the delete LimitOverride command to delete the limit value for the tag or template.

Use the id from the list LimitOverride command output to delete the limit value.

The following example deletes the value for the load-balancers limit that is set for the SYSTEM tag: 

PCA-ADMIN> delete LimitOverride id=loadbalancer~load-balancers~TAG~SYSTEM
Command: delete LimitOverride id=loadbalancer~load-balancers~TAG~SYSTEM
Status: Success
Time: 2025-04-12 16:57:39,847 UTC
JobId: 3bc59401-d8cd-41ba-ab75-140a8fcd087f

The following example deletes the value for the listeners limit that is set for template3: 

PCA-ADMIN> delete LimitOverride id=loadbalancer~listeners~TEMPLATE~template3
Command: delete LimitOverride id=loadbalancer~listeners~TEMPLATE~template3
Status: Success
Time: 2025-04-12 16:58:39,847 UTC
JobId: job_ID