Skip to content

Generative AI: DedicatedAiCluster

Manage OCI Generative AI resources from Kubernetes. This page is generated from checked-in package metadata, CRD schemas, and sample manifests.

Resource Snapshot

Field Value
Service generativeai
Resource DedicatedAiCluster
API Version generativeai.oracle.com/v1beta1
Package Generative AI
Support Status Preview
Latest Released Version v2.1.0-alpha
Install Namespace oci-service-operator-generativeai-system

Spec Fields

This summary shows the top-level spec fields. Use the full API reference for nested fields, defaults, and enum values.

Field Description Type Required
compartmentId The compartment OCID to create the dedicated AI cluster in. 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 An optional description of the dedicated AI cluster. 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
type The dedicated AI cluster type indicating whether this is a fine-tuning/training processor or hosting/inference processor. Allowed values are: - HOSTING - FINE_TUNING string Yes
unitCount The number of dedicated units in this AI cluster. integer Yes
unitShape The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers. Allowed values are: - LARGE_COHERE - LARGE_COHERE_V2 - SMALL_COHERE - SMALL_COHERE_V2 - SMALL_COHERE_4 - EMBED_COHERE - LLAMA2_70 - LARGE_GENERIC - LARGE_COHERE_V2_2 - LARGE_GENERIC_4 - SMALL_GENERIC_V2 - LARGE_GENERIC_2 - LARGE_GENERIC_V3 - LARGE_COHERE_V3 - RERANK_COHERE - SMALL_GENERIC_V1 - MEDIUM_GENERIC_V1 - LARGE_GENERIC_V1 - A10_X1 - A10_X2 - A10_X4 - A100_40G_X1 - A100_40G_X2 - A100_40G_X4 - A100_40G_X8 - A100_80G_X1 - A100_80G_X2 - A100_80G_X4 - A100_80G_X8 - H100_X1 - H100_X2 - H100_X4 - H100_X8 - H200_X1 - H200_X2 - H200_X4 - H200_X8 The following shapes can only be used to deploy imported models: - A10_X1, A10_X2, A10_X4 - A100_40G_X1, A100_40G_X2, A100_40G_X4, A100_40G_X8 - A100_80G_X1, A100_80G_X2, A100_80G_X4, A100_80G_X8 - H100_X1, H100_X2, H100_X4, H100_X8 - H200_X1, H200_X2, H200_X4, H200_X8 - OAI_A10_X2 - OAI_H100_X1 - OAI_H100_X2 - OAI_H200_X1 - OAI_A100_80G_X1 - OAI_A100_80G_X2 - OAI_A100_40G_X1 - OAI_A100_40G_X4 string Yes

Status Fields

This summary shows the top-level status fields. Use the full API reference for nested fields, defaults, and enum values.

Field Description Type Required
capacity DedicatedAiClusterCapacity defines nested fields for DedicatedAiCluster.Capacity. object No
compartmentId The compartment OCID to create the dedicated AI cluster in. 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 An optional description of the dedicated AI cluster. 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
id The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the dedicated AI cluster. string No
lifecycleDetails A message describing the current state with detail that can provide actionable information. string No
lifecycleState The current state of the dedicated AI cluster. 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 dedicated AI cluster was created, in the format defined by RFC 3339 string No
timeUpdated The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339 string No
type The dedicated AI cluster type indicating whether this is a fine-tuning/training processor or hosting/inference processor. string No
unitCount The number of dedicated units in this AI cluster. integer No
unitShape The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers. string No

Sample Manifest

This example is generated from the checked-in sample manifest at config/samples/generativeai_v1beta1_dedicatedaicluster.yaml. Replace placeholder values before applying it.

Open the rendered sample page

#
# Copyright (c) 2021, Oracle and/or its affiliates. All rights reserved.
# Licensed under the Universal Permissive License v 1.0 as shown at http://oss.oracle.com/licenses/upl.
#

#
# Replace the compartment OCID and tune the displayName below before running e2e.
# Keeping spec.displayName empty disables pre-create reuse; setting it allows the
# controller to bind to an existing DedicatedAiCluster with the same compartmentId
# and displayName.
#
apiVersion: generativeai.oracle.com/v1beta1
kind: DedicatedAiCluster
metadata:
  name: dedicatedaicluster-sample
spec:
  compartmentId: ocid1.compartment.oc1..exampleuniqueID
  displayName: osok-dedicatedaicluster-sample
  type: HOSTING
  unitCount: 1
  unitShape: SMALL_COHERE
  description: OSOK DedicatedAiCluster sample
  freeformTags:
    managed-by: oci-service-operator