model

type AgentInstallContent struct {
	InfraId string `json:"infraId"`
	NodeId  string `json:"nodeId"`
	NodeIp  string `json:"nodeIp"`
	Result  string `json:"result"`
}

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

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

type AlternativeNodeConfigCandidate struct {
	// Rank is 1-based; lower rank = higher similarity.
	Rank int `json:"rank"`
	// SimilarityScore is 0.0–100.0; computed from "preferred" fields only.
	SimilarityScore float64 `json:"similarityScore"`

	Spec     SpecInfo `json:"spec"`
	SpecDiff SpecDiff `json:"specDiff"`

	// PrimaryImage is the best-matched image for the candidate spec.
	// For GPU specs: prefers isBasicGpuImage=true, then isGPUImage=true.
	// For non-GPU specs: prefers isBasicImage=true.
	// Nil when no image is found.
	PrimaryImage *ImageInfo `json:"primaryImage,omitempty"`

	// AlternativeImages are additional image options (up to ImageAlternativeLimit).
	AlternativeImages []ImageInfo `json:"alternativeImages,omitempty"`
}

type AssetsSummaryResponse struct {
	NamespaceID       string                 `json:"namespaceId" example:"system"`
	TotalSpecCount    int64                  `json:"totalSpecCount" example:"45000"`
	PricedSpecCount   int64                  `json:"pricedSpecCount" example:"43000"`
	UnpricedSpecCount int64                  `json:"unpricedSpecCount" example:"2000"`
	TotalImageCount   int64                  `json:"totalImageCount" example:"18000"`
	Providers         []ProviderAssetSummary `json:"providers"`
}

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

type AutoAction struct {
	ActionType          string                    `json:"actionType" example:"ScaleOut" enums:"ScaleOut,ScaleIn"`
	NodeGroupDynamicReq CreateNodeGroupDynamicReq `json:"nodeGroupDynamicReq"`

	// PostCommand is field for providing command to Nodes after their 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   InfraCmdReq `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 AvailabilityQuery struct {
	Provider           string // CSP identifier (e.g., "alibaba", "azure")
	Region             string // CSP-native region (e.g., "cn-qingdao")
	InstanceType       string // CSP-native instance type (e.g., "ecs.gn6i-c4g1.xlarge")
	SystemDiskCategory string // CSP-native disk category (optional, e.g., "cloud_essd")
	PreferredZone      string // optional zone hint
	ImageId            string // optional image id (some CSPs validate compatibility)
}

type AvailabilityResult struct {
	Provider     string             `json:"provider"`
	Region       string             `json:"region"`
	InstanceType string             `json:"instanceType"`
	Available    bool               `json:"available"`
	Zones        []ZoneAvailability `json:"zones,omitempty"`
	Reason       string             `json:"reason,omitempty"` // explanation when Available is false (or when no checker)
	Source       string             `json:"source,omitempty"` // checker identifier for tracing (e.g., "alibaba:DescribeAvailableResource")
	Cached       bool               `json:"cached,omitempty"` // true if served from cache
	QueriedAt    time.Time          `json:"queriedAt"`        // time of original (uncached) query
}

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 {
	NodeId []string `json:"nodeId"`
}

type BastionNode struct {
	NsId    string `json:"nsId,omitempty"`
	InfraId string `json:"infraId"`
	NodeId  string `json:"nodeId"`
}

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 {
	// Infra configuration for creating the infrastructure
	SourceInfraReq InfraDynamicReq `json:"sourceInfraReq" validate:"required"`

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

	// Whether to cleanup (terminate) Infra after snapshot creation
	CleanupInfraAfterSnapshot bool `json:"cleanupInfraAfterSnapshot" example:"true" default:"true"`
}

