model

type AgentInstallContent struct {
	MciId  string `json:"mciId"`
	VmId   string `json:"vmId"`
	VmIp   string `json:"vmIp"`
	Result string `json:"result"`
}

type AgentInstallContentWrapper struct {
	ResultArray []AgentInstallContent `json:"resultArray"`
}

type AlibabaSpecificProperty struct {
	BgpAsn string `json:"bgpAsn,omitempty" default:"65532" example:"65532"`
}

type AttachDetachDataDiskReq struct {
	DataDiskId string `json:"dataDiskId" validate:"required"`
}

type AutoAction struct {
	ActionType         string                   `json:"actionType" example:"ScaleOut" enums:"ScaleOut,ScaleIn"`
	SubGroupDynamicReq CreateSubGroupDynamicReq `json:"subGroupDynamicReq"`

	// PostCommand is field for providing command to VMs after its creation. example:"wget https://raw.githubusercontent.com/cloud-barista/cb-tumblebug/main/scripts/setweb.sh -O ~/setweb.sh; chmod +x ~/setweb.sh; sudo ~/setweb.sh"
	PostCommand   MciCmdReq `json:"postCommand"`
	PlacementAlgo string    `json:"placementAlgo" example:"random"`
}

type AutoCondition struct {
	Metric           string   `json:"metric" example:"cpu"`
	Operator         string   `json:"operator" example:">=" enums:"<,<=,>,>="`
	Operand          float64  `json:"operand" example:"80"`
	EvaluationPeriod int      `json:"evaluationPeriod" example:"10"`
	EvaluationValue  []string `json:"evaluationValue"`
}

type AvailableZonesError struct {
	// SpecId is the queried spec ID
	SpecId string `json:"specId" example:"aws+ap-northeast-2+t3.medium"`
	// ErrorCode provides a machine-readable error code for programmatic handling
	ErrorCode string `json:"errorCode" example:"PROVIDER_NOT_AVAILABLE"`
	// ErrorMessage provides a human-readable error description
	ErrorMessage string `json:"errorMessage" example:"Provider 'xyz' is not available"`
	// Suggestion provides actionable guidance when errors occur
	Suggestion string `json:"suggestion,omitempty" example:"Available providers: aws, gcp, azure"`
	// AlternativeRegions provides alternative regions when the specified region is unavailable
	AlternativeRegions []string `json:"alternativeRegions,omitempty" example:"ap-northeast-1,us-east-1"`
	// QueryDurationMs is the time taken to process the query in milliseconds
	QueryDurationMs int64 `json:"queryDurationMs" example:"15"`
}

type AvailableZonesInfo struct {
	// SpecId is the queried spec ID
	SpecId string `json:"specId" example:"aws+ap-northeast-2+t3.medium"`
	// ProviderName is the cloud service provider name
	ProviderName string `json:"providerName" example:"aws"`
	// RegionName is the region name
	RegionName string `json:"regionName" example:"ap-northeast-2"`
	// CspSpecName is the CSP-specific spec name
	CspSpecName string `json:"cspSpecName" example:"t3.medium"`
	// CredentialHolder is the credential holder used for the query
	CredentialHolder string `json:"credentialHolder" example:"admin"`
	// AvailableZones contains zones that are verified and available
	AvailableZones []string `json:"availableZones" example:"ap-northeast-2a,ap-northeast-2c"`
	// AllVerifiedZones contains all verified zones for the provider/region (before CSP-specific filtering)
	AllVerifiedZones []string `json:"allVerifiedZones,omitempty" example:"ap-northeast-2a,ap-northeast-2b,ap-northeast-2c"`
	// UnavailableZones contains zones that exist but are not verified or filtered out
	UnavailableZones []string `json:"unavailableZones,omitempty" example:"ap-northeast-2b"`
	// HasZoneConcept indicates whether the CSP/region has zone concept
	HasZoneConcept bool `json:"hasZoneConcept" example:"true"`
	// QueryDurationMs is the time taken to process the query in milliseconds
	QueryDurationMs int64 `json:"queryDurationMs" example:"125"`
}

type AwsSpecificProperty struct {
	BgpAsn string `json:"bgpAsn,omitempty" default:"64512" example:"64512"`
}

type AzureBgpPeeringCidrs struct {
	ToAws     []string `json:"toAws,omitempty" example:"169.254.21.0/30,169.254.21.4/30,169.254.22.0/30,169.254.22.4/30"`
	ToGcp     []string `json:"toGcp,omitempty" example:"169.254.21.8/30,169.254.21.12/30,169.254.22.8/30,169.254.22.12/30"`
	ToAlibaba []string `json:"toAlibaba,omitempty" example:"169.254.21.16/30,169.254.21.20/30,169.254.22.16/30,169.254.22.20/30"`
	ToTencent []string `json:"toTencent,omitempty" example:"169.254.21.24/30,169.254.21.28/30,169.254.22.24/30,169.254.22.28/30"`
	ToIbm     []string `json:"toIbm,omitempty" example:"169.254.21.32/30,169.254.21.36/30,169.254.22.32/30,169.254.22.36/30"`
}

type AzureSpecificProperty struct {
	GatewaySubnetCidr string                `json:"gatewaySubnetCidr,omitempty" default:"" example:"xxx.xxx.xxx.xxx/xx"`
	BgpAsn            string                `json:"bgpAsn,omitempty" default:"65531" example:"65531"`
	VpnSku            string                `json:"vpnSku,omitempty" default:"VpnGw1AZ" example:"VpnGw1AZ"`
	BgpPeeringCidrs   *AzureBgpPeeringCidrs `json:"bgpPeeringCidrs,omitempty"`
}

type BasicImageRules struct {
	Common      PatternSet            `mapstructure:"common" json:"common"`
	CspSpecific map[string]PatternSet `mapstructure:"cspSpecific" json:"cspSpecific,omitempty"`
}

type BastionInfo struct {
	VmId []string `json:"vmId"`
}

type BastionNode struct {
	NsId  string `json:"nsId,omitempty"`
	MciId string `json:"mciId"`
	VmId  string `json:"vmId"`
}

type BenchmarkInfo struct {
	Result      string          `json:"result"`
	Unit        string          `json:"unit"`
	Desc        string          `json:"desc"`
	Elapsed     string          `json:"elapsed"`
	SpecId      string          `json:"specid"`
	RegionName  string          `json:"regionName"`
	ResultArray []BenchmarkInfo `json:"resultarray"` // struct-element cycle ?
}

type BenchmarkInfoArray struct {
	ResultArray []BenchmarkInfo `json:"resultarray"`
}

type BenchmarkReq struct {
	Host string `json:"host"`
	Spec string `json:"spec"`
}

type Bucket struct {
	Name         string `json:"name" example:"spider-test-bucket"`
	CreationDate string `json:"creationDate" example:"2025-09-04T04:18:06Z"`
}

type Buckets struct {
	Bucket []Bucket `json:"bucket"`
}

type BuildAgnosticImageReq struct {
	// MCI configuration for creating the infrastructure
	SourceMciReq MciDynamicReq `json:"sourceMciReq" validate:"required"`

	// Snapshot configuration for creating custom images
	SnapshotReq SnapshotReq `json:"snapshotReq" validate:"required"`

	// Whether to cleanup (terminate) MCI after snapshot creation
	CleanupMciAfterSnapshot bool `json:"cleanupMciAfterSnapshot" example:"true" default:"true"`
}

type BuildAgnosticImageResult struct {
	// MCI information
	MciId        string `json:"mciId" example:"mci01"`
	Namespace    string `json:"namespace" example:"default"`
	MciStatus    string `json:"mciStatus" example:"Running"`
	MciCleanedUp bool   `json:"mciCleanedUp" example:"true"`

	// Snapshot results
	SnapshotResult MciSnapshotResult `json:"snapshotResult"`

	// Overall summary
	TotalDuration string `json:"totalDuration" example:"15m30s"`
	Message       string `json:"message" example:"Successfully created 3 custom images from MCI"`
}

type CIDRBlockDetail struct {
	CIDRBlock   string `mapstructure:"cidr-block" json:"cidrBlock"`
	Description string `mapstructure:"description" json:"description"`
}

type CSPDetail struct {
	Description                string                  `mapstructure:"description" json:"description"`
	CloudPlatform              string                  `mapstructure:"cloudPlatform" json:"cloudPlatform,omitempty"`
	Driver                     string                  `mapstructure:"driver" json:"driver"`
	Links                      []string                `mapstructure:"link" json:"links,omitempty"`
	UseEmptyRepresentativeZone bool                    `mapstructure:"useEmptyRepresentativeZone" json:"useEmptyRepresentativeZone,omitempty"`
	Regions                    map[string]RegionDetail `mapstructure:"region" json:"regions"`
}

type CSPIgnorePatterns struct {
	Description    string                          `yaml:"description,omitempty"`
	GlobalPatterns []string                        `yaml:"global_patterns,omitempty"`
	Regions        map[string]RegionIgnorePatterns `yaml:"regions,omitempty"`
}

type CSPNetworkDetail struct {
	Description         string            `mapstructure:"description" json:"description"`
	Links               []string          `mapstructure:"link" json:"links,omitempty"`
	AvailableCIDRBlocks []CIDRBlockDetail `mapstructure:"available-cidr-blocks" json:"availableCidrBlocks"`
	ReservedCIDRBlocks  []CIDRBlockDetail `mapstructure:"reserved-cidr-blocks" json:"reservedCidrBlocks,omitempty"`
	VNet                *VNetDetail       `mapstructure:"vnet" json:"vnet,omitempty"`
	Subnet              *SubnetDetail     `mapstructure:"subnet" json:"subnet,omitempty"`
	VPN                 *VPNDetail        `mapstructure:"vpn" json:"vpn,omitempty"`
}

type CancelTaskRequest struct {
	// Reason is an optional reason for cancellation
	Reason string `json:"reason,omitempty" example:"User requested cancellation"`
}

type CancelTaskResponse struct {
	// TaskId is the cancelled task ID
	TaskId string `json:"taskId" example:"cmd-g1-1-req123-1"`

	// Success indicates whether the cancellation was successful
	Success bool `json:"success" example:"true"`

	// Status is the new status after cancellation (Cancelled)
	Status CommandExecutionStatus `json:"status,omitempty" example:"Cancelled"`

	// Message provides additional information about the cancellation
	Message string `json:"message" example:"Task cancelled successfully"`

	// CancelledAt is when the task was cancelled (RFC3339 format)
	CancelledAt string `json:"cancelledAt,omitempty" example:"2024-01-15T10:32:00Z"`
}

type ChangeK8sNodeGroupAutoscaleSizeReq struct {
	DesiredNodeSize int `json:"desiredNodeSize" example:"1"`
	MinNodeSize     int `json:"minNodeSize" example:"1"`
	MaxNodeSize     int `json:"maxNodeSize" example:"3"`
}

type ChangeK8sNodeGroupAutoscaleSizeRes struct {
	K8sNodeGroupInfo
}

type CheckK8sClusterDynamicReqInfo struct {
	ReqCheck []CheckNodeDynamicReqInfo `json:"reqCheck" validate:"required"`
}

type CheckMciDynamicReqInfo struct {
	ReqCheck []CheckSubGroupDynamicReqInfo `json:"reqCheck" validate:"required"`
}

type CheckNodeDynamicReqInfo struct {

	// ConnectionConfigCandidates will provide ConnectionConfig options
	ConnectionConfigCandidates []string `json:"connectionConfigCandidates" default:""`

	Spec   SpecInfo     `json:"spec" default:""`
	Image  []ImageInfo  `json:"image" default:""`
	Region RegionDetail `json:"region" default:""`

	// Latest system message such as error message
	SystemMessage string `json:"systemMessage" example:"Failed because ..." default:""` // systeam-given string message

}

type CheckSubGroupDynamicReqInfo struct {

	// ConnectionConfigCandidates will provide ConnectionConfig options
	ConnectionConfigCandidates []string `json:"connectionConfigCandidates" default:""`

	Spec   SpecInfo     `json:"spec" default:""`
	Image  []ImageInfo  `json:"image" default:""`
	Region RegionDetail `json:"region" default:""`

	// Latest system message such as error message
	SystemMessage string `json:"systemMessage" example:"Failed because ..." default:""` // systeam-given string message

}

type Cloud struct {
	Common    CloudSetting `yaml:"common"`
	Aws       CloudSetting `yaml:"aws"`
	Azure     CloudSetting `yaml:"azure"`
	Gcp       CloudSetting `yaml:"gcp"`
	Alibaba   CloudSetting `yaml:"alibaba"`
	Tencent   CloudSetting `yaml:"tencent"`
	Ibm       CloudSetting `yaml:"ibm"`
	Ncp       CloudSetting `yaml:"ncp"`
	NHN       CloudSetting `yaml:"nhn"`
	Openstack CloudSetting `yaml:"openstack"`
	Cloudit   CloudSetting `yaml:"cloudit"`
}

type CloudDriverInfo struct {
	DriverName        string
	ProviderName      string
	DriverLibFileName string
}

type CloudInfo struct {
	CSPs map[string]CSPDetail `mapstructure:"cloud" json:"csps"`
}

type CloudNetworkInfo struct {
	CSPs map[string]CSPNetworkDetail `mapstructure:"network" json:"csps"`
}

type CloudSetting struct {
	Enable     string            `yaml:"enable"`
	Nlb        NlbSetting        `yaml:"nlb"`
	K8sCluster K8sClusterSetting `yaml:"k8scluster"`
}

type CloudSpecIgnoreConfig struct {
	Global GlobalIgnorePatterns         `yaml:"global"`
	CSPs   map[string]CSPIgnorePatterns `yaml:"csps,omitempty"`
}

type CommandDoneSummary struct {
	// TotalVms is the number of VMs that were targeted
	TotalVms int `json:"totalVms" example:"3"`

	// CompletedVms is the number of VMs that completed successfully
	CompletedVms int `json:"completedVms" example:"2"`

	// FailedVms is the number of VMs that failed
	FailedVms int `json:"failedVms" example:"1"`

	// ElapsedSeconds is total wall-clock time for the entire command execution
	ElapsedSeconds int64 `json:"elapsedSeconds" example:"45"`

	// Error is set when the command execution failed before reaching VMs (e.g., preprocessing error)
	Error string `json:"error,omitempty" example:"built-in function GetPublicIP error: no VM found"`
}

type CommandExecutionStatus string

type CommandLogEntry struct {
	// Stream indicates the source: "stdout" or "stderr"
	Stream string `json:"stream" example:"stdout"`

	// Line is the log line content (truncated at 4096 chars)
	Line string `json:"line" example:"total 8"`

	// LineNumber is the sequential line number within this stream for this VM
	LineNumber int `json:"lineNumber" example:"1"`
}

type CommandStatusFilter struct {
	// Status filters by command execution status
	Status []CommandExecutionStatus `json:"status,omitempty" example:"[\"Completed\",\"Failed\"]"`

	// XRequestId filters by specific request ID
	XRequestId string `json:"xRequestId,omitempty" example:"req-12345678-abcd-1234-efgh-123456789012"`

	// CommandContains filters commands containing this text
	CommandContains string `json:"commandContains,omitempty" example:"ls"`

	// StartTimeFrom filters commands started from this time (RFC3339 format)
	StartTimeFrom string `json:"startTimeFrom,omitempty" example:"2024-01-15T10:00:00Z"`

	// StartTimeTo filters commands started until this time (RFC3339 format)
	StartTimeTo string `json:"startTimeTo,omitempty" example:"2024-01-15T11:00:00Z"`

	// IndexFrom filters commands from this index (inclusive)
	IndexFrom int `json:"indexFrom,omitempty" example:"1"`

	// IndexTo filters commands to this index (inclusive)
	IndexTo int `json:"indexTo,omitempty" example:"10"`

	// Limit limits the number of results returned
	Limit int `json:"limit,omitempty" example:"50"`

	// Offset specifies the number of results to skip
	Offset int `json:"offset,omitempty" example:"0"`
}

