Oracle Cloud Infrastructure Documentation

Managing Compartment Quotas

Use compartment quotas in Oracle Cloud Infrastructure Email Delivery to set granular limits on email sending within specific compartments in your tenancy.

Use Compartment Quotas in Email Delivery to set granular limits on email sending within specific compartments in your tenancy.

Using compartment quotas, you can:

  • Control how many emails are sent from each compartment.
  • Set limits to avoid exceeding your budget for email delivery.
  • Restrict unauthorized email sending within compartments.

When sending an email, the Email Delivery service uses the compartment quotas functionality within OCI to check the compartment quotas for the sending compartment. If the quota is exceeded, the email send request is blocked.

For detailed information on existing email delivery limits on tenancies, see Email Delivery Service Limits.

Email Delivery Quotas

The compartment quotas for the email-delivery family are listed below.

Email Delivery Quotas
Name Scope Description
approved-sender-count Regional Number of approved senders
email-domain-count Regional Number of email domains
email-private-endpoint-count Regional Number of private endpoints
max-emails-day Regional Maximum number of emails sent per day
max-message-size Regional Message size
sendrate Regional Number of emails sent per minute

Example

zero email-delivery quota approved-sender-count in compartment MyCompartment

Creating a Quota Policy

Create an email quota policy for a compartment by defining a policy statement.

Using the Console

  1. Open the navigation menu and click Governance & Administration. Under Tenancy Management, click Limits, Quotas and Usage.
  2. Click the Actions menu to the right of the limit name you want to create a quota for, and click Create Quota Policy.
  3. In the Create Quota Policy dialog box, specify the following:
    • Name: Enter a name for the quota. Avoid entering confidential information.
    • Description: Enter a description.
    • Quota Policy: Define the quota policy statement.
  4. Under Tags, add one or more tags to the quota policy by entering a tag namespace, key, and value.
  5. Optional: Select Save as stack to save the quota policy as a stack.
  6. Select Create Quota Policy.

Examples for defining quota policy:

Set email-delivery quota email-domain-count to [number] in compartment [compartment name]
                            
                            Set email-delivery quota max-emails-day to [number] in compartment [compartment name]
                            
                            Set email-delivery quota max-message-size to [number] in compartment [compartment name]
                            
                            Set email-delivery quota sendrate to [number] in compartment [compartment name]

For more information on creating quota policies and statements, see Quota Policy Quick Start, Sample Quotas, and Quota Policy Syntax.

Note

New quota policies can take up to 10 minutes to start working.

For more information about quotas, see Managing Quota Policies.