Network.AWS.EC2.DescribeReservedInstances

Describes one or more of the Reserved Instances that you purchased.

For more information about Reserved Instances, see Reserved Instances in the Amazon Elastic Compute Cloud User Guide .

Creating a Request

describeReservedInstances :: DescribeReservedInstances

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

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

• driFilters - One or more filters. * availability-zone - The Availability Zone where the Reserved Instance can be used. * duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000 ). * end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z). * fixed-price - The purchase price of the Reserved Instance (for example, 9800.0). * instance-type - The instance type that is covered by the reservation. * scope - The scope of the Reserved Instance (Region or Availability Zone ). * product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC) ). * reserved-instances-id - The ID of the Reserved Instance. * start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z). * state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired ). * tag :key =value - The keyvalue combination of a tag assigned to the resource. Specify the key of the tag in the filter name and the value of the tag in the filter value. For example, for the tag Purpose=X, specify tag:Purpose for the filter name and X for the filter value. * tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter "tag-key=Purpose" and the filter "tag-value=X", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag :key =value/ filter. * tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter. * usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).
• driReservedInstancesIds - One or more Reserved Instance IDs. Default: Describes all your Reserved Instances, or only those otherwise specified.
• driOfferingType - The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.
• driOfferingClass - Describes whether the Reserved Instance is Standard or Convertible.
• driDryRun - 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 .

data DescribeReservedInstances

Contains the parameters for DescribeReservedInstances.

See: describeReservedInstances smart constructor.

Instances

Eq DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

(==) :: DescribeReservedInstances -> DescribeReservedInstances -> Bool

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

Data DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

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

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

toConstr :: DescribeReservedInstances -> Constr

dataTypeOf :: DescribeReservedInstances -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

readsPrec :: Int -> ReadS DescribeReservedInstances

readList :: ReadS [DescribeReservedInstances]

readPrec :: ReadPrec DescribeReservedInstances

readListPrec :: ReadPrec [DescribeReservedInstances]

Show DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

showsPrec :: Int -> DescribeReservedInstances -> ShowS

show :: DescribeReservedInstances -> String

showList :: [DescribeReservedInstances] -> ShowS

Generic DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Associated Types

type Rep DescribeReservedInstances :: Type -> Type

Methods

from :: DescribeReservedInstances -> Rep DescribeReservedInstances x

to :: Rep DescribeReservedInstances x -> DescribeReservedInstances

Hashable DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

hashWithSalt :: Int -> DescribeReservedInstances -> Int

hash :: DescribeReservedInstances -> Int

AWSRequest DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Associated Types

type Rs DescribeReservedInstances :: Type

Methods

request :: DescribeReservedInstances -> Request DescribeReservedInstances

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

ToHeaders DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

toHeaders :: DescribeReservedInstances -> [Header]

ToPath DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

toPath :: DescribeReservedInstances -> ByteString

ToQuery DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

toQuery :: DescribeReservedInstances -> QueryString

NFData DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

rnf :: DescribeReservedInstances -> ()

type Rep DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

