Network.AWS.RDS.DescribeDBInstances

Returns information about provisioned RDS instances. This API supports pagination.

This operation returns paginated results.

Creating a Request

describeDBInstances :: DescribeDBInstances

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

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

• ddbiFilters - A filter that specifies one or more DB instances to describe. Supported filters: * db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB instances associated with the DB clusters identified by these ARNs. * db-instance-id - Accepts DB instance identifiers and DB instance Amazon Resource Names (ARNs). The results list will only include information about the DB instances identified by these ARNs.
• ddbiDBInstanceIdentifier - The user-supplied instance identifier. If this parameter is specified, information from only the specific DB instance is returned. This parameter isn't case-sensitive. Constraints: * If supplied, must match the identifier of an existing DBInstance.
• ddbiMarker - An optional pagination token provided by a previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .
• ddbiMaxRecords - The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved. Default: 100 Constraints: Minimum 20, maximum 100.

data DescribeDBInstances

See: describeDBInstances smart constructor.

Instances

Eq DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

(==) :: DescribeDBInstances -> DescribeDBInstances -> Bool

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

Data DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

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

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

toConstr :: DescribeDBInstances -> Constr

dataTypeOf :: DescribeDBInstances -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

readsPrec :: Int -> ReadS DescribeDBInstances

readList :: ReadS [DescribeDBInstances]

readPrec :: ReadPrec DescribeDBInstances

readListPrec :: ReadPrec [DescribeDBInstances]

Show DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

showsPrec :: Int -> DescribeDBInstances -> ShowS

show :: DescribeDBInstances -> String

showList :: [DescribeDBInstances] -> ShowS

Generic DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Associated Types

type Rep DescribeDBInstances :: Type -> Type

Methods

from :: DescribeDBInstances -> Rep DescribeDBInstances x

to :: Rep DescribeDBInstances x -> DescribeDBInstances

Hashable DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

hashWithSalt :: Int -> DescribeDBInstances -> Int

hash :: DescribeDBInstances -> Int

AWSPager DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

page :: DescribeDBInstances -> Rs DescribeDBInstances -> Maybe DescribeDBInstances

AWSRequest DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Associated Types

type Rs DescribeDBInstances :: Type

Methods

request :: DescribeDBInstances -> Request DescribeDBInstances

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

ToHeaders DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

toHeaders :: DescribeDBInstances -> [Header]

ToPath DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

toPath :: DescribeDBInstances -> ByteString

ToQuery DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

toQuery :: DescribeDBInstances -> QueryString

NFData DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

rnf :: DescribeDBInstances -> ()

type Rep DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

type Rep DescribeDBInstances = D1 (MetaData "DescribeDBInstances" "Network.AWS.RDS.DescribeDBInstances" "amazonka-rds-1.6.1-GvYb6r2di9RGFKQcoJXq1A" False) (C1 (MetaCons "DescribeDBInstances'" PrefixI True) ((S1 (MetaSel (Just "_ddbiFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter])) :*: S1 (MetaSel (Just "_ddbiDBInstanceIdentifier") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 (MetaSel (Just "_ddbiMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_ddbiMaxRecords") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)))))

type Rs DescribeDBInstances

Defined in Network.AWS.RDS.DescribeDBInstances

type Rs DescribeDBInstances = DescribeDBInstancesResponse

Request Lenses

ddbiFilters :: Lens' DescribeDBInstances [Filter]

A filter that specifies one or more DB instances to describe. Supported filters: * db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB instances associated with the DB clusters identified by these ARNs. * db-instance-id - Accepts DB instance identifiers and DB instance Amazon Resource Names (ARNs). The results list will only include information about the DB instances identified by these ARNs.

ddbiDBInstanceIdentifier :: Lens' DescribeDBInstances (Maybe Text)

The user-supplied instance identifier. If this parameter is specified, information from only the specific DB instance is returned. This parameter isn't case-sensitive. Constraints: * If supplied, must match the identifier of an existing DBInstance.

ddbiMarker :: Lens' DescribeDBInstances (Maybe Text)

An optional pagination token provided by a previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

ddbiMaxRecords :: Lens' DescribeDBInstances (Maybe Int)

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved. Default: 100 Constraints: Minimum 20, maximum 100.

Destructuring the Response

describeDBInstancesResponse

Arguments

:: Int

ddbirsResponseStatus

-> DescribeDBInstancesResponse

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

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

• ddbirsDBInstances - A list of DBInstance instances.
• ddbirsMarker - An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .
• ddbirsResponseStatus - -- | The response status code.

data DescribeDBInstancesResponse

Contains the result of a successful invocation of the DescribeDBInstances action.

See: describeDBInstancesResponse smart constructor.

Instances

Eq DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

(==) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool

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

Data DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

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

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

toConstr :: DescribeDBInstancesResponse -> Constr

dataTypeOf :: DescribeDBInstancesResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

readsPrec :: Int -> ReadS DescribeDBInstancesResponse

readList :: ReadS [DescribeDBInstancesResponse]

readPrec :: ReadPrec DescribeDBInstancesResponse

readListPrec :: ReadPrec [DescribeDBInstancesResponse]

Show DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

showsPrec :: Int -> DescribeDBInstancesResponse -> ShowS

show :: DescribeDBInstancesResponse -> String

showList :: [DescribeDBInstancesResponse] -> ShowS

Generic DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

Associated Types

type Rep DescribeDBInstancesResponse :: Type -> Type

Methods

from :: DescribeDBInstancesResponse -> Rep DescribeDBInstancesResponse x

to :: Rep DescribeDBInstancesResponse x -> DescribeDBInstancesResponse

NFData DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

Methods

rnf :: DescribeDBInstancesResponse -> ()

type Rep DescribeDBInstancesResponse

Defined in Network.AWS.RDS.DescribeDBInstances

type Rep DescribeDBInstancesResponse = D1 (MetaData "DescribeDBInstancesResponse" "Network.AWS.RDS.DescribeDBInstances" "amazonka-rds-1.6.1-GvYb6r2di9RGFKQcoJXq1A" False) (C1 (MetaCons "DescribeDBInstancesResponse'" PrefixI True) (S1 (MetaSel (Just "_ddbirsDBInstances") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [DBInstance])) :*: (S1 (MetaSel (Just "_ddbirsMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_ddbirsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

ddbirsDBInstances :: Lens' DescribeDBInstancesResponse [DBInstance]

A list of DBInstance instances.

ddbirsMarker :: Lens' DescribeDBInstancesResponse (Maybe Text)

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

ddbirsResponseStatus :: Lens' DescribeDBInstancesResponse Int

• - | The response status code.