Network.AWS.EC2.DescribeScheduledInstanceAvailability

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.

Creating a Request

describeScheduledInstanceAvailability

Arguments

:: ScheduledInstanceRecurrenceRequest

dsiaRecurrence

-> SlotDateTimeRangeRequest

dsiaFirstSlotStartTimeRange

-> 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
• dsiaFilters
• dsiaNextToken
• dsiaMaxSlotDurationInHours
• dsiaDryRun
• dsiaMaxResults
• dsiaRecurrence
• dsiaFirstSlotStartTimeRange

data DescribeScheduledInstanceAvailability

Contains the parameters for DescribeScheduledInstanceAvailability.

See: describeScheduledInstanceAvailability smart constructor.

Instances

Eq DescribeScheduledInstanceAvailability

Methods

(==) :: DescribeScheduledInstanceAvailability -> DescribeScheduledInstanceAvailability -> Bool

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

Data 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

Methods

readsPrec :: Int -> ReadS DescribeScheduledInstanceAvailability

readList :: ReadS [DescribeScheduledInstanceAvailability]

readPrec :: ReadPrec DescribeScheduledInstanceAvailability

readListPrec :: ReadPrec [DescribeScheduledInstanceAvailability]

Show DescribeScheduledInstanceAvailability

Methods

showsPrec :: Int -> DescribeScheduledInstanceAvailability -> ShowS

show :: DescribeScheduledInstanceAvailability -> String

showList :: [DescribeScheduledInstanceAvailability] -> ShowS

Generic DescribeScheduledInstanceAvailability

Associated Types

type Rep DescribeScheduledInstanceAvailability :: * -> *

Methods

from :: DescribeScheduledInstanceAvailability -> Rep DescribeScheduledInstanceAvailability x

to :: Rep DescribeScheduledInstanceAvailability x -> DescribeScheduledInstanceAvailability

Hashable DescribeScheduledInstanceAvailability

Methods

hashWithSalt :: Int -> DescribeScheduledInstanceAvailability -> Int

hash :: DescribeScheduledInstanceAvailability -> Int

NFData DescribeScheduledInstanceAvailability

Methods

rnf :: DescribeScheduledInstanceAvailability -> ()

AWSRequest DescribeScheduledInstanceAvailability

Associated Types

type Rs DescribeScheduledInstanceAvailability :: *

Methods

request :: DescribeScheduledInstanceAvailability -> Request DescribeScheduledInstanceAvailability

response :: MonadResource m => Logger -> Service -> Proxy * DescribeScheduledInstanceAvailability -> ClientResponse -> m (Response DescribeScheduledInstanceAvailability)

ToPath DescribeScheduledInstanceAvailability

Methods

toPath :: DescribeScheduledInstanceAvailability -> ByteString

ToHeaders DescribeScheduledInstanceAvailability

Methods

toHeaders :: DescribeScheduledInstanceAvailability -> [Header]

ToQuery DescribeScheduledInstanceAvailability

Methods

toQuery :: DescribeScheduledInstanceAvailability -> QueryString

type Rep DescribeScheduledInstanceAvailability

type Rep DescribeScheduledInstanceAvailability = D1 (MetaData "DescribeScheduledInstanceAvailability" "Network.AWS.EC2.DescribeScheduledInstanceAvailability" "amazonka-ec2-1.4.2-6EJAAVBh1q13dHrwE82a1F" False) (C1 (MetaCons "DescribeScheduledInstanceAvailability'" PrefixI True) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_dsiaMinSlotDurationInHours") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int))) (S1 (MetaSel (Just Symbol "_dsiaFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter])))) ((:*:) (S1 (MetaSel (Just Symbol "_dsiaNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dsiaMaxSlotDurationInHours") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_dsiaDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) (S1 (MetaSel (Just Symbol "_dsiaMaxResults") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))) ((:*:) (S1 (MetaSel (Just Symbol "_dsiaRecurrence") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ScheduledInstanceRecurrenceRequest)) (S1 (MetaSel (Just Symbol "_dsiaFirstSlotStartTimeRange") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 SlotDateTimeRangeRequest))))))

type Rs 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.

dsiaRecurrence :: Lens' DescribeScheduledInstanceAvailability ScheduledInstanceRecurrenceRequest

The schedule recurrence.

dsiaFirstSlotStartTimeRange :: Lens' DescribeScheduledInstanceAvailability SlotDateTimeRangeRequest

The time period for the first schedule to start.

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
• dsiarsNextToken
• dsiarsResponseStatus

data DescribeScheduledInstanceAvailabilityResponse

Contains the output of DescribeScheduledInstanceAvailability.

See: describeScheduledInstanceAvailabilityResponse smart constructor.

Instances

Eq DescribeScheduledInstanceAvailabilityResponse

Methods

(==) :: DescribeScheduledInstanceAvailabilityResponse -> DescribeScheduledInstanceAvailabilityResponse -> Bool

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

Data DescribeScheduledInstanceAvailabilityResponse

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

Methods

readsPrec :: Int -> ReadS DescribeScheduledInstanceAvailabilityResponse

readList :: ReadS [DescribeScheduledInstanceAvailabilityResponse]

readPrec :: ReadPrec DescribeScheduledInstanceAvailabilityResponse

readListPrec :: ReadPrec [DescribeScheduledInstanceAvailabilityResponse]

Show DescribeScheduledInstanceAvailabilityResponse

Methods

showsPrec :: Int -> DescribeScheduledInstanceAvailabilityResponse -> ShowS

show :: DescribeScheduledInstanceAvailabilityResponse -> String

showList :: [DescribeScheduledInstanceAvailabilityResponse] -> ShowS

Generic DescribeScheduledInstanceAvailabilityResponse

Associated Types

type Rep DescribeScheduledInstanceAvailabilityResponse :: * -> *

Methods

from :: DescribeScheduledInstanceAvailabilityResponse -> Rep DescribeScheduledInstanceAvailabilityResponse x

to :: Rep DescribeScheduledInstanceAvailabilityResponse x -> DescribeScheduledInstanceAvailabilityResponse

NFData DescribeScheduledInstanceAvailabilityResponse

Methods

rnf :: DescribeScheduledInstanceAvailabilityResponse -> ()

type Rep DescribeScheduledInstanceAvailabilityResponse

type Rep DescribeScheduledInstanceAvailabilityResponse = D1 (MetaData "DescribeScheduledInstanceAvailabilityResponse" "Network.AWS.EC2.DescribeScheduledInstanceAvailability" "amazonka-ec2-1.4.2-6EJAAVBh1q13dHrwE82a1F" False) (C1 (MetaCons "DescribeScheduledInstanceAvailabilityResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dsiarsScheduledInstanceAvailabilitySet") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [ScheduledInstanceAvailability]))) ((:*:) (S1 (MetaSel (Just Symbol "_dsiarsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_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.