Network.AWS.EC2.CreateFleet

Launches an EC2 Fleet.

You can create a single EC2 Fleet that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

For more information, see Launching an EC2 Fleet in the Amazon Elastic Compute Cloud User Guide .

Creating a Request

createFleet

Arguments

:: TargetCapacitySpecificationRequest

cfTargetCapacitySpecification

-> CreateFleet

Creates a value of CreateFleet with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cfClientToken - Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency .
• cfSpotOptions - Includes SpotAllocationStrategy and SpotInstanceInterruptionBehavior inside this structure.
• cfExcessCapacityTerminationPolicy - Indicates whether running instances should be terminated if the total target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.
• cfTagSpecifications - The tags for an EC2 Fleet resource.
• cfValidUntil - The end date and time of the request, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z). At this point, no new EC2 Fleet requests are placed or able to fulfill the request. The default end date is 7 days from the current date.
• cfTerminateInstancesWithExpiration - Indicates whether running instances should be terminated when the EC2 Fleet expires.
• cfType - The type of request. Indicates whether the EC2 Fleet only requests the target capacity, or also attempts to maintain it. If you request a certain target capacity, EC2 Fleet only places the required requests. It does not attempt to replenish instances if capacity is diminished, and does not submit requests in alternative capacity pools if capacity is unavailable. To maintain a certain target capacity, EC2 Fleet places the required requests to meet this target capacity. It also automatically replenishes any interrupted Spot Instances. Default: maintain .
• cfValidFrom - The start date and time of the request, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z). The default is to start fulfilling the request immediately.
• cfReplaceUnhealthyInstances - Indicates whether EC2 Fleet should replace unhealthy instances.
• cfDryRun - 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 .
• cfLaunchTemplateConfigs - The configuration for the EC2 Fleet.
• cfTargetCapacitySpecification - The TotalTargetCapacity , OnDemandTargetCapacity , SpotTargetCapacity , and DefaultCapacityType structure.

data CreateFleet

See: createFleet smart constructor.

Instances

Eq CreateFleet

Methods

(==) :: CreateFleet -> CreateFleet -> Bool

(/=) :: CreateFleet -> CreateFleet -> Bool

Data CreateFleet

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateFleet -> c CreateFleet

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateFleet

toConstr :: CreateFleet -> Constr

dataTypeOf :: CreateFleet -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateFleet)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateFleet)

gmapT :: (forall b. Data b => b -> b) -> CreateFleet -> CreateFleet

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateFleet -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateFleet -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateFleet -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateFleet -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateFleet -> m CreateFleet

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateFleet -> m CreateFleet

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateFleet -> m CreateFleet

Read CreateFleet

Methods

readsPrec :: Int -> ReadS CreateFleet

readList :: ReadS [CreateFleet]

readPrec :: ReadPrec CreateFleet

readListPrec :: ReadPrec [CreateFleet]

Show CreateFleet

Methods

showsPrec :: Int -> CreateFleet -> ShowS

show :: CreateFleet -> String

showList :: [CreateFleet] -> ShowS

Generic CreateFleet

Associated Types

type Rep CreateFleet :: * -> *

Methods

from :: CreateFleet -> Rep CreateFleet x

to :: Rep CreateFleet x -> CreateFleet

Hashable CreateFleet

Methods

hashWithSalt :: Int -> CreateFleet -> Int

hash :: CreateFleet -> Int

NFData CreateFleet

Methods

rnf :: CreateFleet -> ()

AWSRequest CreateFleet

Associated Types

type Rs CreateFleet :: *

Methods

request :: CreateFleet -> Request CreateFleet

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * CreateFleet -> ClientResponse -> m (Response CreateFleet)

ToHeaders CreateFleet

Methods

toHeaders :: CreateFleet -> [Header]

ToPath CreateFleet

Methods

toPath :: CreateFleet -> ByteString

ToQuery CreateFleet

Methods

toQuery :: CreateFleet -> QueryString

type Rep CreateFleet