type CommandStatusInfo struct {
	// Index is sequential identifier for this command execution (1, 2, 3, ...)
	Index int `json:"index" example:"1"`

	// XRequestId is the request ID from X-Request-ID header when the command was executed
	XRequestId string `json:"xRequestId,omitempty" example:"req-12345678-abcd-1234-efgh-123456789012"`

	// CommandRequested is the original command as requested by the user
	CommandRequested string `json:"commandRequested" example:"ls -la"`

	// CommandExecuted is the actual SSH command executed on the VM (may be adjusted)
	CommandExecuted string `json:"commandExecuted" example:"ls -la"`

	// Status represents the current status of the command execution
	Status CommandExecutionStatus `json:"status" example:"Completed"`

	// StartedTime is when the command execution started
	StartedTime string `json:"startedTime" example:"2024-01-15 10:30:00" default:""`

	// CompletedTime is when the command execution completed (success or failure)
	CompletedTime string `json:"completedTime,omitempty" example:"2024-01-15 10:30:05"`

	// ElapsedTime is the duration of command execution in seconds
	ElapsedTime int64 `json:"elapsedTime,omitempty" example:"120"`

	// ResultSummary provides a brief summary of the execution result
	ResultSummary string `json:"resultSummary,omitempty" example:"Command executed successfully"`

	// ErrorMessage contains error details if the execution failed
	ErrorMessage string `json:"errorMessage,omitempty" example:"SSH connection failed"`

	// Stdout contains the standard output from command execution (truncated for history)
	Stdout string `json:"stdout,omitempty" example:"total 8\ndrwxr-xr-x 2 user user 4096 Jan 15 10:30 ."`

	// Stderr contains the standard error from command execution (truncated for history)
	Stderr string `json:"stderr,omitempty" example:""`
}

type CommandStatusListResponse struct {
	// Commands is the list of command status info matching the filter criteria
	Commands []CommandStatusInfo `json:"commands"`

	// Total is the total number of commands matching the criteria (before limit/offset)
	Total int `json:"total" example:"25"`

	// Limit is the limit applied to the query
	Limit int `json:"limit" example:"50"`

	// Offset is the offset applied to the query
	Offset int `json:"offset" example:"0"`
}

type CommandStreamEvent struct {
	// Type indicates the kind of event
	Type CommandStreamEventType `json:"type" example:"CommandLog"`

	// VmId identifies which VM this event belongs to
	VmId string `json:"vmId" example:"g1-1"`

	// CommandIndex is the command status index in VmInfo.CommandStatus
	CommandIndex int `json:"commandIndex" example:"1"`

	// Timestamp is when the event was generated (RFC3339)
	Timestamp string `json:"timestamp" example:"2024-01-15T10:30:05Z"`

	// Status is populated for EventCommandStatus events (reuses existing CommandStatusInfo)
	Status *CommandStatusInfo `json:"status,omitempty"`

	// Log is populated for EventCommandLog events
	Log *CommandLogEntry `json:"log,omitempty"`

	// Summary is populated for EventCommandDone events
	Summary *CommandDoneSummary `json:"summary,omitempty"`
}

type CommandStreamEventType string

type ConfigInfo struct {
	Id    string `json:"id" example:"TB_SPIDER_REST_URL"`
	Name  string `json:"name" example:"TB_SPIDER_REST_URL"`
	Value string `json:"value" example:"http://localhost:1024/spider"`
}

type ConfigReq struct {
	Name  string `json:"name" example:"TB_SPIDER_REST_URL"`
	Value string `json:"value" example:"http://localhost:1024/spider"`
}

type ConnConfig struct {
	ConfigName           string         `json:"configName"`
	ProviderName         string         `json:"providerName"`
	DriverName           string         `json:"driverName"`
	CredentialName       string         `json:"credentialName"`
	CredentialHolder     string         `json:"credentialHolder"`
	RegionZoneInfoName   string         `json:"regionZoneInfoName"`
	RegionZoneInfo       RegionZoneInfo `json:"regionZoneInfo" gorm:"type:text;serializer:json"`
	RegionDetail         RegionDetail   `json:"regionDetail" gorm:"type:text;serializer:json"`
	RegionRepresentative bool           `json:"regionRepresentative"`
	Verified             bool           `json:"verified"`
}

type ConnConfigList struct {
	Connectionconfig []ConnConfig `json:"connectionconfig"`
}

type ContextKey string

type ControlVmResult struct {
	VmId   string `json:"vmId"`
	Status string `json:"Status"`
	Error  error  `json:"Error"`
}

type ControlVmResultWrapper struct {
	ResultArray []ControlVmResult `json:"resultarray"`
}

type CorsRule struct {
	AllowedMethod []string `json:"allowedMethod" example:"GET,PUT"`
	AllowedOrigin []string `json:"allowedOrigin" example:"*"`
	AllowedHeader []string `json:"allowedHeader" example:"*"`
	ExposeHeader  []string `json:"exposeHeader" example:"ETag"`
	MaxAgeSeconds int      `json:"maxAgeSeconds" example:"3000"`
}

type CreateSubGroupDynamicReq struct {
	// SubGroup name, actual VM name will be generated with -N postfix.
	Name string `json:"name" example:"g1"`

	// SubGroupSize is the number of VMs to create in this SubGroup. If > 0, subGroup will be generated. Default is 1.
	SubGroupSize int `json:"subGroupSize" example:"3"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label" example:"{\"role\":\"worker\",\"env\":\"test\"}"`

	Description string `json:"description" example:"Created via CB-Tumblebug"`

	// SpecId is field for id of a spec in common namespace
	SpecId string `json:"specId" validate:"required" example:"aws+ap-northeast-2+t3.nano"`
	// ImageId is field for id of a image in common namespace
	ImageId string `json:"imageId" validate:"required" example:"ami-01f71f215b23ba262"`

	RootDiskType string `json:"rootDiskType,omitempty" example:"gp3" default:"default"` // "", "default", "TYPE1", AWS: ["standard", "gp2", "gp3"], Azure: ["PremiumSSD", "StandardSSD", "StandardHDD"], GCP: ["pd-standard", "pd-balanced", "pd-ssd", "pd-extreme"], ALIBABA: ["cloud_efficiency", "cloud", "cloud_essd"], TENCENT: ["CLOUD_PREMIUM", "CLOUD_SSD"]
	RootDiskSize int    `json:"rootDiskSize,omitempty" example:"50"`                    // Root disk size in GB. 0 = use CSP default.

	VmUserPassword string `json:"vmUserPassword,omitempty" example:"" default:""`
	// if ConnectionName is given, the VM tries to use associtated credential.
	// if not, it will use predefined ConnectionName in Spec objects
	ConnectionName string `json:"connectionName,omitempty" example:"aws-ap-northeast-2" default:""`
	// Zone is an optional field to specify the availability zone for VM placement.
	// If specified, subnet will be created in this zone for resources like GPU VMs
	// that may only be available in specific zones. If empty, auto-selection applies.
	Zone string `json:"zone,omitempty" example:"ap-northeast-2a" default:""`

	// VNetTemplateId overrides the MCI-level VNetTemplateId for this SubGroup.
	// If empty, inherits the VNetTemplateId from the parent MciDynamicReq.
	VNetTemplateId string `json:"vNetTemplateId,omitempty" example:""`

	// SgTemplateId overrides the MCI-level SgTemplateId for this SubGroup.
	// If empty, inherits the SgTemplateId from the parent MciDynamicReq.
	SgTemplateId string `json:"sgTemplateId,omitempty" example:""`
}

type CreateSubGroupReq struct {
	// SubGroup name of VMs. Actual VM name will be generated with -N postfix.
	Name string `json:"name" validate:"required" example:"g1-1"`

	// CspResourceId is resource identifier managed by CSP (required for option=register)
	CspResourceId string `json:"cspResourceId,omitempty" example:"i-014fa6ede6ada0b2c"`

	// SubGroupSize is the number of VMs to create in this SubGroup. If > 0, subGroup will be generated.
	SubGroupSize int `json:"subGroupSize" example:"3"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	Description string `json:"description" example:"Description"`

	ConnectionName string `json:"connectionName" validate:"required" example:"testcloud01-seoul"`
	SpecId         string `json:"specId" validate:"required"`
	// ImageType        string   `json:"imageType"`
	ImageId          string   `json:"imageId" validate:"required"`
	VNetId           string   `json:"vNetId" validate:"required"`
	SubnetId         string   `json:"subnetId" validate:"required"`
	SecurityGroupIds []string `json:"securityGroupIds" validate:"required"`
	SshKeyId         string   `json:"sshKeyId" validate:"required"`
	VmUserName       string   `json:"vmUserName,omitempty"`
	VmUserPassword   string   `json:"vmUserPassword,omitempty"`
	RootDiskType     string   `json:"rootDiskType,omitempty" example:"default, TYPE1, ..."` // "", "default", "TYPE1", AWS: ["standard", "gp2", "gp3"], Azure: ["PremiumSSD", "StandardSSD", "StandardHDD"], GCP: ["pd-standard", "pd-balanced", "pd-ssd", "pd-extreme"], ALIBABA: ["cloud_efficiency", "cloud", "cloud_ssd"], TENCENT: ["CLOUD_PREMIUM", "CLOUD_SSD"]
	RootDiskSize     int      `json:"rootDiskSize,omitempty" example:"50"`                  // Root disk size in GB. 0 = use CSP default.
	DataDiskIds      []string `json:"dataDiskIds"`
}

type Credential struct {
	Credentialholder map[string]map[string]map[string]string `yaml:"credentialholder"`
}

type CredentialHolderInfo struct {
	// CredentialHolder is the holder identifier (e.g., "admin", "team-a")
	CredentialHolder string `json:"credentialHolder" example:"admin"`
	// Providers is the list of cloud providers registered under this holder
	Providers []string `json:"providers" example:"aws,gcp,azure"`
	// ConnectionCount is the total number of connection configs for this holder
	ConnectionCount int `json:"connectionCount" example:"42"`
	// VerifiedConnectionCount is the number of verified connections for this holder
	VerifiedConnectionCount int `json:"verifiedConnectionCount" example:"38"`
	// IsDefault indicates whether this holder is the system default
	IsDefault bool `json:"isDefault" example:"true"`
}

type CredentialHolderList struct {
	CredentialHolderList []CredentialHolderInfo `json:"credentialHolderList"`
}

type CredentialInfo struct {
	CredentialName   string         `json:"credentialName"`
	CredentialHolder string         `json:"credentialHolder"`
	ProviderName     string         `json:"providerName"`
	KeyValueInfoList []KeyValue     `json:"keyValueInfoList"`
	AllConnections   ConnConfigList `json:"allConnections"`
}

type CredentialReq struct {

	// ProviderName specifies the cloud provider associated with the credential (e.g., AWS, GCP).
	ProviderName string `json:"providerName" example:"aws"`

	// CredentialHolder is the entity or user that holds the credential.
	CredentialHolder string `json:"credentialHolder" example:"admin"`

	// PublicKeyTokenId is the unique token ID used to retrieve the corresponding private key for decryption.
	PublicKeyTokenId string `json:"publicKeyTokenId" example:"cr31av30uphc738d7h0g"`

	// EncryptedClientAesKeyByPublicKey is the client temporary AES key encrypted with the RSA public key.
	EncryptedClientAesKeyByPublicKey string `` /* 138-byte string literal not displayed */

	// CredentialKeyValueList contains key-(encrypted)value pairs that include the sensitive credential data.
	CredentialKeyValueList []KeyWithEncryptedValue `json:"credentialKeyValueList"`
}

type CspResourceStatusRequest struct {
	ConnectionName string `json:"ConnectionName"`
}

type CspResourceStatusResponse struct {
	ConnectionName string        `json:"connectionName"`
	ResourceType   string        `json:"resourceType"`
	AllList        SpiderAllList `json:"allList"`
	SystemMessage  string        `json:"systemMessage,omitempty"`
	Error          string        `json:"error,omitempty"`
}

type CspSpecificProperty struct {
	Aws     *AwsSpecificProperty     `json:"aws,omitempty"`
	Azure   *AzureSpecificProperty   `json:"azure,omitempty"`
	Gcp     *GcpSpecificProperty     `json:"gcp,omitempty"`
	Alibaba *AlibabaSpecificProperty `json:"alibaba,omitempty"`
}

type CustomImageReq struct {
	// This field is for 'Register existing custom image'
	CspResourceId string `json:"cspResourceId"`

	ConnectionName string `json:"connectionName"`
	Name           string `json:"name" validate:"required"`
	SourceVmId     string `json:"sourceVmId"`
	Description    string `json:"description"`
}

type CustomImageStatus string

type DataDiskInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Id is unique identifier for the object
	Id string `json:"id" example:"aws-ap-southeast-1"`
	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`
	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"`
	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"`

	// Name is human-readable string to represent the object
	Name             string     `json:"name" example:"aws-ap-southeast-1"`
	ConnectionName   string     `json:"connectionName,omitempty" example:"aws-ap-southeast-1"`
	ConnectionConfig ConnConfig `json:"connectionConfig"`

	DiskType             string     `json:"diskType" example:"standard"`
	DiskSize             int        `json:"diskSize" example:"77"`      // Disk size in GB
	Status               DiskStatus `json:"status" example:"Available"` // Available, Unavailable, Attached, ...
	AssociatedObjectList []string   `json:"associatedObjectList" example:"/ns/default/mci/mci01/vm/aws-ap-southeast-1-1"`
	CreatedTime          time.Time  `json:"createdTime,omitempty" example:"2022-10-12T05:09:51.05Z"`
	KeyValueList         []KeyValue `json:"keyValueList,omitempty"`
	Description          string     `json:"description,omitempty" example:"Available"`

	// Latest system message such as error message
	SystemMessage string `json:"systemMessage" example:"Failed because ..." default:""` // systeam-given string message

	IsAutoGenerated bool `json:"isAutoGenerated,omitempty"`

	// SystemLabel is for describing the Resource in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel,omitempty" example:"Managed by CB-Tumblebug" default:""`
}

type DataDiskReq struct {
	Name           string `json:"name" validate:"required" example:"aws-ap-southeast-1-datadisk"`
	ConnectionName string `json:"connectionName" validate:"required" example:"aws-ap-southeast-1"`
	DiskType       string `json:"diskType" example:"default"`
	DiskSize       int    `json:"diskSize" validate:"required" example:"77"` // Disk size in GB
	Description    string `json:"description,omitempty"`

	// Fields for "Register existing dataDisk" feature
	// CspResourceId is required to register object from CSP (option=register)
	CspResourceId string `json:"cspResourceId"`
}

type DataDiskUpsizeReq struct {
	DiskSize    int    `json:"diskSize" validate:"required"` // Disk size in GB
	Description string `json:"description"`
}

type DataDiskVmReq struct {
	Name        string `json:"name" validate:"required" example:"aws-ap-southeast-1-datadisk"`
	DiskType    string `json:"diskType" example:"default"`
	DiskSize    int    `json:"diskSize" validate:"required" example:"77"` // Disk size in GB
	Description string `json:"description,omitempty"`
}

type DfAgentInstallReq struct {
	NsId        string `json:"ns_id"`
	MciId       string `json:"mci_id"`
	VmId        string `json:"vm_id"`
	PublicIp    string `json:"public_ip"`
	UserName    string `json:"user_name"`
	SshKey      string `json:"ssh_key"`
	CspType     string `json:"cspType"`
	ServiceType string `json:"service_type"`
	Port        string `json:"port"`
}

