ionoscloud 6.7.6, Apr 14 25

ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionos-cloud/terraform-provider-ionoscloud

ionoscloud.Server

Explore with Pulumi AI

ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionos-cloud/terraform-provider-ionoscloud

Import

Resource Server can be imported using the resource id and the datacenter id, e.g.. Passing only resource id and datacenter id means that the first nic found linked to the server will be attached to it.

$ pulumi import ionoscloud:index/server:Server myserver datacenter uuid/server uuid

Optionally, you can pass primary_nic and firewallrule_id so terraform will know to import also the first nic and firewall rule (if it exists on the server):

$ pulumi import ionoscloud:index/server:Server myserver datacenter uuid/server uuid/primary nic id/firewall rule id

Create Server Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Server(name: string, args: ServerArgs, opts?: CustomResourceOptions);

@overload
def Server(resource_name: str,
           args: ServerArgs,
           opts: Optional[ResourceOptions] = None)

@overload
def Server(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           datacenter_id: Optional[str] = None,
           name: Optional[str] = None,
           image_name: Optional[str] = None,
           boot_image: Optional[str] = None,
           cores: Optional[float] = None,
           cpu_family: Optional[str] = None,
           availability_zone: Optional[str] = None,
           firewallrule_ids: Optional[Sequence[str]] = None,
           nic: Optional[ServerNicArgs] = None,
           allow_replace: Optional[bool] = None,
           image_password: Optional[str] = None,
           boot_cdrom: Optional[str] = None,
           labels: Optional[Sequence[ServerLabelArgs]] = None,
           hostname: Optional[str] = None,
           ram: Optional[float] = None,
           security_groups_ids: Optional[Sequence[str]] = None,
           server_id: Optional[str] = None,
           ssh_key_paths: Optional[Sequence[str]] = None,
           ssh_keys: Optional[Sequence[str]] = None,
           template_uuid: Optional[str] = None,
           timeouts: Optional[ServerTimeoutsArgs] = None,
           type: Optional[str] = None,
           vm_state: Optional[str] = None,
           volume: Optional[ServerVolumeArgs] = None)

func NewServer(ctx *Context, name string, args ServerArgs, opts ...ResourceOption) (*Server, error)

public Server(string name, ServerArgs args, CustomResourceOptions? opts = null)

public Server(String name, ServerArgs args)
public Server(String name, ServerArgs args, CustomResourceOptions options)

