Copyright	(c) 2013-2018 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

Network.AWS.EC2.DescribeScheduledInstanceAvailability

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Finds available schedules that meet the specified criteria.

You can search for an available schedule no more than 3 months in advance. You must meet the minimum required duration of 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

After you find a schedule that meets your needs, call PurchaseScheduledInstances to purchase Scheduled Instances with that schedule.

Synopsis

Creating a Request

describeScheduledInstanceAvailability #

Arguments

:: SlotDateTimeRangeRequest	`dsiaFirstSlotStartTimeRange`
-> ScheduledInstanceRecurrenceRequest	`dsiaRecurrence`
-> DescribeScheduledInstanceAvailability

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

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

dsiaMinSlotDurationInHours - The minimum available duration, in hours. The minimum required duration is 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.
dsiaFilters - One or more filters. * availability-zone - The Availability Zone (for example, us-west-2a ). * instance-type - The instance type (for example, c4.large ). * network-platform - The network platform (EC2-Classic or EC2-VPC ). * platform - The platform (Linux/UNIX or Windows ).
dsiaNextToken - The token for the next set of results.
dsiaMaxSlotDurationInHours - The maximum available duration, in hours. This value must be greater than MinSlotDurationInHours and less than 1,720.
dsiaDryRun - 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 .
dsiaMaxResults - The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 300. To retrieve the remaining results, make another call with the returned NextToken value.
dsiaFirstSlotStartTimeRange - The time period for the first schedule to start.
dsiaRecurrence - The schedule recurrence.

data DescribeScheduledInstanceAvailability #

Contains the parameters for DescribeScheduledInstanceAvailability.

See: describeScheduledInstanceAvailability smart constructor.

Instances

Eq DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods (==) :: DescribeScheduledInstanceAvailability -> DescribeScheduledInstanceAvailability -> Bool # (/=) :: DescribeScheduledInstanceAvailability -> DescribeScheduledInstanceAvailability -> Bool #
Data DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeScheduledInstanceAvailability -> c DescribeScheduledInstanceAvailability # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeScheduledInstanceAvailability # toConstr :: DescribeScheduledInstanceAvailability -> Constr # dataTypeOf :: DescribeScheduledInstanceAvailability -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c DescribeScheduledInstanceAvailability) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeScheduledInstanceAvailability) # gmapT :: (forall b. Data b => b -> b) -> DescribeScheduledInstanceAvailability -> DescribeScheduledInstanceAvailability # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeScheduledInstanceAvailability -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeScheduledInstanceAvailability -> r # gmapQ :: (forall d. Data d => d -> u) -> DescribeScheduledInstanceAvailability -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeScheduledInstanceAvailability -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeScheduledInstanceAvailability -> m DescribeScheduledInstanceAvailability # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeScheduledInstanceAvailability -> m DescribeScheduledInstanceAvailability # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeScheduledInstanceAvailability -> m DescribeScheduledInstanceAvailability #
Read DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods readsPrec :: Int -> ReadS DescribeScheduledInstanceAvailability # readList :: ReadS [DescribeScheduledInstanceAvailability] # readPrec :: ReadPrec DescribeScheduledInstanceAvailability # readListPrec :: ReadPrec [DescribeScheduledInstanceAvailability] #
Show DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods showsPrec :: Int -> DescribeScheduledInstanceAvailability -> ShowS # show :: DescribeScheduledInstanceAvailability -> String # showList :: [DescribeScheduledInstanceAvailability] -> ShowS #
Generic DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Associated Types type Rep DescribeScheduledInstanceAvailability :: * -> * # Methods from :: DescribeScheduledInstanceAvailability -> Rep DescribeScheduledInstanceAvailability x # to :: Rep DescribeScheduledInstanceAvailability x -> DescribeScheduledInstanceAvailability #
Hashable DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods hashWithSalt :: Int -> DescribeScheduledInstanceAvailability -> Int # hash :: DescribeScheduledInstanceAvailability -> Int #
AWSRequest DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Associated Types type Rs DescribeScheduledInstanceAvailability :: * # Methods request :: DescribeScheduledInstanceAvailability -> Request DescribeScheduledInstanceAvailability # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy DescribeScheduledInstanceAvailability -> ClientResponse -> m (Response DescribeScheduledInstanceAvailability) #
ToHeaders DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods toHeaders :: DescribeScheduledInstanceAvailability -> [Header] #
ToPath DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods toPath :: DescribeScheduledInstanceAvailability -> ByteString #
ToQuery DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods toQuery :: DescribeScheduledInstanceAvailability -> QueryString #
NFData DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods rnf :: DescribeScheduledInstanceAvailability -> () #
type Rep DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability type Rep DescribeScheduledInstanceAvailability = D1 (MetaData "DescribeScheduledInstanceAvailability" "Network.AWS.EC2.DescribeScheduledInstanceAvailability" "amazonka-ec2-1.6.0-G6ppxISnQxeI7PhDx9p8Zy" False) (C1 (MetaCons "DescribeScheduledInstanceAvailability'" PrefixI True) (((S1 (MetaSel (Just "_dsiaMinSlotDurationInHours") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)) :: S1 (MetaSel (Just "_dsiaFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter]))) :: (S1 (MetaSel (Just "_dsiaNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_dsiaMaxSlotDurationInHours") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))) :: ((S1 (MetaSel (Just "_dsiaDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :: S1 (MetaSel (Just "_dsiaMaxResults") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int))) :: (S1 (MetaSel (Just "_dsiaFirstSlotStartTimeRange") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 SlotDateTimeRangeRequest) :*: S1 (MetaSel (Just "_dsiaRecurrence") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ScheduledInstanceRecurrenceRequest)))))
type Rs DescribeScheduledInstanceAvailability #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability type Rs DescribeScheduledInstanceAvailability = DescribeScheduledInstanceAvailabilityResponse

