servers.md

subcategory	layout	page_title	sidebar_current	description
Compute Engine	ionoscloud	IonosCloud : servers	docs-ionoscloud-datasource-servers	Retrieves a list of Ionos Cloud Servers

ionoscloud_servers

The Servers data source can be used to search for and return existing servers based on filters used.

Example Usage

By Name

data ionoscloud_servers example {
  datacenter_id = ionoscloud_datacenter.example.id
  filter {
    name = "name"
    value = "server_name_to_look_here"
  }
}

By CPU Family

data ionoscloud_servers example {
  datacenter_id = ionoscloud_datacenter.example.id
  filter {
    name = "cpu_family"
    value = "INTEL_XEON"
  }
}

By Name and Cores

data ionoscloud_servers example {
  datacenter_id = ionoscloud_datacenter.example.id
  filter {
    name = "name"
    value = "test"
  }
  filter {
    name = "cores"
    value = "1"
  }
}

Argument Reference

• datacenter_id - (Required) Name of an existing datacenter that the servers are a part of
• filter - (Required) One or more name/value pairs to filter off of. You can use most base fields in the server resource. These do NOT include nested fields in nics or volume nested fields.

datacenter_id and filter must be provided. If either is missing, the datasource will return an error.

NOTE: Lookup by filter is partial. Searching for a server using filter name and value test, will find all servers that have test in the name. For example, it will find servers named test, test1, testsomething.

NOTE: You cannot search by image_name by providing an alias like ubuntu.

Attributes Reference

The following attributes are returned by the datasource:

• servers - list of servers that matches the filters provided. For a full reference of all attributes returned, check out documentation