Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.RDS.DescribeDBInstances

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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

This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.

This operation returns paginated results.

Synopsis

data DescribeDBInstances = DescribeDBInstances' {
- filters :: Maybe [Filter]
- dbInstanceIdentifier :: Maybe Text
- marker :: Maybe Text
- maxRecords :: Maybe Int
}
newDescribeDBInstances :: DescribeDBInstances
describeDBInstances_filters :: Lens' DescribeDBInstances (Maybe [Filter])
describeDBInstances_dbInstanceIdentifier :: Lens' DescribeDBInstances (Maybe Text)
describeDBInstances_marker :: Lens' DescribeDBInstances (Maybe Text)
describeDBInstances_maxRecords :: Lens' DescribeDBInstances (Maybe Int)
data DescribeDBInstancesResponse = DescribeDBInstancesResponse' {
- dbInstances :: Maybe [DBInstance]
- marker :: Maybe Text
- httpStatus :: Int
}
newDescribeDBInstancesResponse :: Int -> DescribeDBInstancesResponse
describeDBInstancesResponse_dbInstances :: Lens' DescribeDBInstancesResponse (Maybe [DBInstance])
describeDBInstancesResponse_marker :: Lens' DescribeDBInstancesResponse (Maybe Text)
describeDBInstancesResponse_httpStatus :: Lens' DescribeDBInstancesResponse Int

Creating a Request

data DescribeDBInstances Source #

See: newDescribeDBInstances smart constructor.

Constructors

DescribeDBInstances'

Fields

filters :: Maybe [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.
- dbi-resource-id - Accepts DB instance resource identifiers. The results list will only include information about the DB instances identified by these DB instance resource identifiers.
- domain - Accepts Active Directory directory IDs. The results list will only include information about the DB instances associated with these domains.
- engine - Accepts engine names. The results list will only include information about the DB instances for these engines.
dbInstanceIdentifier :: 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.
marker :: 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.
maxRecords :: 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 you can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.

Instances

Instances details

Eq DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods (==) :: DescribeDBInstances -> DescribeDBInstances -> Bool # (/=) :: DescribeDBInstances -> DescribeDBInstances -> Bool #
Read DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods readsPrec :: Int -> ReadS DescribeDBInstances # readList :: ReadS [DescribeDBInstances] # readPrec :: ReadPrec DescribeDBInstances # readListPrec :: ReadPrec [DescribeDBInstances] #
Show DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods showsPrec :: Int -> DescribeDBInstances -> ShowS # show :: DescribeDBInstances -> String # showList :: [DescribeDBInstances] -> ShowS #
Generic DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Associated Types type Rep DescribeDBInstances :: Type -> Type # Methods from :: DescribeDBInstances -> Rep DescribeDBInstances x # to :: Rep DescribeDBInstances x -> DescribeDBInstances #
NFData DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods rnf :: DescribeDBInstances -> () #
Hashable DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods hashWithSalt :: Int -> DescribeDBInstances -> Int # hash :: DescribeDBInstances -> Int #
AWSPager DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods page :: DescribeDBInstances -> AWSResponse DescribeDBInstances -> Maybe DescribeDBInstances #
AWSRequest DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Associated Types type AWSResponse DescribeDBInstances # Methods request :: DescribeDBInstances -> Request DescribeDBInstances # response :: MonadResource m => Logger -> Service -> Proxy DescribeDBInstances -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeDBInstances))) #
ToHeaders DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods toHeaders :: DescribeDBInstances -> [Header] #
ToPath DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods toPath :: DescribeDBInstances -> ByteString #
ToQuery DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods toQuery :: DescribeDBInstances -> QueryString #
type Rep DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances type Rep DescribeDBInstances = D1 ('MetaData "DescribeDBInstances" "Amazonka.RDS.DescribeDBInstances" "libZSservicesZSamazonka-rdsZSamazonka-rds" 'False) (C1 ('MetaCons "DescribeDBInstances'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])) :: S1 ('MetaSel ('Just "dbInstanceIdentifier") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "marker") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "maxRecords") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)))))
type AWSResponse DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances type AWSResponse DescribeDBInstances = DescribeDBInstancesResponse

