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

:: 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

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

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

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

Data DescribeScheduledInstanceAvailability

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

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

readsPrec :: Int -> ReadS DescribeScheduledInstanceAvailability

readList :: ReadS [DescribeScheduledInstanceAvailability]

readPrec :: ReadPrec DescribeScheduledInstanceAvailability

readListPrec :: ReadPrec [DescribeScheduledInstanceAvailability]

Show DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

showsPrec :: Int -> DescribeScheduledInstanceAvailability -> ShowS

show :: DescribeScheduledInstanceAvailability -> String

showList :: [DescribeScheduledInstanceAvailability] -> ShowS

Generic DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Associated Types

type Rep DescribeScheduledInstanceAvailability :: Type -> Type

Methods

from :: DescribeScheduledInstanceAvailability -> Rep DescribeScheduledInstanceAvailability x

to :: Rep DescribeScheduledInstanceAvailability x -> DescribeScheduledInstanceAvailability

Hashable DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

hashWithSalt :: Int -> DescribeScheduledInstanceAvailability -> Int

hash :: DescribeScheduledInstanceAvailability -> Int

AWSRequest DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Associated Types

type Rs DescribeScheduledInstanceAvailability :: Type

Methods

request :: DescribeScheduledInstanceAvailability -> Request DescribeScheduledInstanceAvailability

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

ToHeaders DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

toHeaders :: DescribeScheduledInstanceAvailability -> [Header]

ToPath DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

toPath :: DescribeScheduledInstanceAvailability -> ByteString

ToQuery DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

toQuery :: DescribeScheduledInstanceAvailability -> QueryString

NFData DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

rnf :: DescribeScheduledInstanceAvailability -> ()

type Rep DescribeScheduledInstanceAvailability

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

type Rep DescribeScheduledInstanceAvailability = D1 (MetaData "DescribeScheduledInstanceAvailability" "Network.AWS.EC2.DescribeScheduledInstanceAvailability" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" 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

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

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

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

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

Data DescribeScheduledInstanceAvailabilityResponse

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

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

readsPrec :: Int -> ReadS DescribeScheduledInstanceAvailabilityResponse

readList :: ReadS [DescribeScheduledInstanceAvailabilityResponse]

readPrec :: ReadPrec DescribeScheduledInstanceAvailabilityResponse

readListPrec :: ReadPrec [DescribeScheduledInstanceAvailabilityResponse]

Show DescribeScheduledInstanceAvailabilityResponse

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

showsPrec :: Int -> DescribeScheduledInstanceAvailabilityResponse -> ShowS

show :: DescribeScheduledInstanceAvailabilityResponse -> String

showList :: [DescribeScheduledInstanceAvailabilityResponse] -> ShowS

Generic DescribeScheduledInstanceAvailabilityResponse

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Associated Types

type Rep DescribeScheduledInstanceAvailabilityResponse :: Type -> Type

Methods

from :: DescribeScheduledInstanceAvailabilityResponse -> Rep DescribeScheduledInstanceAvailabilityResponse x

to :: Rep DescribeScheduledInstanceAvailabilityResponse x -> DescribeScheduledInstanceAvailabilityResponse

NFData DescribeScheduledInstanceAvailabilityResponse

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

Methods

rnf :: DescribeScheduledInstanceAvailabilityResponse -> ()

type Rep DescribeScheduledInstanceAvailabilityResponse

Defined in Network.AWS.EC2.DescribeScheduledInstanceAvailability

type Rep DescribeScheduledInstanceAvailabilityResponse = D1 (MetaData "DescribeScheduledInstanceAvailabilityResponse" "Network.AWS.EC2.DescribeScheduledInstanceAvailability" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" 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.