Skip to content

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.

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

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 - -