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.DescribeDBClusters

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns information about provisioned Aurora DB clusters. This API supports pagination.

For more information on Amazon Aurora, see What Is Amazon Aurora? in the Amazon Aurora User Guide.

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

This operation returns paginated results.

Synopsis

data DescribeDBClusters = DescribeDBClusters' {
- dbClusterIdentifier :: Maybe Text
- includeShared :: Maybe Bool
- filters :: Maybe [Filter]
- marker :: Maybe Text
- maxRecords :: Maybe Int
}
newDescribeDBClusters :: DescribeDBClusters
describeDBClusters_dbClusterIdentifier :: Lens' DescribeDBClusters (Maybe Text)
describeDBClusters_includeShared :: Lens' DescribeDBClusters (Maybe Bool)
describeDBClusters_filters :: Lens' DescribeDBClusters (Maybe [Filter])
describeDBClusters_marker :: Lens' DescribeDBClusters (Maybe Text)
describeDBClusters_maxRecords :: Lens' DescribeDBClusters (Maybe Int)
data DescribeDBClustersResponse = DescribeDBClustersResponse' {
- dbClusters :: Maybe [DBCluster]
- marker :: Maybe Text
- httpStatus :: Int
}
newDescribeDBClustersResponse :: Int -> DescribeDBClustersResponse
describeDBClustersResponse_dbClusters :: Lens' DescribeDBClustersResponse (Maybe [DBCluster])
describeDBClustersResponse_marker :: Lens' DescribeDBClustersResponse (Maybe Text)
describeDBClustersResponse_httpStatus :: Lens' DescribeDBClustersResponse Int

Creating a Request

data DescribeDBClusters Source #

See: newDescribeDBClusters smart constructor.

Constructors

DescribeDBClusters'

Fields

dbClusterIdentifier :: Maybe Text
The user-supplied DB cluster identifier. If this parameter is specified, information from only the specific DB cluster is returned. This parameter isn't case-sensitive.
Constraints:
- If supplied, must match an existing DBClusterIdentifier.
includeShared :: Maybe Bool
Optional Boolean parameter that specifies whether the output includes information about clusters shared from other Amazon Web Services accounts.
filters :: Maybe [Filter]
A filter that specifies one or more DB clusters to describe.
Supported filters:
- clone-group-id - Accepts clone group identifiers. The results list will only include information about the DB clusters associated with these clone groups.
- db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB clusters identified by these ARNs.
- domain - Accepts Active Directory directory IDs. The results list will only include information about the DB clusters associated with these domains.
- engine - Accepts engine names. The results list will only include information about the DB clusters for these engines.
marker :: Maybe Text
An optional pagination token provided by a previous DescribeDBClusters 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 you can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.

Instances

Instances details

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

newDescribeDBClusters :: DescribeDBClusters Source #

Create a value of DescribeDBClusters 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:dbClusterIdentifier:DescribeDBClusters', describeDBClusters_dbClusterIdentifier - The user-supplied DB cluster identifier. If this parameter is specified, information from only the specific DB cluster is returned. This parameter isn't case-sensitive.

Constraints:

If supplied, must match an existing DBClusterIdentifier.

$sel:includeShared:DescribeDBClusters', describeDBClusters_includeShared - Optional Boolean parameter that specifies whether the output includes information about clusters shared from other Amazon Web Services accounts.

$sel:filters:DescribeDBClusters', describeDBClusters_filters - A filter that specifies one or more DB clusters to describe.

Supported filters:

clone-group-id - Accepts clone group identifiers. The results list will only include information about the DB clusters associated with these clone groups.
db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB clusters identified by these ARNs.
domain - Accepts Active Directory directory IDs. The results list will only include information about the DB clusters associated with these domains.
engine - Accepts engine names. The results list will only include information about the DB clusters for these engines.

$sel:marker:DescribeDBClusters', describeDBClusters_marker - An optional pagination token provided by a previous DescribeDBClusters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

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

Default: 100

Constraints: Minimum 20, maximum 100.

Request Lenses

describeDBClusters_dbClusterIdentifier :: Lens' DescribeDBClusters (Maybe Text) Source #

The user-supplied DB cluster identifier. If this parameter is specified, information from only the specific DB cluster is returned. This parameter isn't case-sensitive.

Constraints:

If supplied, must match an existing DBClusterIdentifier.

describeDBClusters_includeShared :: Lens' DescribeDBClusters (Maybe Bool) Source #

Optional Boolean parameter that specifies whether the output includes information about clusters shared from other Amazon Web Services accounts.

describeDBClusters_filters :: Lens' DescribeDBClusters (Maybe [Filter]) Source #

A filter that specifies one or more DB clusters to describe.

Supported filters:

clone-group-id - Accepts clone group identifiers. The results list will only include information about the DB clusters associated with these clone groups.
db-cluster-id - Accepts DB cluster identifiers and DB cluster Amazon Resource Names (ARNs). The results list will only include information about the DB clusters identified by these ARNs.
domain - Accepts Active Directory directory IDs. The results list will only include information about the DB clusters associated with these domains.
engine - Accepts engine names. The results list will only include information about the DB clusters for these engines.

describeDBClusters_marker :: Lens' DescribeDBClusters (Maybe Text) Source #

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

describeDBClusters_maxRecords :: Lens' DescribeDBClusters (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 you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100.

Destructuring the Response

data DescribeDBClustersResponse Source #

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

See: newDescribeDBClustersResponse smart constructor.

Constructors

DescribeDBClustersResponse'
Fields dbClusters :: Maybe [DBCluster] Contains a list of DB clusters for the user. marker :: Maybe Text A pagination token that can be used in a later DescribeDBClusters request. httpStatus :: Int The response's http status code.

Instances

Instances details

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

newDescribeDBClustersResponse Source #

Arguments

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

Create a value of DescribeDBClustersResponse 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:dbClusters:DescribeDBClustersResponse', describeDBClustersResponse_dbClusters - Contains a list of DB clusters for the user.

$sel:marker:DescribeDBClusters', describeDBClustersResponse_marker - A pagination token that can be used in a later DescribeDBClusters request.

$sel:httpStatus:DescribeDBClustersResponse', describeDBClustersResponse_httpStatus - The response's http status code.

Response Lenses

describeDBClustersResponse_dbClusters :: Lens' DescribeDBClustersResponse (Maybe [DBCluster]) Source #

Contains a list of DB clusters for the user.

describeDBClustersResponse_marker :: Lens' DescribeDBClustersResponse (Maybe Text) Source #

A pagination token that can be used in a later DescribeDBClusters request.

describeDBClustersResponse_httpStatus :: Lens' DescribeDBClustersResponse Int Source #

The response's http status code.