type DiskStatus string

type ExecCredential struct {
	ApiVersion string               `json:"apiVersion"`
	Kind       string               `json:"kind"`
	Status     ExecCredentialStatus `json:"status"`
}

type ExecCredentialStatus struct {
	Token string `json:"token"`
}

type ExecutionTask struct {
	// TaskId is the unique identifier for this execution task (format: xRequestId:vmId:index)
	TaskId string `json:"taskId" example:"req-12345678:vm-01:1"`

	// XRequestId is the X-Request-ID header value, the unique identifier for the request
	XRequestId string `json:"xRequestId,omitempty" example:"req-12345678"`

	// NsId is the namespace ID
	NsId string `json:"nsId" example:"default"`

	// MciId is the MCI ID
	MciId string `json:"mciId" example:"mci01"`

	// VmId is the target VM ID
	VmId string `json:"vmId,omitempty" example:"g1-1"`

	// CommandIndex is the index of this command in the VM's command history
	CommandIndex int `json:"commandIndex,omitempty" example:"1"`

	// SubGroupId is the target subgroup ID (empty if not specified)
	SubGroupId string `json:"subGroupId,omitempty" example:"g1"`

	// Command is the command being executed
	Command []string `json:"command" example:"apt update && apt install -y docker.io"`

	// Status is the current status of the task (uses CommandExecutionStatus: Queued, Handling, Completed, etc.)
	Status CommandExecutionStatus `json:"status" example:"Handling"`

	// StartedAt is when the task started (RFC3339 format)
	StartedAt string `json:"startedAt" example:"2024-01-15T10:30:00Z"`

	// CompletedAt is when the task completed (RFC3339 format), empty if still running
	CompletedAt string `json:"completedAt,omitempty" example:"2024-01-15T10:35:00Z"`

	// TimeoutMinutes is the timeout setting for this task
	TimeoutMinutes int `json:"timeoutMinutes" example:"30"`

	// ElapsedSeconds is the elapsed time in seconds
	ElapsedSeconds int64 `json:"elapsedSeconds" example:"120"`

	// Message provides additional status information
	Message string `json:"message,omitempty" example:"Executing command on 3 VMs"`

	// TargetVmCount is the number of VMs targeted by this task
	TargetVmCount int `json:"targetVmCount" example:"3"`

	// CompletedVmCount is the number of VMs that have completed execution
	CompletedVmCount int `json:"completedVmCount" example:"1"`
}

type ExecutionTaskList struct {
	// Tasks is the list of execution tasks
	Tasks []*ExecutionTask `json:"tasks"`
}

type ExecutionTaskListResponse struct {
	// Tasks is the list of execution tasks
	Tasks []ExecutionTask `json:"tasks"`

	// Total is the total number of tasks
	Total int `json:"total" example:"5"`
}

type ExtractPatterns struct {
	OSType      map[string]OSTypeDetail `mapstructure:"osType" json:"os_type"`
	GPUPatterns []string                `mapstructure:"gpuPatterns" json:"gpu_patterns"`
	K8sPatterns []string                `mapstructure:"k8sPatterns" json:"k8s_patterns"`
}

type ExtractPatternsInfo struct {
	ExtractPatterns ExtractPatterns `mapstructure:"extractionPatterns" json:"extraction_patterns"`
}

type FileDownloadReq struct {
	SourcePath string `json:"sourcePath" validate:"required" example:"/home/cb-user/result.json"` // Full path of the file on the remote VM
}

type FilterAvailableValues struct {
	// Basic identification fields
	Id             []string `json:"id,omitempty" description:"Available spec IDs"`
	Name           []string `json:"name,omitempty" description:"Available spec names"`
	ConnectionName []string `json:"connectionName,omitempty" description:"Available connection names"`

	// Provider and region information
	ProviderName []string `json:"providerName" description:"Available CSP provider names"`
	RegionName   []string `json:"regionName" description:"Available region names"`
	CspSpecName  []string `json:"cspSpecName,omitempty" description:"Available CSP spec names"`

	// Infrastructure specifications
	InfraType    []string `json:"infraType" description:"Available infrastructure types"`
	Architecture []string `json:"architecture" description:"Available architectures"`
	OsType       []string `json:"osType,omitempty" description:"Available OS types"`

	// Accelerator information
	AcceleratorModel []string `json:"acceleratorModel,omitempty" description:"Available accelerator models"`
	AcceleratorType  []string `json:"acceleratorType,omitempty" description:"Available accelerator types"`

	// Additional fields
	Description      []string `json:"description,omitempty" description:"Available descriptions"`
	EvaluationStatus []string `json:"evaluationStatus,omitempty" description:"Available evaluation statuses"`
}

type FilterCondition struct {
	Metric    string      `json:"metric" example:"vCPU" enums:"vCPU,memoryGiB,costPerHour"`
	Condition []Operation `json:"condition"`
}

type FilterConditionExample struct {
	Metric      string             `json:"metric" example:"vCPU"`
	Description string             `json:"description" example:"Filter specs with 2-8 vCPUs"`
	Condition   []OperationExample `json:"condition"`
}

type FilterInfo struct {
	Policy []FilterCondition `json:"policy"`
}

type FilterOptionsInfo struct {
	// Available metrics for filtering
	AvailableMetrics []string `` /* 149-byte string literal not displayed */

	// Example filter policies
	ExamplePolicies []FilterConditionExample `json:"examplePolicies" description:"Example filter policies"`

	// Available values for each metric (for select fields)
	AvailableValues FilterAvailableValues `json:"availableValues" description:"Available values for select-type filter fields"`

	// Example limit values for performance optimization
	LimitExamples []string `json:"limitExamples" example:"0,50,100,200,500" description:"Example limit values for performance optimization"`
}

type FilterSpecsByRangeRequest struct {
	Id                  string  `json:"id"`
	Name                string  `json:"name"`
	ConnectionName      string  `json:"connectionName"`
	ProviderName        string  `json:"providerName"`
	RegionName          string  `json:"regionName"`
	RegionLatitude      float64 `json:"regionLatitude"`
	RegionLongitude     float64 `json:"regionLongitude"`
	CspSpecName         string  `json:"cspSpecName"`
	InfraType           string  `json:"infraType"`
	Architecture        string  `json:"architecture"`
	OsType              string  `json:"osType"`
	VCPU                Range   `json:"vCPU"`
	MemoryGiB           Range   `json:"memoryGiB"`
	DiskSizeGB          Range   `json:"diskSizeGB"`
	MaxTotalStorageTiB  Range   `json:"maxTotalStorageTiB"`
	NetBwGbps           Range   `json:"netBwGbps"`
	AcceleratorModel    string  `json:"acceleratorModel"`
	AcceleratorCount    Range   `json:"acceleratorCount"`
	AcceleratorMemoryGB Range   `json:"acceleratorMemoryGB"`
	AcceleratorType     string  `json:"acceleratorType"`
	CostPerHour         Range   `json:"costPerHour"`
	Description         string  `json:"description"`
	EvaluationStatus    string  `json:"evaluationStatus"`
	EvaluationScore01   Range   `json:"evaluationScore01"`
	EvaluationScore02   Range   `json:"evaluationScore02"`
	EvaluationScore03   Range   `json:"evaluationScore03"`
	EvaluationScore04   Range   `json:"evaluationScore04"`
	EvaluationScore05   Range   `json:"evaluationScore05"`
	EvaluationScore06   Range   `json:"evaluationScore06"`
	EvaluationScore07   Range   `json:"evaluationScore07"`
	EvaluationScore08   Range   `json:"evaluationScore08"`
	EvaluationScore09   Range   `json:"evaluationScore09"`
	EvaluationScore10   Range   `json:"evaluationScore10"`
	Limit               int     `json:"limit" example:"0" description:"Maximum number of results to return (0 for no limit - returns all results)"`
}

type FirewallRuleInfo struct {
	// Port is the single port (e.g. "22") or port range (e.g. "1-65535") for the rule
	Port string `json:"Port" example:"1-65535"`
	// Protocol is the protocol type for the rule (TCP, UDP, ICMP, ALL)
	Protocol string `validate:"required" json:"Protocol" example:"TCP" enums:"TCP,UDP,ICMP,ALL"`
	// Direction is the direction of the rule (inbound or outbound)
	Direction string `validate:"required" json:"Direction" example:"inbound" enums:"inbound,outbound"`
	// CIDR is the allowed IP range (e.g. 0.0.0.0/0, 10.0.0/8)
	CIDR string `json:"CIDR" example:"0.0.0.0/0"`
}

type FirewallRuleReq struct {
	// Ports is to get multiple ports or port ranges as a string (e.g. "22,900-1000,2000-3000")
	// This allows flexibility in specifying single ports or ranges in a comma-separated format.
	// This field is used to handle both single ports and port ranges in a unified way.
	// It can accept a single port (e.g. "22"), a range (e.g. "900-1000"), or multiple ports/ranges (e.g. "22,900-1000,2000-3000").
	Ports string `json:"Ports" example:"22,900-1000,2000-3000"`
	// Protocol is the protocol type for the rule (TCP, UDP, ICMP). Don't use ALL here.
	Protocol string `validate:"required" json:"Protocol" example:"TCP" enums:"TCP,UDP,ICMP"`
	// Direction is the direction of the rule (inbound or outbound)
	Direction string `validate:"required" json:"Direction" example:"inbound" enums:"inbound,outbound"`
	// CIDR is the allowed IP range (e.g. 0.0.0.0/0, 10.0.0/8)
	CIDR string `json:"CIDR" example:"0.0.0.0/0"`
}

type GatewaySubnetDetail struct {
	Required     bool               `mapstructure:"required" json:"required"`
	Name         string             `mapstructure:"name" json:"name"`
	Description  string             `mapstructure:"description" json:"description"`
	PrefixLength PrefixLengthDetail `mapstructure:"prefix-length" json:"prefixLength"`
}

type GcpSpecificProperty struct {
	BgpAsn string `json:"bgpAsn,omitempty" default:"65530" example:"65530"`
}

type GetAvailableRegionZonesListRequest struct {
	Provider     string   `json:"provider" validate:"required" example:"alibaba"`
	CspSpecNames []string `json:"cspSpecNames" validate:"required" example:"ecs.t5.large,ecs.t5.medium"`
}

type GetAvailableRegionZonesRequest struct {
	Provider    string `json:"provider" validate:"required" example:"alibaba"`
	CspSpecName string `json:"cspSpecName" validate:"required" example:"ecs.t5.large"`
}

type GlobalDnsBulkDeleteReq struct {
	Records []GlobalDnsDeleteReq `json:"records" validate:"required" description:"List of records to delete"`
}

type GlobalDnsBulkDeleteResponse struct {
	TotalRequested int                         `json:"totalRequested" example:"5"`
	Succeeded      int                         `json:"succeeded" example:"4"`
	Failed         int                         `json:"failed" example:"1"`
	Results        []GlobalDnsBulkDeleteResult `json:"results"`
}

type GlobalDnsBulkDeleteResult struct {
	RecordName    string `json:"recordName" example:"mci.example.com"`
	RecordType    string `json:"recordType" example:"A"`
	SetIdentifier string `json:"setIdentifier,omitempty"`
	Success       bool   `json:"success" example:"true"`
	Message       string `json:"message" example:"deleted successfully"`
}

type GlobalDnsDeleteReq struct {
	DomainName    string `json:"domainName" validate:"required" example:"example.com" description:"Managed Domain Name in Route53"`
	RecordName    string `json:"recordName" validate:"required" example:"mci.example.com" description:"Record Name (FQDN) to delete"`
	RecordType    string `json:"recordType" example:"A" enums:"A,AAAA,CNAME,TXT" description:"DNS Record Type"`
	SetIdentifier string `json:"setIdentifier,omitempty" example:"" description:"SetIdentifier for specific record (empty = delete all matching)"`
}

type GlobalDnsIPSource struct {
	Mci   *GlobalDnsMciSource   `json:"mci,omitempty" description:"(Method 1) MCI ID source"`
	Label *GlobalDnsLabelSource `json:"label,omitempty" description:"(Method 2) Label Selector source"`
	Ips   []string              `json:"ips,omitempty" example:"[\"1.2.3.4\"]" description:"(Method 3) Manual IP addresses"`
}

type GlobalDnsLabelSource struct {
	NsId          string `json:"nsId" validate:"required" example:"default" description:"Namespace ID"`
	LabelSelector string `` /* 141-byte string literal not displayed */
}

type GlobalDnsMciSource struct {
	NsId  string `json:"nsId" validate:"required" example:"default" description:"Namespace ID"`
	MciId string `json:"mciId" validate:"required" example:"mci-01" description:"MCI ID"`
}

type GlobalDnsRecordInfo struct {
	Name          string   `json:"name" example:"mci.example.com"`
	Type          string   `json:"type" example:"A"`
	TTL           int64    `json:"ttl" example:"300"`
	Values        []string `json:"values" example:"[\"1.2.3.4\"]"`
	SetIdentifier string   `json:"setIdentifier,omitempty" example:""`
	RoutingPolicy string   `json:"routingPolicy,omitempty" example:"simple"`
	GeoLatitude   string   `json:"geoLatitude,omitempty" example:"37.56"`
	GeoLongitude  string   `json:"geoLongitude,omitempty" example:"126.97"`
}

type GlobalDnsRecordReq struct {
	// --- DNS Record Settings ---
	DomainName    string `json:"domainName" validate:"required" example:"example.com" description:"Managed Domain Name in Route53"`
	RecordName    string `json:"recordName" example:"mci.example.com" description:"Record Name (FQDN) to update"`
	RecordType    string `json:"recordType" example:"A" enums:"A,AAAA,CNAME,TXT" description:"DNS Record Type"`
	TTL           int64  `json:"ttl" example:"300" description:"Time To Live (seconds)"`
	RoutingPolicy string `json:"routingPolicy,omitempty" example:"simple" enums:"simple,geoproximity" description:"Routing policy (default: simple)"`

	// --- IP Source Selection ---
	SetBy GlobalDnsIPSource `json:"setBy" validate:"required" description:"IP source selection (Choose exactly one)"`
}

type GlobalIgnorePatterns struct {
	Patterns []string `yaml:"patterns"`
}

type HandlingCommandCountResponse struct {
	// VmId is the VM identifier
	VmId string `json:"vmId" example:"g1-1"`

	// HandlingCount is the number of commands currently in 'Handling' status
	HandlingCount int `json:"handlingCount" example:"3"`
}

type HostedZoneInfo struct {
	ZoneId      string `json:"zoneId" example:"/hostedzone/Z1234567890"`
	Name        string `json:"name" example:"example.com."`
	RecordCount int64  `json:"recordCount" example:"10"`
}

type IID struct {
	NameId   string `json:"NameId" validate:"required" example:"user-defined-name"`
	SystemId string `json:"SystemId" validate:"required" example:"csp-defined-id"`
}

type IbmSpecificProperty struct {
}

type IdList struct {
	IdList []string `json:"output"`
	// contains filtered or unexported fields
}

type IdNameInDetailInfo struct {
	IdInTb    string `json:"idInTb"`
	IdInSp    string `json:"idInSp"`
	IdInCsp   string `json:"idInCsp"`
	NameInCsp string `json:"nameInCsp"`
}

type ImageFetchOption struct {
	// Specific providers to target for the image fetching operation (ex: ["aws", "gcp"])
	// If specified, only these providers will be processed (excludedProviders will be ignored)
	TargetProviders []string `` /* 148-byte string literal not displayed */

	// providers need to be excluded from the image fetching operation (ex: ["azure"])
	ExcludedProviders []string `json:"excludedProviders,omitempty" example:"azure" description:"Providers to be excluded from the image fetching operation."`

	// providers that are not region-specific (ex: ["gcp"])
	RegionAgnosticProviders []string `json:"regionAgnosticProviders,omitempty" example:"gcp,tencent" description:"Providers that are not region-specific."`
}

