OSDOCS-16222: Cluster API AWS capacityReservationPreference

Author: jeana-redhat

modules/machine-feature-agnostic-capacity-reservation.adoc

@@ -45,15 +45,23 @@ spec:
   template:
     spec:
       capacityReservationId: <capacity_reservation> # <1>
-      marketType: <market_type> # <2>
+      capacityReservationPreference: <reservation_preference> # <2>
+      marketType: <market_type> # <3>
 # ...
 ----
 <1> Specify the ID of the 
 ifdef::azure[Capacity Reservation group]
 ifdef::aws[Capacity Block for ML or On-Demand Capacity Reservation]
 that you want to deploy machines on.
 ifdef::aws[]
-<2> Specify the market type to use.
+<2> Specify your preferred capacity reservation behavior.
+The following values are valid:
+`CapacityReservationsOnly`:: Use this option to require a matching capacity reservation.
+If no matching capacity reservation is available, the instance fails to launch.
+`Open`:: Use this option to allow using an open capacity reservation that matches the availability zone and instance type.
+`None`:: Use this option to prohibit using a capacity reservation.
+You might use this option to help keep capacity reservations available for workloads that you want to use them.
+<3> Specify the market type to use.
 The following values are valid:
 `CapacityBlock`:: Use this market type with Capacity Blocks for ML.
 `OnDemand`:: Use this market type with On-Demand Capacity Reservations.