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.Neptune.DescribeDBInstances

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns information about provisioned instances, and supports pagination.

This operation can also return information for Amazon RDS instances and Amazon DocDB 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.
- engine - Accepts an engine name (such as neptune), and restricts the results list to DB instances created by that engine.
For example, to invoke this API from the Amazon CLI and filter so that only Neptune DB instances are returned, you could use the following command:
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 the remaining results can be retrieved.
Default: 100
Constraints: Minimum 20, maximum 100.

Instances

Instances details

Eq DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods (==) :: DescribeDBInstances -> DescribeDBInstances -> Bool # (/=) :: DescribeDBInstances -> DescribeDBInstances -> Bool #
Read DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods readsPrec :: Int -> ReadS DescribeDBInstances # readList :: ReadS [DescribeDBInstances] # readPrec :: ReadPrec DescribeDBInstances # readListPrec :: ReadPrec [DescribeDBInstances] #
Show DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods showsPrec :: Int -> DescribeDBInstances -> ShowS # show :: DescribeDBInstances -> String # showList :: [DescribeDBInstances] -> ShowS #
Generic DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.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.Neptune.DescribeDBInstances Methods rnf :: DescribeDBInstances -> () #
Hashable DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods hashWithSalt :: Int -> DescribeDBInstances -> Int # hash :: DescribeDBInstances -> Int #
AWSPager DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods page :: DescribeDBInstances -> AWSResponse DescribeDBInstances -> Maybe DescribeDBInstances #
AWSRequest DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.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.Neptune.DescribeDBInstances Methods toHeaders :: DescribeDBInstances -> [Header] #
ToPath DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods toPath :: DescribeDBInstances -> ByteString #
ToQuery DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods toQuery :: DescribeDBInstances -> QueryString #
type Rep DescribeDBInstances Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances type Rep DescribeDBInstances = D1 ('MetaData "DescribeDBInstances" "Amazonka.Neptune.DescribeDBInstances" "libZSservicesZSamazonka-neptuneZSamazonka-neptune" '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.Neptune.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.
engine - Accepts an engine name (such as neptune), and restricts the results list to DB instances created by that engine.

For example, to invoke this API from the Amazon CLI and filter so that only Neptune DB instances are returned, you could use the following command:

$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 the remaining results can be retrieved.

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.
engine - Accepts an engine name (such as neptune), and restricts the results list to DB instances created by that engine.

For example, to invoke this API from the Amazon CLI and filter so that only Neptune DB instances are returned, you could use the following command:

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 the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

Destructuring the Response

data DescribeDBInstancesResponse Source #

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.Neptune.DescribeDBInstances Methods (==) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool # (/=) :: DescribeDBInstancesResponse -> DescribeDBInstancesResponse -> Bool #
Read DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods readsPrec :: Int -> ReadS DescribeDBInstancesResponse # readList :: ReadS [DescribeDBInstancesResponse] # readPrec :: ReadPrec DescribeDBInstancesResponse # readListPrec :: ReadPrec [DescribeDBInstancesResponse] #
Show DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances Methods showsPrec :: Int -> DescribeDBInstancesResponse -> ShowS # show :: DescribeDBInstancesResponse -> String # showList :: [DescribeDBInstancesResponse] -> ShowS #
Generic DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.Neptune.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.Neptune.DescribeDBInstances Methods rnf :: DescribeDBInstancesResponse -> () #
type Rep DescribeDBInstancesResponse Source #
Instance details Defined in Amazonka.Neptune.DescribeDBInstances type Rep DescribeDBInstancesResponse = D1 ('MetaData "DescribeDBInstancesResponse" "Amazonka.Neptune.DescribeDBInstances" "libZSservicesZSamazonka-neptuneZSamazonka-neptune" '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.