Get information on a Ionos Cloud Servers
The Server data source can be used to search for and return existing servers. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned. When this happens, please refine your search string so that it is specific enough to return only one result.
datacenter_id - (Required) Datacenter's UUID.
name - (Optional) Name of an existing server that you want to search for.
id - (Optional) ID of the server you want to search for.
datacenter_id and either name or id must be provided. If none, or both of name and id are provided, the datasource will return an error.
The following attributes are returned by the datasource:
template_uuid - The UUID of the template for creating a CUBE server; the available templates for CUBE servers can be found on the templates resource
hostname - The hostname of the resource.
id - The id of that resource
name - The name of that resource
type - Server usages: ENTERPRISE or CUBE
vm_state- Status of the virtual Machine
datacenter_id - The id of the datacenter
cores - The total number of cores for the server
cpu_family - 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.
ram - The amount of memory for the server in MB
availability_zone - The availability zone in which the server should exist
vm_state - Status of the virtual Machine
boot_cdrom
boot_volume
boot_image
token
cdroms - list of
id - Id of the attached cdrom
name - The name of the attached cdrom
description - Description of cdrom
location - Location of that image/snapshot
size - The size of the image in GB
cpu_hot_plug - Is capable of CPU hot plug (no reboot required)
cpu_hot_unplug - Is capable of CPU hot unplug (no reboot required)
ram_hot_plug - Is capable of memory hot plug (no reboot required)
ram_hot_unplug - Is capable of memory hot unplug (no reboot required)
nic_hot_plug - Is capable of nic hot plug (no reboot required)
nic_hot_unplug - Is capable of nic hot unplug (no reboot required)
disc_virtio_hot_plug - Is capable of Virt-IO drive hot plug (no reboot required)
disc_virtio_hot_unplug - Is capable of Virt-IO drive hot unplug (no reboot required)
disc_scsi_hot_plug - Is capable of SCSI drive hot plug (no reboot required)
disc_scsi_hot_unplug - Is capable of SCSI drive hot unplug (no reboot required)
licence_type - OS type of this Image
image_type - Type of image
image_aliases - List of image aliases mapped for this Image
public - Indicates if the image is part of the public repository or not
image_aliases - List of image aliases mapped for this Image
cloud_init - Cloud init compatibility
volumes - list of
id - Id of the attached volume
name - Name of the attached volume
type - Hardware type of the volume.
size - The size of the volume in GB
availability_zone - The availability zone in which the volume should exist
image - Image or snapshot ID to be used as template for this volume
image_password - Initial password to be set for installed OS
ssh_keys - Public SSH keys are set on the image as authorized keys for appropriate SSH login to the instance using the corresponding private key
bus - The bus type of the volume
licence_type - OS type of this volume
cpu_hot_plug - Is capable of CPU hot plug (no reboot required)
ram_hot_plug - Is capable of memory hot plug (no reboot required)
nic_hot_plug - Is capable of nic hot plug (no reboot required)
nic_hot_unplug - Is capable of nic hot unplug (no reboot required)
disc_virtio_hot_plug - Is capable of Virt-IO drive hot plug (no reboot required)
disc_virtio_hot_unplug - Is capable of Virt-IO drive hot unplug (no reboot required)
device_number - The Logical Unit Number of the storage volume
pci_slot - The PCI slot number of the storage volume
backup_unit_id - The uuid of the Backup Unit that user has access to
user_data - The cloud-init configuration for the volume as base64 encoded string
nics - list of
id - Id of the attached nic
name - Name of the attached nid
mac - The MAC address of the NIC
ips - Collection of IP addresses assigned to a nic
dhcp - Indicates if the nic will reserve an IP using DHCP
lan - The LAN ID the NIC will sit on
firewall_active - Activate or deactivate the firewall
firewall_type - The type of firewall rules that will be allowed on the NIC
device_number - The Logical Unit Number (LUN) of the storage volume
pci_slot - The PCI slot number of the Nic
security_groups_ids - The list of Security Group IDs for the resource.
firewall_rules - list of
id - Id of the firewall rule
name - Name of the firewall rule
protocol - he protocol for the rule
source_mac - Only traffic originating from the respective MAC address is allowed
source_ip - Only traffic originating from the respective IPv4 address is allowed. Value null allows all source IPs
target_ip - In case the target NIC has multiple IP addresses, only traffic directed to the respective IP address of the NIC is allowed
icmp_code - Defines the allowed code (from 0 to 254) if protocol ICMP is chosen
icmp_type - Defines the allowed type (from 0 to 254) if the protocol ICMP is chosen
port_range_start - Defines the start range of the allowed port (from 1 to 65534) if protocol TCP or UDP is chosen
port_range_end - Defines the end range of the allowed port (from 1 to 65534) if the protocol TCP or UDP is chosen
type - The type of firewall rule
labels - list of
id - The Id of the label
key - The key of the label
value - The value of the label
security_groups_ids - The list of Security Group IDs for the resource.