Skip to content

Modifies the number of instances allocated to an interruptible reservation, allowing you to add more capacity or reclaim capacity to your source Capacity Reservation

Description

Modifies the number of instances allocated to an interruptible reservation, allowing you to add more capacity or reclaim capacity to your source Capacity Reservation.

Usage

ec2_update_interruptible_capacity_reservation_allocation(
  CapacityReservationId, TargetInstanceCount, DryRun, ZeroSizePreference)

Arguments

  • CapacityReservationId

    [required] The ID of the source Capacity Reservation containing the interruptible allocation to modify.

  • TargetInstanceCount

    The new number of instances to allocate. Enter a higher number to add more capacity to share, or a lower number to reclaim capacity to your source Capacity Reservation.

  • DryRun

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response.

  • ZeroSizePreference

    Specifies the updated behavior for the interruptible Capacity Reservation when you reduce its allocation to zero instances. Specify retain to keep the interruptible Capacity Reservation active at zero capacity so that you can allocate instances to it again later. Specify default to cancel the interruptible Capacity Reservation and return the capacity to your source Capacity Reservation.

Value

A list with the following syntax:

list(
  InterruptibleCapacityReservationId = "string",
  SourceCapacityReservationId = "string",
  InstanceCount = 123,
  TargetInstanceCount = 123,
  Status = "pending"|"active"|"updating"|"canceling"|"canceled"|"failed",
  InterruptionType = "adhoc"
)

Request syntax

svc$update_interruptible_capacity_reservation_allocation(
  CapacityReservationId = "string",
  TargetInstanceCount = 123,
  DryRun = TRUE|FALSE,
  ZeroSizePreference = "retain"|"default"
)