type: ionoscloud:Server
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args ServerArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args ServerArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args ServerArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args ServerArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args ServerArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var serverResource = new Ionoscloud.Server("serverResource", new()
{
    DatacenterId = "string",
    Name = "string",
    ImageName = "string",
    BootImage = "string",
    Cores = 0,
    CpuFamily = "string",
    AvailabilityZone = "string",
    FirewallruleIds = new[]
    {
        "string",
    },
    Nic = new Ionoscloud.Inputs.ServerNicArgs
    {
        Lan = 0,
        Id = "string",
        Ipv6CidrBlock = "string",
        FirewallActive = false,
        FirewallType = "string",
        Firewalls = new[]
        {
            new Ionoscloud.Inputs.ServerNicFirewallArgs
            {
                Protocol = "string",
                IcmpCode = "string",
                IcmpType = "string",
                Id = "string",
                Name = "string",
                PortRangeEnd = 0,
                PortRangeStart = 0,
                SourceIp = "string",
                SourceMac = "string",
                TargetIp = "string",
                Type = "string",
            },
        },
        DeviceNumber = 0,
        Ips = new[]
        {
            "string",
        },
        Dhcpv6 = false,
        Ipv6Ips = new[]
        {
            "string",
        },
        Dhcp = false,
        Mac = "string",
        Name = "string",
        PciSlot = 0,
        SecurityGroupsIds = new[]
        {
            "string",
        },
    },
    AllowReplace = false,
    ImagePassword = "string",
    Labels = new[]
    {
        new Ionoscloud.Inputs.ServerLabelArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    Hostname = "string",
    Ram = 0,
    SecurityGroupsIds = new[]
    {
        "string",
    },
    ServerId = "string",
    SshKeys = new[]
    {
        "string",
    },
    TemplateUuid = "string",
    Timeouts = new Ionoscloud.Inputs.ServerTimeoutsArgs
    {
        Create = "string",
        Default = "string",
        Delete = "string",
        Update = "string",
    },
    Type = "string",
    VmState = "string",
    Volume = new Ionoscloud.Inputs.ServerVolumeArgs
    {
        DiskType = "string",
        LicenceType = "string",
        Name = "string",
        Bus = "string",
        AvailabilityZone = "string",
        DeviceNumber = 0,
        DiscVirtioHotPlug = false,
        DiscVirtioHotUnplug = false,
        BackupUnitId = "string",
        BootServer = "string",
        CpuHotPlug = false,
        NicHotPlug = false,
        NicHotUnplug = false,
        PciSlot = 0,
        RamHotPlug = false,
        Size = 0,
        UserData = "string",
    },
});

example, err := ionoscloud.NewServer(ctx, "serverResource", &ionoscloud.ServerArgs{
	DatacenterId:     pulumi.String("string"),
	Name:             pulumi.String("string"),
	ImageName:        pulumi.String("string"),
	BootImage:        pulumi.String("string"),
	Cores:            pulumi.Float64(0),
	CpuFamily:        pulumi.String("string"),
	AvailabilityZone: pulumi.String("string"),
	FirewallruleIds: pulumi.StringArray{
		pulumi.String("string"),
	},
	Nic: &ionoscloud.ServerNicArgs{
		Lan:            pulumi.Float64(0),
		Id:             pulumi.String("string"),
		Ipv6CidrBlock:  pulumi.String("string"),
		FirewallActive: pulumi.Bool(false),
		FirewallType:   pulumi.String("string"),
		Firewalls: ionoscloud.ServerNicFirewallArray{
			&ionoscloud.ServerNicFirewallArgs{
				Protocol:       pulumi.String("string"),
				IcmpCode:       pulumi.String("string"),
				IcmpType:       pulumi.String("string"),
				Id:             pulumi.String("string"),
				Name:           pulumi.String("string"),
				PortRangeEnd:   pulumi.Float64(0),
				PortRangeStart: pulumi.Float64(0),
				SourceIp:       pulumi.String("string"),
				SourceMac:      pulumi.String("string"),
				TargetIp:       pulumi.String("string"),
				Type:           pulumi.String("string"),
			},
		},
		DeviceNumber: pulumi.Float64(0),
		Ips: pulumi.StringArray{
			pulumi.String("string"),
		},
		Dhcpv6: pulumi.Bool(false),
		Ipv6Ips: pulumi.StringArray{
			pulumi.String("string"),
		},
		Dhcp:    pulumi.Bool(false),
		Mac:     pulumi.String("string"),
		Name:    pulumi.String("string"),
		PciSlot: pulumi.Float64(0),
		SecurityGroupsIds: pulumi.StringArray{
			pulumi.String("string"),
		},
	},
	AllowReplace:  pulumi.Bool(false),
	ImagePassword: pulumi.String("string"),
	Labels: ionoscloud.ServerLabelArray{
		&ionoscloud.ServerLabelArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	Hostname: pulumi.String("string"),
	Ram:      pulumi.Float64(0),
	SecurityGroupsIds: pulumi.StringArray{
		pulumi.String("string"),
	},
	ServerId: pulumi.String("string"),
	SshKeys: pulumi.StringArray{
		pulumi.String("string"),
	},
	TemplateUuid: pulumi.String("string"),
	Timeouts: &ionoscloud.ServerTimeoutsArgs{
		Create:  pulumi.String("string"),
		Default: pulumi.String("string"),
		Delete:  pulumi.String("string"),
		Update:  pulumi.String("string"),
	},
	Type:    pulumi.String("string"),
	VmState: pulumi.String("string"),
	Volume: &ionoscloud.ServerVolumeArgs{
		DiskType:            pulumi.String("string"),
		LicenceType:         pulumi.String("string"),
		Name:                pulumi.String("string"),
		Bus:                 pulumi.String("string"),
		AvailabilityZone:    pulumi.String("string"),
		DeviceNumber:        pulumi.Float64(0),
		DiscVirtioHotPlug:   pulumi.Bool(false),
		DiscVirtioHotUnplug: pulumi.Bool(false),
		BackupUnitId:        pulumi.String("string"),
		BootServer:          pulumi.String("string"),
		CpuHotPlug:          pulumi.Bool(false),
		NicHotPlug:          pulumi.Bool(false),
		NicHotUnplug:        pulumi.Bool(false),
		PciSlot:             pulumi.Float64(0),
		RamHotPlug:          pulumi.Bool(false),
		Size:                pulumi.Float64(0),
		UserData:            pulumi.String("string"),
	},
})

var serverResource = new Server("serverResource", ServerArgs.builder()
    .datacenterId("string")
    .name("string")
    .imageName("string")
    .bootImage("string")
    .cores(0)
    .cpuFamily("string")
    .availabilityZone("string")
    .firewallruleIds("string")
    .nic(ServerNicArgs.builder()
        .lan(0)
        .id("string")
        .ipv6CidrBlock("string")
        .firewallActive(false)
        .firewallType("string")
        .firewalls(ServerNicFirewallArgs.builder()
            .protocol("string")
            .icmpCode("string")
            .icmpType("string")
            .id("string")
            .name("string")
            .portRangeEnd(0)
            .portRangeStart(0)
            .sourceIp("string")
            .sourceMac("string")
            .targetIp("string")
            .type("string")
            .build())
        .deviceNumber(0)
        .ips("string")
        .dhcpv6(false)
        .ipv6Ips("string")
        .dhcp(false)
        .mac("string")
        .name("string")
        .pciSlot(0)
        .securityGroupsIds("string")
        .build())
    .allowReplace(false)
    .imagePassword("string")
    .labels(ServerLabelArgs.builder()
        .key("string")
        .value("string")
        .build())
    .hostname("string")
    .ram(0)
    .securityGroupsIds("string")
    .serverId("string")
    .sshKeys("string")
    .templateUuid("string")
    .timeouts(ServerTimeoutsArgs.builder()
        .create("string")
        .default_("string")
        .delete("string")
        .update("string")
        .build())
    .type("string")
    .vmState("string")
    .volume(ServerVolumeArgs.builder()
        .diskType("string")
        .licenceType("string")
        .name("string")
        .bus("string")
        .availabilityZone("string")
        .deviceNumber(0)
        .discVirtioHotPlug(false)
        .discVirtioHotUnplug(false)
        .backupUnitId("string")
        .bootServer("string")
        .cpuHotPlug(false)
        .nicHotPlug(false)
        .nicHotUnplug(false)
        .pciSlot(0)
        .ramHotPlug(false)
        .size(0)
        .userData("string")
        .build())
    .build());

server_resource = ionoscloud.Server("serverResource",
    datacenter_id="string",
    name="string",
    image_name="string",
    boot_image="string",
    cores=0,
    cpu_family="string",
    availability_zone="string",
    firewallrule_ids=["string"],
    nic={
        "lan": 0,
        "id": "string",
        "ipv6_cidr_block": "string",
        "firewall_active": False,
        "firewall_type": "string",
        "firewalls": [{
            "protocol": "string",
            "icmp_code": "string",
            "icmp_type": "string",
            "id": "string",
            "name": "string",
            "port_range_end": 0,
            "port_range_start": 0,
            "source_ip": "string",
            "source_mac": "string",
            "target_ip": "string",
            "type": "string",
        }],
        "device_number": 0,
        "ips": ["string"],
        "dhcpv6": False,
        "ipv6_ips": ["string"],
        "dhcp": False,
        "mac": "string",
        "name": "string",
        "pci_slot": 0,
        "security_groups_ids": ["string"],
    },
    allow_replace=False,
    image_password="string",
    labels=[{
        "key": "string",
        "value": "string",
    }],
    hostname="string",
    ram=0,
    security_groups_ids=["string"],
    server_id="string",
    ssh_keys=["string"],
    template_uuid="string",
    timeouts={
        "create": "string",
        "default": "string",
        "delete": "string",
        "update": "string",
    },
    type="string",
    vm_state="string",
    volume={
        "disk_type": "string",
        "licence_type": "string",
        "name": "string",
        "bus": "string",
        "availability_zone": "string",
        "device_number": 0,
        "disc_virtio_hot_plug": False,
        "disc_virtio_hot_unplug": False,
        "backup_unit_id": "string",
        "boot_server": "string",
        "cpu_hot_plug": False,
        "nic_hot_plug": False,
        "nic_hot_unplug": False,
        "pci_slot": 0,
        "ram_hot_plug": False,
        "size": 0,
        "user_data": "string",
    })

const serverResource = new ionoscloud.Server("serverResource", {
    datacenterId: "string",
    name: "string",
    imageName: "string",
    bootImage: "string",
    cores: 0,
    cpuFamily: "string",
    availabilityZone: "string",
    firewallruleIds: ["string"],
    nic: {
        lan: 0,
        id: "string",
        ipv6CidrBlock: "string",
        firewallActive: false,
        firewallType: "string",
        firewalls: [{
            protocol: "string",
            icmpCode: "string",
            icmpType: "string",
            id: "string",
            name: "string",
            portRangeEnd: 0,
            portRangeStart: 0,
            sourceIp: "string",
            sourceMac: "string",
            targetIp: "string",
            type: "string",
        }],
        deviceNumber: 0,
        ips: ["string"],
        dhcpv6: false,
        ipv6Ips: ["string"],
        dhcp: false,
        mac: "string",
        name: "string",
        pciSlot: 0,
        securityGroupsIds: ["string"],
    },
    allowReplace: false,
    imagePassword: "string",
    labels: [{
        key: "string",
        value: "string",
    }],
    hostname: "string",
    ram: 0,
    securityGroupsIds: ["string"],
    serverId: "string",
    sshKeys: ["string"],
    templateUuid: "string",
    timeouts: {
        create: "string",
        "default": "string",
        "delete": "string",
        update: "string",
    },
    type: "string",
    vmState: "string",
    volume: {
        diskType: "string",
        licenceType: "string",
        name: "string",
        bus: "string",
        availabilityZone: "string",
        deviceNumber: 0,
        discVirtioHotPlug: false,
        discVirtioHotUnplug: false,
        backupUnitId: "string",
        bootServer: "string",
        cpuHotPlug: false,
        nicHotPlug: false,
        nicHotUnplug: false,
        pciSlot: 0,
        ramHotPlug: false,
        size: 0,
        userData: "string",
    },
});

type: ionoscloud:Server
properties:
    allowReplace: false
    availabilityZone: string
    bootImage: string
    cores: 0
    cpuFamily: string
    datacenterId: string
    firewallruleIds:
        - string
    hostname: string
    imageName: string
    imagePassword: string
    labels:
        - key: string
          value: string
    name: string
    nic:
        deviceNumber: 0
        dhcp: false
        dhcpv6: false
        firewallActive: false
        firewallType: string
        firewalls:
            - icmpCode: string
              icmpType: string
              id: string
              name: string
              portRangeEnd: 0
              portRangeStart: 0
              protocol: string
              sourceIp: string
              sourceMac: string
              targetIp: string
              type: string
        id: string
        ips:
            - string
        ipv6CidrBlock: string
        ipv6Ips:
            - string
        lan: 0
        mac: string
        name: string
        pciSlot: 0
        securityGroupsIds:
            - string
    ram: 0
    securityGroupsIds:
        - string
    serverId: string
    sshKeys:
        - string
    templateUuid: string
    timeouts:
        create: string
        default: string
        delete: string
        update: string
    type: string
    vmState: string
    volume:
        availabilityZone: string
        backupUnitId: string
        bootServer: string
        bus: string
        cpuHotPlug: false
        deviceNumber: 0
        discVirtioHotPlug: false
        discVirtioHotUnplug: false
        diskType: string
        licenceType: string
        name: string
        nicHotPlug: false
        nicHotUnplug: false
        pciSlot: 0
        ramHotPlug: false
        size: 0
        userData: string

Server Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Server resource accepts the following input properties:

DatacenterId string

[string] The ID of a Virtual Data Center.

AllowReplace bool

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠️ Warning: allow_replace - lets you update immutable fields, but it first destroys and then re-creates the server in order to do it. This field should be used with care, understanding the risks.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

AvailabilityZone string

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

BootCdrom string

DEPRECATED Please refer to ionoscloud.ServerBootDeviceSelection (Optional)(Computed)[string] The associated boot drive, if any. Must be the UUID of a bootable CDROM image that can be retrieved using the ionoscloud.getImage data source.

Deprecated: Deprecated

BootImage string

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

Cores double

(Computed)[integer] Number of server CPU cores.

CpuFamily string

[string] CPU architecture on which server gets provisioned; not all CPU architectures are available in all datacenter regions; available CPU architectures can be retrieved from the datacenter resource. E.g.: "INTEL_SKYLAKE" or "INTEL_XEON".

FirewallruleIds List<string>

The associated firewall rules.

Hostname string

(Computed)[string] The hostname of the resource. Allowed characters are a-z, 0-9 and - (minus). Hostname should not start with minus and should not be longer than 63 characters. If no value provided explicitly, it will be populated with the name of the server

ImageName string

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

ImagePassword string

[string] Required if ssh_key_path is not provided.

Labels List<ServerLabel>

[set] A label can be seen as an object with only two required fields: key and value, both of the string type. Please check the example presented above to see how a label can be used in the plan. A server can have multiple labels.

Name string

[string] The name of the server.

Nic ServerNic

See the Nic section.

Ram double

(Computed)[integer] The amount of memory for the server in MB.

SecurityGroupsIds List<string>

The list of Security Group IDs for the

ServerId string

SshKeyPaths List<string>

[list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.

Deprecated: Deprecated

SshKeys List<string>

[list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.

TemplateUuid string

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

Timeouts ServerTimeouts

Type string

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

VmState string

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

Volume ServerVolume

See the Volume section.

DatacenterId string

[string] The ID of a Virtual Data Center.

AllowReplace bool

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

AvailabilityZone string

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

BootCdrom string

Deprecated: Deprecated

BootImage string

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

Cores float64

(Computed)[integer] Number of server CPU cores.

CpuFamily string

FirewallruleIds []string

The associated firewall rules.

Hostname string

ImageName string

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

ImagePassword string

[string] Required if ssh_key_path is not provided.

Labels []ServerLabelArgs

Name string

[string] The name of the server.

Nic ServerNicArgs

See the Nic section.

Ram float64

(Computed)[integer] The amount of memory for the server in MB.

SecurityGroupsIds []string

The list of Security Group IDs for the

ServerId string

SshKeyPaths []string

Deprecated: Deprecated

SshKeys []string

TemplateUuid string

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

Timeouts ServerTimeoutsArgs

Type string

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

VmState string

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

Volume ServerVolumeArgs

See the Volume section.

datacenterId String

[string] The ID of a Virtual Data Center.

allowReplace Boolean

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availabilityZone String

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

bootCdrom String

Deprecated: Deprecated

bootImage String

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

cores Double

(Computed)[integer] Number of server CPU cores.

cpuFamily String

firewallruleIds List<String>

The associated firewall rules.

hostname String

imageName String

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

imagePassword String

[string] Required if ssh_key_path is not provided.

labels List<ServerLabel>

name String

[string] The name of the server.

nic ServerNic

See the Nic section.

ram Double

(Computed)[integer] The amount of memory for the server in MB.

securityGroupsIds List<String>

The list of Security Group IDs for the

serverId String

sshKeyPaths List<String>

Deprecated: Deprecated

sshKeys List<String>

templateUuid String

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts ServerTimeouts

type String

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vmState String

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume ServerVolume

See the Volume section.

datacenterId string

[string] The ID of a Virtual Data Center.

allowReplace boolean

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availabilityZone string

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

bootCdrom string

Deprecated: Deprecated

bootImage string

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

cores number

(Computed)[integer] Number of server CPU cores.

cpuFamily string

firewallruleIds string[]

The associated firewall rules.

hostname string

imageName string

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

imagePassword string

[string] Required if ssh_key_path is not provided.

labels ServerLabel[]

name string

[string] The name of the server.

nic ServerNic

See the Nic section.

ram number

(Computed)[integer] The amount of memory for the server in MB.

securityGroupsIds string[]

The list of Security Group IDs for the

serverId string

sshKeyPaths string[]

Deprecated: Deprecated

sshKeys string[]

templateUuid string

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts ServerTimeouts

type string

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vmState string

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume ServerVolume

See the Volume section.

datacenter_id str

[string] The ID of a Virtual Data Center.

allow_replace bool

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availability_zone str

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

boot_cdrom str

Deprecated: Deprecated

boot_image str

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

cores float

(Computed)[integer] Number of server CPU cores.

cpu_family str

firewallrule_ids Sequence[str]

The associated firewall rules.

hostname str

image_name str

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

image_password str

[string] Required if ssh_key_path is not provided.

labels Sequence[ServerLabelArgs]

name str

[string] The name of the server.

nic ServerNicArgs

See the Nic section.

ram float

(Computed)[integer] The amount of memory for the server in MB.

security_groups_ids Sequence[str]

The list of Security Group IDs for the

server_id str

ssh_key_paths Sequence[str]

Deprecated: Deprecated

ssh_keys Sequence[str]

template_uuid str

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts ServerTimeoutsArgs

type str

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vm_state str

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume ServerVolumeArgs

See the Volume section.

datacenterId String

[string] The ID of a Virtual Data Center.

allowReplace Boolean

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availabilityZone String

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

bootCdrom String

Deprecated: Deprecated

bootImage String

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

cores Number

(Computed)[integer] Number of server CPU cores.

cpuFamily String

firewallruleIds List<String>

The associated firewall rules.

hostname String

imageName String

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

imagePassword String

[string] Required if ssh_key_path is not provided.

labels List<Property Map>

name String

[string] The name of the server.

nic Property Map

See the Nic section.

ram Number

(Computed)[integer] The amount of memory for the server in MB.

securityGroupsIds List<String>

The list of Security Group IDs for the

serverId String

sshKeyPaths List<String>

Deprecated: Deprecated

sshKeys List<String>

templateUuid String

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts Property Map

type String

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vmState String

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume Property Map

See the Volume section.

Outputs

All input properties are implicitly available as output properties. Additionally, the Server resource produces the following output properties:

BootVolume string: The associated boot volume.
FirewallruleId string: The associated firewall rule.
Id string: The provider-assigned unique ID for this managed resource.
InlineVolumeIds List<string>: A list with the IDs for the volumes that are defined inside the server resource.
PrimaryIp string: The associated IP address.
PrimaryNic string: The associated NIC.

BootVolume string: The associated boot volume.
FirewallruleId string: The associated firewall rule.
Id string: The provider-assigned unique ID for this managed resource.
InlineVolumeIds []string: A list with the IDs for the volumes that are defined inside the server resource.
PrimaryIp string: The associated IP address.
PrimaryNic string: The associated NIC.

bootVolume String: The associated boot volume.
firewallruleId String: The associated firewall rule.
id String: The provider-assigned unique ID for this managed resource.
inlineVolumeIds List<String>: A list with the IDs for the volumes that are defined inside the server resource.
primaryIp String: The associated IP address.
primaryNic String: The associated NIC.

bootVolume string: The associated boot volume.
firewallruleId string: The associated firewall rule.
id string: The provider-assigned unique ID for this managed resource.
inlineVolumeIds string[]: A list with the IDs for the volumes that are defined inside the server resource.
primaryIp string: The associated IP address.
primaryNic string: The associated NIC.

boot_volume str: The associated boot volume.
firewallrule_id str: The associated firewall rule.
id str: The provider-assigned unique ID for this managed resource.
inline_volume_ids Sequence[str]: A list with the IDs for the volumes that are defined inside the server resource.
primary_ip str: The associated IP address.
primary_nic str: The associated NIC.

bootVolume String: The associated boot volume.
firewallruleId String: The associated firewall rule.
id String: The provider-assigned unique ID for this managed resource.
inlineVolumeIds List<String>: A list with the IDs for the volumes that are defined inside the server resource.
primaryIp String: The associated IP address.
primaryNic String: The associated NIC.

Look up Existing Server Resource

Get an existing Server resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ServerState, opts?: CustomResourceOptions): Server

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allow_replace: Optional[bool] = None,
        availability_zone: Optional[str] = None,
        boot_cdrom: Optional[str] = None,
        boot_image: Optional[str] = None,
        boot_volume: Optional[str] = None,
        cores: Optional[float] = None,
        cpu_family: Optional[str] = None,
        datacenter_id: Optional[str] = None,
        firewallrule_id: Optional[str] = None,
        firewallrule_ids: Optional[Sequence[str]] = None,
        hostname: Optional[str] = None,
        image_name: Optional[str] = None,
        image_password: Optional[str] = None,
        inline_volume_ids: Optional[Sequence[str]] = None,
        labels: Optional[Sequence[ServerLabelArgs]] = None,
        name: Optional[str] = None,
        nic: Optional[ServerNicArgs] = None,
        primary_ip: Optional[str] = None,
        primary_nic: Optional[str] = None,
        ram: Optional[float] = None,
        security_groups_ids: Optional[Sequence[str]] = None,
        server_id: Optional[str] = None,
        ssh_key_paths: Optional[Sequence[str]] = None,
        ssh_keys: Optional[Sequence[str]] = None,
        template_uuid: Optional[str] = None,
        timeouts: Optional[ServerTimeoutsArgs] = None,
        type: Optional[str] = None,
        vm_state: Optional[str] = None,
        volume: Optional[ServerVolumeArgs] = None) -> Server

func GetServer(ctx *Context, name string, id IDInput, state *ServerState, opts ...ResourceOption) (*Server, error)

public static Server Get(string name, Input<string> id, ServerState? state, CustomResourceOptions? opts = null)

public static Server get(String name, Output<String> id, ServerState state, CustomResourceOptions options)

resources:  _:    type: ionoscloud:Server    get:      id: ${id}

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

AllowReplace bool

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

AvailabilityZone string

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

BootCdrom string

Deprecated: Deprecated

BootImage string

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

BootVolume string

The associated boot volume.

Cores double

(Computed)[integer] Number of server CPU cores.

CpuFamily string

DatacenterId string

[string] The ID of a Virtual Data Center.

FirewallruleId string

The associated firewall rule.

FirewallruleIds List<string>

The associated firewall rules.

Hostname string

ImageName string

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

ImagePassword string

[string] Required if ssh_key_path is not provided.

InlineVolumeIds List<string>

A list with the IDs for the volumes that are defined inside the server resource.

Labels List<ServerLabel>

Name string

[string] The name of the server.

Nic ServerNic

See the Nic section.

PrimaryIp string

The associated IP address.

PrimaryNic string

The associated NIC.

Ram double

(Computed)[integer] The amount of memory for the server in MB.

SecurityGroupsIds List<string>

The list of Security Group IDs for the

ServerId string

SshKeyPaths List<string>

Deprecated: Deprecated

SshKeys List<string>

TemplateUuid string

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

Timeouts ServerTimeouts

Type string

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

VmState string

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

Volume ServerVolume

See the Volume section.

AllowReplace bool

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

AvailabilityZone string

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

BootCdrom string

Deprecated: Deprecated

BootImage string

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

BootVolume string

The associated boot volume.

Cores float64

(Computed)[integer] Number of server CPU cores.

CpuFamily string

DatacenterId string

[string] The ID of a Virtual Data Center.

FirewallruleId string

The associated firewall rule.

FirewallruleIds []string

The associated firewall rules.

Hostname string

ImageName string

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

ImagePassword string

[string] Required if ssh_key_path is not provided.

InlineVolumeIds []string

A list with the IDs for the volumes that are defined inside the server resource.

Labels []ServerLabelArgs

Name string

[string] The name of the server.

Nic ServerNicArgs

See the Nic section.

PrimaryIp string

The associated IP address.

PrimaryNic string

The associated NIC.

Ram float64

(Computed)[integer] The amount of memory for the server in MB.

SecurityGroupsIds []string

The list of Security Group IDs for the

ServerId string

SshKeyPaths []string

Deprecated: Deprecated

SshKeys []string

TemplateUuid string

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

Timeouts ServerTimeoutsArgs

Type string

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

VmState string

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

Volume ServerVolumeArgs

See the Volume section.

allowReplace Boolean

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availabilityZone String

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

bootCdrom String

Deprecated: Deprecated

bootImage String

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

bootVolume String

The associated boot volume.

cores Double

(Computed)[integer] Number of server CPU cores.

cpuFamily String

datacenterId String

[string] The ID of a Virtual Data Center.

firewallruleId String

The associated firewall rule.

firewallruleIds List<String>

The associated firewall rules.

hostname String

imageName String

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

imagePassword String

[string] Required if ssh_key_path is not provided.

inlineVolumeIds List<String>

A list with the IDs for the volumes that are defined inside the server resource.

labels List<ServerLabel>

name String

[string] The name of the server.

nic ServerNic

See the Nic section.

primaryIp String

The associated IP address.

primaryNic String

The associated NIC.

ram Double

(Computed)[integer] The amount of memory for the server in MB.

securityGroupsIds List<String>

The list of Security Group IDs for the

serverId String

sshKeyPaths List<String>

Deprecated: Deprecated

sshKeys List<String>

templateUuid String

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts ServerTimeouts

type String

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vmState String

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume ServerVolume

See the Volume section.

allowReplace boolean

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availabilityZone string

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

bootCdrom string

Deprecated: Deprecated

bootImage string

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

bootVolume string

The associated boot volume.

cores number

(Computed)[integer] Number of server CPU cores.

cpuFamily string

datacenterId string

[string] The ID of a Virtual Data Center.

firewallruleId string

The associated firewall rule.

firewallruleIds string[]

The associated firewall rules.

hostname string

imageName string

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

imagePassword string

[string] Required if ssh_key_path is not provided.

inlineVolumeIds string[]

A list with the IDs for the volumes that are defined inside the server resource.

labels ServerLabel[]

name string

[string] The name of the server.

nic ServerNic

See the Nic section.

primaryIp string

The associated IP address.

primaryNic string

The associated NIC.

ram number

(Computed)[integer] The amount of memory for the server in MB.

securityGroupsIds string[]

The list of Security Group IDs for the

serverId string

sshKeyPaths string[]

Deprecated: Deprecated

sshKeys string[]

templateUuid string

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts ServerTimeouts

type string

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vmState string

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume ServerVolume

See the Volume section.

allow_replace bool

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availability_zone str

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

boot_cdrom str

Deprecated: Deprecated

boot_image str

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

boot_volume str

The associated boot volume.

cores float

(Computed)[integer] Number of server CPU cores.

cpu_family str

datacenter_id str

[string] The ID of a Virtual Data Center.

firewallrule_id str

The associated firewall rule.

firewallrule_ids Sequence[str]

The associated firewall rules.

hostname str

image_name str

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

image_password str

[string] Required if ssh_key_path is not provided.

inline_volume_ids Sequence[str]

A list with the IDs for the volumes that are defined inside the server resource.

labels Sequence[ServerLabelArgs]

name str

[string] The name of the server.

nic ServerNicArgs

See the Nic section.

primary_ip str

The associated IP address.

primary_nic str

The associated NIC.

ram float

(Computed)[integer] The amount of memory for the server in MB.

security_groups_ids Sequence[str]

The list of Security Group IDs for the

server_id str

ssh_key_paths Sequence[str]

Deprecated: Deprecated

ssh_keys Sequence[str]

template_uuid str

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts ServerTimeoutsArgs

type str

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vm_state str

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume ServerVolumeArgs

See the Volume section.

allowReplace Boolean

[bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the server.

⚠ WARNING
Image_name under volume level is deprecated, please use image_name under server level ssh_key_path and ssh_keys fields are immutable.

⚠ WARNING
If you want to create a CUBE server, you have to provide the template_uuid. In this case you can not set cores, ram and volume.size arguments, these being mutually exclusive with template_uuid.
In all the other cases (ENTERPRISE servers) you have to provide values for cores, ram and volume size.

availabilityZone String

[string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.

bootCdrom String

Deprecated: Deprecated

bootImage String

[string] The image or snapshot UUID / name. May also be an image alias. It is required if licence_type is not provided.

bootVolume String

The associated boot volume.

cores Number

(Computed)[integer] Number of server CPU cores.

cpuFamily String

datacenterId String

[string] The ID of a Virtual Data Center.

firewallruleId String

The associated firewall rule.

firewallruleIds List<String>

The associated firewall rules.

hostname String

imageName String

[string] The name, ID or alias of the image. May also be a snapshot ID. It is required if licence_type is not provided. Attribute is immutable.

imagePassword String

[string] Required if ssh_key_path is not provided.

inlineVolumeIds List<String>

A list with the IDs for the volumes that are defined inside the server resource.

labels List<Property Map>

name String

[string] The name of the server.

nic Property Map

See the Nic section.

primaryIp String

The associated IP address.

primaryNic String

The associated NIC.

ram Number

(Computed)[integer] The amount of memory for the server in MB.

securityGroupsIds List<String>

The list of Security Group IDs for the

serverId String

sshKeyPaths List<String>

Deprecated: Deprecated

sshKeys List<String>

templateUuid String

[string] The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource

timeouts Property Map

type String

(Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

vmState String

[string] Sets the power state of the server. E.g: RUNNING, SHUTOFF or SUSPENDED. SUSPENDED state is only valid for cube. SHUTOFF state is only valid for enterprise.

volume Property Map

See the Volume section.

Supporting Types

ServerLabel, ServerLabelArgs

Key string: [string] The key of the label.
Value string: [string] The value of the label.

Key string: [string] The key of the label.
Value string: [string] The value of the label.

key String: [string] The key of the label.
value String: [string] The value of the label.

key string: [string] The key of the label.
value string: [string] The value of the label.

key str: [string] The key of the label.
value str: [string] The value of the label.

key String: [string] The key of the label.
value String: [string] The value of the label.

ServerNic, ServerNicArgs

Lan double
DeviceNumber double
Dhcp bool
Dhcpv6 bool: Indicates whether this NIC receives an IPv6 address through DHCP.
FirewallActive bool
FirewallType string
Firewalls List<ServerNicFirewall>: Allows to define firewall rules inline in the server. See the Firewall section.
Id string
Ips List<string>: Collection of IP addresses assigned to a nic. Explicitly assigned public IPs need to come from reserved IP blocks, Passing value null or empty array will assign an IP address automatically.
Ipv6CidrBlock string: IPv6 CIDR block assigned to the NIC.
Ipv6Ips List<string>: Collection for IPv6 addresses assigned to a nic. Explicitly assigned IPv6 addresses need to come from inside the IPv6 CIDR block assigned to the nic.
Mac string
Name string: [string] The name of the server.
PciSlot double
SecurityGroupsIds List<string>: The list of Security Group IDs for the

Lan float64
DeviceNumber float64
Dhcp bool
Dhcpv6 bool: Indicates whether this NIC receives an IPv6 address through DHCP.
FirewallActive bool
FirewallType string
Firewalls []ServerNicFirewall: Allows to define firewall rules inline in the server. See the Firewall section.
Id string
Ips []string: Collection of IP addresses assigned to a nic. Explicitly assigned public IPs need to come from reserved IP blocks, Passing value null or empty array will assign an IP address automatically.
Ipv6CidrBlock string: IPv6 CIDR block assigned to the NIC.
Ipv6Ips []string: Collection for IPv6 addresses assigned to a nic. Explicitly assigned IPv6 addresses need to come from inside the IPv6 CIDR block assigned to the nic.
Mac string
Name string: [string] The name of the server.
PciSlot float64
SecurityGroupsIds []string: The list of Security Group IDs for the

lan Double
deviceNumber Double
dhcp Boolean
dhcpv6 Boolean: Indicates whether this NIC receives an IPv6 address through DHCP.
firewallActive Boolean
firewallType String
firewalls List<ServerNicFirewall>: Allows to define firewall rules inline in the server. See the Firewall section.
id String
ips List<String>: Collection of IP addresses assigned to a nic. Explicitly assigned public IPs need to come from reserved IP blocks, Passing value null or empty array will assign an IP address automatically.
ipv6CidrBlock String: IPv6 CIDR block assigned to the NIC.
ipv6Ips List<String>: Collection for IPv6 addresses assigned to a nic. Explicitly assigned IPv6 addresses need to come from inside the IPv6 CIDR block assigned to the nic.
mac String
name String: [string] The name of the server.
pciSlot Double
securityGroupsIds List<String>: The list of Security Group IDs for the

lan number
deviceNumber number
dhcp boolean
dhcpv6 boolean: Indicates whether this NIC receives an IPv6 address through DHCP.
firewallActive boolean
firewallType string
firewalls ServerNicFirewall[]: Allows to define firewall rules inline in the server. See the Firewall section.
id string
ips string[]: Collection of IP addresses assigned to a nic. Explicitly assigned public IPs need to come from reserved IP blocks, Passing value null or empty array will assign an IP address automatically.
ipv6CidrBlock string: IPv6 CIDR block assigned to the NIC.
ipv6Ips string[]: Collection for IPv6 addresses assigned to a nic. Explicitly assigned IPv6 addresses need to come from inside the IPv6 CIDR block assigned to the nic.
mac string
name string: [string] The name of the server.
pciSlot number
securityGroupsIds string[]: The list of Security Group IDs for the

lan float
device_number float
dhcp bool
dhcpv6 bool: Indicates whether this NIC receives an IPv6 address through DHCP.
firewall_active bool
firewall_type str
firewalls Sequence[ServerNicFirewall]: Allows to define firewall rules inline in the server. See the Firewall section.
id str
ips Sequence[str]: Collection of IP addresses assigned to a nic. Explicitly assigned public IPs need to come from reserved IP blocks, Passing value null or empty array will assign an IP address automatically.
ipv6_cidr_block str: IPv6 CIDR block assigned to the NIC.
ipv6_ips Sequence[str]: Collection for IPv6 addresses assigned to a nic. Explicitly assigned IPv6 addresses need to come from inside the IPv6 CIDR block assigned to the nic.
mac str
name str: [string] The name of the server.
pci_slot float
security_groups_ids Sequence[str]: The list of Security Group IDs for the

lan Number
deviceNumber Number
dhcp Boolean
dhcpv6 Boolean: Indicates whether this NIC receives an IPv6 address through DHCP.
firewallActive Boolean
firewallType String
firewalls List<Property Map>: Allows to define firewall rules inline in the server. See the Firewall section.
id String
ips List<String>: Collection of IP addresses assigned to a nic. Explicitly assigned public IPs need to come from reserved IP blocks, Passing value null or empty array will assign an IP address automatically.
ipv6CidrBlock String: IPv6 CIDR block assigned to the NIC.
ipv6Ips List<String>: Collection for IPv6 addresses assigned to a nic. Explicitly assigned IPv6 addresses need to come from inside the IPv6 CIDR block assigned to the nic.
mac String
name String: [string] The name of the server.
pciSlot Number
securityGroupsIds List<String>: The list of Security Group IDs for the

ServerNicFirewall, ServerNicFirewallArgs

Protocol string
IcmpCode string
IcmpType string
Id string
Name string: [string] The name of the server.
PortRangeEnd double
PortRangeStart double
SourceIp string
SourceMac string
TargetIp string
Type string: (Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

Protocol string
IcmpCode string
IcmpType string
Id string
Name string: [string] The name of the server.
PortRangeEnd float64
PortRangeStart float64
SourceIp string
SourceMac string
TargetIp string
Type string: (Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

protocol String
icmpCode String
icmpType String
id String
name String: [string] The name of the server.
portRangeEnd Double
portRangeStart Double
sourceIp String
sourceMac String
targetIp String
type String: (Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

protocol string
icmpCode string
icmpType string
id string
name string: [string] The name of the server.
portRangeEnd number
portRangeStart number
sourceIp string
sourceMac string
targetIp string
type string: (Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

protocol str
icmp_code str
icmp_type str
id str
name str: [string] The name of the server.
port_range_end float
port_range_start float
source_ip str
source_mac str
target_ip str
type str: (Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

protocol String
icmpCode String
icmpType String
id String
name String: [string] The name of the server.
portRangeEnd Number
portRangeStart Number
sourceIp String
sourceMac String
targetIp String
type String: (Computed)[string] Server usages: ENTERPRISE or CUBE. This property is immutable.

ServerTimeouts, ServerTimeoutsArgs

Create string
Default string
Delete string
Update string

Create string
Default string
Delete string
Update string

create String
default_ String
delete String
update String

create string
default string
delete string
update string

create str
default str
delete str
update str

create String
default String
delete String
update String

ServerVolume, ServerVolumeArgs

DiskType string
AvailabilityZone string: [string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.
BackupUnitId string: The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
BootServer string: The UUID of the attached server.
Bus string
CpuHotPlug bool
DeviceNumber double
DiscVirtioHotPlug bool
DiscVirtioHotUnplug bool
ImagePassword string: [string] Required if ssh_key_path is not provided.
Deprecated: Deprecated
LicenceType string: [string] Sets the OS type of the server.
Name string: [string] The name of the server.
NicHotPlug bool
NicHotUnplug bool
PciSlot double
RamHotPlug bool
Size double: The size of the volume in GB.
SshKeyPaths List<string>: [list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.
Deprecated: Deprecated
SshKeys List<string>: [list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.
Deprecated: Deprecated
UserData string: The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.

DiskType string
AvailabilityZone string: [string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.
BackupUnitId string: The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
BootServer string: The UUID of the attached server.
Bus string
CpuHotPlug bool
DeviceNumber float64
DiscVirtioHotPlug bool
DiscVirtioHotUnplug bool
ImagePassword string: [string] Required if ssh_key_path is not provided.
Deprecated: Deprecated
LicenceType string: [string] Sets the OS type of the server.
Name string: [string] The name of the server.
NicHotPlug bool
NicHotUnplug bool
PciSlot float64
RamHotPlug bool
Size float64: The size of the volume in GB.
SshKeyPaths []string: [list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.
Deprecated: Deprecated
SshKeys []string: [list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.
Deprecated: Deprecated
UserData string: The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.

diskType String
availabilityZone String: [string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.
backupUnitId String: The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
bootServer String: The UUID of the attached server.
bus String
cpuHotPlug Boolean
deviceNumber Double
discVirtioHotPlug Boolean
discVirtioHotUnplug Boolean
imagePassword String: [string] Required if ssh_key_path is not provided.
Deprecated: Deprecated
licenceType String: [string] Sets the OS type of the server.
name String: [string] The name of the server.
nicHotPlug Boolean
nicHotUnplug Boolean
pciSlot Double
ramHotPlug Boolean
size Double: The size of the volume in GB.
sshKeyPaths List<String>: [list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.
Deprecated: Deprecated
sshKeys List<String>: [list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.
Deprecated: Deprecated
userData String: The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.

diskType string
availabilityZone string: [string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.
backupUnitId string: The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
bootServer string: The UUID of the attached server.
bus string
cpuHotPlug boolean
deviceNumber number
discVirtioHotPlug boolean
discVirtioHotUnplug boolean
imagePassword string: [string] Required if ssh_key_path is not provided.
Deprecated: Deprecated
licenceType string: [string] Sets the OS type of the server.
name string: [string] The name of the server.
nicHotPlug boolean
nicHotUnplug boolean
pciSlot number
ramHotPlug boolean
size number: The size of the volume in GB.
sshKeyPaths string[]: [list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.
Deprecated: Deprecated
sshKeys string[]: [list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.
Deprecated: Deprecated
userData string: The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.

disk_type str
availability_zone str: [string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.
backup_unit_id str: The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
boot_server str: The UUID of the attached server.
bus str
cpu_hot_plug bool
device_number float
disc_virtio_hot_plug bool
disc_virtio_hot_unplug bool
image_password str: [string] Required if ssh_key_path is not provided.
Deprecated: Deprecated
licence_type str: [string] Sets the OS type of the server.
name str: [string] The name of the server.
nic_hot_plug bool
nic_hot_unplug bool
pci_slot float
ram_hot_plug bool
size float: The size of the volume in GB.
ssh_key_paths Sequence[str]: [list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.
Deprecated: Deprecated
ssh_keys Sequence[str]: [list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.
Deprecated: Deprecated
user_data str: The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.

diskType String
availabilityZone String: [string] The availability zone in which the server should exist. E.g: AUTO, ZONE_1, ZONE_2. This property is immutable.
backupUnitId String: The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
bootServer String: The UUID of the attached server.
bus String
cpuHotPlug Boolean
deviceNumber Number
discVirtioHotPlug Boolean
discVirtioHotUnplug Boolean
imagePassword String: [string] Required if ssh_key_path is not provided.
Deprecated: Deprecated
licenceType String: [string] Sets the OS type of the server.
name String: [string] The name of the server.
nicHotPlug Boolean
nicHotUnplug Boolean
pciSlot Number
ramHotPlug Boolean
size Number: The size of the volume in GB.
sshKeyPaths List<String>: [list] List of absolute paths to files containing a public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Required for IonosCloud Linux images. Required if image_password is not provided. Does not support ~ expansion to homedir in the given path. This property is immutable.
Deprecated: Deprecated
sshKeys List<String>: [list] Immutable List of absolute or relative paths to files containing public SSH key that will be injected into IonosCloud provided Linux images. Also accepts ssh keys directly. Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key. This field may only be set in creation requests. When reading, it always returns null. SSH keys are only supported if a public Linux image is used for the volume creation. Does not support ~ expansion to homedir in the given path.
Deprecated: Deprecated
userData String: The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.

Package Details

Repository: ionoscloud ionos-cloud/terraform-provider-ionoscloud
License
Notes: This Pulumi package is based on the ionoscloud Terraform Provider.

ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionos-cloud/terraform-provider-ionoscloud

ionoscloud.Server

On this page

On this page

Import

Create Server Resource

Constructor syntax

Parameters

Constructor example

Server Resource Properties

Inputs

Outputs

Look up Existing Server Resource

Supporting Types

ServerLabel, ServerLabelArgs

ServerNic, ServerNicArgs

ServerNicFirewall, ServerNicFirewallArgs

ServerTimeouts, ServerTimeoutsArgs

ServerVolume, ServerVolumeArgs

Package Details

On this page

On this page