// Copyright (c) 2016, 2018, 2026, Oracle and/or its affiliates.  All rights reserved.
// This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
// Code generated. DO NOT EDIT.

// Generative AI Service Management API
//
// OCI Generative AI is a fully managed service that provides a set of state-of-the-art, customizable large language models (LLMs) that cover a wide range of use cases for text generation, summarization, and text embeddings.
// Use the Generative AI service management API to create and manage DedicatedAiCluster, Endpoint, Model, and WorkRequest in the Generative AI service. For example, create a custom model by fine-tuning an out-of-the-box model using your own data, on a fine-tuning dedicated AI cluster. Then, create a hosting dedicated AI cluster with an endpoint to host your custom model.
// To access your custom model endpoints, or to try the out-of-the-box models to generate text, summarize, and create text embeddings see the Generative AI Inference API (https://docs.oracle.com/iaas/api/#/en/generative-ai-inference/latest/).
// To learn more about the service, see the Generative AI documentation (https://docs.oracle.com/iaas/Content/generative-ai/home.htm).
//

package generativeai

import (
	"fmt"
	"github.com/oracle/oci-go-sdk/v65/common"
	"strings"
)

// CreateDedicatedAiClusterDetails The data to create a dedicated AI cluster.
type CreateDedicatedAiClusterDetails struct {

	// The dedicated AI cluster type indicating whether this is a fine-tuning/training processor or hosting/inference processor.
	// Allowed values are:
	// - HOSTING
	// - FINE_TUNING
	Type DedicatedAiClusterTypeEnum `mandatory:"true" json:"type"`

	// The compartment OCID to create the dedicated AI cluster in.
	CompartmentId *string `mandatory:"true" json:"compartmentId"`

	// The number of dedicated units in this AI cluster.
	UnitCount *int `mandatory:"true" json:"unitCount"`

	// 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
	UnitShape DedicatedAiClusterUnitShapeEnum `mandatory:"true" json:"unitShape"`

	// A user-friendly name. Does not have to be unique, and it's changeable.
	DisplayName *string `mandatory:"false" json:"displayName"`

	// An optional description of the dedicated AI cluster.
	Description *string `mandatory:"false" json:"description"`

	// 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"}`
	FreeformTags map[string]string `mandatory:"false" json:"freeformTags"`

	// 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"}}`
	DefinedTags map[string]map[string]interface{} `mandatory:"false" json:"definedTags"`
}

func (m CreateDedicatedAiClusterDetails) String() string {
	return common.PointerString(m)
}

// ValidateEnumValue returns an error when providing an unsupported enum value
// This function is being called during constructing API request process
// Not recommended for calling this function directly
func (m CreateDedicatedAiClusterDetails) ValidateEnumValue() (bool, error) {
	errMessage := []string{}
	if _, ok := GetMappingDedicatedAiClusterTypeEnum(string(m.Type)); !ok && m.Type != "" {
		errMessage = append(errMessage, fmt.Sprintf("unsupported enum value for Type: %s. Supported values are: %s.", m.Type, strings.Join(GetDedicatedAiClusterTypeEnumStringValues(), ",")))
	}
	if _, ok := GetMappingDedicatedAiClusterUnitShapeEnum(string(m.UnitShape)); !ok && m.UnitShape != "" {
		errMessage = append(errMessage, fmt.Sprintf("unsupported enum value for UnitShape: %s. Supported values are: %s.", m.UnitShape, strings.Join(GetDedicatedAiClusterUnitShapeEnumStringValues(), ",")))
	}

	if len(errMessage) > 0 {
		return true, fmt.Errorf("%s", strings.Join(errMessage, "\n"))
	}
	return false, nil
}
