alicloud_ecs_dedicated_hosts

This data source provides the ECS Dedicated Hosts of the current Alibaba Cloud user.

-> NOTE: Available since v1.91.0.

Example Usage

Basic Usage

variable "name" {
  default = "terraform-example"
}

provider "alicloud" {
  region = "cn-hangzhou"
}

resource "alicloud_ecs_dedicated_host" "default" {
  dedicated_host_type   = "ddh.c5"
  description           = "From_Terraform"
  dedicated_host_name   = var.name
  action_on_maintenance = "Migrate"
  tags = {
    Create = "TF"
    For    = "ddh-test",
  }
}

data "alicloud_ecs_dedicated_hosts" "ids" {
  ids = [alicloud_ecs_dedicated_host.default.id]
}

output "ecs_dedicated_host_id_0" {
  value = data.alicloud_ecs_dedicated_hosts.ids.hosts.0.id
}

Argument Reference

The following arguments are supported:

• ids - (Optional, ForceNew, List) A list of ECS Dedicated Host ids.
• name_regex - (Optional, ForceNew) A regex string to filter results by the ECS Dedicated Host name.
• dedicated_host_id - (Optional, ForceNew) The ID of ECS Dedicated Host.
• dedicated_host_name - (Optional, ForceNew) The name of ECS Dedicated Host.
• dedicated_host_type - (Optional, ForceNew) The type of the dedicated host.
• operation_locks - (Optional, ForceNew, Available since v1.123.1) The reason why the dedicated host resource is locked. See operation_locks below.
• resource_group_id - (Optional, ForceNew) The ID of the resource group to which the ECS Dedicated Host belongs.
• status - (Optional, ForceNew) The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
• zone_id - (Optional, ForceNew) The zone ID of the ECS Dedicated Host.
• tags - (Optional, ForceNew) A mapping of tags to assign to the resource.
• output_file - (Optional) Save the result to the file.

operation_locks

The operation_locks supports the following:

• lock_reason - (Optional, ForceNew) The reason why the dedicated host resource is locked.

Attributes Reference

The following attributes are exported in addition to the arguments listed above:

• names - A list of ECS Dedicated Host names.
• hosts - A list of ECS Dedicated Hosts. Each element contains the following attributes:
  • id - ID of the ECS Dedicated Host.
  • action_on_maintenance - The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
  • auto_placement - Specifies whether to add the dedicated host to the resource pool for automatic deployment.
  • auto_release_time - The automatic release time of the dedicated host.
  • cores - A mapping of tags to assign to the resource.
  • dedicated_host_id - ID of the ECS Dedicated Host.
  • dedicated_host_name - The name of the dedicated host.
  • dedicated_host_type - The type of the dedicated host.
  • description - The description of the dedicated host.
  • expired_time - The expiration time of the subscription dedicated host.
  • gpu_spec - The GPU model.
  • machine_id - The machine code of the dedicated host.
  • payment_type - The billing method of the dedicated host.
  • physical_gpus - The number of physical GPUs.
  • resource_group_id - The ID of the resource group to which the dedicated host belongs.
  • sale_cycle - The unit of the subscription billing method.
  • sockets - The number of physical CPUs.
  • status - The service status of the dedicated host.
  • supported_instance_types_list - The list of ECS instance.
  • tags - The tags of the dedicated host.
  • zone_id - The zone id of the dedicated host.
  • capacity - (Available since v1.123.1) A collection of proprietary host performance indicators.
    • available_local_storage - The remaining local disk capacity. Unit: GiB.
    • available_memory - The remaining memory capacity, unit: GiB.
    • available_vcpus - The number of remaining vCPU cores.
    • available_vgpus - The number of available virtual GPUs.
    • local_storage_category - Local disk type.
    • total_local_storage - The total capacity of the local disk, in GiB.
    • total_memory - The total memory capacity, unit: GiB.
    • total_vcpus - The total number of vCPU cores.
    • total_vgpus - The total number of virtual GPUs.
  • cpu_over_commit_ratio - (Available since v1.123.1) CPU oversold ratio.
  • network_attributes - dedicated host network parameters. contains the following attributes:
    • slb_udp_timeout - The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    • udp_timeout - (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.
  • operation_locks - (Available since v1.123.1) The operation_locks. contains the following attribute:
    • lock_reason - The reason why the dedicated host resource is locked.
  • supported_instance_type_families - (Available since v1.123.1) ECS instance type family supported by the dedicated host.
  • supported_custom_instance_type_families - (Available since v1.123.1) A custom instance type family supported by a dedicated host.
  • instances - (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    • instance_id - The ID of the ECS instance.
    • instance_type - The instance type of the ECS instance that was created on the dedicated host.
    • socket_id - The ID of the socket to which the ECS instance belongs.
    • instance_owner_id - The ID of the ECS instance owner.