Skip to content

/AWS1/CL_EC2CAPACITYRSVPEC

Describes an instance's Capacity Reservation targeting option.

Use the CapacityReservationPreference parameter to configure the instance to run as an On-Demand Instance, to run in any open Capacity Reservation that has matching attributes, or to run only in a Capacity Reservation or Capacity Reservation group. Use the CapacityReservationTarget parameter to explicitly target a specific Capacity Reservation or a Capacity Reservation group.

You can only specify CapacityReservationPreference and CapacityReservationTarget if the CapacityReservationPreference is capacity-reservations-only.

CONSTRUCTOR

IMPORTING

Optional arguments:

IV_CAPRESERVATIONPREFERENCE TYPE /AWS1/EC2CAPRESERVATIONPREFE00 /AWS1/EC2CAPRESERVATIONPREFE00

Indicates the instance's Capacity Reservation preferences. Possible preferences include:

  • capacity-reservations-only - The instance will only run in a Capacity Reservation or Capacity Reservation group. If capacity isn't available, the instance will fail to launch.

  • open - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone, and tenancy). If capacity isn't available, the instance runs as an On-Demand Instance.

  • none - The instance doesn't run in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.

IO_CAPACITYRESERVATIONTARGET TYPE REF TO /AWS1/CL_EC2CAPRESERVATIONTGT /AWS1/CL_EC2CAPRESERVATIONTGT

Information about the target Capacity Reservation or Capacity Reservation group.

Queryable Attributes

CapacityReservationPreference

Indicates the instance's Capacity Reservation preferences. Possible preferences include:

  • capacity-reservations-only - The instance will only run in a Capacity Reservation or Capacity Reservation group. If capacity isn't available, the instance will fail to launch.

  • open - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone, and tenancy). If capacity isn't available, the instance runs as an On-Demand Instance.

  • none - The instance doesn't run in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.

Accessible with the following methods

Method Description
GET_CAPRESERVATIONPREFERENCE() Getter for CAPRESERVATIONPREFERENCE, with configurable defau
ASK_CAPRESERVATIONPREFERENCE() Getter for CAPRESERVATIONPREFERENCE w/ exceptions if field h
HAS_CAPRESERVATIONPREFERENCE() Determine if CAPRESERVATIONPREFERENCE has a value

CapacityReservationTarget

Information about the target Capacity Reservation or Capacity Reservation group.

Accessible with the following methods

Method Description
GET_CAPRESERVATIONTARGET() Getter for CAPACITYRESERVATIONTARGET