type Rep DescribeReservedInstances = D1 (MetaData "DescribeReservedInstances" "Network.AWS.EC2.DescribeReservedInstances" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeReservedInstances'" PrefixI True) ((S1 (MetaSel (Just "_driFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter])) :*: S1 (MetaSel (Just "_driReservedInstancesIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text]))) :*: (S1 (MetaSel (Just "_driOfferingType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe OfferingTypeValues)) :*: (S1 (MetaSel (Just "_driOfferingClass") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe OfferingClassType)) :*: S1 (MetaSel (Just "_driDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))))))

type Rs DescribeReservedInstances

Defined in Network.AWS.EC2.DescribeReservedInstances

type Rs DescribeReservedInstances = DescribeReservedInstancesResponse

Request Lenses

driFilters :: Lens' DescribeReservedInstances [Filter]

One or more filters. * availability-zone - The Availability Zone where the Reserved Instance can be used. * duration - The duration of the Reserved Instance (one year or three years), in seconds (31536000 | 94608000 ). * end - The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z). * fixed-price - The purchase price of the Reserved Instance (for example, 9800.0). * instance-type - The instance type that is covered by the reservation. * scope - The scope of the Reserved Instance (Region or Availability Zone ). * product-description - The Reserved Instance product platform description. Instances that include (Amazon VPC) in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX | Linux/UNIX (Amazon VPC) | SUSE Linux | SUSE Linux (Amazon VPC) | Red Hat Enterprise Linux | Red Hat Enterprise Linux (Amazon VPC) | Windows | Windows (Amazon VPC) | Windows with SQL Server Standard | Windows with SQL Server Standard (Amazon VPC) | Windows with SQL Server Web | Windows with SQL Server Web (Amazon VPC) | Windows with SQL Server Enterprise | Windows with SQL Server Enterprise (Amazon VPC) ). * reserved-instances-id - The ID of the Reserved Instance. * start - The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z). * state - The state of the Reserved Instance (payment-pending | active | payment-failed | retired ). * tag :key =value - The keyvalue combination of a tag assigned to the resource. Specify the key of the tag in the filter name and the value of the tag in the filter value. For example, for the tag Purpose=X, specify tag:Purpose for the filter name and X for the filter value. * tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter "tag-key=Purpose" and the filter "tag-value=X", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose is X, see the tag :key =value/ filter. * tag-value - The value of a tag assigned to the resource. This filter is independent of the tag-key filter. * usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).

driReservedInstancesIds :: Lens' DescribeReservedInstances [Text]

One or more Reserved Instance IDs. Default: Describes all your Reserved Instances, or only those otherwise specified.

driOfferingType :: Lens' DescribeReservedInstances (Maybe OfferingTypeValues)

The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only have access to the Medium Utilization Reserved Instance offering type.

driOfferingClass :: Lens' DescribeReservedInstances (Maybe OfferingClassType)

Describes whether the Reserved Instance is Standard or Convertible.

driDryRun :: Lens' DescribeReservedInstances (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 .

Destructuring the Response

describeReservedInstancesResponse

Arguments

:: Int

drirsResponseStatus

-> DescribeReservedInstancesResponse

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

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

• drirsReservedInstances - A list of Reserved Instances.
• drirsResponseStatus - -- | The response status code.

data DescribeReservedInstancesResponse

Contains the output for DescribeReservedInstances.

See: describeReservedInstancesResponse smart constructor.

Instances

Eq DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

(==) :: DescribeReservedInstancesResponse -> DescribeReservedInstancesResponse -> Bool

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

Data DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

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

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

toConstr :: DescribeReservedInstancesResponse -> Constr

dataTypeOf :: DescribeReservedInstancesResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

readsPrec :: Int -> ReadS DescribeReservedInstancesResponse

readList :: ReadS [DescribeReservedInstancesResponse]

readPrec :: ReadPrec DescribeReservedInstancesResponse

readListPrec :: ReadPrec [DescribeReservedInstancesResponse]

Show DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

showsPrec :: Int -> DescribeReservedInstancesResponse -> ShowS

show :: DescribeReservedInstancesResponse -> String

showList :: [DescribeReservedInstancesResponse] -> ShowS

Generic DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

Associated Types

type Rep DescribeReservedInstancesResponse :: Type -> Type

Methods

from :: DescribeReservedInstancesResponse -> Rep DescribeReservedInstancesResponse x

to :: Rep DescribeReservedInstancesResponse x -> DescribeReservedInstancesResponse

NFData DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

Methods

rnf :: DescribeReservedInstancesResponse -> ()

type Rep DescribeReservedInstancesResponse

Defined in Network.AWS.EC2.DescribeReservedInstances

type Rep DescribeReservedInstancesResponse = D1 (MetaData "DescribeReservedInstancesResponse" "Network.AWS.EC2.DescribeReservedInstances" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeReservedInstancesResponse'" PrefixI True) (S1 (MetaSel (Just "_drirsReservedInstances") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [ReservedInstances])) :*: S1 (MetaSel (Just "_drirsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

drirsReservedInstances :: Lens' DescribeReservedInstancesResponse [ReservedInstances]

A list of Reserved Instances.

drirsResponseStatus :: Lens' DescribeReservedInstancesResponse Int

• - | The response status code.