Network.AWS.EC2.DescribeSpotPriceHistory

Describes the Spot price history. For more information, see Spot Instance Pricing History in the Amazon EC2 User Guide for Linux Instances .

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

This operation returns paginated results.

Creating a Request

describeSpotPriceHistory :: DescribeSpotPriceHistory

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

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

• dsphInstanceTypes - Filters the results by the specified instance types.
• dsphStartTime - The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z).
• dsphFilters - One or more filters. * availability-zone - The Availability Zone for which prices should be returned. * instance-type - The type of instance (for example, m3.medium ). * product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC) ). * spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported). * timestamp - The time stamp of the Spot price history, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.
• dsphNextToken - The token for the next set of results.
• dsphAvailabilityZone - Filters the results by the specified Availability Zone.
• dsphEndTime - The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z).
• dsphProductDescriptions - Filters the results by the specified basic product descriptions.
• dsphDryRun - 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 .
• dsphMaxResults - The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

data DescribeSpotPriceHistory

Contains the parameters for DescribeSpotPriceHistory.

See: describeSpotPriceHistory smart constructor.

Instances

Eq DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

(==) :: DescribeSpotPriceHistory -> DescribeSpotPriceHistory -> Bool

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

Data DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

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

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

toConstr :: DescribeSpotPriceHistory -> Constr

dataTypeOf :: DescribeSpotPriceHistory -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

readsPrec :: Int -> ReadS DescribeSpotPriceHistory

readList :: ReadS [DescribeSpotPriceHistory]

readPrec :: ReadPrec DescribeSpotPriceHistory

readListPrec :: ReadPrec [DescribeSpotPriceHistory]

Show DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

showsPrec :: Int -> DescribeSpotPriceHistory -> ShowS

show :: DescribeSpotPriceHistory -> String

showList :: [DescribeSpotPriceHistory] -> ShowS

Generic DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Associated Types

type Rep DescribeSpotPriceHistory :: Type -> Type

Methods

from :: DescribeSpotPriceHistory -> Rep DescribeSpotPriceHistory x

to :: Rep DescribeSpotPriceHistory x -> DescribeSpotPriceHistory

Hashable DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

hashWithSalt :: Int -> DescribeSpotPriceHistory -> Int

hash :: DescribeSpotPriceHistory -> Int

AWSPager DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

page :: DescribeSpotPriceHistory -> Rs DescribeSpotPriceHistory -> Maybe DescribeSpotPriceHistory

AWSRequest DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Associated Types

type Rs DescribeSpotPriceHistory :: Type

Methods

request :: DescribeSpotPriceHistory -> Request DescribeSpotPriceHistory

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

ToHeaders DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

toHeaders :: DescribeSpotPriceHistory -> [Header]

ToPath DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

toPath :: DescribeSpotPriceHistory -> ByteString

ToQuery DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

toQuery :: DescribeSpotPriceHistory -> QueryString

NFData DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

rnf :: DescribeSpotPriceHistory -> ()

type Rep DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

type Rep DescribeSpotPriceHistory = D1 (MetaData "DescribeSpotPriceHistory" "Network.AWS.EC2.DescribeSpotPriceHistory" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeSpotPriceHistory'" PrefixI True) (((S1 (MetaSel (Just "_dsphInstanceTypes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [InstanceType])) :*: S1 (MetaSel (Just "_dsphStartTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ISO8601))) :*: (S1 (MetaSel (Just "_dsphFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter])) :*: S1 (MetaSel (Just "_dsphNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 (MetaSel (Just "_dsphAvailabilityZone") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_dsphEndTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ISO8601))) :*: (S1 (MetaSel (Just "_dsphProductDescriptions") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])) :*: (S1 (MetaSel (Just "_dsphDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 (MetaSel (Just "_dsphMaxResults") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))))))

type Rs DescribeSpotPriceHistory

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

type Rs DescribeSpotPriceHistory = DescribeSpotPriceHistoryResponse

Request Lenses

dsphInstanceTypes :: Lens' DescribeSpotPriceHistory [InstanceType]

Filters the results by the specified instance types.

dsphStartTime :: Lens' DescribeSpotPriceHistory (Maybe UTCTime)

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z).

