oci-service-operator

dif.oracle.com/v1beta1

Back to API Reference

APIVersion: dif.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 dif.oracle.com/v1beta1.

Resources

Kind Scope Sample Packages
Stack Namespaced Sample -

Stack

Stack is the Schema for the stacks API.

Spec

StackSpec defines the desired state of Stack.

Field Description Type Required Default Enum
adb ADB details if adb is included in the services. list[object] No - -
aidataplatform AI Data Platform Details if aidataplatform is included in services. list[object] No - -
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment to create the Stack in. string Yes - -
dataflow DATAFLOW details if dataflow is included in the services. list[object] 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 - -
displayName A user-friendly name. Should be unique per compartment. Avoid entering confidential information. 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 - -
genai GenAi Details if genai is included in services. list[object] No - -
ggcs GGCS details if ggcs is included in the services. list[object] No - -
notificationEmail email id to which the stack notifications would be sent. string No - -
objectstorage Object Storage Details if object storage is included in services. list[object] No - -
oke OKE Details if oke is included in services. list[object] No - -
omk OMK Details if omk is included in services. list[object] No - -
services List of services to be onboarded for the stack. list[string] Yes - -
stackTemplates List of templates to be onboarded for the stack. list[string] Yes - -

Spec.adb[]

Back to Stack spec

StackAdb defines nested fields for Stack.Adb.

Field Description Type Required Default Enum
adminPasswordId The OCI vault secret [/Content/General/Concepts/identifiers.htm]OCID for admin password. string Yes - -
dataStorageSizeInTBs The size, in terabytes, of the data volume that will be created and attached to the database. integer Yes - -
dbVersion A valid Oracle Database version for Autonomous Database. string Yes - -
dbWorkload DB Workload to be used with ADB. Accepted values are OLTP, DW. string Yes - -
ecpu The compute amount (ECPUs) available to the database. integer Yes - -
instanceId Id for the adw instance. string Yes - -
isMtlsConnectionRequired Specifies if the Autonomous Database requires mTLS connections. boolean No - -
isPublic If true then subnetId should not be provided. boolean No - -
subnetId The OCID of the subnet the Autonomous Database is associated with. string No - -
toolsPublicAccess This is an array of CIDR (classless inter-domain routing) notations for a subnet or VCN OCID (virtual cloud network Oracle Cloud ID). Allowed only when subnetId is provided (private ADB). string No - -

Spec.aidataplatform[]

Back to Stack spec

StackAidataplatform defines nested fields for Stack.Aidataplatform.

Field Description Type Required Default Enum
defaultWorkspaceName A default workspace will be created with this name. string Yes - -
instanceId Identifier for AIDP instance to be provisioned. string Yes - -

Spec.dataflow[]

Back to Stack spec

StackDataflow defines nested fields for Stack.Dataflow.

Field Description Type Required Default Enum
connections StackDataflowConnections defines nested fields for Stack.Dataflow.Connections. object No - -
driverShape The VM shape for the driver. Sets the driver cores and memory. string Yes - -
driverShapeConfig StackDataflowDriverShapeConfig defines nested fields for Stack.Dataflow.DriverShapeConfig. object No - -
executorShape The VM shape for the executors. Sets the executor cores and memory. string Yes - -
executorShapeConfig StackDataflowExecutorShapeConfig defines nested fields for Stack.Dataflow.ExecutorShapeConfig. object No - -
instanceId Id for dataflow instance string Yes - -
logBucketInstanceId InstanceId of log bucket created as part of objectstorage service in stack. Used for storing application run logs. string Yes - -
numExecutors The number of executor VMs requested. integer Yes - -
privateEndpointId OCID of the already provisioned dataflow private endpoint. string No - -
sparkVersion The Spark version utilized to run the application. string Yes - -
warehouseBucketInstanceId InstanceId of warehouse bucket created as part of objectstorage service in stack. Mandatory for SQL applications. string No - -

Spec.dataflow[].connections

Back to Stack spec

StackDataflowConnections defines nested fields for Stack.Dataflow.Connections.

Field Description Type Required Default Enum
connectionDetails StackDataflowConnectionsConnectionDetails defines nested fields for Stack.Dataflow.Connections.ConnectionDetails. object Yes - -
subnetId OCID of the private subnet string Yes - -

Spec.dataflow[].connections.connectionDetails

Back to Stack spec