type ImageInfo struct {

	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Composite primary key
	Namespace    string `json:"namespace" example:"default" gorm:"primaryKey"`
	ProviderName string `json:"providerName" gorm:"primaryKey"`
	CspImageName string `` /* 141-byte string literal not displayed */

	// Array field for supporting multiple regions
	RegionList []string `json:"regionList" gorm:"type:text;serializer:json"`

	Id   string `json:"id" example:"aws-ap-southeast-1"`
	Uid  string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`
	Name string `json:"name" example:"aws-ap-southeast-1"`

	// CspImageId is resource identifier managed by CSP
	CspImageId string `json:"cspImageId,omitempty" example:"ami-0d399fba46a30a310"`
	// SourceVmUid is the UID of the source VM from which this image was created
	SourceVmUid string `json:"sourceVmUid" example:"wef12awefadf1221edcf"`
	// SourceCspImageName is the name of the source CSP image from which this image was created
	SourceCspImageName string `json:"sourceCspImageName" example:"csp-06eb41e14121c550a"`

	ConnectionName string `json:"connectionName"`
	InfraType      string `json:"infraType"` // vm|k8s|kubernetes|container, etc.

	FetchedTime  string `json:"fetchedTime"`
	CreationDate string `json:"creationDate"`

	IsGPUImage        bool `` /* 133-byte string literal not displayed */
	IsKubernetesImage bool `` /* 232-byte string literal not displayed */
	IsBasicImage      bool `` /* 142-byte string literal not displayed */

	OSType string `json:"osType" gorm:"column:os_type" example:"ubuntu 22.04" description:"Simplified OS name and version string"`

	OSArchitecture OSArchitecture `` // arm64, x86_64 etc.
	/* 137-byte string literal not displayed */
	OSPlatform OSPlatform `` // Linux/UNIX, Windows, NA
	/* 129-byte string literal not displayed */
	OSDistribution string `` // Ubuntu 22.04~, CentOS 8 etc.
	/* 144-byte string literal not displayed */
	OSDiskType   string  `json:"osDiskType" gorm:"column:os_disk_type" example:"HDD" description:"The type of the OS disk of for the VM being created."` // ebs, HDD, etc.
	OSDiskSizeGB float64 ``                                                                                                                              // 10, 50, 100 etc.
	/* 135-byte string literal not displayed */
	ImageStatus ImageStatus `json:"imageStatus" example:"Available" description:"The status of the image, e.g., Available, Deprecated, NA."` // Available, Deprecated, NA

	Details     []KeyValue `json:"details" gorm:"type:text;serializer:json"`
	SystemLabel string     `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`
	Description string     `json:"description"`

	// CommandHistory stores the status and history of remote commands executed on this VM
	CommandHistory []ImageSourceCommandHistory `json:"commandHistory" gorm:"type:text;serializer:json"`
}

type ImageReq struct {
	Name           string `json:"name" validate:"required"`
	ConnectionName string `json:"connectionName" validate:"required"`
	CspImageName   string `json:"cspImageName" validate:"required"`
	Description    string `json:"description"`
}

type ImageRiskInfo struct {
	// Level is the risk level: "low", "medium", "high"
	Level string `json:"level"`

	// Message explains the image-specific risk reasoning
	Message string `json:"message"`

	// HasFailedWithSpec indicates if this image has failed with this spec before
	HasFailedWithSpec bool `json:"hasFailedWithSpec"`

	// HasSucceededWithSpec indicates if this image has succeeded with this spec before
	HasSucceededWithSpec bool `json:"hasSucceededWithSpec"`

	// IsNewCombination indicates if this spec+image combination has never been tried
	IsNewCombination bool `json:"isNewCombination"`
}

type ImageSourceCommandHistory struct {
	// Index is sequential identifier for this command execution (1, 2, 3, ...)
	Index int `json:"index" example:"1"`
	// CommandExecuted is the actual SSH command executed on the VM (may be adjusted)
	CommandExecuted string `json:"commandExecuted" example:"ls -la"`
}

type ImageStatus string

type ImageSummary struct {
	ResourceType   string         `json:"resourceType,omitempty" example:"image" description:"image or customImage"`
	CspImageName   string         `json:"cspImageName,omitempty" example:"ami-0123456789abcdef0"`
	OSType         string         `json:"osType" gorm:"column:os_type" example:"ubuntu 22.04" description:"Simplified OS name and version string"`
	OSArchitecture OSArchitecture `json:"osArchitecture,omitempty" example:"x86_64"`
	OSDistribution string         `json:"osDistribution,omitempty" example:"Ubuntu 22.04"`
}

type InspectResource struct {
	ConnectionName   string                `json:"connectionName"`
	ResourceType     string                `json:"resourceType"`
	SystemMessage    string                `json:"systemMessage"`
	ResourceOverview ResourceCountOverview `json:"resourceOverview"`
	Resources        ResourcesByManageType `json:"resources"`
}

type InspectResourceAllResult struct {
	ElapsedTime          int                     `json:"elapsedTime"`
	RegisteredConnection int                     `json:"registeredConnection"`
	AvailableConnection  int                     `json:"availableConnection"`
	TumblebugOverview    inspectOverview         `json:"tumblebugOverview"`
	CspOnlyOverview      inspectOverview         `json:"cspOnlyOverview"`
	InspectResult        []InspectResourceResult `json:"inspectResult"`
}

type InspectResourceResult struct {
	ConnectionName    string          `json:"connectionName"`
	SystemMessage     string          `json:"systemMessage"`
	ElapsedTime       int             `json:"elapsedTime"`
	TumblebugOverview inspectOverview `json:"tumblebugOverview"`
	CspOnlyOverview   inspectOverview `json:"cspOnlyOverview"`
}

type InspectResourcesRequest struct {
	ConnectionName string `json:"connectionName" example:"aws-ap-southeast-1"`
	ResourceType   string `json:"resourceType" example:"vNet" enums:"vNet,subnet,securityGroup,sshKey,vm"`
}

type InspectResourcesResponse struct {
	InspectResources []InspectResource `json:"inspectResources"`
}

type K8sAccessInfo struct {
	Endpoint   string `json:"endpoint" example:"http://1.2.3.4:6443"`
	Kubeconfig string `json:"kubeconfig" example:"apiVersion: v1\nclusters:\n- cluster:\n certificate-authority-data: LS0..."`
}

type K8sAddonsInfo struct {
	KeyValueList []KeyValue `json:"keyValueList"`
}

type K8sClusterAssetInfo struct {
	CSPs map[string]K8sClusterDetail `mapstructure:"k8scluster" json:"k8s_cluster"`
}

type K8sClusterConnectionConfigCandidatesReq struct {
	// SpecId is field for id of a spec in common namespace
	SpecIds []string `json:"specId" validate:"required" example:"tencent+ap-seoul+S2.MEDIUM4"`
}

type K8sClusterContainerCmdReq struct {
	Command []string `json:"command" validate:"required" example:"echo hello"`
}

type K8sClusterContainerCmdResult struct {
	Command string `json:"command"`
	Stdout  string `json:"stdout"`
	Stderr  string `json:"stderr"`
	Err     error  `json:"err"`
}

type K8sClusterContainerCmdResults struct {
	Results []*K8sClusterContainerCmdResult `json:"results"`
}

type K8sClusterDetail struct {
	NodeGroupsOnCreation bool                        `mapstructure:"nodeGroupsOnCreation" json:"nodegroups_on_creation"`
	NodeImageDesignation bool                        `mapstructure:"nodeImageDesignation" json:"node_image_designation"`
	RequiredSubnetCount  int                         `mapstructure:"requiredSubnetCount" json:"required_subnet_count"`
	NodeGroupNamingRule  string                      `mapstructure:"nodeGroupNamingRule" json:"nodegroup_naming_rule"`
	Version              []K8sClusterVersionDetail   `mapstructure:"version" json:"versions"`
	NodeImage            []K8sClusterNodeImageDetail `mapstructure:"nodeImage" json:"node_images"`
	RootDisk             []K8sClusterRootDiskDetail  `mapstructure:"rootDisk" json:"root_disks"`
}

type K8sClusterDynamicReq struct {
	// K8sCluster name if it is not empty. Optional when used with namePrefix in multi-cluster creation.
	Name string `json:"name" example:"k8scluster01"`

	// K8s Clsuter version
	Version string `json:"version,omitempty" example:"1.29"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label,omitempty"`

	Description string `json:"description,omitempty" example:"Description"`

	// NodeGroup name if it is not empty
	NodeGroupName string `json:"nodeGroupName,omitempty" example:"k8sng01"`

	// SpecId is field for id of a spec in common namespace
	SpecId string `json:"specId" validate:"required" example:"tencent+ap-seoul+S2.MEDIUM4"`

	// ImageId is field for id of a image in common namespace
	ImageId string `json:"imageId" validate:"required" example:"default, tencent+ap-seoul+ubuntu20.04"`

	RootDiskType string `json:"rootDiskType,omitempty" example:"default, TYPE1, ..." default:"default"` // "", "default", "TYPE1", AWS: ["standard", "gp2", "gp3"], Azure: ["PremiumSSD", "StandardSSD", "StandardHDD"], GCP: ["pd-standard", "pd-balanced", "pd-ssd", "pd-extreme"], ALIBABA: ["cloud_efficiency", "cloud", "cloud_essd"], TENCENT: ["CLOUD_PREMIUM", "CLOUD_SSD"]
	RootDiskSize int    `json:"rootDiskSize,omitempty" example:"30"`                                    // Root disk size in GB. 0 = use CSP default.

	OnAutoScaling   string `json:"onAutoScaling,omitempty" default:"true" example:"true"`
	DesiredNodeSize int    `json:"desiredNodeSize,omitempty" example:"1"`
	MinNodeSize     int    `json:"minNodeSize,omitempty" example:"1"`
	MaxNodeSize     int    `json:"maxNodeSize,omitempty" example:"3"`

	// if ConnectionName is given, the VM tries to use associtated credential.
	// if not, it will use predefined ConnectionName in Spec objects
	ConnectionName string `json:"connectionName,omitempty" default:"tencent-ap-seoul"`
}

type K8sClusterFailedInfo struct {
	Name           string `json:"name" example:"k8s-cluster-01"`
	ConnectionName string `json:"connectionName,omitempty" example:"aws-ap-northeast-2"`
	SpecId         string `json:"specId,omitempty" example:"aws+ap-northeast-2+t3.medium"`
	Error          string `json:"error" example:"failed to create cluster: resource quota exceeded"`
}

type K8sClusterInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Id is unique identifier for the object, same as Name
	Id string `json:"id" example:"k8scluster01"`

	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`

	// Name is human-readable string to represent the object
	Name           string `json:"name" example:"k8scluster01"`
	ConnectionName string `json:"connectionName" example:"alibaba-ap-northeast-2"`

	// ConnectionConfig shows connection info to cloud service provider
	ConnectionConfig ConnConfig `json:"connectionConfig"`

	Description string `json:"description" example:"My K8sCluster"`

	// Latest system message such as error message
	SystemMessage string `json:"systemMessage" example:"Failed because ..." default:""` // systeam-given string message

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	// SystemLabel is for describing the Resource in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`

	// Version is for kubernetes version
	Version string `json:"version" example:"1.30.1"` // Kubernetes Version, ex) 1.30.1

	// Network is for describing network information about the cluster
	Network K8sClusterNetworkInfo `json:"network"`

	// K8sNodeGroupList is for describing network information about the cluster
	K8sNodeGroupList []K8sNodeGroupInfo `json:"k8sNodeGroupList"`
	AccessInfo       K8sAccessInfo      `json:"accessInfo"`
	Addons           K8sAddonsInfo      `json:"addons"`

	Status K8sClusterStatus `json:"status" example:"Active"` // Creating, Active, Inactive, Updating, Deleting

	CreatedTime  time.Time  `json:"createdTime" example:"1970-01-01T00:00:00.00Z"`
	KeyValueList []KeyValue `json:"keyValueList"`

	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"`

	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"`

	SpiderViewK8sClusterDetail SpiderClusterInfo `json:"spiderViewK8sClusterDetail,omitempty"`
}

type K8sClusterNetworkInfo struct {
	VNetId           string   `json:"vNetId" example:"vpc-01"`
	SubnetIds        []string `json:"subnetIds" example:"subnet-01"`
	SecurityGroupIds []string `json:"securityGroupIds" example:"sg-01"`

	KeyValueList []KeyValue `json:"keyValueList"`
}

type K8sClusterNodeGroupsOnCreation struct {
	Result string `json:"result" example:"true"`
}

type K8sClusterNodeImageDesignation struct {
	Result string `json:"result" example:"true"`
}

type K8sClusterNodeImageDetail struct {
	Region    []string                             `mapstructure:"region" json:"region"`
	Available []K8sClusterNodeImageDetailAvailable `mapstructure:"available" json:"availables"`
}

type K8sClusterNodeImageDetailAvailable struct {
	Name string `mapstructure:"name" json:"name"`
	Id   string `mapstructure:"id" json:"id"`
}

type K8sClusterReq struct {
	//Namespace      string `json:"namespace" validate:"required" example:"default"`
	ConnectionName string `json:"connectionName" validate:"required" example:"alibaba-ap-northeast-2"`
	Description    string `json:"description" example:"My K8sCluster"`

	// (1) K8sCluster Info
	Name    string `json:"name" validate:"required" example:"k8scluster01"`
	Version string `json:"version" example:"1.30.1-aliyun.1"`

	// (2) Network Info
	VNetId           string   `json:"vNetId" validate:"required" example:"vpc-01"`
	SubnetIds        []string `json:"subnetIds" validate:"required" example:"subnet-01"`
	SecurityGroupIds []string `json:"securityGroupIds" validate:"required" example:"sg-01"`

	// (3) NodeGroupInfo List
	K8sNodeGroupList []K8sNodeGroupReq `json:"k8sNodeGroupList"`

	// Fields for "Register existing K8sCluster" feature
	// @description CspResourceId is required to register a k8s cluster from CSP (option=register)
	CspResourceId string `json:"cspResourceId" example:"required when option is register"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	// SystemLabel is for describing the k8scluster in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"" default:""`
}

type K8sClusterRequiredSubnetCount struct {
	Result string `json:"result" example:"1"`
}

type K8sClusterRootDiskDetail struct {
	Region []string                       `mapstructure:"region" json:"region"`
	Type   []K8sClusterRootDiskDetailType `mapstructure:"type" json:"type"`
	Size   K8sClusterRootDiskDetailSize   `mapstructure:"size" json:"size"`
}

type K8sClusterRootDiskDetailSize struct {
	Min uint `mapstructure:"min" json:"min"`
	Max uint `mapstructure:"max" json:"max"`
}

type K8sClusterRootDiskDetailType struct {
	Name string `mapstructure:"name" json:"name"`
	Id   string `mapstructure:"id" json:"id"`
}

type K8sClusterSetting struct {
	Enable string `yaml:"enable"`
}

type K8sClusterStatus string

type K8sClusterTokenResponse struct {
	ExecCredential ExecCredential `json:"execCredential"`
}

type K8sClusterVersionDetail struct {
	Region    []string                           `mapstructure:"region" json:"region"`
	Available []K8sClusterVersionDetailAvailable `mapstructure:"available" json:"availables"`
}

type K8sClusterVersionDetailAvailable struct {
	Name string `mapstructure:"name" json:"name" example:"1.30"`
	Id   string `mapstructure:"id" json:"id" example:"1.30.1-aliyun.1"`
}