Request Lenses

dsiaMinSlotDurationInHours :: Lens' DescribeScheduledInstanceAvailability (Maybe Int) #

The minimum available duration, in hours. The minimum required duration is 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

dsiaFilters :: Lens' DescribeScheduledInstanceAvailability [Filter] #

One or more filters. * availability-zone - The Availability Zone (for example, us-west-2a ). * instance-type - The instance type (for example, c4.large ). * network-platform - The network platform (EC2-Classic or EC2-VPC ). * platform - The platform (Linux/UNIX or Windows ).

dsiaNextToken :: Lens' DescribeScheduledInstanceAvailability (Maybe Text) #

The token for the next set of results.

dsiaMaxSlotDurationInHours :: Lens' DescribeScheduledInstanceAvailability (Maybe Int) #

The maximum available duration, in hours. This value must be greater than MinSlotDurationInHours and less than 1,720.

dsiaDryRun :: Lens' DescribeScheduledInstanceAvailability (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 .

dsiaMaxResults :: Lens' DescribeScheduledInstanceAvailability (Maybe Int) #

The maximum number of results to return in a single call. This value can be between 5 and 300. The default value is 300. To retrieve the remaining results, make another call with the returned NextToken value.

dsiaFirstSlotStartTimeRange :: Lens' DescribeScheduledInstanceAvailability SlotDateTimeRangeRequest #

The time period for the first schedule to start.

dsiaRecurrence :: Lens' DescribeScheduledInstanceAvailability ScheduledInstanceRecurrenceRequest #

The schedule recurrence.

Destructuring the Response

describeScheduledInstanceAvailabilityResponse #

Arguments

:: Int	`dsiarsResponseStatus`
-> DescribeScheduledInstanceAvailabilityResponse

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

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

dsiarsScheduledInstanceAvailabilitySet - Information about the available Scheduled Instances.
dsiarsNextToken - The token required to retrieve the next set of results. This value is null when there are no more results to return.
dsiarsResponseStatus - -- | The response status code.

data DescribeScheduledInstanceAvailabilityResponse #