type BuildAgnosticImageResult struct {
	// Infra information
	InfraId        string `json:"infraId" example:"infra01"`
	Namespace      string `json:"namespace" example:"default"`
	InfraStatus    string `json:"infraStatus" example:"Running"`
	InfraCleanedUp bool   `json:"infraCleanedUp" example:"true"`

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

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

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 CSPImageIgnorePatterns 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 CheckInfraDynamicReqInfo struct {
	ReqCheck []CheckNodeGroupDynamicReqInfo `json:"reqCheck" validate:"required"`
}

type CheckK8sClusterDynamicReqInfo struct {
	ReqCheck []CheckNodeDynamicReqInfo `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 CheckNodeGroupDynamicReqInfo 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 CloudImageIgnoreConfig struct {
	Global GlobalIgnorePatterns              `yaml:"global"`
	CSPs   map[string]CSPImageIgnorePatterns `yaml:"csps,omitempty"`
}

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 {
	// TotalNodes is the number of Nodes that were targeted
	TotalNodes int `json:"totalNodes" example:"3"`

	// CompletedNodes is the number of Nodes that completed successfully
	CompletedNodes int `json:"completedNodes" example:"2"`

	// FailedNodes is the number of Nodes that failed
	FailedNodes int `json:"failedNodes" 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 Nodes (e.g., preprocessing error)
	Error string `json:"error,omitempty" example:"built-in function GetPublicIP error: no Node 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 Node
	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 Node (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"`

	// NodeId identifies which Node this event belongs to
	NodeId string `json:"nodeId" example:"g1-1"`

	// CommandIndex is the command status index in NodeInfo.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 Condition struct {
	Type               ConditionType   `json:"type"`
	Status             ConditionStatus `json:"status"`
	Reason             string          `json:"reason,omitempty"`
	Message            string          `json:"message,omitempty"`
	LastTransitionTime string          `json:"lastTransitionTime,omitempty"`
}

type ConditionStatus string

type ConditionType 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 ControlNodeResult struct {
	NodeId string `json:"nodeId"`
	Status string `json:"Status"`
	Error  error  `json:"Error"`
}

type ControlNodeResultWrapper struct {
	ResultArray []ControlNodeResult `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 CreateNodeGroupDynamicReq struct {
	// NodeGroup name, actual Node name will be generated with -N postfix.
	Name string `json:"name" example:"g1"`

	// NodeGroupSize is the number of Nodes to create in this NodeGroup. If > 0, nodeGroup will be generated. Default is 1.
	NodeGroupSize int `json:"nodeGroupSize" 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.

	NodeUserPassword string `json:"nodeUserPassword,omitempty" example:"" default:""`
	// if ConnectionName is given, the Node 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 Node placement.
	// If specified, subnet will be created in this zone for resources like GPU Nodes
	// 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 Infra-level VNetTemplateId for this NodeGroup.
	// If empty, inherits the VNetTemplateId from the parent InfraDynamicReq.
	VNetTemplateId string `json:"vNetTemplateId,omitempty" example:""`

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

type CreateNodeGroupReq struct {
	// NodeGroup name of Nodes. Actual Node 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"`

	// NodeGroupSize is the number of Nodes to create in this NodeGroup. If > 0, nodeGroup will be generated.
	NodeGroupSize int `json:"nodeGroupSize" 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"`
	// CspImageName is the CSP-side image identifier pre-resolved by EnsureImageAvailable
	// at nodegroup level (Alibaba/Azure latest-version resolution included). When non-empty
	// and the image is not a custom image, CreateNode skips the redundant per-VM GetImage
	// DB call, significantly reducing concurrent DB load during large infra creation.
	// Custom images always go through the full GetImage path (this field stays empty for them).
	CspImageName     string   `json:"cspImageName,omitempty"`
	VNetId           string   `json:"vNetId" validate:"required"`
	SubnetId         string   `json:"subnetId" validate:"required"`
	SecurityGroupIds []string `json:"securityGroupIds" validate:"required"`
	SshKeyId         string   `json:"sshKeyId" validate:"required"`
	NodeUserName     string   `json:"nodeUserName,omitempty"`
	NodeUserPassword string   `json:"nodeUserPassword,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"`
	// Tencent *TencentSpecificProperty `json:"tencent,omitempty"`
	// Ibm     *IbmSpecificProperty     `json:"ibm,omitempty"`
	OpenStack *OpenStackSpecificProperty `json:"openstack,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"`
	SourceNodeId   string `json:"sourceNodeId"`
	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/infra/infra01/node/aws-ap-southeast-1-1"`
	CreatedTime          time.Time  `json:"createdTime" 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 DataDiskNodeReq 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 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 DfAgentInstallReq struct {
	NsId        string `json:"ns_id"`
	InfraId     string `json:"infra_id"`
	NodeId      string `json:"node_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:nodeId:index)
	TaskId string `json:"taskId" example:"req-12345678:node-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"`

	// InfraId is the Infra ID
	InfraId string `json:"infraId" example:"infra01"`

	// NodeId is the target Node ID
	NodeId string `json:"nodeId,omitempty" example:"g1-1"`

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

	// NodeGroupId is the target nodegroup ID (empty if not specified)
	NodeGroupId string `json:"nodeGroupId,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 Nodes"`

	// TargetNodeCount is the number of Nodes targeted by this task
	TargetNodeCount int `json:"targetNodeCount" example:"3"`

	// CompletedNodeCount is the number of Nodes that have completed execution
	CompletedNodeCount int `json:"completedNodeCount" 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"`
	GPUExcludePatterns []string                `mapstructure:"gpuExcludePatterns" json:"gpu_exclude_patterns"`
	BasicGpuImageRules *BasicImageRules        `mapstructure:"basicGpuImageRules" json:"basic_gpu_image_rules,omitempty"`
	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:"infra.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:"infra.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 {
	Infra *GlobalDnsInfraSource `json:"infra,omitempty" description:"(Method 1) Infra 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 GlobalDnsInfraSource struct {
	NsId    string `json:"nsId" validate:"required" example:"default" description:"Namespace ID"`
	InfraId string `json:"infraId" validate:"required" example:"infra-01" description:"Infra ID"`
}

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

type GlobalDnsRecordInfo struct {
	Name          string   `json:"name" example:"infra.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:"infra.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 `` /* 131-byte string literal not displayed */

	// --- 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 {
	// NodeId is the Node identifier
	NodeId string `json:"nodeId" 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 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" 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"`
	// SourceNodeUid is the UID of the source Node from which this image was created
	SourceNodeUid string `json:"sourceNodeUid" 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 `` /* 192-byte string literal not displayed */
	IsBasicGpuImage   bool `` /* 240-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 InfraAccessInfo struct {
	InfraId                  string
	InfraNlbListener         *InfraAccessInfo `json:"infraNlbListener,omitempty"`
	InfraNodeGroupAccessInfo []InfraNodeGroupAccessInfo
}

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

	NodeGroupIds []string `json:"nodeGroupIds"`
	NodeIds      []string `json:"nodeIds"`
	CspNodeNames []string `json:"cspNodeNames"`
	CspNodeIds   []string `json:"cspNodeIds"`
	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 InfraClusterInfo struct {
	// Id is a deterministic cluster identifier generated from grouping attributes.
	Id string `json:"id"`

	// Name is a human-readable cluster name. Currently same as Id.
	Name string `json:"name"`

	// InfraId is the parent Infra ID.
	InfraId string `json:"infraId"`

	// VNetId is the shared VNet boundary used for implicit clustering.
	VNetId string `json:"vNetId,omitempty"`

	// ConnectionNames are unique connection names included in this cluster.
	ConnectionNames []string `json:"connectionNames"`

	// ProviderNames are unique CSP providers included in this cluster.
	ProviderNames []string `json:"providerNames"`

	// RegionNames are unique regions included in this cluster.
	RegionNames []string `json:"regionNames"`

	// NodeGroupIds are NodeGroups that belong to this implicit cluster.
	NodeGroupIds []string `json:"nodeGroupIds"`

	// NodeIds are Nodes that belong to this implicit cluster.
	NodeIds []string `json:"nodeIds"`

	// NodeGroupCount is the number of NodeGroups in this cluster.
	NodeGroupCount int `json:"nodeGroupCount"`

	// NodeCount is the number of Nodes in this cluster.
	NodeCount int `json:"nodeCount"`

	// RepresentativeNodeGroupId is a representative NodeGroup ID for quick inspection.
	RepresentativeNodeGroupId string `json:"representativeNodeGroupId,omitempty"`

	// RepresentativeNodeId is a representative Node ID for quick inspection.
	RepresentativeNodeId string `json:"representativeNodeId,omitempty"`
}

type InfraClusterList struct {
	Cluster []InfraClusterInfo `json:"cluster"`
}

type InfraCmdReq 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 InfraConnectionConfigCandidatesReq 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 InfraCreationErrors struct {
	// NodeObjectCreationErrors contains errors from Node object creation phase
	NodeObjectCreationErrors []NodeCreationError `json:"nodeObjectCreationErrors,omitempty"`

	// NodeCreationErrors contains errors from actual Node creation phase
	NodeCreationErrors []NodeCreationError `json:"nodeCreationErrors,omitempty"`

	// TotalNodeCount is the total number of Nodes that were supposed to be created
	TotalNodeCount int `json:"totalNodeCount"`

	// SuccessfulNodeCount is the number of Nodes that were successfully created
	SuccessfulNodeCount int `json:"successfulNodeCount"`

	// FailedNodeCount is the number of Nodes that failed to be created
	FailedNodeCount int `json:"failedNodeCount"`

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

type InfraDynamicReq struct {
	Name string `json:"name" validate:"required" example:"infra01"`

	// PolicyOnPartialFailure determines how to handle Node creation failures
	// - "continue": Continue with partial Infra creation (default)
	// - "rollback": Cleanup entire Infra when any Node fails
	// - "refine": Mark failed Nodes 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

	// NodeGroups is array of Node requests for multi-cloud infrastructure
	// Example: Multiple Node groups across different CSPs
	// [
	//   {
	//     "name": "aws-group",
	//     "nodeGroupSize": "3",
	//     "specId": "aws+ap-northeast-2+t3.nano",
	//     "imageId": "ami-01f71f215b23ba262",
	//     "rootDiskSize": "50",
	//     "label": {"role": "worker", "csp": "aws"}
	//   },
	//   {
	//     "name": "azure-group",
	//     "nodeGroupSize": "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",
	//     "nodeGroupSize": "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"}
	//   }
	// ]
	NodeGroups []CreateNodeGroupDynamicReq `json:"nodeGroups" validate:"required"`

	// PostCommand is for the command to bootstrap the Nodes
	PostCommand InfraCmdReq `json:"postCommand"`

	// SystemLabel is for describing the infra 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 NodeGroups unless overridden
	// at the NodeGroup level. If empty, the default hard-coded CIDR behavior is used.
	VNetTemplateId string `json:"vNetTemplateId,omitempty" example:"vnet-default"`

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

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

	// 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
	// - "infra:{nsId}/{infraId}": extracted from an existing Infra
	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"`

	// InfraDynamicReq is the template body (Infra dynamic request)
	InfraDynamicReq InfraDynamicReq `json:"infraDynamicReq"`
}

type InfraDynamicTemplateListResponse struct {
	Templates []InfraDynamicTemplateInfo `json:"templates"`
}

type InfraDynamicTemplateReq 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"`

	// InfraDynamicReq is the template body (Infra dynamic request configuration)
	InfraDynamicReq InfraDynamicReq `json:"infraDynamicReq" validate:"required"`
}

type InfraFileTransferAndCmdResult struct {
	FileTransferResults []SshCmdResult `json:"fileTransferResults"`
	CmdResults          []SshCmdResult `json:"cmdResults,omitempty"`
}

type InfraFileTransferAndCmdResultForAPI struct {
	FileTransferResults InfraSshCmdResultForAPI  `json:"fileTransferResults"`
	CmdResults          *InfraSshCmdResultForAPI `json:"cmdResults,omitempty"`
}

type InfraHandlingCommandCountResponse struct {
	// InfraId is the Infra identifier
	InfraId string `json:"infraId" example:"infra01"`

	// NodeHandlingCounts is a map of Node ID to handling command count
	NodeHandlingCounts map[string]int `json:"nodeHandlingCounts"`

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

type InfraInfo 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 infra 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"`
	Node          []NodeInfo `json:"node"`

	// Cluster is the list of implicit clusters synthesized at query-time from Nodes.
	Cluster []InfraClusterInfo `json:"cluster,omitempty"`

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

	// PostCommand is for the command to bootstrap the Nodes
	PostCommand InfraCmdReq `json:"postCommand"`

	// PostCommandResult is the result of the command for bootstraping the Nodes
	PostCommandResult InfraSshCmdResult `json:"postCommandResult"`

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

type InfraNodeAccessInfo struct {
	NodeId           string     `json:"nodeId"`
	PublicIP         string     `json:"publicIP"`
	PrivateIP        string     `json:"privateIP"`
	SSHPort          int        `json:"sshPort"`
	PrivateKey       string     `json:"privateKey,omitempty"`
	NodeUserName     string     `json:"nodeUserName,omitempty"`
	NodeUserPassword string     `json:"nodeUserPassword,omitempty"`
	ConnectionConfig ConnConfig `json:"connectionConfig"`
}

type InfraNodeGroupAccessInfo struct {
	NodeGroupId    string
	NlbListener    *NLBListenerInfo `json:"nlbListener,omitempty"`
	BastionNodeId  string
	NodeAccessInfo []InfraNodeAccessInfo
}

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

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

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

type InfraRecommendReq struct {
	NodeReq        []NodeRecommendReq `json:"nodeReq"`
	PlacementAlgo  string             `json:"placementAlgo"`
	PlacementParam []KeyValue         `json:"placementParam"`
	MaxResultNum   string             `json:"maxResultNum"`
}

type InfraReq struct {
	Name string `json:"name" validate:"required" example:"infra01"`

	// 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 infra 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"`

	NodeGroups []CreateNodeGroupReq `json:"nodeGroups" validate:"required"`

	// PostCommand is for the command to bootstrap the Nodes
	PostCommand InfraCmdReq `json:"postCommand" validate:"omitempty"`

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

type InfraSnapshotResult struct {
	InfraId      string               `json:"infraId" example:"infra01"`
	Namespace    string               `json:"namespace" example:"default"`
	SuccessCount int                  `json:"successCount" example:"3"`
	FailCount    int                  `json:"failCount" example:"0"`
	Results      []NodeSnapshotResult `json:"results"`
}

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

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

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

	MasterNodeId  string `json:"masterNodeId" example:"node-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 infra in a keyword (any string can be used) for special System purpose
	SystemLabel string `json:"systemLabel" example:"Managed by CB-Tumblebug" default:""`

	Node []NodeStatusInfo `json:"node"`
}

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,node"`
}

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"`
	// InitialNodeGroupManagedByCluster indicates that the initial node group created during
	// cluster creation is lifecycle-bound to the cluster and cannot be deleted independently
	// via the node group API (e.g., Alibaba ACK, Tencent TKE).
	InitialNodeGroupManagedByCluster bool                        `mapstructure:"initialNodeGroupManagedByCluster" json:"initial_nodegroup_managed_by_cluster"`
	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 K8sClusterDynamicTemplateInfo struct {
	// ResourceType is the type of the resource
	ResourceType string `json:"resourceType" example:"k8sCluster"`

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

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

	// Description of the template
	Description string `json:"description" example:"Multi-cloud K8s cluster template"`

	// Source indicates where this template was created from
	// - "user": manually created by user
	// - "k8sCluster:{nsId}/{k8sClusterId}": extracted from an existing K8sCluster
	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"`

	// K8sMultiClusterDynamicReq is the template body (K8s multi-cluster dynamic request)
	K8sMultiClusterDynamicReq K8sMultiClusterDynamicReq `json:"k8sMultiClusterDynamicReq"`
}

type K8sClusterDynamicTemplateListResponse struct {
	Templates []K8sClusterDynamicTemplateInfo `json:"templates"`
}

type K8sClusterDynamicTemplateReq struct {
	// Name is the template ID and name
	Name string `json:"name" validate:"required" example:"k8s-across-global"`

	// Description of the template
	Description string `json:"description" example:"Multi-cloud K8s cluster template"`

	// K8sMultiClusterDynamicReq is the template body (K8s multi-cluster dynamic request configuration)
	K8sMultiClusterDynamicReq K8sMultiClusterDynamicReq `json:"k8sMultiClusterDynamicReq" validate:"required"`
}

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"`
}

type K8sClusterKubeconfigResponse struct {
	Kubeconfig string `json:"kubeconfig" example:"apiVersion: v1\nkind: Config\n..."`
}

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 K8sClusterTemplateApplyReq struct {
	// NamePrefix for the new K8s clusters to be created from the template (maps to K8sMultiClusterDynamicReq.NamePrefix)
	NamePrefix string `json:"namePrefix" validate:"required" example:"my-k8s"`

	// Description for the new K8s clusters (optional, propagated to all clusters)
	Description string `json:"description" example:"K8s clusters created from template"`
}

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

	// IsInitialNodeGroup indicates whether this node group was created during cluster creation.
	// For some CSPs (Alibaba ACK, Tencent TKE), this node group cannot be deleted independently;
	// it is automatically removed when the cluster is deleted.
	IsInitialNodeGroup bool `json:"isInitialNodeGroup,omitempty"`

	// 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"`
}

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

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

type McNlbInfo struct {
	InfraAccessInfo *InfraAccessInfo  `json:"infraAccessInfo"`
	McNlbHostInfo   *InfraInfo        `json:"mcNlbHostInfo"`
	DeploymentLog   InfraSshCmdResult `json:"deploymentLog"`
}

type MonAgentInstallReq struct {
	NsId     string `json:"nsId,omitempty"`
	InfraId  string `json:"infraId,omitempty"`
	NodeId   string `json:"nodeId,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"`
	NodeId string `json:"nodeId"`
	Value  string `json:"value"`
	Err    string `json:"err"`
}

type MonResultSimpleResponse struct {
	NsId            string            `json:"nsId"`
	InfraId         string            `json:"infraId"`
	InfraMonitoring []MonResultSimple `json:"infraMonitoring"`
}

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

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

type NLBFeatureSupport struct {
	CustomHealthCheckerInterval  bool `json:"customHealthCheckerInterval" example:"true"`
	CustomHealthCheckerTimeout   bool `json:"customHealthCheckerTimeout" example:"false"`
	CustomHealthCheckerThreshold bool `json:"customHealthCheckerThreshold" example:"true"`
}

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 node when no response.
	Threshold int    `json:"threshold" example:"3"`  // num, The number of continuous health checks to change the node 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 {
	AllNodes       []string
	HealthyNodes   []string
	UnHealthyNodes []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 NLBSupportResponse struct {
	ResourceType string                       `json:"resourceType" example:"nlb"`
	Supports     map[string]NLBFeatureSupport `json:"supports,omitempty"`
}

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

	NodeGroupId string   `json:"nodeGroupId" example:"g1"`
	Nodes       []string `json:"nodes"`

	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
	NodeGroupId string `json:"nodeGroupId" 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"`
	NlbInfraSpecId          string `yaml:"nlbInfraSpecId"`
	NlbInfraImageId         string `yaml:"nlbInfraImageId"`
	NlbInfraNodeGroupSize   int    `yaml:"nlbInfraNodeGroupSize"`
}

