CancelCapacityReservationFleets - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

CancelCapacityReservationFleets

Cancels one or more Capacity Reservation Fleets. When you cancel a Capacity Reservation Fleet, the following happens:

  • The Capacity Reservation Fleet's status changes to cancelled.

  • The individual Capacity Reservations in the Fleet are cancelled. Instances running in the Capacity Reservations at the time of cancelling the Fleet continue to run in shared capacity.

  • The Fleet stops creating new Capacity Reservations.

Request Parameters

The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.

CapacityReservationFleetId.N

The IDs of the Capacity Reservation Fleets to cancel.

Type: Array of strings

Required: Yes

DryRun

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Type: Boolean

Required: No

Response Elements

The following elements are returned by the service.

failedFleetCancellationSet

Information about the Capacity Reservation Fleets that could not be cancelled.

Type: Array of FailedCapacityReservationFleetCancellationResult objects

requestId

The ID of the request.

Type: String

successfulFleetCancellationSet

Information about the Capacity Reservation Fleets that were successfully cancelled.

Type: Array of CapacityReservationFleetCancellationState objects

Errors

For information about the errors that are common to all actions, see Common client error codes.

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: