Oracle Cloud Infrastructure Documentation

Creating a Dedicated Virtual Machine Host

You must create a dedicated virtual machine host in Compute before you can place any instances on it.

When creating a dedicated virtual machine host, you select an availability domain and fault domain to launch it in. All the VM instances that you place on the host are subsequently created in this availability domain and fault domain.

You also select a compartment when you create the host, but you can move the host to a new compartment later without impacting any of the instances placed on it. You can also create the instances in a different compartment than the host, or move them to different compartments after they have been launched.

    1. Navigate to the Dedicated Virtual Machine Hosts list page. If you need help finding the list page, see Listing Dedicated Virtual Machine Hosts.
    2. Select Create dedicated virtual machine host.
    3. Enter the following information:
      • Name: Enter a name for the host. It doesn't have to be unique, and you can change it later. Avoid entering confidential information.
      • Create in compartment: Select the compartment to create the host in.
      • Availability domain Select the availability domain for the host.
      • Under the Dedicated host shape section:

        Select the shape to use for the host. Use the option you see:

        • Select the down arrow in the row for a host shape. Select a shape.
      • Optionally, select the option you see:
        • Select Show Advanced Options. Then enter the following information:
          • Fault domain: By leaving the default value, OCI selects the fault domain for the host. Otherwise, select your fault domain.
          • Tags: Select the tags for this resource.
    4. Select Create.

  • To create a dedicated virtual machine host, use the dedicated-vm-host create command:

    oci compute dedicated-vm-host create --dedicated-vm-host-shape <shape_name> --wait-for-state ACTIVE --display-name <display_name> --availability-domain <availability_domain> --compartment-id <compartment_OCID>

    Or use a JSON file.

    oci compute dedicated-vm-host-instance create --from-json <file://path/to/file.json>

    <file://path/to/file.json> is the path to a JSON file that defines the instance details. For information about how to generate an example of the JSON file, see Advanced JSON Options.

    For a complete list of flags and variable options for the Compute service CLI commands, see the command line reference for Compute.

    Important

    It can take up to 15 minutes for the dedicated virtual machine host to be fully created. The host must be in the ACTIVE state before you can launch an instance.

    To query the current state of a dedicated virtual machine host using the CLI, run the following command:

    oci compute dedicated-vm-host get --dedicated-vm-host-id <dedicatedVMhost_OCID>

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    Use this API operation to create a dedicated virtual machine host: CreateDedicatedVmHost.