StackDataflowConnectionsConnectionDetails defines nested fields for Stack.Dataflow.Connections.ConnectionDetails.

Field Description Type Required Default Enum
difDependencies List of DIF Service Dependency Details to create private endpoint. list[object] No - -
domainNames An array of DNS zone names. list[string] No - -

Spec.dataflow[].connections.connectionDetails.difDependencies[]

Back to Stack spec

StackDataflowConnectionsConnectionDetailsDifDependency defines nested fields for Stack.Dataflow.Connections.ConnectionDetails.DifDependency.

Field Description Type Required Default Enum
serviceInstanceId InstanceId of service which is part of the Stack. string Yes - -
serviceType Supported service name. string Yes - -

Spec.dataflow[].driverShapeConfig

Back to Stack spec

StackDataflowDriverShapeConfig defines nested fields for Stack.Dataflow.DriverShapeConfig.

Field Description Type Required Default Enum
memoryInGBs The amount of memory used for the driver or executors. integer Yes - -
ocpus The total number of OCPUs used for the driver or executors. See here for details. integer Yes - -

Spec.dataflow[].executorShapeConfig

Back to Stack spec

StackDataflowExecutorShapeConfig defines nested fields for Stack.Dataflow.ExecutorShapeConfig.

Field Description Type Required Default Enum
memoryInGBs The amount of memory used for the driver or executors. integer Yes - -
ocpus The total number of OCPUs used for the driver or executors. See here for details. integer Yes - -

Spec.genai[]

Back to Stack spec

StackGenai defines nested fields for Stack.Genai.

Field Description Type Required Default Enum
baseModel Name of the base model. string Yes - -
clusterType The dedicated AI cluster type. string Yes - -
endpoints List of endpoints to provision for the GENAI cluster. list[object] No - -
instanceId Id for the GenAi instance to be provisioned. string Yes - -
ociRegion Region on which the cluster end endpoint will be provisioned. string Yes - -
unitCount No of replicas of base model to be used for hosting. integer Yes - -

Spec.genai[].endpoints[]

Back to Stack spec

StackGenaiEndpoint defines nested fields for Stack.Genai.Endpoint.

Field Description Type Required Default Enum
endpointName Identifier for each endpoint. string Yes - -
isContentModerationEnabled Helps remove toxic and biased content from responses. boolean Yes - -

Spec.ggcs[]

Back to Stack spec

StackGgc defines nested fields for Stack.Ggc.

Field Description Type Required Default Enum
connections Connection details to be associated with the Goldengate deployment. list[object] No - -
instanceId Id for the GGCS instance to provision. string Yes - -
ocpu The Minimum number of OCPUs to be made available for this Deployment. integer Yes - -
oggVersion Version of OGG. string No - -
passwordSecretId The OCID of the Secret where the deployment password is stored. string Yes - -
publicSubnetId The OCID of a public subnet in the customer tenancy. Can be provided only for public GGCS deployments. string No - -
subnetId The OCID of the subnet of the GGCS deployment’s private endpoint. string Yes - -

Spec.ggcs[].connections[]

Back to Stack spec

StackGgcConnection defines nested fields for Stack.Ggc.Connection.

Field Description Type Required Default Enum
connectionId OCID of pre-created Oracle GoldenGate connection. string No - -
connectionName Name of the connection to be created. string Yes - -
difDependencies List of Service Dependency Details for connection creation. list[object] No - -
ggAdminSecretId Vault secret OCID containing password that Oracle GoldenGate uses to connect the associated system of the given technology. string No - -

Spec.ggcs[].connections[].difDependencies[]

Back to Stack spec

StackGgcConnectionDifDependency defines nested fields for Stack.Ggc.Connection.DifDependency.

Field Description Type Required Default Enum
serviceInstanceId InstanceId of service which is part of the Stack. string Yes - -
serviceType Supported service name. string Yes - -

Spec.objectstorage[]

Back to Stack spec

StackObjectstorage defines nested fields for Stack.Objectstorage.

Field Description Type Required Default Enum
autoTiering It sets the auto-tiering status on the bucket.Allowed values are “DISABLED” / “INFREQUENTACCESS” string No - -
instanceId Id for Object Storage instance to be provisioned. string Yes - -
objectVersioning Mentions whether the object versioning to be enabled or not,Allowed values are “ENABLED” / “DISABLED”/”SUSPENDED” string Yes - -
storageTier Mentions which storage tier to use for the bucket,Allowed values are “STANDARD” / “ARCHIVE” string Yes - -

