Skip to content

email.oracle.com/v1beta1

Back to API Reference

APIVersion: email.oracle.com/v1beta1

This content is generated from the checked-in CRD schemas in config/crd/bases/. If a description is missing or incorrect, fix the source comments or generator inputs and rerun make generate manifests; do not hand-edit config/crd/bases/*.yaml.

Packages

No customer-visible package currently exposes email.oracle.com/v1beta1.

Resources

Kind Scope Sample Packages
Dkim Namespaced Sample -
EmailDomain Namespaced Sample -
Sender Namespaced Sample -
Suppression Namespaced Sample -

Dkim

Dkim is the Schema for the dkims API.

  • Plural: dkims
  • Scope: Namespaced
  • APIVersion: email.oracle.com/v1beta1
  • Sample: Sample (config/samples/email_v1beta1_dkim.yaml)
  • Packages: Not currently exposed by a customer-visible package.

Spec

DkimSpec defines the desired state of Dkim.

Field Description Type Required Default Enum
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} map[string, map[string, string]] No - -
description A string that describes the details about the DKIM. It does not have to be unique, and you can change it. Avoid entering confidential information. string No - -
emailDomainId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the EmailDomain for this DKIM. string Yes - -
freeformTags Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} map[string, string] No - -
name The DKIM selector. This selector is required to be globally unique for this email domain. If you do not provide the selector, we will generate one for you. If you do provide the selector, we suggest adding a short region indicator to differentiate from your signing of emails in other regions you might be subscribed to. Selectors limited to ASCII characters can use alphanumeric, dash ("-"), and dot (".") characters. Non-ASCII selector names should adopt IDNA2008 normalization (RFC 5891-5892). Avoid entering confidential information. Example: mydomain-phx-20210228 string No - -
privateKey The DKIM RSA Private Key in Privacy-Enhanced Mail (PEM) format. It is a text-based representation of the private key used for signing email messages. string No - -

Status

DkimStatus defines the observed state of Dkim.

Field Description Type Required Default Enum
cnameRecordValue The DNS CNAME record value to provision to the DKIM DNS subdomain, when using the CNAME method for DKIM setup (preferred). string No - -
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment that contains this DKIM. string No - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} map[string, map[string, string]] No - -
description The description of the DKIM. Avoid entering confidential information. string No - -
dnsSubdomainName The name of the DNS subdomain that must be provisioned to enable email recipients to verify DKIM signatures. It is usually created with a CNAME record set to the cnameRecordValue. string No - -
emailDomainId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the email domain that this DKIM belongs to. string No - -
freeformTags Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} map[string, string] No - -
id The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DKIM. string No - -
isImported Indicates whether the DKIM was imported. boolean No - -
keyLength Length of the RSA key used in the DKIM. integer No - -
lifecycleDetails A message describing the current state in more detail. For example, can be used to provide actionable information for a resource. string No - -
lifecycleState The current state of the DKIM. string No - -
name The DKIM selector. If the same domain is managed in more than one region, each region must use different selectors. string No - -
status - object Yes - -
systemTags Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud": {"free-tier-retained": "true"}} map[string, map[string, string]] No - -
timeCreated The time the DKIM was created. Times are expressed in RFC 3339 (https://tools.ietf.org/html/rfc3339) timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z string No - -
timeUpdated The time of the last change to the DKIM configuration, due to a state change or an update operation. Times are expressed in RFC 3339 (https://tools.ietf.org/html/rfc3339) timestamp format, "YYYY-MM-ddThh:mmZ". string No - -
txtRecordValue The DNS TXT record value to provision to the DKIM DNS subdomain in place of using a CNAME record. This is used in cases where a CNAME cannot be used, such as when the cnameRecordValue would exceed the maximum length for a DNS entry. You can also use this if you have an existing procedure to directly provision TXT records for DKIM. Many DNS APIs require you to break this string into segments of fewer than 255 characters. string No - -

Status.status

Back to Dkim status

Field Description Type Required Default Enum
async Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first. object No - -
conditions - list[object] No - -
createdAt - string (date-time) No - -
deletedAt - string (date-time) No - -
message - string No - -
ocid - string No - -
opcRequestId OpcRequestID is the latest non-empty OCI request ID from a mutating OCI response or surfaced OCI service error that materially contributed to the current shared status projection. Headerless follow-up observations keep the last non-empty value intact. string No - -
reason - string No - -
requestedAt - string (date-time) No - -
updatedAt - string (date-time) No - -

Status.status.async

Back to Dkim status

Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first.

Field Description Type Required Default Enum
current - object No - -

Status.status.async.current

Back to Dkim status

Field Description Type Required Default Enum
message - string No - -
normalizedClass - string Yes - attention, canceled, failed, pending, succeeded, unknown
percentComplete - number No - -
phase - string Yes - create, delete, update
rawOperationType - string No - -
rawStatus - string No - -
source - string Yes - lifecycle, none, workrequest
updatedAt - string (date-time) Yes - -
workRequestId - string No - -

Status.status.conditions[]

Back to Dkim status

Field Description Type Required Default Enum
lastTransitionTime - string (date-time) No - -
message - string No - -
reason - string No - -
status - string Yes - -
type - string Yes - -

EmailDomain

EmailDomain is the Schema for the emaildomains API.

  • Plural: emaildomains
  • Scope: Namespaced
  • APIVersion: email.oracle.com/v1beta1
  • Sample: Sample (config/samples/email_v1beta1_emaildomain.yaml)
  • Packages: Not currently exposed by a customer-visible package.

Spec

EmailDomainSpec defines the desired state of EmailDomain.

Field Description Type Required Default Enum
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment for this email domain. string Yes - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} map[string, map[string, string]] No - -
description A string that describes the details about the domain. It does not have to be unique, and you can change it. Avoid entering confidential information. string No - -
domainVerificationId Id for Domain in Domain Management (under governance) if DOMAINID verification method used. string No - -
freeformTags Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} map[string, string] No - -
name The name of the email domain in the Internet Domain Name System (DNS). The email domain name must be unique in the region for this tenancy. Domain names limited to ASCII characters use alphanumeric, dash ("-"), and dot (".") characters. The dash and dot are only allowed between alphanumeric characters. For details, see RFC 5321, section 4.1.2 (https://tools.ietf.org/html/rfc5321#section-4.1.2) Non-ASCII domain names should adopt IDNA2008 normalization (RFC 5891-5892). string Yes - -

Status

EmailDomainStatus defines the observed state of EmailDomain.

Field Description Type Required Default Enum
activeDkimId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the DKIM key that will be used to sign mail sent from this email domain. string No - -
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment that contains this email domain. string No - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} map[string, map[string, string]] No - -
description The description of an email domain. string No - -
domainVerificationId Id for Domain in Domain Management (under governance) if DOMAINID verification method used. string No - -
domainVerificationStatus The current domain verification status. string No - -
freeformTags Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} map[string, string] No - -
id The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the email domain. string No - -
isSpf Value of the SPF field. For more information about SPF, please see SPF Authentication (https://docs.oracle.com/iaas/Content/Email/Concepts/overview.htm#components). boolean No - -
lifecycleState The current state of the email domain. string No - -
locks Locks associated with this resource. list[object] No - -
name The name of the email domain in the Internet Domain Name System (DNS). Example: mydomain.example.com string No - -
status - object Yes - -
systemTags Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud": {"free-tier-retained": "true"}} map[string, map[string, string]] No - -
timeCreated The time the email domain was created, expressed in RFC 3339 (https://tools.ietf.org/html/rfc3339) timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z string No - -

Status.locks[]

Back to EmailDomain status

EmailDomainLock defines nested fields for EmailDomain.Lock.

Field Description Type Required Default Enum
compartmentId The lock compartment ID. string No - -
message A message added by the lock creator. The message typically gives an indication of why the resource is locked. string No - -
relatedResourceId The resource ID that is locking this resource. Indicates that deleting this resource removes the lock. string No - -
timeCreated Indicates when the lock was created, in the format defined by RFC 3339. string No - -
type Lock type. string No - -

Status.status

Back to EmailDomain status

Field Description Type Required Default Enum
async Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first. object No - -
conditions - list[object] No - -
createdAt - string (date-time) No - -
deletedAt - string (date-time) No - -
message - string No - -
ocid - string No - -
opcRequestId OpcRequestID is the latest non-empty OCI request ID from a mutating OCI response or surfaced OCI service error that materially contributed to the current shared status projection. Headerless follow-up observations keep the last non-empty value intact. string No - -
reason - string No - -
requestedAt - string (date-time) No - -
updatedAt - string (date-time) No - -

Status.status.async

Back to EmailDomain status

Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first.

Field Description Type Required Default Enum
current - object No - -

Status.status.async.current

Back to EmailDomain status

Field Description Type Required Default Enum
message - string No - -
normalizedClass - string Yes - attention, canceled, failed, pending, succeeded, unknown
percentComplete - number No - -
phase - string Yes - create, delete, update
rawOperationType - string No - -
rawStatus - string No - -
source - string Yes - lifecycle, none, workrequest
updatedAt - string (date-time) Yes - -
workRequestId - string No - -

Status.status.conditions[]

Back to EmailDomain status

Field Description Type Required Default Enum
lastTransitionTime - string (date-time) No - -
message - string No - -
reason - string No - -
status - string Yes - -
type - string Yes - -

Sender

Sender is the Schema for the senders API.

  • Plural: senders
  • Scope: Namespaced
  • APIVersion: email.oracle.com/v1beta1
  • Sample: Sample (config/samples/email_v1beta1_sender.yaml)
  • Packages: Not currently exposed by a customer-visible package.

Spec

SenderSpec defines the desired state of Sender.

Field Description Type Required Default Enum
compartmentId The OCID of the compartment that contains the sender. string Yes - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} map[string, map[string, string]] No - -
emailAddress The email address of the sender. string Yes - -
emailIpPoolId An optional field. The IpPool OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) used to submit an email by Email Delivery when sent from this sender. string No - -
freeformTags Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} map[string, string] No - -

Status

SenderStatus defines the observed state of Sender.

Field Description Type Required Default Enum
compartmentId The OCID for the compartment. string No - -
definedTags Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} map[string, map[string, string]] No - -
emailAddress Email address of the sender. string No - -
emailDomainId The email domain used to assert responsibility for emails sent from this sender. string No - -
emailIpPoolId The IpPool OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) used to submit an email by Email Delivery when sent from this sender. string No - -
freeformTags Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} map[string, string] No - -
id The unique OCID of the sender. string No - -
isSpf Value of the SPF field. For more information about SPF, please see SPF Authentication (https://docs.oracle.com/iaas/Content/Email/Concepts/overview.htm#components). boolean No - -
lifecycleState The sender's current lifecycle state. string No - -
locks Locks associated with this resource. list[object] No - -
status - object Yes - -
systemTags Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud": {"free-tier-retained": "true"}} map[string, map[string, string]] No - -
timeCreated The date and time the approved sender was added in "YYYY-MM-ddThh:mmZ" format with a Z offset, as defined by RFC 3339 (https://tools.ietf.org/html/rfc3339). string No - -

Status.locks[]

Back to Sender status

SenderLock defines nested fields for Sender.Lock.

Field Description Type Required Default Enum
compartmentId The lock compartment ID. string No - -
message A message added by the lock creator. The message typically gives an indication of why the resource is locked. string No - -
relatedResourceId The resource ID that is locking this resource. Indicates that deleting this resource removes the lock. string No - -
timeCreated Indicates when the lock was created, in the format defined by RFC 3339. string No - -
type Lock type. string No - -

Status.status

Back to Sender status

Field Description Type Required Default Enum
async Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first. object No - -
conditions - list[object] No - -
createdAt - string (date-time) No - -
deletedAt - string (date-time) No - -
message - string No - -
ocid - string No - -
opcRequestId OpcRequestID is the latest non-empty OCI request ID from a mutating OCI response or surfaced OCI service error that materially contributed to the current shared status projection. Headerless follow-up observations keep the last non-empty value intact. string No - -
reason - string No - -
requestedAt - string (date-time) No - -
updatedAt - string (date-time) No - -

Status.status.async

Back to Sender status

Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first.

Field Description Type Required Default Enum
current - object No - -

Status.status.async.current

Back to Sender status

Field Description Type Required Default Enum
message - string No - -
normalizedClass - string Yes - attention, canceled, failed, pending, succeeded, unknown
percentComplete - number No - -
phase - string Yes - create, delete, update
rawOperationType - string No - -
rawStatus - string No - -
source - string Yes - lifecycle, none, workrequest
updatedAt - string (date-time) Yes - -
workRequestId - string No - -

Status.status.conditions[]

Back to Sender status

Field Description Type Required Default Enum
lastTransitionTime - string (date-time) No - -
message - string No - -
reason - string No - -
status - string Yes - -
type - string Yes - -

Suppression

Suppression is the Schema for the suppressions API.

  • Plural: suppressions
  • Scope: Namespaced
  • APIVersion: email.oracle.com/v1beta1
  • Sample: Sample (config/samples/email_v1beta1_suppression.yaml)
  • Packages: Not currently exposed by a customer-visible package.

Spec

SuppressionSpec defines the desired state of Suppression.

Field Description Type Required Default Enum
compartmentId The OCID of the compartment to contain the suppression. Since suppressions are at the customer level, this must be the tenancy OCID. string Yes - -
emailAddress The recipient email address of the suppression. string Yes - -

Status

SuppressionStatus defines the observed state of Suppression.

Field Description Type Required Default Enum
compartmentId The OCID of the compartment to contain the suppression. Since suppressions are at the customer level, this must be the tenancy OCID. string No - -
emailAddress Email address of the suppression. string No - -
errorDetail The specific error message returned by a system that resulted in the suppression. This message is usually an SMTP error code with additional descriptive text. Not provided for all types of suppressions. string No - -
errorSource DNS name of the source of the error that caused the suppression. Will be set to either the remote-mta or reporting-mta field from a delivery status notification (RFC 3464) when available. Not provided for all types of suppressions, and not always known. Note: Most SMTP errors that cause suppressions come from software run by email receiving systems rather than from OCI email delivery itself. string No - -
id The unique ID of the suppression. string No - -
messageId The value of the Message-ID header from the email that triggered a suppression. This value is as defined in RFC 5322 section 3.6.4, excluding angle-brackets. Not provided for all types of suppressions. string No - -
reason The reason that the email address was suppressed. For more information on the types of bounces, see Suppression List (https://docs.oracle.com/iaas/Content/Email/Concepts/overview.htm#components). string No - -
status - object Yes - -
timeCreated The date and time the suppression was added in "YYYY-MM-ddThh:mmZ" format with a Z offset, as defined by RFC 3339 (https://tools.ietf.org/html/rfc3339). string No - -
timeLastSuppressed The last date and time the suppression prevented submission in "YYYY-MM-ddThh:mmZ" format with a Z offset, as defined by RFC 3339 (https://tools.ietf.org/html/rfc3339). string No - -

Status.status

Back to Suppression status

Field Description Type Required Default Enum
async Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first. object No - -
conditions - list[object] No - -
createdAt - string (date-time) No - -
deletedAt - string (date-time) No - -
message - string No - -
ocid - string No - -
opcRequestId OpcRequestID is the latest non-empty OCI request ID from a mutating OCI response or surfaced OCI service error that materially contributed to the current shared status projection. Headerless follow-up observations keep the last non-empty value intact. string No - -
reason - string No - -
requestedAt - string (date-time) No - -
updatedAt - string (date-time) No - -

Status.status.async

Back to Suppression status

Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first.

Field Description Type Required Default Enum
current - object No - -

Status.status.async.current

Back to Suppression status

Field Description Type Required Default Enum
message - string No - -
normalizedClass - string Yes - attention, canceled, failed, pending, succeeded, unknown
percentComplete - number No - -
phase - string Yes - create, delete, update
rawOperationType - string No - -
rawStatus - string No - -
source - string Yes - lifecycle, none, workrequest
updatedAt - string (date-time) Yes - -
workRequestId - string No - -

Status.status.conditions[]

Back to Suppression status

Field Description Type Required Default Enum
lastTransitionTime - string (date-time) No - -
message - string No - -
reason - string No - -
status - string Yes - -
type - string Yes - -