Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

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' {
- dbInstanceIdentifier :: Maybe Text
- filters :: Maybe [Filter]
- marker :: Maybe Text
- maxRecords :: Maybe Int
}
newDescribeDBInstances :: DescribeDBInstances
describeDBInstances_dbInstanceIdentifier :: Lens' DescribeDBInstances (Maybe Text)
describeDBInstances_filters :: Lens' DescribeDBInstances (Maybe [Filter])
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

dbInstanceIdentifier :: Maybe Text
The user-supplied instance identifier or the Amazon Resource Name (ARN) of the DB instance. 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.
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 only includes 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 only includes 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 only includes information about the DB instances associated with these domains.
- engine - Accepts engine names. The results list only includes information about the DB instances for these engines.
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

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 #
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 :: (Service -> Service) -> DescribeDBInstances -> Request DescribeDBInstances # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DescribeDBInstances -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeDBInstances))) #
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 #
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 #
NFData DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods rnf :: DescribeDBInstances -> () #
Eq DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods (==) :: DescribeDBInstances -> DescribeDBInstances -> Bool # (/=) :: DescribeDBInstances -> DescribeDBInstances -> Bool #
Hashable DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods hashWithSalt :: Int -> DescribeDBInstances -> Int # hash :: DescribeDBInstances -> Int #
type AWSResponse DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances type AWSResponse DescribeDBInstances = DescribeDBInstancesResponse
type Rep DescribeDBInstances Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances type Rep DescribeDBInstances = D1 ('MetaData "DescribeDBInstances" "Amazonka.RDS.DescribeDBInstances" "amazonka-rds-2.0-3xXyiLHmAvvCXXUIx1uhpP" 'False) (C1 ('MetaCons "DescribeDBInstances'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "dbInstanceIdentifier") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter]))) :: (S1 ('MetaSel ('Just "marker") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "maxRecords") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)))))

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:

DescribeDBInstances, describeDBInstances_dbInstanceIdentifier - The user-supplied instance identifier or the Amazon Resource Name (ARN) of the DB instance. 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: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 only includes 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 only includes 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 only includes information about the DB instances associated with these domains.
engine - Accepts engine names. The results list only includes information about the DB instances for these engines.

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_dbInstanceIdentifier :: Lens' DescribeDBInstances (Maybe Text) Source #

The user-supplied instance identifier or the Amazon Resource Name (ARN) of the DB instance. 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_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 only includes 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 only includes 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 only includes information about the DB instances associated with these domains.
engine - Accepts engine names. The results list only includes information about the DB instances for these engines.

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

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 #
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 #
NFData DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods rnf :: DescribeDBInstancesResponse -> () #
Eq DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances Methods (==) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool # (/=) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool #
type Rep DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.RDS.DescribeDBInstances type Rep DescribeDBInstancesResponse = D1 ('MetaData "DescribeDBInstancesResponse" "Amazonka.RDS.DescribeDBInstances" "amazonka-rds-2.0-3xXyiLHmAvvCXXUIx1uhpP" '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.

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.