type NodeCreationError struct {
	// NodeName is the name of the Node that failed
	NodeName string `json:"nodeName"`

	// Error is the error message
	Error string `json:"error"`

	// Phase indicates when the error occurred
	Phase string `json:"phase"` // "object_creation", "vm_creation"

	// Timestamp when the error occurred
	Timestamp string `json:"timestamp"`
}

type NodeGroupInfo 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"`

	NodeId        []string `json:"nodeId"`
	NodeGroupSize int      `json:"nodeGroupSize"`
}

type NodeInfo 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"`

	// defined if the Node is in a group
	NodeGroupId string `json:"nodeGroupId"`

	Location Location `json:"location"`

	// Required by CB-Tumblebug
	Status       string `json:"status"`
	TargetStatus string `json:"targetStatus"`
	TargetAction string `json:"targetAction"`

	// Montoring agent status
	MonAgentStatus string `json:"monAgentStatus" example:"[installed, notInstalled, failed]"` // yes or no// installed, notInstalled, failed

	// NetworkAgent status
	NetworkAgentStatus string `json:"networkAgentStatus" example:"[notInstalled, installing, installed, failed]"` // notInstalled, installing, installed, failed

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

	// Created time
	CreatedTime string `json:"createdTime" example:"2022-11-10 23:00:00" default:""`

	Label       map[string]string `json:"label"`
	Description string            `json:"description"`

	Region         RegionInfo `json:"region"` // AWS, ex) {us-east1, us-east1-c} or {ap-northeast-2}
	PublicIP       string     `json:"publicIP"`
	SSHPort        int        `json:"sshPort"`
	PublicDNS      string     `json:"publicDNS"`
	PrivateIP      string     `json:"privateIP"`
	PrivateDNS     string     `json:"privateDNS"`
	RootDiskType   string     `json:"rootDiskType"`
	RootDiskSize   int        `json:"rootDiskSize"`
	RootDeviceName string     `json:"RootDeviceName"`

	ConnectionName   string       `json:"connectionName"`
	ConnectionConfig ConnConfig   `json:"connectionConfig"`
	SpecId           string       `json:"specId"`
	CspSpecName      string       `json:"cspSpecName"`
	Spec             SpecSummary  `json:"spec"`
	ImageId          string       `json:"imageId"`
	CspImageName     string       `json:"cspImageName"`
	Image            ImageSummary `json:"image"`
	VNetId           string       `json:"vNetId"`
	CspVNetId        string       `json:"cspVNetId"`
	SubnetId         string       `json:"subnetId"`
	CspSubnetId      string       `json:"cspSubnetId"`
	NetworkInterface string       `json:"networkInterface"`
	SecurityGroupIds []string     `json:"securityGroupIds"`
	DataDiskIds      []string     `json:"dataDiskIds"`
	SshKeyId         string       `json:"sshKeyId"`
	CspSshKeyId      string       `json:"cspSshKeyId"`
	NodeUserName     string       `json:"nodeUserName,omitempty"`
	NodeUserPassword string       `json:"nodeUserPassword,omitempty"`

	// SshHostKeyInfo contains SSH host key information for TOFU (Trust On First Use) verification
	SshHostKeyInfo *SshHostKeyInfo `json:"sshHostKeyInfo,omitempty"`

	// CommandStatus stores the status and history of remote commands executed on this Node
	CommandStatus []CommandStatusInfo `json:"commandStatus,omitempty"`

	AddtionalDetails []KeyValue `json:"addtionalDetails,omitempty"`
}