type K8sMultiClusterDynamicReq struct {
	NamePrefix string                 `json:"namePrefix" example:"across"`
	Clusters   []K8sClusterDynamicReq `json:"clusters" validate:"required,dive"`
}

type K8sMultiClusterInfo struct {
	Clusters       []K8sClusterInfo       `json:"clusters"`
	FailedClusters []K8sClusterFailedInfo `json:"failedClusters,omitempty"`
}

type K8sNodeGroupDynamicReq struct {
	// K8sNodeGroup name if it is not empty.
	Name string `json:"name" validate:"required" example:"k8sng01"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label,omitempty"`

	Description string `json:"description,omitempty" example:"Description"`

	// SpecId is field for id of a spec in common namespace
	SpecId string `json:"specId" validate:"required" example:"tencent+ap-seoul+S2.MEDIUM4"`

	// ImageId is field for id of a image in common namespace
	ImageId string `json:"imageId" validate:"required" example:"default, tencent+ap-seoul+ubuntu20.04"`

	RootDiskType string `json:"rootDiskType,omitempty" example:"default, TYPE1, ..." default:"default"` // "", "default", "TYPE1", AWS: ["standard", "gp2", "gp3"], Azure: ["PremiumSSD", "StandardSSD", "StandardHDD"], GCP: ["pd-standard", "pd-balanced", "pd-ssd", "pd-extreme"], ALIBABA: ["cloud_efficiency", "cloud", "cloud_essd"], TENCENT: ["CLOUD_PREMIUM", "CLOUD_SSD"]
	RootDiskSize int    `json:"rootDiskSize,omitempty" example:"30"`                                    // Root disk size in GB. 0 = use CSP default.

	OnAutoScaling   string `json:"onAutoScaling,omitempty" default:"true" example:"true"`
	DesiredNodeSize int    `json:"desiredNodeSize,omitempty" example:"1"`
	MinNodeSize     int    `json:"minNodeSize,omitempty" example:"1"`
	MaxNodeSize     int    `json:"maxNodeSize,omitempty" example:"3"`
}

type K8sNodeGroupInfo struct {
	// Id is unique identifier for the object
	Id string `json:"id" example:"aws-ap-southeast-1"`

	// Name is human-readable string to represent the object
	Name string `json:"name" example:"aws-ap-southeast-1"`

	ImageId         string             `json:"imageId"`
	SpecId          string             `json:"specId"`
	RootDiskType    string             `json:"rootDiskType"`
	RootDiskSize    int                `json:"rootDiskSize"`
	SshKeyId        string             `json:"sshKeyId"`
	OnAutoScaling   bool               `json:"onAutoScaling"`
	DesiredNodeSize int                `json:"desiredNodeSize"`
	MinNodeSize     int                `json:"minNodeSize"`
	MaxNodeSize     int                `json:"maxNodeSize"`
	Status          K8sNodeGroupStatus `json:"status" example:"Active"` // Creating, Active, Inactive, Updating, Deleting
	K8sNodes        []K8sNodeInfo      `json:"k8sNodes"`
	KeyValueList    []KeyValue         `json:"keyValueList"`

	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"`

	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"`

	SpiderViewK8sNodeGroupDetail SpiderNodeGroupInfo `json:"spiderViewK8sNodeGroupDetail,omitempty"`
}

type K8sNodeGroupReq struct {
	Name         string `json:"name" example:"k8sng01"`
	ImageId      string `json:"imageId" example:"image-01"`
	SpecId       string `json:"specId" example:"spec-01"`
	RootDiskType string `json:"rootDiskType" example:"cloud_essd" enum:"default, TYPE1, ..."` // "", "default", "TYPE1", AWS: ["standard", "gp2", "gp3"], Azure: ["PremiumSSD", "StandardSSD", "StandardHDD"], GCP: ["pd-standard", "pd-balanced", "pd-ssd", "pd-extreme"], ALIBABA: ["cloud_efficiency", "cloud", "cloud_ssd"], TENCENT: ["CLOUD_PREMIUM", "CLOUD_SSD"]
	RootDiskSize int    `json:"rootDiskSize" example:"40"`                                    // Root disk size in GB. 0 = use CSP default.
	SshKeyId     string `json:"sshKeyId" example:"sshkey-01"`

	// autoscale config.
	OnAutoScaling   string `json:"onAutoScaling" example:"true"`
	DesiredNodeSize int    `json:"desiredNodeSize" example:"1"`
	MinNodeSize     int    `json:"minNodeSize" example:"1"`
	MaxNodeSize     int    `json:"maxNodeSize" example:"3"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	Description string `json:"description" example:"Description"`
}

type K8sNodeGroupStatus string

type K8sNodeInfo struct {
	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"`

	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"`
}

type KeyValue struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type KeyWithEncryptedValue struct {
	// Key for the value
	Key string `json:"key"`

	// Should be encrypted by the public key issued by GET /credential/publicKey
	Value string `json:"value"`
}

type Label struct {
	Labels map[string]string `json:"labels"`
}

type LabelInfo struct {
	ResourceKey string            `json:"resourceKey"`
	Labels      map[string]string `json:"labels"`
}

type LabelableResource interface {
	GetLabels() map[string]string
	SetLabels(labels map[string]string)
}

type LatencyInfo struct {
	// SourceRegion is the source region for latency measurement
	SourceRegion string `json:"sourceRegion" gorm:"primaryKey" example:"aws+us-east-1"`
	// TargetRegion is the target region for latency measurement
	TargetRegion string `json:"targetRegion" gorm:"primaryKey" example:"aws+us-west-2"`
	// LatencyMs is the latency in milliseconds between source and target regions
	LatencyMs float64 `json:"latencyMs" example:"70.5"`
	// MeasuredAt is the timestamp when the latency was measured
	MeasuredAt time.Time `json:"measuredAt"`
	// UpdatedAt is the timestamp when the record was last updated
	UpdatedAt time.Time `json:"updatedAt"`
}

type Location struct {
	Display   string  `mapstructure:"display" json:"display"`
	Latitude  float64 `mapstructure:"latitude" json:"latitude"`
	Longitude float64 `mapstructure:"longitude" json:"longitude"`
}

type McNetConfigurationDetails struct {
	Csp     string          `json:"csp"`
	Regions []RegionDetails `json:"regions"`
}

type McNlbInfo struct {
	MciAccessInfo *MciAccessInfo  `json:"mciAccessInfo"`
	McNlbHostInfo *MciInfo        `json:"mcNlbHostInfo"`
	DeploymentLog MciSshCmdResult `json:"deploymentLog"`
}

type MciAccessInfo struct {
	MciId                 string
	MciNlbListener        *MciAccessInfo `json:"mciNlbListener,omitempty"`
	MciSubGroupAccessInfo []MciSubGroupAccessInfo
}

type MciAssociatedResourceList struct {
	ConnectionNames []string `json:"connectionNames"`
	ProviderNames   []string `json:"providerNames"`

	SubGroupIds []string `json:"subGroupIds"`
	VmIds       []string `json:"vmIds"`
	CspVmNames  []string `json:"cspVmNames"`
	CspVmIds    []string `json:"cspVmIds"`
	ImageIds    []string `json:"imageIds"`
	SpecIds     []string `json:"specIds"`

	VNetIds          []string `json:"vNetIds"`
	CspVNetIds       []string `json:"cspVNetIds"`
	SubnetIds        []string `json:"subnetIds"`
	CspSubnetIds     []string `json:"cspSubnetIds"`
	SecurityGroupIds []string `json:"securityGroupIds"`
	DataDiskIds      []string `json:"dataDiskIds"`
	SSHKeyIds        []string `json:"sshKeyIds"`
}

type MciCmdReq struct {
	// UserName is the SSH username to use for command execution
	UserName string `json:"userName" example:"cb-user" default:""`

	// Command is the list of commands to execute
	Command []string `` /* 128-byte string literal not displayed */

	// TimeoutMinutes is the timeout for command execution in minutes (default: 30, min: 1, max: 120)
	// If not specified or set to 0, the default timeout (30 minutes) will be used
	TimeoutMinutes int `json:"timeoutMinutes,omitempty" example:"30" default:"30"`
}

type MciConnectionConfigCandidatesReq struct {
	// SpecId is field for id of a spec in common namespace
	SpecIds []string `json:"specId" validate:"required" example:"aws+ap-northeast-2+t2.small,gcp+us-west1+g1-small"`
}

type MciCreationErrors struct {
	// VmObjectCreationErrors contains errors from VM object creation phase
	VmObjectCreationErrors []VmCreationError `json:"vmObjectCreationErrors,omitempty"`

	// VmCreationErrors contains errors from actual VM creation phase
	VmCreationErrors []VmCreationError `json:"vmCreationErrors,omitempty"`

	// TotalVmCount is the total number of VMs that were supposed to be created
	TotalVmCount int `json:"totalVmCount"`

	// SuccessfulVmCount is the number of VMs that were successfully created
	SuccessfulVmCount int `json:"successfulVmCount"`

	// FailedVmCount is the number of VMs that failed to be created
	FailedVmCount int `json:"failedVmCount"`

	// FailureHandlingStrategy indicates how failures were handled
	FailureHandlingStrategy string `json:"failureHandlingStrategy,omitempty"` // "rollback", "refine", "continue"
}

type MciDynamicReq struct {
	Name string `json:"name" validate:"required" example:"mci01"`

	// PolicyOnPartialFailure determines how to handle VM creation failures
	// - "continue": Continue with partial MCI creation (default)
	// - "rollback": Cleanup entire MCI when any VM fails
	// - "refine": Mark failed VMs for refinement
	PolicyOnPartialFailure string `json:"policyOnPartialFailure" example:"continue" default:"continue" enums:"continue,rollback,refine"`

	// InstallMonAgent Option for CB-Dragonfly agent installation ([yes/no] default:no)
	InstallMonAgent string `json:"installMonAgent" example:"no" default:"no" enums:"yes,no"` // yes or no

	// SubGroups is array of VM requests for multi-cloud infrastructure
	// Example: Multiple VM groups across different CSPs
	// [
	//   {
	//     "name": "aws-group",
	//     "subGroupSize": "3",
	//     "specId": "aws+ap-northeast-2+t3.nano",
	//     "imageId": "ami-01f71f215b23ba262",
	//     "rootDiskSize": "50",
	//     "label": {"role": "worker", "csp": "aws"}
	//   },
	//   {
	//     "name": "azure-group",
	//     "subGroupSize": "2",
	//     "specId": "azure+koreasouth+standard_b1s",
	//     "imageId": "Canonical:0001-com-ubuntu-server-jammy:22_04-lts:22.04.202505210",
	//     "rootDiskSize": "50",
	//     "label": {"role": "head", "csp": "azure"}
	//   },
	//   {
	//     "name": "gcp-group",
	//     "subGroupSize": "1",
	//     "specId": "gcp+asia-northeast3+g1-small",
	//     "imageId": "https://www.googleapis.com/compute/v1/projects/ubuntu-os-cloud/global/images/ubuntu-2204-jammy-v20250712",
	//     "rootDiskSize": "50",
	//     "label": {"role": "test", "csp": "gcp"}
	//   }
	// ]
	SubGroups []CreateSubGroupDynamicReq `json:"subGroups" validate:"required"`

	// PostCommand is for the command to bootstrap the VMs
	PostCommand MciCmdReq `json:"postCommand"`

	// SystemLabel is for describing the mci in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"" default:""`

	Description string `json:"description" example:"Made in CB-TB"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	// VNetTemplateId specifies the vNet template ID (from system namespace) to use when
	// auto-creating shared vNet resources. Propagates to all SubGroups unless overridden
	// at the SubGroup level. If empty, the default hard-coded CIDR behavior is used.
	VNetTemplateId string `json:"vNetTemplateId,omitempty" example:"default-vnet"`

	// SgTemplateId specifies the SecurityGroup template ID (from system namespace) to use
	// when auto-creating shared SecurityGroup resources. Propagates to all SubGroups unless
	// overridden at the SubGroup level. If empty, the default all-open behavior is used.
	SgTemplateId string `json:"sgTemplateId,omitempty" example:"default-sg"`
}

type MciDynamicTemplateInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType" example:"mci"`

	// Id is unique identifier for the template
	Id string `json:"id" example:"my-template"`

	// Name is human-readable string to represent the template
	Name string `json:"name" example:"my-template"`

	// Description of the template
	Description string `json:"description" example:"3-tier web application template"`

	// Source indicates where this template was created from
	// - "user": manually created by user
	// - "mci:{nsId}/{mciId}": extracted from an existing MCI
	Source string `json:"source" example:"user"`

	// CreatedAt is the creation timestamp
	CreatedAt string `json:"createdAt" example:"2024-01-01T00:00:00Z"`

	// UpdatedAt is the last update timestamp
	UpdatedAt string `json:"updatedAt" example:"2024-01-01T00:00:00Z"`

	// MciDynamicReq is the template body (MCI dynamic request)
	MciDynamicReq MciDynamicReq `json:"mciDynamicReq"`
}

type MciDynamicTemplateListResponse struct {
	Templates []MciDynamicTemplateInfo `json:"templates"`
}

type MciDynamicTemplateReq struct {
	// Name is the template ID and name
	Name string `json:"name" validate:"required" example:"my-template"`

	// Description of the template
	Description string `json:"description" example:"3-tier web application template"`

	// MciDynamicReq is the template body (MCI dynamic request configuration)
	MciDynamicReq MciDynamicReq `json:"mciDynamicReq" validate:"required"`
}

type MciHandlingCommandCountResponse struct {
	// MciId is the MCI identifier
	MciId string `json:"mciId" example:"mci01"`

	// VmHandlingCounts is a map of VM ID to handling command count
	VmHandlingCounts map[string]int `json:"vmHandlingCounts"`

	// TotalHandlingCount is the total number of handling commands across all VMs in the MCI
	TotalHandlingCount int `json:"totalHandlingCount" example:"3"`
}

type MciInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Id is unique identifier for the object
	Id string `json:"id" example:"aws-ap-southeast-1"`
	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`

	// Name is human-readable string to represent the object
	Name string `json:"name" example:"aws-ap-southeast-1"`

	Status       string          `json:"status"`
	StatusCount  StatusCountInfo `json:"statusCount"`
	TargetStatus string          `json:"targetStatus"`
	TargetAction string          `json:"targetAction"`

	// InstallMonAgent Option for CB-Dragonfly agent installation ([yes/no] default:no)
	InstallMonAgent string `json:"installMonAgent" example:"no" default:"no" enums:"yes,no"` // yes or no

	// ConfigureCloudAdaptiveNetwork is an option to configure Cloud Adaptive Network (CLADNet) ([yes/no] default:yes)
	ConfigureCloudAdaptiveNetwork string `json:"configureCloudAdaptiveNetwork" example:"yes" default:"no" enums:"yes,no"` // yes or no

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	// SystemLabel is for describing the mci in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`

	// Latest system message such as error message
	SystemMessage []string `json:"systemMessage"` // systeam-given string message

	PlacementAlgo string   `json:"placementAlgo,omitempty"`
	Description   string   `json:"description"`
	Vm            []VmInfo `json:"vm"`

	// List of IDs for new VMs. Return IDs if the VMs are newly added. This field should be used for return body only.
	NewVmList []string `json:"newVmList"`

	// PostCommand is for the command to bootstrap the VMs
	PostCommand MciCmdReq `json:"postCommand"`

	// PostCommandResult is the result of the command for bootstraping the VMs
	PostCommandResult MciSshCmdResult `json:"postCommandResult"`

	// CreationErrors contains information about VM creation failures (if any)
	CreationErrors *MciCreationErrors `json:"creationErrors,omitempty"`
}

