» oci_core_dedicated_vm_host

This resource provides the Dedicated Vm Host resource in Oracle Cloud Infrastructure Core service.

Creates a new dedicated virtual machine host in the specified compartment and the specified availability domain. Dedicated virtual machine hosts enable you to run your Compute virtual machine (VM) instances on dedicated servers that are a single tenant and not shared with other customers. For more information, see Dedicated Virtual Machine Hosts.

» Example Usage

resource "oci_core_dedicated_vm_host" "test_dedicated_vm_host" {
    #Required
    availability_domain = "${var.dedicated_vm_host_availability_domain}"
    compartment_id = "${var.compartment_id}"
    dedicated_vm_host_shape = "${var.dedicated_vm_host_dedicated_vm_host_shape}"

    #Optional
    defined_tags = {"Operations.CostCenter"= "42"}
    display_name = "${var.dedicated_vm_host_display_name}"
    fault_domain = "${var.dedicated_vm_host_fault_domain}"
    freeform_tags = {"Department"= "Finance"}
}

» Argument Reference

The following arguments are supported:

  • availability_domain - (Required) The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
  • compartment_id - (Required) (Updatable) The OCID of the compartment.
  • dedicated_vm_host_shape - (Required) The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VM instances launched on the dedicated virtual machine host.
  • defined_tags - (Optional) (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
  • display_name - (Optional) (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My dedicated VM host
  • fault_domain - (Optional) The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

  • freeform_tags - (Optional) (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

» Attributes Reference

The following attributes are exported:

  • availability_domain - The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1
  • compartment_id - The OCID of the compartment that contains the dedicated virtual machine host.
  • dedicated_vm_host_shape - The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.
  • defined_tags - Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
  • display_name - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example: My Dedicated Vm Host
  • fault_domain - The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

    If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it, and then create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

  • freeform_tags - Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

  • id - The OCID of the dedicated VM host.

  • remaining_ocpus - The current available OCPUs of the dedicated VM host.

  • state - The current state of the dedicated VM host.

  • time_created - The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

  • total_ocpus - The current total OCPUs of the dedicated VM host.

» Import

DedicatedVmHosts can be imported using the id, e.g.

$ terraform import oci_core_dedicated_vm_host.test_dedicated_vm_host "id"