// Module included in the following assemblies:
//
// * machine_management/creating_machinesets/creating-machineset-aws.adoc

:_mod-docs-content-type: PROCEDURE
[id="machineset-creating-dedicated-hosts-byo-machineset_{context}"]
= Place machines on a specific Dedicated Host by using machine sets

[role="_abstract"]
You can configure a machine set to place machines on a specific {aws-first} Dedicated Host by specifying the host ID.

:FeatureName: {aws-short} Dedicated Host support
include::snippets/technology-preview.adoc[]

.Procedure

* Specify the following `placement` fields in your machine set YAML file:
+
[source,yaml]
----
apiVersion: machine.openshift.io/v1beta1
kind: MachineSet
# ...
spec:
  template:
    spec:
      providerSpec:
        placement:
          tenancy: host
          host:
            affinity: DedicatedHost
            dedicatedHost:
              id: <dedicated_host_id>
----
where:

`<dedicated_host_id>`:: Specifies the ID of the {aws-short} Dedicated Host on which to place the machine, for example `h-0123456789abcdef0`.

.Verification

* Verify that the machine set exists by running the following command:
+
[source,terminal]
----
$ oc get machineset -n openshift-machine-api
----
