Skip to main content

spot_fleet_instances

Creates, updates, deletes, gets or lists a spot_fleet_instances resource.

Overview

Namespot_fleet_instances
TypeResource
Idaws.ec2.spot_fleet_instances

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
instance_healthstringThe health status of the instance. If the status of either the instance status check or the system status check is impaired, the health status of the instance is unhealthy. Otherwise, the health status is healthy.
instance_idstringThe ID of the instance.
instance_typestringThe instance type.
spot_instance_request_idstringThe ID of the Spot Instance request.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_spot_fleet_instancesselectSpotFleetRequestId, regionDryRun, NextToken, MaxResultsDescribes the running instances for the specified Spot Fleet.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
SpotFleetRequestIdstringThe ID of the Spot Fleet request.
regionstringAWS region (default: us-east-1)
DryRunbooleanChecks 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.
MaxResultsintegerThe maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.
NextTokenstringThe token to include in another request to get the next page of items. This value is null when there are no more items to return.

SELECT examples

Describes the running instances for the specified Spot Fleet.

SELECT
instance_health,
instance_id,
instance_type,
spot_instance_request_id
FROM aws.ec2.spot_fleet_instances
WHERE SpotFleetRequestId = '{{ SpotFleetRequestId }}' -- required
AND region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND NextToken = '{{ NextToken }}'
AND MaxResults = '{{ MaxResults }}'
;