VCPU Server

Get information on a Ionos Cloud VCPU Servers

The VCPU Server data source can be used to search for and return existing VCPU 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.

Example Usage

By ID

data "ionoscloud_vcpu_server" "example" {
   datacenter_id = <datacenter_id>
   id            = <server_id>
}

By Name

data "ionoscloud_vcpu_server" "example" {
   datacenter_id = <datacenter_id>
   name          = "VCPU Server Example"
}

Argument Reference

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.

Attributes Reference

The following attributes are returned by the datasource:

id - The id of that resource
name - The name of that resource
hostname - The hostname of the server
type - The type of the server, should always be VCPU
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
security_groups_ids - The list of Security Group IDs for the resource.
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
- 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

PreviousServer NextCube Server

Last updated 2 days ago