dsphFilters :: Lens' DescribeSpotPriceHistory [Filter]

One or more filters. * availability-zone - The Availability Zone for which prices should be returned. * instance-type - The type of instance (for example, m3.medium ). * product-description - The product description for the Spot price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC) ). * spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported). * timestamp - The time stamp of the Spot price history, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

dsphNextToken :: Lens' DescribeSpotPriceHistory (Maybe Text)

The token for the next set of results.

dsphAvailabilityZone :: Lens' DescribeSpotPriceHistory (Maybe Text)

Filters the results by the specified Availability Zone.

dsphEndTime :: Lens' DescribeSpotPriceHistory (Maybe UTCTime)

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY -MM -DD THH :MM :SS Z).

dsphProductDescriptions :: Lens' DescribeSpotPriceHistory [Text]

Filters the results by the specified basic product descriptions.

dsphDryRun :: Lens' DescribeSpotPriceHistory (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 .

dsphMaxResults :: Lens' DescribeSpotPriceHistory (Maybe Int)

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

Destructuring the Response

describeSpotPriceHistoryResponse

Arguments

:: Int

dsphrsResponseStatus

-> DescribeSpotPriceHistoryResponse

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

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

• dsphrsNextToken - The token required to retrieve the next set of results. This value is null or an empty string when there are no more results to return.
• dsphrsSpotPriceHistory - The historical Spot prices.
• dsphrsResponseStatus - -- | The response status code.

data DescribeSpotPriceHistoryResponse

Contains the output of DescribeSpotPriceHistory.

See: describeSpotPriceHistoryResponse smart constructor.

Instances

Eq DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

(==) :: DescribeSpotPriceHistoryResponse -> DescribeSpotPriceHistoryResponse -> Bool

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

Data DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

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

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

toConstr :: DescribeSpotPriceHistoryResponse -> Constr

dataTypeOf :: DescribeSpotPriceHistoryResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

readsPrec :: Int -> ReadS DescribeSpotPriceHistoryResponse

readList :: ReadS [DescribeSpotPriceHistoryResponse]

readPrec :: ReadPrec DescribeSpotPriceHistoryResponse

readListPrec :: ReadPrec [DescribeSpotPriceHistoryResponse]

Show DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

showsPrec :: Int -> DescribeSpotPriceHistoryResponse -> ShowS

show :: DescribeSpotPriceHistoryResponse -> String

showList :: [DescribeSpotPriceHistoryResponse] -> ShowS

Generic DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Associated Types

type Rep DescribeSpotPriceHistoryResponse :: Type -> Type

Methods

from :: DescribeSpotPriceHistoryResponse -> Rep DescribeSpotPriceHistoryResponse x

to :: Rep DescribeSpotPriceHistoryResponse x -> DescribeSpotPriceHistoryResponse

NFData DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

Methods

rnf :: DescribeSpotPriceHistoryResponse -> ()

type Rep DescribeSpotPriceHistoryResponse

Defined in Network.AWS.EC2.DescribeSpotPriceHistory

type Rep DescribeSpotPriceHistoryResponse = D1 (MetaData "DescribeSpotPriceHistoryResponse" "Network.AWS.EC2.DescribeSpotPriceHistory" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeSpotPriceHistoryResponse'" PrefixI True) (S1 (MetaSel (Just "_dsphrsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_dsphrsSpotPriceHistory") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [SpotPrice])) :*: S1 (MetaSel (Just "_dsphrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

dsphrsNextToken :: Lens' DescribeSpotPriceHistoryResponse (Maybe Text)

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

dsphrsSpotPriceHistory :: Lens' DescribeSpotPriceHistoryResponse [SpotPrice]

The historical Spot prices.

dsphrsResponseStatus :: Lens' DescribeSpotPriceHistoryResponse Int

• - | The response status code.