type MciPolicyInfo struct {
	Name   string   `json:"Name"` //MCI Name (for request)
	Id     string   `json:"Id"`   //MCI Id (generated ID by the Name)
	Policy []Policy `json:"policy"`

	ActionLog   string `json:"actionLog"`
	Description string `json:"description" example:"Description"`
}

type MciPolicyReq struct {
	Policy      []Policy `json:"policy"`
	Description string   `json:"description" example:"Description"`
}

type MciRecommendReq struct {
	VmReq          []VmRecommendReq `json:"vmReq"`
	PlacementAlgo  string           `json:"placementAlgo"`
	PlacementParam []KeyValue       `json:"placementParam"`
	MaxResultNum   string           `json:"maxResultNum"`
}

type MciReq struct {
	Name string `json:"name" validate:"required" example:"mci01"`

	// InstallMonAgent Option for CB-Dragonfly agent installation ([yes/no] default:yes)
	InstallMonAgent string `json:"installMonAgent" example:"no" default:"no" enums:"yes,no"` // yes or no

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	// SystemLabel is for describing the mci in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"" default:""`

	PlacementAlgo string `json:"placementAlgo,omitempty"`
	Description   string `json:"description" example:"Made in CB-TB"`

	SubGroups []CreateSubGroupReq `json:"subGroups" validate:"required"`

	// PostCommand is for the command to bootstrap the VMs
	PostCommand MciCmdReq `json:"postCommand" validate:"omitempty"`

	// PolicyOnPartialFailure determines how to handle VM creation failures
	// - "continue": Continue with partial MCI creation (default)
	// - "rollback": Cleanup entire MCI when any VM fails
	// - "refine": Mark failed VMs for refinement
	PolicyOnPartialFailure string `json:"policyOnPartialFailure" example:"continue" default:"continue" enums:"continue,rollback,refine"`
}

type MciSnapshotResult struct {
	MciId        string             `json:"mciId" example:"mci01"`
	Namespace    string             `json:"namespace" example:"default"`
	SuccessCount int                `json:"successCount" example:"3"`
	FailCount    int                `json:"failCount" example:"0"`
	Results      []VmSnapshotResult `json:"results"`
}

type MciSshCmdResult struct {
	Results []SshCmdResult `json:"results"`
}

type MciSshCmdResultForAPI struct {
	Results []SshCmdResultForAPI `json:"results"`
}

type MciStatusInfo struct {
	Id   string `json:"id"`
	Name string `json:"name"`

	Status       string          `json:"status"`
	StatusCount  StatusCountInfo `json:"statusCount"`
	TargetStatus string          `json:"targetStatus"`
	TargetAction string          `json:"targetAction"`

	// InstallMonAgent Option for CB-Dragonfly agent installation ([yes/no] default:yes)
	InstallMonAgent string `json:"installMonAgent" example:"[yes, no]"` // yes or no

	MasterVmId    string `json:"masterVmId" example:"vm-asiaeast1-cb-01"`
	MasterIp      string `json:"masterIp" example:"32.201.134.113"`
	MasterSSHPort int    `json:"masterSSHPort"`

	// Label is for describing the object by keywords
	Label map[string]string `json:"label"`

	// SystemLabel is for describing the mci in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`

	Vm []VmStatusInfo `json:"vm"`
}

type MciSubGroupAccessInfo struct {
	SubGroupId      string
	NlbListener     *NLBListenerInfo `json:"nlbListener,omitempty"`
	BastionVmId     string
	MciVmAccessInfo []MciVmAccessInfo
}

type MciVmAccessInfo struct {
	VmId             string     `json:"vmId"`
	PublicIP         string     `json:"publicIP"`
	PrivateIP        string     `json:"privateIP"`
	SSHPort          int        `json:"sshPort"`
	PrivateKey       string     `json:"privateKey,omitempty"`
	VmUserName       string     `json:"vmUserName,omitempty"`
	VmUserPassword   string     `json:"vmUserPassword,omitempty"`
	ConnectionConfig ConnConfig `json:"connectionConfig"`
}

type MonAgentInstallReq struct {
	NsId     string `json:"nsId,omitempty"`
	MciId    string `json:"mciId,omitempty"`
	VmId     string `json:"vmId,omitempty"`
	PublicIp string `json:"publicIp,omitempty"`
	Port     string `json:"port,omitempty"`
	UserName string `json:"userName,omitempty"`
	SshKey   string `json:"sshKey,omitempty"`
	CspType  string `json:"cspType,omitempty"`
}

type MonResultSimple struct {
	Metric string `json:"metric"`
	VmId   string `json:"vmId"`
	Value  string `json:"value"`
	Err    string `json:"err"`
}

type MonResultSimpleResponse struct {
	NsId          string            `json:"nsId"`
	MciId         string            `json:"mciId"`
	MciMonitoring []MonResultSimple `json:"mciMonitoring"`
}

type MultihostBenchmarkReq struct {
	Multihost []BenchmarkReq `json:"multihost"`
}

type NLBAddRemoveVMReq struct {
	TargetGroup NLBTargetGroupInfo `json:"targetGroup"`
}

type NLBHealthCheckerInfo struct {
	Protocol  string `json:"protocol" example:"TCP"` // TCP|HTTP|HTTPS
	Port      string `json:"port" example:"22"`      // Listener Port or 1-65535
	Interval  int    `json:"interval" example:"10"`  // secs, Interval time between health checks.
	Timeout   int    `json:"timeout" example:"10"`   // secs, Waiting time to decide an unhealthy VM when no response.
	Threshold int    `json:"threshold" example:"3"`  // num, The number of continuous health checks to change the VM status.

	KeyValueList []KeyValue `json:"keyValueList"`
}

type NLBHealthCheckerReq struct {
	Interval  int `json:"interval" example:"10"` // secs, Interval time between health checks. 0 = use default.
	Timeout   int `json:"timeout" example:"10"`  // secs, Waiting time to decide an unhealthy VM when no response. 0 = use default.
	Threshold int `json:"threshold" example:"3"` // num, The number of continuous health checks to change the VM status. 0 = use default.
}

type NLBHealthInfo struct {
	AllVMs       []string
	HealthyVMs   []string
	UnHealthyVMs []string
}

type NLBInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Id is unique identifier for the object
	Id string `json:"id" example:"aws-ap-southeast-1"`
	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`
	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"`
	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"`

	// Name is human-readable string to represent the object
	Name string `json:"name" example:"aws-ap-southeast-1"`

	ConnectionName   string     `json:"connectionName"`
	ConnectionConfig ConnConfig `json:"connectionConfig"`

	Type  string // PUBLIC(V) | INTERNAL
	Scope string // REGION(V) | GLOBAL

	Listener NLBListenerInfo `json:"listener"`

	TargetGroup   NLBTargetGroupInfo   `json:"targetGroup"`
	HealthChecker NLBHealthCheckerInfo `json:"healthChecker"`

	CreatedTime time.Time

	Description          string     `json:"description"`
	Status               string     `json:"status"`
	KeyValueList         []KeyValue `json:"keyValueList"`
	AssociatedObjectList []string   `json:"associatedObjectList"`
	IsAutoGenerated      bool       `json:"isAutoGenerated"`
	Location             Location   `json:"location"`

	// SystemLabel is for describing the Resource in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`
}

type NLBListenerInfo struct {
	Protocol string `json:"protocol" example:"TCP"`                                               // TCP|UDP
	IP       string `json:"ip" example:"x.x.x.x"`                                                 // Auto Generated and attached
	Port     string `json:"port" example:"80"`                                                    // 1-65535
	DNSName  string `json:"dnsName" example:"default-group-cd3.elb.ap-northeast-2.amazonaws.com"` // Optional, Auto Generated and attached

	KeyValueList []KeyValue `json:"keyValueList"`
}

type NLBListenerReq struct {
	Protocol string `json:"protocol" example:"TCP"` // TCP|UDP
	Port     string `json:"port" example:"80"`      // 1-65535
}

type NLBReq struct {
	Description string `json:"description"`
	// Existing NLB (used only for option=register)
	CspResourceId string `json:"cspResourceId"`

	Type  string `json:"type" validate:"required" enums:"PUBLIC,INTERNAL" example:"PUBLIC"` // PUBLIC(V) | INTERNAL
	Scope string `json:"scope" validate:"required" enums:"REGION,GLOBAL" example:"REGION"`  // REGION(V) | GLOBAL

	// Frontend
	Listener NLBListenerReq `json:"listener" validate:"required"`
	// Backend
	TargetGroup NLBTargetGroupReq `json:"targetGroup" validate:"required"`
	// HealthChecker
	HealthChecker NLBHealthCheckerReq `json:"healthChecker" validate:"required"`
}

type NLBTargetGroupInfo struct {
	Protocol string `json:"protocol" example:"TCP"` // TCP|HTTP|HTTPS
	Port     string `json:"port" example:"80"`      // Listener Port or 1-65535

	SubGroupId string   `json:"subGroupId" example:"g1"`
	VMs        []string `json:"vms"`

	KeyValueList []KeyValue
}

type NLBTargetGroupReq struct {
	Protocol   string `json:"protocol" example:"TCP"` // TCP|HTTP|HTTPS
	Port       string `json:"port" example:"80"`      // Listener Port or 1-65535
	SubGroupId string `json:"subGroupId" example:"g1"`
}

type NlbSetting struct {
	Enable    string `yaml:"enable"`
	Interval  int    `yaml:"interval"`
	Timeout   int    `yaml:"timeout"`
	Threshold int    `yaml:"threshold"`
}

type Nlbsw struct {
	Sw                      string `yaml:"sw"`
	Version                 string `yaml:"version"`
	CommandNlbPrepare       string `yaml:"commandNlbPrepare"`
	CommandNlbDeploy        string `yaml:"commandNlbDeploy"`
	CommandNlbAddTargetNode string `yaml:"commandNlbAddTargetNode"`
	CommandNlbApplyConfig   string `yaml:"commandNlbApplyConfig"`
	NlbMciSpecId            string `yaml:"nlbMciSpecId"`
	NlbMciImageId           string `yaml:"nlbMciImageId"`
	NlbMciSubGroupSize      int    `yaml:"nlbMciSubGroupSize"`
}

type NsInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Id is unique identifier for the object
	Id string `json:"id" example:"default"`
	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`

	// Name is human-readable string to represent the object
	Name string `json:"name" example:"default"`

	Description string `json:"description" example:"Description for this namespace"`
}

type NsReq struct {
	Name        string `json:"name" example:"default"`
	Description string `json:"description" example:"Description for this namespace"`
}

type OSArchitecture string

type OSPlatform string

type OSTypeDetail struct {
	Name            string           `mapstructure:"name" json:"name"`
	Versions        []string         `mapstructure:"versions" json:"versions"`
	DefaultVersion  string           `mapstructure:"defaultVersion" json:"default_version"`
	Patterns        []string         `mapstructure:"patterns" json:"patterns"`
	BasicImageRules *BasicImageRules `mapstructure:"basicImageRules" json:"basicImageRules,omitempty"`
}

type Object struct {
	Key          string `json:"key" example:"test-object.txt"`
	LastModified string `json:"lastModified" example:"2025-09-04T04:18:06Z"`
	ETag         string `json:"eTag" example:"9b2cf535f27731c974343645a3985328"`
	Size         int64  `json:"size" example:"1024"`
	StorageClass string `json:"storageClass" example:"STANDARD"`
}

type ObjectStorageCreateRequest struct {
	BucketName     string `json:"bucketName" validate:"required" example:"os01"`
	ConnectionName string `json:"connectionName" validate:"required" example:"aws-ap-northeast-2"`
	Description    string `json:"description" example:"this bucket is managed by CB-Tumblebug"`
}

type ObjectStorageFeatureSupport struct {
	Cors       bool `json:"cors" example:"true"`
	Versioning bool `json:"versioning" example:"true"`
}

type ObjectStorageGetCorsResponse struct {
	CorsRule []CorsRule `json:"corsRule"`
}

type ObjectStorageGetVersioningResponse struct {
	Status string `json:"status" example:"Enabled"`
}

type ObjectStorageInfo struct {
	// ResourceType is the type of this resource
	ResourceType string `json:"resourceType" example:"ObjectStorage"`

	// Id is unique identifier for the object
	Id string `json:"id" example:"globally-unique-bucket-name-12345"`
	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`

	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:""`
	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:""`

	// Variables for management of Object Storage resource in CB-Tumblebug
	ConnectionName   string     `json:"connectionName"`
	ConnectionConfig ConnConfig `json:"connectionConfig"`
	Description      string     `json:"description" example:"this object storage is managed by CB-Tumblebug"`
	Status           string     `json:"status"`

	// Name is human-readable string to represent the object
	Name         string   `json:"name" example:"globally-unique-bucket-name-12345"`
	Prefix       string   `json:"prefix,omitempty" example:""`
	Marker       string   `json:"marker,omitempty" example:""`
	MaxKeys      int      `json:"maxKeys,omitempty" example:"1000"`
	IsTruncated  bool     `json:"isTruncated,omitempty" example:"false"`
	CreationDate string   `json:"creationDate,omitempty" example:"2025-09-04T04:18:06Z"`
	Contents     []Object `json:"contents,omitempty"`
}

type ObjectStorageListBucketsResponse struct {
	Owner   Owner   `json:"owner"`
	Buckets Buckets `json:"buckets"`
}

type ObjectStorageListObjectVersionsResponse struct {
	Name                string          `json:"name" example:"example-bucket"`
	Prefix              string          `json:"prefix" example:""`
	KeyMarker           string          `json:"keyMarker" example:""`
	VersionIdMarker     string          `json:"versionIdMarker" example:""`
	NextKeyMarker       string          `json:"nextKeyMarker" example:""`
	NextVersionIdMarker string          `json:"nextVersionIdMarker" example:""`
	MaxKeys             int             `json:"maxKeys" example:"1000"`
	IsTruncated         bool            `json:"isTruncated" example:"false"`
	Version             []ObjectVersion `json:"version"`
	DeleteMarker        []ObjectVersion `json:"deleteMarker"`
}

type ObjectStorageListObjectsResponse struct {
	Objects []Object `json:"objects"`
}

type ObjectStorageListResponse struct {
	ObjectStorage []ObjectStorageInfo `json:"objectStorage"`
}

type ObjectStorageLocationResponse struct {
	LocationConstraint string `json:"locationConstraint" example:"ap-northeast-2"`
}

type ObjectStoragePresignedUrlResponse struct {
	Expires      int64  `json:"expires" example:"1693824000"`
	Method       string `json:"method" example:"GET"`
	PreSignedURL string `json:"presignedURL" example:"https://example.com/presigned-url"`
}

type ObjectStorageSetCorsRequest struct {
	CorsRule []CorsRule `json:"corsRule" validate:"required"`
}

type ObjectStorageSetVersioningRequest struct {
	Status string `json:"status" validate:"required" example:"Enabled"`
}

type ObjectStorageSupportResponse struct {
	ResourceType string                                 `json:"resourceType" example:"objectStorage"`
	Supports     map[string]ObjectStorageFeatureSupport `json:"supports,omitempty"`
}

type ObjectVersion struct {
	Key          string `json:"key,omitempty" example:"test-object.txt"`
	VersionId    string `json:"versionId,omitempty" example:"3/L4kqtJlcpXroDTDmJ+rmSpXd3aIbrC"`
	IsLatest     bool   `json:"isLatest,omitempty" example:"true"`
	LastModified string `json:"lastModified,omitempty" example:"2025-09-04T04:18:06Z"`
	ETag         string `json:"eTag,omitempty" example:"9b2cf535f27731c974343645a3985328"`
	Size         int64  `json:"size,omitempty" example:"1024"`
	StorageClass string `json:"storageClass,omitempty" example:"STANDARD"`
	Owner        Owner  `json:"owner,omitempty"`
}

