DeleteFleets
Deletes the specified EC2 Fleet request.
After you delete an EC2 Fleet request, it launches no new instances.
You must also specify whether a deleted EC2 Fleet request should terminate its instances. If
you choose to terminate the instances, the EC2 Fleet request enters the
deleted_terminating state. Otherwise, it enters the
deleted_running state, and the instances continue to run until they are
interrupted or you terminate them manually.
A deleted instant fleet with running instances is not supported. When you
delete an instant fleet, Amazon EC2 automatically terminates all its instances. For
fleets with more than 1000 instances, the deletion request might fail. If your fleet has
more than 1000 instances, first terminate most of the instances manually, leaving 1000 or
fewer. Then delete the fleet, and the remaining instances will be terminated automatically.
Restrictions
-
You can delete up to 25 fleets of type
instantin a single request. -
You can delete up to 100 fleets of type
maintainorrequestin a single request. -
You can delete up to 125 fleets in a single request, provided you do not exceed the quota for each fleet type, as specified above.
-
If you exceed the specified number of fleets to delete, no fleets are deleted.
For more information, see Delete an EC2 Fleet request and the instances in the fleet in the Amazon EC2 User Guide.
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.
- 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 isUnauthorizedOperation.Type: Boolean
Required: No
- FleetId.N
-
The IDs of the EC2 Fleets.
Constraints: In a single request, you can specify up to 25
instantfleet IDs and up to 100maintainorrequestfleet IDs.Type: Array of strings
Required: Yes
- TerminateInstances
-
Indicates whether to terminate the associated instances when the EC2 Fleet is deleted. The default is to terminate the instances.
To let the instances continue to run after the EC2 Fleet is deleted, specify
no-terminate-instances. Supported only for fleets of typemaintainandrequest.For
instantfleets, you cannot specifyNoTerminateInstances. A deletedinstantfleet with running instances is not supported.Type: Boolean
Required: Yes
Response Elements
The following elements are returned by the service.
- requestId
-
The ID of the request.
Type: String
- successfulFleetDeletionSet
-
Information about the EC2 Fleets that are successfully deleted.
Type: Array of DeleteFleetSuccessItem objects
- unsuccessfulFleetDeletionSet
-
Information about the EC2 Fleets that are not successfully deleted.
Type: Array of DeleteFleetErrorItem 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 AWS SDKs, see the following:
