Files
decort-golang-sdk/pkg/cloudbroker/kvmx86/create_blank.go

196 lines
6.3 KiB
Go
Raw Normal View History

package kvmx86
import (
"context"
2023-07-13 18:32:21 +03:00
"encoding/json"
"net/http"
"strconv"
2023-03-24 17:09:30 +03:00
"repository.basistech.ru/BASIS/decort-golang-sdk/internal/validators"
)
2023-10-25 17:37:18 +03:00
// CreateBlankRequest struct to create KVM x86 VM from scratch
type CreateBlankRequest struct {
2022-12-22 17:56:47 +03:00
// ID of the resource group, which will own this VM
// Required: true
2023-03-24 17:09:30 +03:00
RGID uint64 `url:"rgId" json:"rgId" validate:"required"`
2022-12-22 17:56:47 +03:00
// Name of this VM.
// Must be unique among all VMs (including those in DELETED state) in target resource group
// Required: true
2023-03-24 17:09:30 +03:00
Name string `url:"name" json:"name" validate:"required"`
2022-12-22 17:56:47 +03:00
// Number CPUs to allocate to this VM
// Required: true
2023-03-24 17:09:30 +03:00
CPU uint64 `url:"cpu" json:"cpu" validate:"required"`
2022-12-22 17:56:47 +03:00
// Volume of RAM in MB to allocate to this VM
// Required: true
2023-03-24 17:09:30 +03:00
RAM uint64 `url:"ram" json:"ram" validate:"required"`
2022-12-22 17:56:47 +03:00
2025-08-29 12:51:25 +03:00
// Storage policy id of сompute. The rules of the specified storage policy will be used.
// Required: true
StoragePolicyID uint64 `url:"storage_policy_id" json:"storage_policy_id" validate:"required"`
2024-05-31 13:35:39 +03:00
// If True, the imageId, bootDisk, sepId, pool parameters are ignored and the compute is created without a boot disk in the stopped state
// Required: false
WithoutBootDisk bool `url:"withoutBootDisk" json:"withoutBootDisk"`
2022-12-22 17:56:47 +03:00
// Size of the boot disk in GB
2024-05-31 13:35:39 +03:00
// Required: false
BootDisk uint64 `url:"bootDisk,omitempty" json:"bootDisk,omitempty"`
2022-12-22 17:56:47 +03:00
// ID of SEP to create boot disk on.
// Uses images SEP ID if not set
2024-05-31 13:35:39 +03:00
// Required: false
SEPID uint64 `url:"sepId,omitempty" json:"sepId,omitempty"`
2022-12-22 17:56:47 +03:00
// Pool to use if sepId is set, can be also empty if needed to be chosen by system
2024-05-31 13:35:39 +03:00
// Required: false
Pool string `url:"pool,omitempty" json:"pool,omitempty"`
2022-12-22 17:56:47 +03:00
2024-04-16 14:26:06 +03:00
// Slice of structs with data disk description. Each disk has parameters: required - diskName, size; optional - sepId, pool, desc and imageId.
// If not specified, compute will be created without disks.
// To create compute without disks, pass initialized empty slice .
// Required: false
DataDisks []DataDisk `url:"-" json:"dataDisks,omitempty" validate:"omitempty,dive"`
2023-07-13 15:28:07 +03:00
// Slice of structs with net interface description.
2023-07-24 15:13:04 +03:00
// If not specified, compute will be created with default interface from RG.
// To create compute without interfaces, pass initialized empty slice .
2022-12-22 17:56:47 +03:00
// Required: false
2023-07-24 15:13:04 +03:00
Interfaces []Interface `url:"-" json:"interfaces,omitempty" validate:"omitempty,dive"`
2022-12-22 17:56:47 +03:00
// Text description of this VM
// Required: false
2023-03-01 19:05:53 +03:00
Description string `url:"desc,omitempty" json:"desc,omitempty"`
2023-09-25 19:11:33 +03:00
2024-11-12 12:51:21 +03:00
// Type of the emulated system, Q35 or i440fx
// Required: false
2025-12-08 16:16:35 +03:00
// Default: Q35
2024-11-22 12:09:50 +03:00
Chipset string `url:"chipset,omitempty" json:"chipset,omitempty" validate:"omitempty,chipset"`
2025-02-07 11:11:43 +03:00
2025-12-08 16:16:35 +03:00
// Use Huge Pages to allocate RAM of the virtual machine. The system must be pre-configured by allocating Huge Pages on the physical node
// Required: false
// Default: false
HPBacked bool `url:"hp_backed" json:"hp_backed"`
// Run VM on dedicated CPUs. To use this feature, the system must be pre-configured by allocating CPUs on the physical node
// Required: false
// Default: false
CPUPin bool `url:"cpu_pin" json:"cpu_pin"`
// Rule for VM placement with NUMA affinity.
// Possible values - none (placement without NUMA affinity),
// strict (strictly with NUMA affinity, if not possible - do not start VM),
// loose (use NUMA affinity if possible)
// Required: false
// Default: none
NumaAffinity string `url:"numa_affinity,omitempty" json:"numa_affinity,omitempty" validate:"omitempty,numaAffinity"`
2025-02-07 11:11:43 +03:00
// Recommended isolated CPUs. Field is ignored if compute.cpupin=False or compute.pinned=False
// Required: false
PreferredCPU []int64 `url:"preferredCpu,omitempty" json:"preferredCpu,omitempty" validate:"omitempty,preferredCPU"`
2025-04-09 11:21:07 +03:00
// VM type linux, windows or unknown
// Required: false
LoaderType string `url:"loaderType,omitempty" json:"loaderType,omitempty" validate:"omitempty,loaderType"`
// Boot type of image bios or uefi
// Required: false
BootType string `url:"bootType,omitempty" json:"bootType,omitempty" validate:"omitempty,imageBootType"`
// Select a network interface naming pattern for your Linux machine. eth - onboard, ens - pci slot naming.
// Required: false
NetworkInterfaceNaming string `url:"networkInterfaceNaming,omitempty" json:"networkInterfaceNaming,omitempty" validate:"omitempty,networkInterfaceNaming"`
// Does this machine supports hot resize
// Required: false
HotResize bool `url:"hotResize,omitempty" json:"hotResize,omitempty"`
2025-07-15 17:39:18 +03:00
// Zone ID
// Required: false
ZoneID uint64 `url:"zoneId,omitempty" json:"zoneId,omitempty"`
2025-09-11 15:56:44 +03:00
// The OS version that will be installed on the virtual machine
// Required: false
OSVersion string `url:"os_version,omitempty" json:"os_version,omitempty"`
}
2024-04-16 14:26:06 +03:00
// GetRAM returns RAM field values
func (r CreateBlankRequest) GetRAM() map[string]uint64 {
res := make(map[string]uint64, 1)
res["RAM"] = r.RAM
return res
}
2023-07-13 18:32:21 +03:00
type wrapperCreateBlankRequest struct {
CreateBlankRequest
Interfaces []string `url:"interfaces,omitempty"`
2024-04-16 14:26:06 +03:00
DataDisks []string `url:"dataDisks,omitempty"`
2023-07-13 18:32:21 +03:00
}
2022-12-22 17:56:47 +03:00
// CreateBlank creates KVM x86 VM from scratch
func (k KVMX86) CreateBlank(ctx context.Context, req CreateBlankRequest) (uint64, error) {
2023-03-24 17:09:30 +03:00
err := validators.ValidateRequest(req)
if err != nil {
2023-10-25 17:37:18 +03:00
return 0, validators.ValidationErrors(validators.GetErrors(err))
}
2023-07-24 15:13:04 +03:00
var interfaces []string
2023-07-13 18:32:21 +03:00
2023-07-24 15:13:04 +03:00
if req.Interfaces != nil && len(req.Interfaces) != 0 {
interfaces = make([]string, 0, len(req.Interfaces))
for i := range req.Interfaces {
b, err := json.Marshal(req.Interfaces[i])
if err != nil {
return 0, err
}
2023-07-13 18:32:21 +03:00
2023-07-24 15:13:04 +03:00
interfaces = append(interfaces, string(b))
}
} else if req.Interfaces != nil && len(req.Interfaces) == 0 {
interfaces = []string{"[]"}
2023-07-13 18:32:21 +03:00
}
2024-04-16 14:26:06 +03:00
var dataDisks []string
if req.DataDisks != nil && len(req.DataDisks) != 0 {
dataDisks = make([]string, 0, len(req.DataDisks))
for i := range req.DataDisks {
b, err := json.Marshal(req.DataDisks[i])
if err != nil {
return 0, err
}
dataDisks = append(dataDisks, string(b))
}
}
2023-07-13 18:32:21 +03:00
reqWrapped := wrapperCreateBlankRequest{
CreateBlankRequest: req,
Interfaces: interfaces,
2024-04-16 14:26:06 +03:00
DataDisks: dataDisks,
2023-07-13 18:32:21 +03:00
}
url := "/cloudbroker/kvmx86/createBlank"
2023-07-13 18:32:21 +03:00
res, err := k.client.DecortApiCall(ctx, http.MethodPost, url, reqWrapped)
if err != nil {
return 0, err
}
result, err := strconv.ParseUint(string(res), 10, 64)
if err != nil {
return 0, err
}
return result, nil
2022-12-22 17:56:47 +03:00
}