package linodego import ( "context" "encoding/json" "time" "github.com/linode/linodego/internal/parseabletime" ) // InstanceConfig represents all of the settings that control the boot and run configuration of a Linode Instance type InstanceConfig struct { ID int `json:"id"` Label string `json:"label"` Comments string `json:"comments"` Devices *InstanceConfigDeviceMap `json:"devices"` Helpers *InstanceConfigHelpers `json:"helpers"` Interfaces []InstanceConfigInterface `json:"interfaces"` MemoryLimit int `json:"memory_limit"` Kernel string `json:"kernel"` InitRD *int `json:"init_rd"` RootDevice string `json:"root_device"` RunLevel string `json:"run_level"` VirtMode string `json:"virt_mode"` Created *time.Time `json:"-"` Updated *time.Time `json:"-"` } // InstanceConfigDevice contains either the DiskID or VolumeID assigned to a Config Device type InstanceConfigDevice struct { DiskID int `json:"disk_id,omitempty"` VolumeID int `json:"volume_id,omitempty"` } // InstanceConfigDeviceMap contains SDA-SDH InstanceConfigDevice settings type InstanceConfigDeviceMap struct { // sda-sdz SDA *InstanceConfigDevice `json:"sda,omitempty"` SDB *InstanceConfigDevice `json:"sdb,omitempty"` SDC *InstanceConfigDevice `json:"sdc,omitempty"` SDD *InstanceConfigDevice `json:"sdd,omitempty"` SDE *InstanceConfigDevice `json:"sde,omitempty"` SDF *InstanceConfigDevice `json:"sdf,omitempty"` SDG *InstanceConfigDevice `json:"sdg,omitempty"` SDH *InstanceConfigDevice `json:"sdh,omitempty"` SDI *InstanceConfigDevice `json:"sdi,omitempty"` SDJ *InstanceConfigDevice `json:"sdj,omitempty"` SDK *InstanceConfigDevice `json:"sdk,omitempty"` SDL *InstanceConfigDevice `json:"sdl,omitempty"` SDM *InstanceConfigDevice `json:"sdm,omitempty"` SDN *InstanceConfigDevice `json:"sdn,omitempty"` SDO *InstanceConfigDevice `json:"sdo,omitempty"` SDP *InstanceConfigDevice `json:"sdp,omitempty"` SDQ *InstanceConfigDevice `json:"sdq,omitempty"` SDR *InstanceConfigDevice `json:"sdr,omitempty"` SDS *InstanceConfigDevice `json:"sds,omitempty"` SDT *InstanceConfigDevice `json:"sdt,omitempty"` SDU *InstanceConfigDevice `json:"sdu,omitempty"` SDV *InstanceConfigDevice `json:"sdv,omitempty"` SDW *InstanceConfigDevice `json:"sdw,omitempty"` SDX *InstanceConfigDevice `json:"sdx,omitempty"` SDY *InstanceConfigDevice `json:"sdy,omitempty"` SDZ *InstanceConfigDevice `json:"sdz,omitempty"` // sdaa-sdaz SDAA *InstanceConfigDevice `json:"sdaa,omitempty"` SDAB *InstanceConfigDevice `json:"sdab,omitempty"` SDAC *InstanceConfigDevice `json:"sdac,omitempty"` SDAD *InstanceConfigDevice `json:"sdad,omitempty"` SDAE *InstanceConfigDevice `json:"sdae,omitempty"` SDAF *InstanceConfigDevice `json:"sdaf,omitempty"` SDAG *InstanceConfigDevice `json:"sdag,omitempty"` SDAH *InstanceConfigDevice `json:"sdah,omitempty"` SDAI *InstanceConfigDevice `json:"sdai,omitempty"` SDAJ *InstanceConfigDevice `json:"sdaj,omitempty"` SDAK *InstanceConfigDevice `json:"sdak,omitempty"` SDAL *InstanceConfigDevice `json:"sdal,omitempty"` SDAM *InstanceConfigDevice `json:"sdam,omitempty"` SDAN *InstanceConfigDevice `json:"sdan,omitempty"` SDAO *InstanceConfigDevice `json:"sdao,omitempty"` SDAP *InstanceConfigDevice `json:"sdap,omitempty"` SDAQ *InstanceConfigDevice `json:"sdaq,omitempty"` SDAR *InstanceConfigDevice `json:"sdar,omitempty"` SDAS *InstanceConfigDevice `json:"sdas,omitempty"` SDAT *InstanceConfigDevice `json:"sdat,omitempty"` SDAU *InstanceConfigDevice `json:"sdau,omitempty"` SDAV *InstanceConfigDevice `json:"sdav,omitempty"` SDAW *InstanceConfigDevice `json:"sdaw,omitempty"` SDAX *InstanceConfigDevice `json:"sdax,omitempty"` SDAY *InstanceConfigDevice `json:"sday,omitempty"` SDAZ *InstanceConfigDevice `json:"sdaz,omitempty"` // sdba-sdbl SDBA *InstanceConfigDevice `json:"sdba,omitempty"` SDBB *InstanceConfigDevice `json:"sdbb,omitempty"` SDBC *InstanceConfigDevice `json:"sdbc,omitempty"` SDBD *InstanceConfigDevice `json:"sdbd,omitempty"` SDBE *InstanceConfigDevice `json:"sdbe,omitempty"` SDBF *InstanceConfigDevice `json:"sdbf,omitempty"` SDBG *InstanceConfigDevice `json:"sdbg,omitempty"` SDBH *InstanceConfigDevice `json:"sdbh,omitempty"` SDBI *InstanceConfigDevice `json:"sdbi,omitempty"` SDBJ *InstanceConfigDevice `json:"sdbj,omitempty"` SDBK *InstanceConfigDevice `json:"sdbk,omitempty"` SDBL *InstanceConfigDevice `json:"sdbl,omitempty"` } // InstanceConfigHelpers are Instance Config options that control Linux distribution specific tweaks type InstanceConfigHelpers struct { UpdateDBDisabled bool `json:"updatedb_disabled"` Distro bool `json:"distro"` ModulesDep bool `json:"modules_dep"` Network bool `json:"network"` DevTmpFsAutomount bool `json:"devtmpfs_automount"` } // ConfigInterfacePurpose options start with InterfacePurpose and include all known interface purpose types type ConfigInterfacePurpose string const ( InterfacePurposePublic ConfigInterfacePurpose = "public" InterfacePurposeVLAN ConfigInterfacePurpose = "vlan" InterfacePurposeVPC ConfigInterfacePurpose = "vpc" ) // InstanceConfigCreateOptions are InstanceConfig settings that can be used at creation type InstanceConfigCreateOptions struct { Label string `json:"label,omitempty"` Comments string `json:"comments,omitempty"` Devices InstanceConfigDeviceMap `json:"devices"` Helpers *InstanceConfigHelpers `json:"helpers,omitempty"` Interfaces []InstanceConfigInterfaceCreateOptions `json:"interfaces"` MemoryLimit int `json:"memory_limit,omitempty"` Kernel string `json:"kernel,omitempty"` InitRD int `json:"init_rd,omitempty"` RootDevice *string `json:"root_device,omitempty"` RunLevel string `json:"run_level,omitempty"` VirtMode string `json:"virt_mode,omitempty"` } // InstanceConfigUpdateOptions are InstanceConfig settings that can be used in updates type InstanceConfigUpdateOptions struct { Label string `json:"label,omitempty"` Comments string `json:"comments"` Devices *InstanceConfigDeviceMap `json:"devices,omitempty"` Helpers *InstanceConfigHelpers `json:"helpers,omitempty"` Interfaces []InstanceConfigInterfaceCreateOptions `json:"interfaces"` // MemoryLimit 0 means unlimitted, this is not omitted MemoryLimit int `json:"memory_limit"` Kernel string `json:"kernel,omitempty"` // InitRD is nullable, permit the sending of null InitRD *int `json:"init_rd"` RootDevice string `json:"root_device,omitempty"` RunLevel string `json:"run_level,omitempty"` VirtMode string `json:"virt_mode,omitempty"` } // UnmarshalJSON implements the json.Unmarshaler interface func (i *InstanceConfig) UnmarshalJSON(b []byte) error { type Mask InstanceConfig p := struct { *Mask Created *parseabletime.ParseableTime `json:"created"` Updated *parseabletime.ParseableTime `json:"updated"` }{ Mask: (*Mask)(i), } if err := json.Unmarshal(b, &p); err != nil { return err } i.Created = (*time.Time)(p.Created) i.Updated = (*time.Time)(p.Updated) return nil } // GetCreateOptions converts a InstanceConfig to InstanceConfigCreateOptions for use in CreateInstanceConfig func (i InstanceConfig) GetCreateOptions() InstanceConfigCreateOptions { result := InstanceConfigCreateOptions{ Label: i.Label, Comments: i.Comments, Helpers: i.Helpers, Interfaces: getInstanceConfigInterfacesCreateOptionsList(i.Interfaces), MemoryLimit: i.MemoryLimit, Kernel: i.Kernel, RootDevice: copyString(&i.RootDevice), RunLevel: i.RunLevel, VirtMode: i.VirtMode, } if i.InitRD != nil { result.InitRD = *i.InitRD } if i.Devices != nil { result.Devices = *i.Devices } return result } // GetUpdateOptions converts a InstanceConfig to InstanceConfigUpdateOptions for use in UpdateInstanceConfig func (i InstanceConfig) GetUpdateOptions() InstanceConfigUpdateOptions { return InstanceConfigUpdateOptions{ Label: i.Label, Comments: i.Comments, Devices: i.Devices, Helpers: i.Helpers, Interfaces: getInstanceConfigInterfacesCreateOptionsList(i.Interfaces), MemoryLimit: i.MemoryLimit, Kernel: i.Kernel, InitRD: copyInt(i.InitRD), RootDevice: i.RootDevice, RunLevel: i.RunLevel, VirtMode: i.VirtMode, } } // ListInstanceConfigs lists InstanceConfigs func (c *Client) ListInstanceConfigs(ctx context.Context, linodeID int, opts *ListOptions) ([]InstanceConfig, error) { return getPaginatedResults[InstanceConfig](ctx, c, formatAPIPath("linode/instances/%d/configs", linodeID), opts) } // GetInstanceConfig gets the template with the provided ID func (c *Client) GetInstanceConfig(ctx context.Context, linodeID int, configID int) (*InstanceConfig, error) { e := formatAPIPath("linode/instances/%d/configs/%d", linodeID, configID) return doGETRequest[InstanceConfig](ctx, c, e) } // CreateInstanceConfig creates a new InstanceConfig for the given Instance func (c *Client) CreateInstanceConfig(ctx context.Context, linodeID int, opts InstanceConfigCreateOptions) (*InstanceConfig, error) { e := formatAPIPath("linode/instances/%d/configs", linodeID) return doPOSTRequest[InstanceConfig](ctx, c, e, opts) } // UpdateInstanceConfig update an InstanceConfig for the given Instance func (c *Client) UpdateInstanceConfig(ctx context.Context, linodeID int, configID int, opts InstanceConfigUpdateOptions) (*InstanceConfig, error) { e := formatAPIPath("linode/instances/%d/configs/%d", linodeID, configID) return doPUTRequest[InstanceConfig](ctx, c, e, opts) } // RenameInstanceConfig renames an InstanceConfig func (c *Client) RenameInstanceConfig(ctx context.Context, linodeID int, configID int, label string) (*InstanceConfig, error) { return c.UpdateInstanceConfig(ctx, linodeID, configID, InstanceConfigUpdateOptions{Label: label}) } // DeleteInstanceConfig deletes a Linode InstanceConfig func (c *Client) DeleteInstanceConfig(ctx context.Context, linodeID int, configID int) error { e := formatAPIPath("linode/instances/%d/configs/%d", linodeID, configID) return doDELETERequest(ctx, c, e) }