type Operation struct {
	Operator string `json:"operator" example:"<=" enums:">=,<=,=="` // >=, <=, ==
	Operand  string `json:"operand" example:"4"`                    // 10, 70, 80, 98, ... or string values like "aws", "x86_64"
}

type OperationExample struct {
	Operator string `json:"operator" example:">="`
	Operand  string `json:"operand" example:"2"`
}

type OptionalParameter struct {
	Value string
	Set   bool
}

type OverallRiskInfo struct {
	// Level is the overall risk level: "low", "medium", "high"
	Level string `json:"level"`

	// Message explains the overall risk reasoning
	Message string `json:"message"`

	// PrimaryRiskFactor indicates what the main risk factor is: "spec", "image", "combination", "none"
	PrimaryRiskFactor string `json:"primaryRiskFactor"`
}

type Owner struct {
	ID          string `json:"id" example:"aws-ap-northeast-2"`
	DisplayName string `json:"displayName" example:"aws-ap-northeast-2"`
}

type ParameterKeyVal struct {
	Key string   `json:"key" example:"coordinateClose" enums:"coordinateClose,coordinateWithin,coordinateFair"` // coordinate
	Val []string `json:"val" example:"44.146838/-116.411403"`                                                   // ["Latitude,Longitude","12,543",..,"31,433"]
}

type ParameterKeyValExample struct {
	Key         string   `json:"key" example:"coordinateClose"`
	Description string   `json:"description" example:"Find specs closest to given coordinate"`
	Val         []string `json:"val" example:"37.5665/126.9780"`
}

type ParameterOptionDetail struct {
	Key         string   `json:"key" example:"coordinateClose"`
	Description string   `json:"description" example:"Find specs closest to given coordinate (latitude/longitude)"`
	Format      string   `json:"format" example:"latitude/longitude"`
	Example     []string `json:"example" example:"37.5665/126.9780,35.6762/139.6503"`
}

type ParameterOptionsInfo struct {
	LocationParameters []ParameterOptionDetail `json:"locationParameters" description:"Available parameter options for location-based prioritization"`
	LatencyParameters  []ParameterOptionDetail `json:"latencyParameters" description:"Available parameter options for latency-based prioritization"`
}

type PatternSet struct {
	Include []string `mapstructure:"include" json:"include,omitempty"`
	Exclude []string `mapstructure:"exclude" json:"exclude,omitempty"`
}

type Policy struct {
	AutoCondition AutoCondition `json:"autoCondition"`
	AutoAction    AutoAction    `json:"autoAction"`
	Status        string        `json:"status"`
}

type PrefixLengthDetail struct {
	Min         int    `mapstructure:"min" json:"min,omitempty"`
	Max         int    `mapstructure:"max" json:"max,omitempty"`
	Description string `mapstructure:"description" json:"description"`
}

type PriorityCondition struct {
	Metric    string            `json:"metric" example:"location" enums:"location,cost,random,performance,latency"`
	Weight    float64           `json:"weight" example:"0.3"`
	Parameter []ParameterKeyVal `json:"parameter,omitempty"`
}

type PriorityConditionExample struct {
	Metric      string                   `json:"metric" example:"cost"`
	Description string                   `json:"description" example:"Prioritize by lowest cost"`
	Weight      string                   `json:"weight" example:"1.0"`
	Parameter   []ParameterKeyValExample `json:"parameter,omitempty"`
}

type PriorityInfo struct {
	Policy []PriorityCondition `json:"policy"`
}

type PriorityOptionsInfo struct {
	// Available metrics for prioritization
	AvailableMetrics []string `` /* 129-byte string literal not displayed */

	// Example priority policies
	ExamplePolicies []PriorityConditionExample `json:"examplePolicies" description:"Example priority policies"`

	// Parameter options for location and latency metrics
	ParameterOptions ParameterOptionsInfo `json:"parameterOptions" description:"Available parameter options for location and latency metrics"`
}

type ProvisioningEvent struct {
	// SpecId is the VM specification ID
	SpecId string `json:"specId"`

	// CspImageName is the CSP-specific image name used in this provisioning attempt
	CspImageName string `json:"cspImageName"`

	// IsSuccess indicates if the provisioning was successful
	IsSuccess bool `json:"isSuccess"`

	// ErrorMessage contains the error message if provisioning failed
	ErrorMessage string `json:"errorMessage"`

	// Timestamp is when this provisioning event occurred
	Timestamp time.Time `json:"timestamp"`

	// VmName is the name of the VM that was being provisioned
	VmName string `json:"vmName"`

	// MciId is the MCI ID that this VM belongs to
	MciId string `json:"mciId"`
}

type ProvisioningLog struct {
	// SpecId is the VM specification ID
	SpecId string `json:"specId"`

	// ConnectionName is the connection configuration name
	ConnectionName string `json:"connectionName"`

	// ProviderName is the cloud service provider name
	ProviderName string `json:"providerName"`

	// RegionName is the region name
	RegionName string `json:"regionName"`

	// FailureCount is the total number of provisioning failures
	FailureCount int `json:"failureCount"`

	// SuccessCount is the total number of provisioning successes (only recorded if there were previous failures)
	SuccessCount int `json:"successCount"`

	// FailureTimestamps contains list of failure timestamps
	FailureTimestamps []time.Time `json:"failureTimestamps"`

	// SuccessTimestamps contains list of success timestamps (only recorded if there were previous failures)
	SuccessTimestamps []time.Time `json:"successTimestamps"`

	// FailureMessages contains list of failure error messages
	FailureMessages []string `json:"failureMessages"`

	// FailureImages contains list of CSP image names that failed with this spec
	FailureImages []string `json:"failureImages"`

	// SuccessImages contains list of CSP image names that succeeded with this spec (only recorded if there were previous failures)
	SuccessImages []string `json:"successImages"`

	// LastUpdated is the timestamp of the last log update
	LastUpdated time.Time `json:"lastUpdated"`

	// AdditionalInfo contains any additional information about the provisioning attempts
	AdditionalInfo map[string]string `json:"additionalInfo"`
}

type PublicKeyResponse struct {
	PublicKeyTokenId string `json:"publicKeyTokenId"`
	PublicKey        string `json:"publicKey"`
}

type Range struct {
	Min float32 `json:"min"`
	Max float32 `json:"max"`
}

type ReadyzResponse struct {
	Message     string `json:"message" example:"CB-Tumblebug is ready"`
	Ready       bool   `json:"ready" example:"true"`
	Initialized bool   `json:"initialized" example:"false"`
}

type RecommendSpecReq struct {
	Filter   FilterInfo   `json:"filter"`
	Priority PriorityInfo `json:"priority"`
	Limit    int          `json:"limit" example:"5"`
}

type RecommendSpecRequestOptions struct {
	// Filter options - available filtering fields and their example values
	Filter FilterOptionsInfo `json:"filter" description:"Available filtering options for specs"`

	// Priority options - available prioritization metrics and parameters
	Priority PriorityOptionsInfo `json:"priority" description:"Available prioritization options for specs"`

	// Limit options - example limit values
	Limit []string `json:"limit" example:"5,10,20,50" description:"Example limit values for result count"`
}

type RegionDetail struct {
	RegionId           string   `mapstructure:"id" json:"regionId"`
	RegionName         string   `mapstructure:"regionName" json:"regionName"`
	Description        string   `mapstructure:"description" json:"description"`
	Location           Location `mapstructure:"location" json:"location"`
	Zones              []string `mapstructure:"zone" json:"zones"`
	RepresentativeZone *string  `mapstructure:"representativeZone" json:"representativeZone,omitempty"`
}

type RegionDetails struct {
	Name  string        `json:"name"`
	VNets []VNetDetails `json:"vNets"`
}

type RegionIgnorePatterns struct {
	Patterns []string `yaml:",flow,omitempty"` // Direct array patterns for simplified YAML structure
}

type RegionInfo struct {
	Region string `json:"region" example:"us-east-1"`
	Zone   string `json:"zone,omitempty" example:"us-east-1a"`
}

type RegionList struct {
	Regions []RegionDetail `mapstructure:"regions" json:"regions"`
}

type RegionZoneInfo struct {
	AssignedRegion string `json:"assignedRegion"`
	AssignedZone   string `json:"assignedZone"`
}

type RegisterResourceAllResult struct {
	ElapsedTime           int                      `json:"elapsedTime"`
	RegisteredConnection  int                      `json:"registeredConnection"`
	AvailableConnection   int                      `json:"availableConnection"`
	RegisterationOverview RegisterationOverview    `json:"registerationOverview"`
	RegisterationResult   []RegisterResourceResult `json:"registerationResult"`
}

type RegisterResourceResult struct {
	ConnectionName        string                `json:"connectionName"`
	SystemMessage         string                `json:"systemMessage"`
	ElapsedTime           int                   `json:"elapsedTime"`
	RegisterationOverview RegisterationOverview `json:"registerationOverview"`
	RegisterationOutputs  IdList                `json:"registerationOutputs"`
}

type RegisterSubnetReq struct {
	ConnectionName string `json:"connectionName" validate:"required"`
	CspResourceId  string `json:"cspResourceId" validate:"required"`
	Name           string `json:"name" validate:"required"`
	Zone           string `json:"zone,omitempty"`
	Description    string `json:"description,omitempty"`
}

type RegisterVNetReq struct {
	ConnectionName string `json:"connectionName" validate:"required"`
	CspResourceId  string `json:"cspResourceId" validate:"required"`
	Name           string `json:"name" validate:"required"`
	Description    string `json:"description,omitempty"`
}

type RegisterationOverview struct {
	VNet          int `json:"vNet"`
	SecurityGroup int `json:"securityGroup"`
	SshKey        int `json:"sshKey"`
	DataDisk      int `json:"dataDisk"`
	CustomImage   int `json:"customImage"`
	Vm            int `json:"vm"`
	NLB           int `json:"nlb"`
	Failed        int `json:"failed"`
}

type RequiredAWSResourceForSqlDB struct {
	VNetID    string `json:"vNetID,omitempty" example:"vpc-xxxxx"`
	Subnet1ID string `json:"subnet1ID,omitempty" example:"subnet-xxxx"`
	Subnet2ID string `json:"subnet2ID,omitempty" example:"subnet-xxxx in different AZ"`
}

type RequiredAzureResourceForSqlDB struct {
	ResourceGroup string `json:"resourceGroup,omitempty" example:"koreacentral"`
}

type RequiredCSPResourceForSqlDB struct {
	AWS   RequiredAWSResourceForSqlDB   `json:"aws,omitempty"`
	Azure RequiredAzureResourceForSqlDB `json:"azure,omitempty"`
	NCP   RequiredNCPResourceForSqlDB   `json:"ncp,omitempty"`
}

type RequiredNCPResourceForSqlDB struct {
	SubnetID string `json:"subnetID,omitempty" example:"123456"`
}

type ReservedIPsDetail struct {
	Value       int    `mapstructure:"value" json:"value"`
	Description string `mapstructure:"description" json:"description"`
}

type ResourceCountOverview struct {
	OnTumblebug int `json:"onTumblebug"`
	OnSpider    int `json:"onSpider"`
	OnCspTotal  int `json:"onCspTotal"`
	OnCspOnly   int `json:"onCspOnly"`
}

type ResourceDeleteResult struct {
	// Resource type (e.g., "securityGroup", "sshKey", "vNet")
	ResourceType string `json:"resourceType" example:"securityGroup"`
	// Resource ID
	ResourceId string `json:"resourceId" example:"default-shared-aws-ap-northeast-2"`
	// Whether the deletion was successful
	Success bool `json:"success" example:"true"`
	// Descriptive message (error detail on failure, empty on success)
	Message string `json:"message" example:"Cannot delete resource because it is still referenced by ..."`
}

type ResourceDeleteResults struct {
	// Total number of resources processed
	Total int `json:"total" example:"10"`
	// Number of successfully deleted resources
	SuccessCount int `json:"successCount" example:"8"`
	// Number of failed deletions
	FailedCount int `json:"failedCount" example:"2"`
	// Individual results per resource
	Results []ResourceDeleteResult `json:"results"`
}

type ResourceDetail struct {
	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName" default:"" example:"we12fawefadf1221edcf"`
	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId" default:"" example:"csp-06eb41e14121c550a"`
	// CspResourceDetail is the detailed information of the resource provided from the terrarium.
	CspResourceDetail any `json:"cspResourceDetail"`

	Status string `json:"status,omitempty"`
}

type ResourceIds struct {
	CspResourceId   string
	CspResourceName string
	ConnectionName  string
}

type ResourceOnCsp struct {
	Count int                 `json:"count"`
	Info  []ResourceOnCspInfo `json:"info"`
}

type ResourceOnCspInfo struct {
	CspResourceId string `json:"cspResourceId"`
	RefNameOrId   string `json:"refNameOrId"`
}

type ResourceOnSpider struct {
	Count int                    `json:"count"`
	Info  []ResourceOnSpiderInfo `json:"info"`
}

type ResourceOnSpiderInfo struct {
	IdBySp        string `json:"idBySp"`
	CspResourceId string `json:"cspResourceId"`
}

type ResourceOnTumblebug struct {
	Count int                       `json:"count"`
	Info  []ResourceOnTumblebugInfo `json:"info"`
}

type ResourceOnTumblebugInfo struct {
	IdByTb        string `json:"idByTb"`
	CspResourceId string `json:"cspResourceId"`
	NsId          string `json:"nsId"`
	MciId         string `json:"mciId,omitempty"`
	ObjectKey     string `json:"objectKey"`
}

type ResourceStatusInfo struct {
	Status       string `json:"status"`
	TargetStatus string `json:"targetStatus"`
	TargetAction string `json:"targetAction"`
}

type ResourcesByManageType struct {
	OnTumblebug ResourceOnTumblebug `json:"onTumblebug"`
	OnSpider    ResourceOnSpider    `json:"onSpider"`
	OnCspTotal  ResourceOnCsp       `json:"onCspTotal"`
	OnCspOnly   ResourceOnCsp       `json:"onCspOnly"`
}

type Response struct {
	Success bool                   `json:"success" example:"true"`
	Status  int                    `json:"status,omitempty" example:"200"`
	Message string                 `json:"message" example:"Any message"`
	Detail  string                 `json:"details,omitempty" example:"Any details"`
	Object  map[string]interface{} `json:"object,omitempty"`
	List    []interface{}          `json:"list,omitempty"`
}

type RestGetGlobalDnsRecordResponse struct {
	Record []GlobalDnsRecordInfo `json:"record"`
}

type RestGetHostedZonesResponse struct {
	HostedZones []HostedZoneInfo `json:"hostedZones"`
}

type RestPostSqlDBRequest struct {
	Name                string                      `json:"name" validate:"required" example:"sqldb01"`
	ConnectionName      string                      `json:"connectionName" validate:"required" example:"aws-ap-northeast-2"`
	CSP                 string                      `json:"csp" validate:"required" example:"aws"`
	Region              string                      `json:"region" validate:"required" example:"ap-northeast-2"`
	DBInstanceSpec      string                      `json:"dbInstanceSpec,omitempty" validate:"required" example:"db.t3.micro"`
	DBEnginePort        int                         `json:"dbEnginePort,omitempty" validate:"required" example:"3306"`
	DBEngineVersion     string                      `json:"dbEngineVersion,omitempty" validate:"required" example:"8.0.39"`
	DBAdminUsername     string                      `json:"dbAdminUsername" validate:"required" example:"mydbadmin"`
	DBAdminPassword     string                      `json:"dbAdminPassword" validate:"required" example:"Password1234!"`
	RequiredCSPResource RequiredCSPResourceForSqlDB `json:"requiredCSPResource,omitempty"`
}