type NodePriority struct {
	Priority string   `json:"priority"`
	NodeSpec SpecInfo `json:"nodeSpec"`
}

type NodeRecommendInfo struct {
	NodeReq          NodeRecommendReq `json:"nodeReq"`
	NodePriorityList []NodePriority   `json:"nodePriority"`
	PlacementAlgo    string           `json:"placementAlgo"`
	PlacementParam   []KeyValue       `json:"placementParam"`
}

type NodeRecommendReq struct {
	RequestName  string `json:"requestName"`
	MaxResultNum string `json:"maxResultNum"`

	VcpuSize   string `json:"vcpuSize"`
	MemorySize string `json:"memorySize"`
	DiskSize   string `json:"diskSize"`

	PlacementAlgo  string     `json:"placementAlgo"`
	PlacementParam []KeyValue `json:"placementParam"`
}

type NodeSnapshotResult struct {
	NodeGroupId string    `json:"nodeGroupId" example:"g1"`
	NodeId      string    `json:"nodeId" example:"g1-1"`
	NodeName    string    `json:"nodeName" example:"aws-ap-northeast-2-g1-1"`
	Status      string    `json:"status" example:"Success" enums:"Success,Failed"`
	ImageId     string    `json:"imageId,omitempty" example:"custom-image-g1"`
	ImageInfo   ImageInfo `json:"imageInfo"`
	Error       string    `json:"error,omitempty"`
}