Spec.oke[]

Back to Stack spec

StackOke defines nested fields for Stack.Oke.

Field Description Type Required Default Enum
clusterId OCID of existing OKE cluster. string Yes - -
instanceId Unique identifier for an oke instance. string Yes - -
namespaceName Kubernetes namespace-name of OKE cluster. string Yes - -

Spec.omk[]

Back to Stack spec

StackOmk defines nested fields for Stack.Omk.

Field Description Type Required Default Enum
clusterId OCID of cluster assigned to OMK cluster-namespace. string Yes - -
clusterNamespaceId OCID of existing OMK cluster-namespace. string Yes - -
instanceId Unique identifier for an omk instance. string Yes - -
namespaceName Kubernetes namespace-name of OMK cluster-namespace. string Yes - -

Status

StackStatus defines the observed state of Stack.

Field Description Type Required Default Enum
adb ADB details if adb is included in the services. list[object] No - -
aidataplatform AI Data Platform Details if aidataplatform is included in services. list[object] No - -
compartmentId The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment. string No - -
dataflow DATAFLOW details if dataflow is included in the services. list[object] 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 - -
displayName A user-friendly name. Does not have to be unique, and it’s changeable. 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 - -
genai GenAI Details if genai is included in services. list[object] No - -
ggcs GGCS details if ggcs is included in the services. list[object] No - -
id The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Stack. string No - -
lifecycleDetails A message that describes the current state of the Stack in more detail. For example, can be used to provide actionable information for a resource in the Failed state. string No - -
lifecycleState The current state of the Stack. string No - -
notificationEmail email id to which the stack notifications would be sent. string No - -
objectstorage Object Storage Details if object storage is included in services. list[object] No - -
oke OKE Details if oke is included in services. list[object] No - -
omk OMK Details if omk is included in services. list[object] No - -
serviceDetails Details of the service onboarded for the data intelligence stack. list[object] No - -
services List of services to be onboarded for the stack. list[string] No - -
stackTemplates List of templates to be onboarded for the stack. list[string] No - -
status - object Yes - -
systemTags System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud": {"free-tier-retained": "true"}} map[string, map[string, string]] No - -
timeCreated The date and time the Stack was created, in the format defined by RFC 3339 (https://tools.ietf.org/html/rfc3339). Example: 2016-08-25T21:10:29.600Z string No - -
timeUpdated The date and time the Stack was updated, in the format defined by RFC 3339 (https://tools.ietf.org/html/rfc3339). Example: 2016-08-25T21:10:29.600Z string No - -

Status.adb[]

Back to Stack status

StackAdb defines nested fields for Stack.Adb.

Field Description Type Required Default Enum
adminPasswordId The OCI vault secret [/Content/General/Concepts/identifiers.htm]OCID for admin password. string Yes - -
dataStorageSizeInTBs The size, in terabytes, of the data volume that will be created and attached to the database. integer Yes - -
dbVersion A valid Oracle Database version for Autonomous Database. string Yes - -
dbWorkload DB Workload to be used with ADB. Accepted values are OLTP, DW. string Yes - -
ecpu The compute amount (ECPUs) available to the database. integer Yes - -
instanceId Id for the adw instance. string Yes - -
isMtlsConnectionRequired Specifies if the Autonomous Database requires mTLS connections. boolean No - -
isPublic If true then subnetId should not be provided. boolean No - -
subnetId The OCID of the subnet the Autonomous Database is associated with. string No - -
toolsPublicAccess This is an array of CIDR (classless inter-domain routing) notations for a subnet or VCN OCID (virtual cloud network Oracle Cloud ID). Allowed only when subnetId is provided (private ADB). string No - -

Status.aidataplatform[]

Back to Stack status

StackAidataplatform defines nested fields for Stack.Aidataplatform.

Field Description Type Required Default Enum
defaultWorkspaceName A default workspace will be created with this name. string Yes - -
instanceId Identifier for AIDP instance to be provisioned. string Yes - -

Status.dataflow[]

Back to Stack status

StackDataflow defines nested fields for Stack.Dataflow.

Field Description Type Required Default Enum
connections StackDataflowConnections defines nested fields for Stack.Dataflow.Connections. object No - -
driverShape The VM shape for the driver. Sets the driver cores and memory. string Yes - -
driverShapeConfig StackDataflowDriverShapeConfig defines nested fields for Stack.Dataflow.DriverShapeConfig. object No - -
executorShape The VM shape for the executors. Sets the executor cores and memory. string Yes - -
executorShapeConfig StackDataflowExecutorShapeConfig defines nested fields for Stack.Dataflow.ExecutorShapeConfig. object No - -
instanceId Id for dataflow instance string Yes - -
logBucketInstanceId InstanceId of log bucket created as part of objectstorage service in stack. Used for storing application run logs. string Yes - -
numExecutors The number of executor VMs requested. integer Yes - -
privateEndpointId OCID of the already provisioned dataflow private endpoint. string No - -
sparkVersion The Spark version utilized to run the application. string Yes - -
warehouseBucketInstanceId InstanceId of warehouse bucket created as part of objectstorage service in stack. Mandatory for SQL applications. string No - -

Status.dataflow[].connections

Back to Stack status

StackDataflowConnections defines nested fields for Stack.Dataflow.Connections.

Field Description Type Required Default Enum
connectionDetails StackDataflowConnectionsConnectionDetails defines nested fields for Stack.Dataflow.Connections.ConnectionDetails. object Yes - -
subnetId OCID of the private subnet string Yes - -

Status.dataflow[].connections.connectionDetails

Back to Stack status

StackDataflowConnectionsConnectionDetails defines nested fields for Stack.Dataflow.Connections.ConnectionDetails.

Field Description Type Required Default Enum
difDependencies List of DIF Service Dependency Details to create private endpoint. list[object] No - -
domainNames An array of DNS zone names. list[string] No - -

Status.dataflow[].connections.connectionDetails.difDependencies[]

Back to Stack status

StackDataflowConnectionsConnectionDetailsDifDependency defines nested fields for Stack.Dataflow.Connections.ConnectionDetails.DifDependency.

Field Description Type Required Default Enum
serviceInstanceId InstanceId of service which is part of the Stack. string Yes - -
serviceType Supported service name. string Yes - -

Status.dataflow[].driverShapeConfig

Back to Stack status

StackDataflowDriverShapeConfig defines nested fields for Stack.Dataflow.DriverShapeConfig.

Field Description Type Required Default Enum
memoryInGBs The amount of memory used for the driver or executors. integer Yes - -
ocpus The total number of OCPUs used for the driver or executors. See here for details. integer Yes - -

Status.dataflow[].executorShapeConfig

Back to Stack status

StackDataflowExecutorShapeConfig defines nested fields for Stack.Dataflow.ExecutorShapeConfig.

Field Description Type Required Default Enum
memoryInGBs The amount of memory used for the driver or executors. integer Yes - -
ocpus The total number of OCPUs used for the driver or executors. See here for details. integer Yes - -

Status.genai[]

Back to Stack status

StackGenai defines nested fields for Stack.Genai.

Field Description Type Required Default Enum
baseModel Name of the base model. string Yes - -
clusterType The dedicated AI cluster type. string Yes - -
endpoints List of endpoints to provision for the GENAI cluster. list[object] No - -
instanceId Id for the GenAi instance to be provisioned. string Yes - -
ociRegion Region on which the cluster end endpoint will be provisioned. string Yes - -
unitCount No of replicas of base model to be used for hosting. integer Yes - -

Status.genai[].endpoints[]

Back to Stack status

StackGenaiEndpoint defines nested fields for Stack.Genai.Endpoint.

Field Description Type Required Default Enum
endpointName Identifier for each endpoint. string Yes - -
isContentModerationEnabled Helps remove toxic and biased content from responses. boolean Yes - -

Status.ggcs[]

Back to Stack status

StackGgc defines nested fields for Stack.Ggc.

Field Description Type Required Default Enum
connections Connection details to be associated with the Goldengate deployment. list[object] No - -
instanceId Id for the GGCS instance to provision. string Yes - -
ocpu The Minimum number of OCPUs to be made available for this Deployment. integer Yes - -
oggVersion Version of OGG. string No - -
passwordSecretId The OCID of the Secret where the deployment password is stored. string Yes - -
publicSubnetId The OCID of a public subnet in the customer tenancy. Can be provided only for public GGCS deployments. string No - -
subnetId The OCID of the subnet of the GGCS deployment’s private endpoint. string Yes - -

Status.ggcs[].connections[]

Back to Stack status

StackGgcConnection defines nested fields for Stack.Ggc.Connection.

Field Description Type Required Default Enum
connectionId OCID of pre-created Oracle GoldenGate connection. string No - -
connectionName Name of the connection to be created. string Yes - -
difDependencies List of Service Dependency Details for connection creation. list[object] No - -
ggAdminSecretId Vault secret OCID containing password that Oracle GoldenGate uses to connect the associated system of the given technology. string No - -

Status.ggcs[].connections[].difDependencies[]

Back to Stack status

StackGgcConnectionDifDependency defines nested fields for Stack.Ggc.Connection.DifDependency.

Field Description Type Required Default Enum
serviceInstanceId InstanceId of service which is part of the Stack. string Yes - -
serviceType Supported service name. string Yes - -

Status.objectstorage[]

Back to Stack status

StackObjectstorage defines nested fields for Stack.Objectstorage.

Field Description Type Required Default Enum
autoTiering It sets the auto-tiering status on the bucket.Allowed values are “DISABLED” / “INFREQUENTACCESS” string No - -
instanceId Id for Object Storage instance to be provisioned. string Yes - -
objectVersioning Mentions whether the object versioning to be enabled or not,Allowed values are “ENABLED” / “DISABLED”/”SUSPENDED” string Yes - -
storageTier Mentions which storage tier to use for the bucket,Allowed values are “STANDARD” / “ARCHIVE” string Yes - -

Status.oke[]

Back to Stack status

StackOke defines nested fields for Stack.Oke.

Field Description Type Required Default Enum
clusterId OCID of existing OKE cluster. string Yes - -
instanceId Unique identifier for an oke instance. string Yes - -
namespaceName Kubernetes namespace-name of OKE cluster. string Yes - -

Status.omk[]

Back to Stack status

StackOmk defines nested fields for Stack.Omk.

Field Description Type Required Default Enum
clusterId OCID of cluster assigned to OMK cluster-namespace. string Yes - -
clusterNamespaceId OCID of existing OMK cluster-namespace. string Yes - -
instanceId Unique identifier for an omk instance. string Yes - -
namespaceName Kubernetes namespace-name of OMK cluster-namespace. string Yes - -

Status.serviceDetails[]

Back to Stack status

StackServiceDetail defines nested fields for Stack.ServiceDetail.

Field Description Type Required Default Enum
additionalDetails StackServiceDetailAdditionalDetails defines nested fields for Stack.ServiceDetail.AdditionalDetails. object No - -
currentArtifactPath name of the service string No - -
displayName name of the service string No - -
instanceId ID for the service instance. string No - -
serviceId ID for the service string No - -
serviceType name of the cloud service string No - -
serviceUrl url for the service string No - -
status state of the service string No - -

Status.serviceDetails[].additionalDetails

Back to Stack status

StackServiceDetailAdditionalDetails defines nested fields for Stack.ServiceDetail.AdditionalDetails.

Field Description Type Required Default Enum
assignedConnections connections assigned to Golden Gate deployment list[object] No - -
clusterId OCID of cluster assigned to OMK cluster-namespace. string No - -
endpointDetails details of all endpoints assigned to cluster list[object] No - -
modelId OCID of model string No - -
modelVersion version of model string No - -
namespaceName Kubernetes namespace-name of omk cluster-namespace. string No - -
ociRegion region of cluster string No - -
privateEndpointId OCID of model string No - -

Status.serviceDetails[].additionalDetails.assignedConnections[]

Back to Stack status

StackServiceDetailAdditionalDetailsAssignedConnection defines nested fields for Stack.ServiceDetail.AdditionalDetails.AssignedConnection.

Field Description Type Required Default Enum
connectionId OCID of the connection. string No - -
connectionName Name of the connection. string No - -
requestedBy Specifies who has made this connection. string No - -

Status.serviceDetails[].additionalDetails.endpointDetails[]

Back to Stack status

StackServiceDetailAdditionalDetailsEndpointDetail defines nested fields for Stack.ServiceDetail.AdditionalDetails.EndpointDetail.

Field Description Type Required Default Enum
endpointId OCID of the endpoint. string No - -
endpointName Identifier for each endpoint. string No - -

Status.status

Back to Stack 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 Stack 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 Stack 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 Stack status

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