type RestPostVpnRequest struct {
	Name  string       `json:"name" validate:"required" example:"vpn01"`
	Site1 SiteProperty `json:"site1" validate:"required"`
	Site2 SiteProperty `json:"site2" validate:"required"`
}

type RestWrapperSecurityGroupUpdateResponse struct {
	Response []SecurityGroupUpdateResponse `json:"response"`
	Summary  UpdateSummary                 `json:"summary"`
}

type RetrievedRegionList struct {
	Region []SpiderRegionZoneInfo `json:"region"`
}

type ReviewMciDynamicReqInfo struct {
	// Overall assessment of the MCI request
	OverallStatus  string `json:"overallStatus" example:"Ready/Warning/Error"`
	OverallMessage string `json:"overallMessage" example:"All VMs can be created successfully"`
	CreationViable bool   `json:"creationViable"`
	EstimatedCost  string `json:"estimatedCost,omitempty" example:"$0.50/hour"`

	// MCI-level information
	MciName      string `json:"mciName"`
	TotalVmCount int    `json:"totalVmCount"`

	// Failure policy analysis
	PolicyOnPartialFailure string `json:"policyOnPartialFailure" example:"continue"`
	PolicyDescription      string `` /* 127-byte string literal not displayed */
	PolicyRecommendation   string `json:"policyRecommendation,omitempty" example:"Consider 'refine' policy for automatic cleanup of failed VMs"`

	// VM-level validation results
	VmReviews []ReviewSubGroupDynamicReqInfo `json:"vmReviews"`

	// Resource availability summary
	ResourceSummary ReviewResourceSummary `json:"resourceSummary"`

	// Recommendations for improvement
	Recommendations []string `json:"recommendations,omitempty"`
}

type ReviewResourceSummary struct {
	TotalProviders  int      `json:"totalProviders"`
	TotalRegions    int      `json:"totalRegions"`
	UniqueSpecs     []string `json:"uniqueSpecs"`
	UniqueImages    []string `json:"uniqueImages"`
	ConnectionNames []string `json:"connectionNames"`

	// Provider and region details
	ProviderNames []string `json:"providerNames"`
	RegionNames   []string `json:"regionNames"`

	// Resource availability counts
	AvailableSpecs    int `json:"availableSpecs"`
	UnavailableSpecs  int `json:"unavailableSpecs"`
	AvailableImages   int `json:"availableImages"`
	UnavailableImages int `json:"unavailableImages"`
}

type ReviewResourceValidation struct {
	ResourceId    string `json:"resourceId"`
	ResourceName  string `json:"resourceName,omitempty"`
	IsAvailable   bool   `json:"isAvailable"`
	Status        string `json:"status" example:"Available/Unavailable/Unknown"`
	Message       string `json:"message,omitempty"`
	CspResourceId string `json:"cspResourceId,omitempty"`
}

type ReviewSubGroupDynamicReqInfo struct {
	// VM request information
	VmName       string `json:"vmName"`
	SubGroupSize int    `json:"subGroupSize"`

	// Validation status
	Status    string `json:"status" example:"Ready/Warning/Error"`
	Message   string `json:"message" example:"VM can be created successfully"`
	CanCreate bool   `json:"canCreate"`

	// Resource validation details
	SpecValidation  ReviewResourceValidation `json:"specValidation"`
	ImageValidation ReviewResourceValidation `json:"imageValidation"`

	// Connection and region info
	ConnectionName string `json:"connectionName"`
	ProviderName   string `json:"providerName"`
	RegionName     string `json:"regionName"`

	// Cost estimation
	EstimatedCost string `json:"estimatedCost,omitempty" example:"$0.10/hour"`

	// General information and configuration notes
	Info []string `json:"info,omitempty"`

	// Warnings and errors
	Warnings []string `json:"warnings,omitempty"`
	Errors   []string `json:"errors,omitempty"`
}

type RiskAnalysis struct {
	// SpecRisk contains spec-specific risk analysis
	SpecRisk SpecRiskInfo `json:"specRisk"`

	// ImageRisk contains image-specific risk analysis
	ImageRisk ImageRiskInfo `json:"imageRisk"`

	// OverallRisk contains overall combined risk assessment
	OverallRisk OverallRiskInfo `json:"overallRisk"`

	// Recommendations provides actionable guidance for users
	Recommendations []string `json:"recommendations"`

	// RecentFailureMessages contains recent failure messages for context (up to 5 most recent, unique messages)
	RecentFailureMessages []string `json:"recentFailureMessages,omitempty"`
}

type RuntimeConfig struct {
	Cloud Cloud `yaml:"cloud"`
	Nlbsw Nlbsw `yaml:"nlbsw"`
}

type ScaleOutSubGroupReq struct {
	// Define addtional VMs to scaleOut
	NumVMsToAdd int `json:"numVMsToAdd" validate:"required" example:"2"`
}

type ScheduleJobListResponse struct {
	Jobs []ScheduleJobStatus `json:"jobs"`
}

type ScheduleJobRequest struct {
	JobType         string `json:"jobType" validate:"required" example:"registerCspResources"` // Job type: registerCspResources, registerCspResourcesAll
	NsId            string `json:"nsId" validate:"required" example:"default"`                 // Namespace ID
	IntervalSeconds int    `json:"intervalSeconds" validate:"required,min=10" example:"60"`    // Execution interval in seconds

	// Job-specific parameters (for registerCspResources)
	ConnectionName string `json:"connectionName,omitempty" example:"aws-ap-northeast-2"` // (Deprecated) Connection configuration name. Use Provider/Region/Zone instead
	Provider       string `json:"provider,omitempty" example:"aws"`                      // Cloud provider name. Empty: all providers
	Region         string `json:"region,omitempty" example:"ap-northeast-2"`             // Region name. Requires Provider. Empty: all regions for the provider
	Zone           string `json:"zone,omitempty" example:"ap-northeast-2a"`              // Zone name. Requires Provider and Region. Empty: all zones for the region
	MciNamePrefix  string `json:"mciNamePrefix,omitempty" example:"mci-01"`              // MCI name prefix
	Option         string `json:"option,omitempty" example:"vNet,securityGroup"`         // Resource types (csv): vNet, securityGroup, sshKey, vm, dataDisk, customImage. Empty: all
	MciFlag        string `json:"mciFlag,omitempty" example:"y"`                         // MCI flag: y or n
}

type ScheduleJobStatus struct {
	JobId               string    `json:"jobId" example:"registerCspResources-default-1698765432"`
	JobType             string    `json:"jobType" example:"registerCspResources"`
	NsId                string    `json:"nsId" example:"default"`
	Status              string    `json:"status" example:"Scheduled"`
	IntervalSeconds     int       `json:"intervalSeconds" example:"60"`
	Enabled             bool      `json:"enabled" example:"true"`
	CreatedAt           time.Time `json:"createdAt" example:"2023-10-27T10:30:00Z"`
	LastExecutedAt      time.Time `json:"lastExecutedAt,omitempty" example:"2023-10-27T11:30:00Z"`
	NextExecutionAt     time.Time `json:"nextExecutionAt,omitempty" example:"2023-10-27T12:30:00Z"`
	ExecutionCount      int       `json:"executionCount" example:"5"`
	SuccessCount        int       `json:"successCount" example:"4"`        // Total successful executions
	FailureCount        int       `json:"failureCount" example:"1"`        // Total failed executions
	ConsecutiveFailures int       `json:"consecutiveFailures" example:"0"` // Current consecutive failures
	AutoDisabled        bool      `json:"autoDisabled" example:"false"`    // Whether job was auto-disabled due to failures
	LastError           string    `json:"lastError,omitempty" example:""`
	LastResult          string    `json:"lastResult,omitempty" example:"Success (execution #5)"`

	// Job-specific parameters
	ConnectionName string `json:"connectionName,omitempty" example:"aws-ap-northeast-2"` // (Deprecated)
	Provider       string `json:"provider,omitempty" example:"aws"`
	Region         string `json:"region,omitempty" example:"ap-northeast-2"`
	Zone           string `json:"zone,omitempty" example:"ap-northeast-2a"`
	MciNamePrefix  string `json:"mciNamePrefix,omitempty" example:"mci-01"`
	Option         string `json:"option,omitempty" example:""`
	MciFlag        string `json:"mciFlag,omitempty" example:"y"`
}

type SearchImageRequest struct {

	// MatchedSpecId is the ID of the matched spec.
	// If specified, only the images that match this spec will be returned.
	// This is useful when the user wants to search images that match a specific spec.
	MatchedSpecId string `` /* 179-byte string literal not displayed */

	// Cloud Service Provider (ex: "aws", "azure", "gcp", etc.). Use GET /provider to get the list of available providers.
	ProviderName string `json:"providerName" example:"aws"`

	// Cloud Service Provider Region (ex: "us-east-1", "us-west-2", etc.). Use GET /provider/{providerName}/region to get the list of available regions.
	RegionName string `json:"regionName" example:"us-east-1"`

	// Simplified OS name and version string. Space-separated for AND condition (ex: "ubuntu 22.04", "windows 10", etc.).
	OSType string `json:"osType" example:"ubuntu 22.04" description:"Simplified OS name and version string. Space-separated for AND condition"`

	// The architecture of the operating system of the image. (ex: "x86_64", "arm64", etc.)
	OSArchitecture OSArchitecture `` /* 137-byte string literal not displayed */

	// Whether the image is ready for GPU usage or not.
	// In usual, true means the image is ready for GPU usage with GPU drivers and libraries installed.
	// If not specified, both true and false images will be included in the search results.
	// Even if the image is not ready for GPU usage, it can be used with GPU by installing GPU drivers and libraries manually.
	IsGPUImage *bool `json:"isGPUImage" example:"false"`

	// Whether this image can be used to create K8s nodes.
	// For AWS/GCP, only type identifiers registered in cloudimage.csv are true.
	// If not specified, both true and false images will be included in the search results.
	// Images that are not specialized for Kubernetes also can be used as Kubernetes nodes. It depends on CSPs.
	IsKubernetesImage *bool `json:"isKubernetesImage" example:"false"`

	// Whether the image is registered by CB-Tumblebug asset file or not.
	IsRegisteredByAsset *bool `json:"isRegisteredByAsset" example:"false" description:"Whether the image is registered by asset or not."`

	// Whether the search results should include deprecated images or not.
	// If not specified, deprecated images will not be included in the search results.
	// In usual, deprecated images are not recommended to use, but they can be used if necessary.
	IncludeDeprecatedImage *bool `json:"includeDeprecatedImage" example:"false" description:"Include deprecated images in the search results."`

	// IncludeBasicImageOnly is to return basic OS distribution only without additional applications.
	// If true, the search results will include only the basic OS distribution without additional applications.
	// If false or not specified, the search results will include images with additional applications installed.
	IncludeBasicImageOnly *bool `json:"includeBasicImageOnly" example:"false" description:"Return basic OS distribution only without additional applications."`

	// MaxResults is the maximum number of images to be returned in the search results.
	// If not specified, all images will be returned.
	// If specified, the number of images returned will be limited to the specified value.
	MaxResults *int `` /* 155-byte string literal not displayed */

	// Keywords for searching images in detail.
	// Space-separated for AND condition (ex: "sql 2022", "ubuntu 22.04", etc.).
	// Used for if the user wants to search images with specific keywords in their details.
	DetailSearchKeys []string `json:"detailSearchKeys" example:"tensorflow,2.17" description:"Keywords for searching images in detail"`
}

type SearchImageRequestOptions struct {

	// MatchedSpecId is the ID of the matched spec.
	// If specified, only the images that match this spec will be returned.
	// This is useful when the user wants to search images that match a specific spec.
	MatchedSpecId []string `` /* 169-byte string literal not displayed */

	// Cloud Service Provider (ex: "aws", "azure", "gcp", etc.). Use GET /provider to get the list of available providers.
	ProviderName []string `json:"providerName"`

	// Cloud Service Provider Region (ex: "us-east-1", "us-west-2", etc.). Use GET /provider/{providerName}/region to get the list of available regions.
	RegionName []string `json:"regionName"`

	// Simplified OS name and version string. Space-separated for AND condition (ex: "ubuntu 22.04", "windows 10", etc.).
	OSType []string `json:"osType" description:"Simplified OS name and version string. Space-separated for AND condition"`

	// The architecture of the operating system of the image. (ex: "x86_64", "arm64", etc.)
	OSArchitecture []string `json:"osArchitecture" description:"The architecture of the operating system of the image."`

	// Whether the image is ready for GPU usage or not.
	// In usual, true means the image is ready for GPU usage with GPU drivers and libraries installed.
	// If not specified, both true and false images will be included in the search results.
	// Even if the image is not ready for GPU usage, it can be used with GPU by installing GPU drivers and libraries manually.
	IsGPUImage []bool `json:"isGPUImage" description:"Whether the image is ready for GPU usage or not."`

	// Whether the image is specialized image only for Kubernetes nodes.
	// If not specified, both true and false images will be included in the search results.
	// Images that are not specialized for Kubernetes also can be used as Kubernetes nodes. It depends on CSPs.
	IsKubernetesImage []bool `` /* 164-byte string literal not displayed */

	// Whether the image is registered by CB-Tumblebug asset file or not.
	IsRegisteredByAsset []bool `json:"isRegisteredByAsset" description:"Whether the image is registered by asset or not."`

	// Whether the search results should include deprecated images or not.
	// If not specified, deprecated images will not be included in the search results.
	// In usual, deprecated images are not recommended to use, but they can be used if necessary.
	IncludeDeprecatedImage []bool `json:"includeDeprecatedImage" description:"Include deprecated images in the search results."`

	// MaxResults is the maximum number of images to be returned in the search results.
	// If not specified, all images will be returned.
	// If specified, the number of images returned will be limited to the specified value.
	MaxResults []int `` /* 155-byte string literal not displayed */

	// Keywords for searching images in detail.
	// Space-separated for AND condition (ex: "sql 2022", "ubuntu 22.04", etc.).
	// Used for if the user wants to search images with specific keywords in their details.
	DetailSearchKeys [][]string `json:"detailSearchKeys" description:"Keywords for searching images in detail"`
}

type SearchImageResponse struct {
	ImageCount int         `json:"imageCount"`
	ImageList  []ImageInfo `json:"imageList"`
}

type SecurityGroupInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType"`

	// Id is unique identifier for the object
	Id string `json:"id" example:"aws-ap-southeast-1"`
	// Uid is universally unique identifier for the object, used for labelSelector
	Uid string `json:"uid,omitempty" example:"wef12awefadf1221edcf"`
	// CspResourceName is name assigned to the CSP resource. This name is internally used to handle the resource.
	CspResourceName string `json:"cspResourceName,omitempty" example:"we12fawefadf1221edcf"`
	// CspResourceId is resource identifier managed by CSP
	CspResourceId string `json:"cspResourceId,omitempty" example:"csp-06eb41e14121c550a"`

	// Name is human-readable string to represent the object
	Name string `json:"name" example:"aws-ap-southeast-1"`

	ConnectionName   string     `json:"connectionName"`
	ConnectionConfig ConnConfig `json:"connectionConfig"`

	VNetId               string             `json:"vNetId"`
	Description          string             `json:"description"`
	FirewallRules        []FirewallRuleInfo `json:"firewallRules"`
	KeyValueList         []KeyValue         `json:"keyValueList"`
	AssociatedObjectList []string           `json:"associatedObjectList"`
	IsAutoGenerated      bool               `json:"isAutoGenerated"`

	// SystemLabel is for describing the Resource in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`
}