type NodeStatusInfo struct {

	// 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"`

	Status       string `json:"status"`
	TargetStatus string `json:"targetStatus"`
	TargetAction string `json:"targetAction"`
	NativeStatus string `json:"nativeStatus"`

	// Montoring agent status
	MonAgentStatus string `json:"monAgentStatus" example:"[installed, notInstalled, failed]"` // yes or no// installed, notInstalled, failed

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

	// Created time
	CreatedTime string `json:"createdTime" example:"2022-11-10 23:00:00" default:""`

	PublicIp  string `json:"publicIp"`
	PrivateIp string `json:"privateIp"`
	SSHPort   int    `json:"sshPort"`

	Location Location `json:"location"`
}

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"`
	PresignedUrl bool `json:"presignedUrl" 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"`
	SystemMessage    string      `json:"systemMessage,omitempty"`
	Conditions       []Condition `json:"conditions,omitempty"`

	// 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"`
	RequiredHeaders map[string]string `json:"requiredHeaders,omitempty" example:"x-ms-blob-type:BlockBlob"`
}

type ObjectStorageReconcileResponse struct {
	// ObjectStorageId is the Tumblebug resource ID that was reconciled
	ObjectStorageId string `json:"objectStorageId" example:"test-add-object-tencent"`
	// MetadataStatus indicates whether Tumblebug metadata was found in the key-value store
	// Possible values: "Found", "NotFound"
	MetadataStatus string `json:"metadataStatus" example:"Found"`
	// CspResourceStatus indicates whether the corresponding CSP resource actually exists
	// Possible values: "Exists", "NotFound", "Skipped"
	// "Skipped" means the CSP check was not performed because the metadata had no CSP resource ID (Uid is empty)
	CspResourceStatus string `json:"cspResourceStatus" example:"NotFound"`
	// Action describes what corrective action was taken
	// Possible values: "NoActionNeeded", "MetadataRemoved", "MetadataUpdated", "StatusRestored"
	// "StatusRestored" means the resource status was restored to Available because
	// the CSP resource still exists but Tumblebug metadata was stuck in a terminal
	// failure state (e.g., DeletionFailed) — typically caused by a dependency that
	// has since been resolved.
	Action string `json:"action" example:"MetadataRemoved"`
	// Message provides a human-readable description of the reconcile result
	Message string `json:"message" example:"Orphaned metadata removed: CSP resource does not exist"`
}

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"`
}

type OpenStackSpecificProperty struct {
	BgpAsn string `json:"bgpAsn,omitempty" default:"65000" example:"65000"`
}

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 ProviderAssetSummary struct {
	ProviderName      string `json:"providerName" example:"aws"`
	SpecCount         int64  `json:"specCount" example:"11234"`
	PricedSpecCount   int64  `json:"pricedSpecCount" example:"11000"`
	UnpricedSpecCount int64  `json:"unpricedSpecCount" example:"234"`
	ImageCount        int64  `json:"imageCount" example:"5234"`
}

type ProvisioningEvent struct {
	// SpecId is the Node 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"`

	// NodeName is the name of the VM that was being provisioned
	NodeName string `json:"nodeName"`

	// InfraId is the Infra ID that this VM belongs to
	InfraId string `json:"infraId"`
}