Oracle Cloud Infrastructure Documentation

Viewing a Tenancy's Limits and Usage

View limits and usage for a tenancy in Oracle Cloud Infrastructure.

For default limits, see Limits by Service. This information is also helpful if you don't yet have a tenancy or a user account for the Console, or if you don't find a particular limit listed.

  • You can view a tenancy's limits and usage (by region) in the Console. Be aware of the following considerations:

    • The Console might not display limits and usage information for all the Oracle Cloud Infrastructure services or resources.
    • The usage level listed for a particular resource type could be greater than the limit if the limit was reduced after the resources were created.
    • If all the resource limits are listed as 0, this means your account has been suspended. For help, contact Oracle Support.

    To view limits and usage:

    1. Open the navigation menu  and select Governance & Administration. Under Tenancy Management, select Limits, Quotas and Usage.

      The Limits, Quotas and Usage list page opens.

    2. Use filters to select the service, subscription, scope, and compartment. You can also select the resource, if available.

      If you see Edit filters, select it and use the Edit filters panel to make your selections.

      Note

      The Subscription field is only selectable for certain combinations of service and scope. For example, when selecting the Database service and a particular Scope, a <subscription_ID>-<subscription_name> subscription can be selected, and the Limits, Quotas and Usage page reloads to display the limits specific to the associated subscription.

      All service limits for the selected filters are displayed in a table with the following information:

      • Description
      • Limit Name
      • Status: Current state of the limit, such as active or deprecated.
      • Service Limit: The limit total.
      • Usage: How much of the limit resource has been used.
      • Available: The limit remainder (Service Limit value minus Usage value).
    3. (Optional) If you see Show deprecated limits, select it to show deprecated limits. If you don't see this option, deprecated limits are already included in the list.

    Filtering List Results

    Use filters to further limit the service limits in the list.

    From the Search and Filter box above the list table, select one or more filters and specify the values that you want to use to narrow the list.

    Change the order of the items in the list table by using the sort icons next to the column names.

    For information about searching for resources and managing the columns in the list table, see Listing Resources.

    Actions

    To perform an action on a service limit directly from the list table, select an available option from the Actions menu in the row for that service limit:

  • Use the oci limits resource-availability get command and required parameters to list information for the specified compartment, limit, and service:

    oci limits resource-availability get --compartment-id <compartment_id> --limit-name <limit_name> --service-name <service_name> ... [OPTIONS]

    If the scope type of the limit is AD (availability domain), then include the --availability-domain parameter:

    oci limits resource-availability get --availability-domain <availability_domain>--compartment-id <compartment_id> --limit-name <limit_name> --service-name <service_name> ... [OPTIONS]

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the GetResourceAvailability operation to list limits for the specified service, scope, and compartment.

    Fractional Usage and Availability

    Some resources can have fractional usage and availability, and the Service Limits API reflects this accordingly. If the resource is a fractional one, usage reflects the rounded up value of the fractional usage, and for availability, the rounded down value of the fractional availability. As a result, these fractional availability and usage attributes help indicate the most accurate usage and availability.

    For example, if a resource has 2.4 used, 4.6 available, the following API response is returned:

    {
    used: 3,
    fractionalUsed: 2.4,
    available: 4.6,
    fractionalAvailable: 4
}

    For more information, see the available and used attributes in the ResourceAvailability Reference.