type Rep CreateFleet = D1 * (MetaData "CreateFleet" "Network.AWS.EC2.CreateFleet" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "CreateFleet'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_cfClientToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfSpotOptions") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe SpotOptionsRequest))) (S1 * (MetaSel (Just Symbol "_cfExcessCapacityTerminationPolicy") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe FleetExcessCapacityTerminationPolicy))))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfTagSpecifications") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [TagSpecification]))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfValidUntil") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe ISO8601))) (S1 * (MetaSel (Just Symbol "_cfTerminateInstancesWithExpiration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool)))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_cfType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe FleetType))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfValidFrom") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe ISO8601))) (S1 * (MetaSel (Just Symbol "_cfReplaceUnhealthyInstances") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfLaunchTemplateConfigs") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * [FleetLaunchTemplateConfigRequest])) (S1 * (MetaSel (Just Symbol "_cfTargetCapacitySpecification") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * TargetCapacitySpecificationRequest)))))))

type Rs CreateFleet

type Rs CreateFleet = CreateFleetResponse

Request Lenses

cfClientToken :: Lens' CreateFleet (Maybe Text)

Unique, case-sensitive identifier you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency .

cfSpotOptions :: Lens' CreateFleet (Maybe SpotOptionsRequest)

Includes SpotAllocationStrategy and SpotInstanceInterruptionBehavior inside this structure.

cfExcessCapacityTerminationPolicy :: Lens' CreateFleet (Maybe FleetExcessCapacityTerminationPolicy)

Indicates whether running instances should be terminated if the total target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.

cfTagSpecifications :: Lens' CreateFleet [TagSpecification]

The tags for an EC2 Fleet resource.

cfValidUntil :: Lens' CreateFleet (Maybe UTCTime)

The end date and time of the request, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z). At this point, no new EC2 Fleet requests are placed or able to fulfill the request. The default end date is 7 days from the current date.

cfTerminateInstancesWithExpiration :: Lens' CreateFleet (Maybe Bool)

Indicates whether running instances should be terminated when the EC2 Fleet expires.

cfType :: Lens' CreateFleet (Maybe FleetType)

The type of request. Indicates whether the EC2 Fleet only requests the target capacity, or also attempts to maintain it. If you request a certain target capacity, EC2 Fleet only places the required requests. It does not attempt to replenish instances if capacity is diminished, and does not submit requests in alternative capacity pools if capacity is unavailable. To maintain a certain target capacity, EC2 Fleet places the required requests to meet this target capacity. It also automatically replenishes any interrupted Spot Instances. Default: maintain .

cfValidFrom :: Lens' CreateFleet (Maybe UTCTime)

The start date and time of the request, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z). The default is to start fulfilling the request immediately.

cfReplaceUnhealthyInstances :: Lens' CreateFleet (Maybe Bool)

Indicates whether EC2 Fleet should replace unhealthy instances.

cfDryRun :: Lens' CreateFleet (Maybe Bool)

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 .

cfLaunchTemplateConfigs :: Lens' CreateFleet [FleetLaunchTemplateConfigRequest]

The configuration for the EC2 Fleet.

cfTargetCapacitySpecification :: Lens' CreateFleet TargetCapacitySpecificationRequest

The TotalTargetCapacity , OnDemandTargetCapacity , SpotTargetCapacity , and DefaultCapacityType structure.

Destructuring the Response

createFleetResponse

Arguments

:: Int

cfrsResponseStatus

-> CreateFleetResponse

Creates a value of CreateFleetResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cfrsFleetId - The ID of the EC2 Fleet.
• cfrsResponseStatus - -- | The response status code.

data CreateFleetResponse

See: createFleetResponse smart constructor.

Instances

Eq CreateFleetResponse

Methods

(==) :: CreateFleetResponse -> CreateFleetResponse -> Bool

(/=) :: CreateFleetResponse -> CreateFleetResponse -> Bool

Data CreateFleetResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateFleetResponse -> c CreateFleetResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateFleetResponse

toConstr :: CreateFleetResponse -> Constr

dataTypeOf :: CreateFleetResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateFleetResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateFleetResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateFleetResponse -> CreateFleetResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateFleetResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateFleetResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateFleetResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateFleetResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateFleetResponse -> m CreateFleetResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateFleetResponse -> m CreateFleetResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateFleetResponse -> m CreateFleetResponse

Read CreateFleetResponse

Methods

readsPrec :: Int -> ReadS CreateFleetResponse

readList :: ReadS [CreateFleetResponse]

readPrec :: ReadPrec CreateFleetResponse

readListPrec :: ReadPrec [CreateFleetResponse]

Show CreateFleetResponse

Methods

showsPrec :: Int -> CreateFleetResponse -> ShowS

show :: CreateFleetResponse -> String

showList :: [CreateFleetResponse] -> ShowS

Generic CreateFleetResponse

Associated Types

type Rep CreateFleetResponse :: * -> *

Methods

from :: CreateFleetResponse -> Rep CreateFleetResponse x

to :: Rep CreateFleetResponse x -> CreateFleetResponse

NFData CreateFleetResponse

Methods

rnf :: CreateFleetResponse -> ()

type Rep CreateFleetResponse

type Rep CreateFleetResponse = D1 * (MetaData "CreateFleetResponse" "Network.AWS.EC2.CreateFleet" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "CreateFleetResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_cfrsFleetId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_cfrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int))))

Response Lenses

cfrsFleetId :: Lens' CreateFleetResponse (Maybe Text)

The ID of the EC2 Fleet.

cfrsResponseStatus :: Lens' CreateFleetResponse Int

• - | The response status code.