newDescribeDBInstances :: DescribeDBInstances Source #

Create a value of DescribeDBInstances with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:filters:DescribeDBInstances', describeDBInstances_filters - 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.
dbi-resource-id - Accepts DB instance resource identifiers. The results list will only include information about the DB instances identified by these DB instance resource identifiers.
domain - Accepts Active Directory directory IDs. The results list will only include information about the DB instances associated with these domains.
engine - Accepts engine names. The results list will only include information about the DB instances for these engines.

$sel:dbInstanceIdentifier:DescribeDBInstances', describeDBInstances_dbInstanceIdentifier - 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.

$sel:marker:DescribeDBInstances', describeDBInstances_marker - 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.

$sel:maxRecords:DescribeDBInstances', describeDBInstances_maxRecords - 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 you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100.

Request Lenses

describeDBInstances_filters :: Lens' DescribeDBInstances (Maybe [Filter]) Source #

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.
dbi-resource-id - Accepts DB instance resource identifiers. The results list will only include information about the DB instances identified by these DB instance resource identifiers.
domain - Accepts Active Directory directory IDs. The results list will only include information about the DB instances associated with these domains.
engine - Accepts engine names. The results list will only include information about the DB instances for these engines.

describeDBInstances_dbInstanceIdentifier :: Lens' DescribeDBInstances (Maybe Text) Source #

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.

describeDBInstances_marker :: Lens' DescribeDBInstances (Maybe Text) Source #

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.

describeDBInstances_maxRecords :: Lens' DescribeDBInstances (Maybe Int) Source #

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 you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100.

Destructuring the Response

data DescribeDBInstancesResponse Source #

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

See: newDescribeDBInstancesResponse smart constructor.

Constructors

DescribeDBInstancesResponse'
Fields dbInstances :: Maybe [DBInstance] A list of `DBInstance` instances. marker :: 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` . httpStatus :: Int The response's http status code.

Instances

Instances details

Eq DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods (==) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool # (/=) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool #
Read DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods readsPrec :: Int -> ReadS DescribeDBInstancesResponse # readList :: ReadS [DescribeDBInstancesResponse] # readPrec :: ReadPrec DescribeDBInstancesResponse # readListPrec :: ReadPrec [DescribeDBInstancesResponse] #
Show DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods showsPrec :: Int -> DescribeDBInstancesResponse -> ShowS # show :: DescribeDBInstancesResponse -> String # showList :: [DescribeDBInstancesResponse] -> ShowS #
Generic DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Associated Types type Rep DescribeDBInstancesResponse :: Type -> Type # Methods from :: DescribeDBInstancesResponse -> Rep DescribeDBInstancesResponse x # to :: Rep DescribeDBInstancesResponse x -> DescribeDBInstancesResponse #
NFData DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods rnf :: DescribeDBInstancesResponse -> () #
type Rep DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances type Rep DescribeDBInstancesResponse = D1 ('MetaData "DescribeDBInstancesResponse" "Amazonka.RDS.DescribeDBInstances" "libZSservicesZSamazonka-rdsZSamazonka-rds" 'False) (C1 ('MetaCons "DescribeDBInstancesResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "dbInstances") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [DBInstance])) :: (S1 ('MetaSel ('Just "marker") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeDBInstancesResponse Source #

Arguments

:: Int	`$sel:httpStatus:DescribeDBInstancesResponse'`
-> DescribeDBInstancesResponse

Create a value of DescribeDBInstancesResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:dbInstances:DescribeDBInstancesResponse', describeDBInstancesResponse_dbInstances - A list of DBInstance instances.

$sel:marker:DescribeDBInstances', describeDBInstancesResponse_marker - 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 .

$sel:httpStatus:DescribeDBInstancesResponse', describeDBInstancesResponse_httpStatus - The response's http status code.

Response Lenses

describeDBInstancesResponse_dbInstances :: Lens' DescribeDBInstancesResponse (Maybe [DBInstance]) Source #

A list of DBInstance instances.

describeDBInstancesResponse_marker :: Lens' DescribeDBInstancesResponse (Maybe Text) Source #

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 .

describeDBInstancesResponse_httpStatus :: Lens' DescribeDBInstancesResponse Int Source #

The response's http status code.