Contains the output of DescribeScheduledInstanceAvailability.

See: describeScheduledInstanceAvailabilityResponse smart constructor.

Instances

Eq DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods (==) :: DescribeScheduledInstanceAvailabilityResponse -> DescribeScheduledInstanceAvailabilityResponse -> Bool # (/=) :: DescribeScheduledInstanceAvailabilityResponse -> DescribeScheduledInstanceAvailabilityResponse -> Bool #
Data DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeScheduledInstanceAvailabilityResponse -> c DescribeScheduledInstanceAvailabilityResponse # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeScheduledInstanceAvailabilityResponse # toConstr :: DescribeScheduledInstanceAvailabilityResponse -> Constr # dataTypeOf :: DescribeScheduledInstanceAvailabilityResponse -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c DescribeScheduledInstanceAvailabilityResponse) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeScheduledInstanceAvailabilityResponse) # gmapT :: (forall b. Data b => b -> b) -> DescribeScheduledInstanceAvailabilityResponse -> DescribeScheduledInstanceAvailabilityResponse # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeScheduledInstanceAvailabilityResponse -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeScheduledInstanceAvailabilityResponse -> r # gmapQ :: (forall d. Data d => d -> u) -> DescribeScheduledInstanceAvailabilityResponse -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeScheduledInstanceAvailabilityResponse -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeScheduledInstanceAvailabilityResponse -> m DescribeScheduledInstanceAvailabilityResponse # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeScheduledInstanceAvailabilityResponse -> m DescribeScheduledInstanceAvailabilityResponse # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeScheduledInstanceAvailabilityResponse -> m DescribeScheduledInstanceAvailabilityResponse #
Read DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods readsPrec :: Int -> ReadS DescribeScheduledInstanceAvailabilityResponse # readList :: ReadS [DescribeScheduledInstanceAvailabilityResponse] # readPrec :: ReadPrec DescribeScheduledInstanceAvailabilityResponse # readListPrec :: ReadPrec [DescribeScheduledInstanceAvailabilityResponse] #
Show DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods showsPrec :: Int -> DescribeScheduledInstanceAvailabilityResponse -> ShowS # show :: DescribeScheduledInstanceAvailabilityResponse -> String # showList :: [DescribeScheduledInstanceAvailabilityResponse] -> ShowS #
Generic DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Associated Types type Rep DescribeScheduledInstanceAvailabilityResponse :: * -> * # Methods from :: DescribeScheduledInstanceAvailabilityResponse -> Rep DescribeScheduledInstanceAvailabilityResponse x # to :: Rep DescribeScheduledInstanceAvailabilityResponse x -> DescribeScheduledInstanceAvailabilityResponse #
NFData DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability Methods rnf :: DescribeScheduledInstanceAvailabilityResponse -> () #
type Rep DescribeScheduledInstanceAvailabilityResponse #
Instance details Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability type Rep DescribeScheduledInstanceAvailabilityResponse = D1 (MetaData "DescribeScheduledInstanceAvailabilityResponse" "Network.AWS.EC2.DescribeScheduledInstanceAvailability" "amazonka-ec2-1.6.0-G6ppxISnQxeI7PhDx9p8Zy" False) (C1 (MetaCons "DescribeScheduledInstanceAvailabilityResponse'" PrefixI True) (S1 (MetaSel (Just "_dsiarsScheduledInstanceAvailabilitySet") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [ScheduledInstanceAvailability])) :: (S1 (MetaSel (Just "_dsiarsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_dsiarsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

dsiarsScheduledInstanceAvailabilitySet :: Lens' DescribeScheduledInstanceAvailabilityResponse [ScheduledInstanceAvailability] #

Information about the available Scheduled Instances.

dsiarsNextToken :: Lens' DescribeScheduledInstanceAvailabilityResponse (Maybe Text) #

The token required to retrieve the next set of results. This value is null when there are no more results to return.

dsiarsResponseStatus :: Lens' DescribeScheduledInstanceAvailabilityResponse Int #

- | The response status code.