amazonka-cloudhsmv2-2.0: Amazon CloudHSM V2 SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.CloudHSMV2.DescribeClusters

Description

Gets information about AWS CloudHSM clusters.

This is a paginated operation, which means that each response might contain only a subset of all the clusters. When the response contains only a subset of clusters, it includes a NextToken value. Use this value in a subsequent DescribeClusters request to get more clusters. When you receive a response with no NextToken (or an empty or null value), that means there are no more clusters to get.

This operation returns paginated results.

Synopsis

Creating a Request

data DescribeClusters Source #

See: newDescribeClusters smart constructor.

Constructors

DescribeClusters' 

Fields

  • filters :: Maybe (HashMap Text [Text])

    One or more filters to limit the items returned in the response.

    Use the clusterIds filter to return only the specified clusters. Specify clusters by their cluster identifier (ID).

    Use the vpcIds filter to return only the clusters in the specified virtual private clouds (VPCs). Specify VPCs by their VPC identifier (ID).

    Use the states filter to return only clusters that match the specified state.

  • maxResults :: Maybe Natural

    The maximum number of clusters to return in the response. When there are more clusters than the number you specify, the response contains a NextToken value.

  • nextToken :: Maybe Text

    The NextToken value that you received in the previous response. Use this value to get more clusters.

Instances

Instances details
ToJSON DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

ToHeaders DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

ToPath DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

ToQuery DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

AWSPager DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

AWSRequest DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Associated Types

type AWSResponse DescribeClusters #

Generic DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Associated Types

type Rep DescribeClusters :: Type -> Type #

Read DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Show DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

NFData DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Methods

rnf :: DescribeClusters -> () #

Eq DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Hashable DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

type AWSResponse DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

type Rep DescribeClusters Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

type Rep DescribeClusters = D1 ('MetaData "DescribeClusters" "Amazonka.CloudHSMV2.DescribeClusters" "amazonka-cloudhsmv2-2.0-JPONnjzt63Q1wP3HCntyXZ" 'False) (C1 ('MetaCons "DescribeClusters'" 'PrefixI 'True) (S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text [Text]))) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))

newDescribeClusters :: DescribeClusters Source #

Create a value of DescribeClusters 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:DescribeClusters', describeClusters_filters - One or more filters to limit the items returned in the response.

Use the clusterIds filter to return only the specified clusters. Specify clusters by their cluster identifier (ID).

Use the vpcIds filter to return only the clusters in the specified virtual private clouds (VPCs). Specify VPCs by their VPC identifier (ID).

Use the states filter to return only clusters that match the specified state.

$sel:maxResults:DescribeClusters', describeClusters_maxResults - The maximum number of clusters to return in the response. When there are more clusters than the number you specify, the response contains a NextToken value.

DescribeClusters, describeClusters_nextToken - The NextToken value that you received in the previous response. Use this value to get more clusters.

Request Lenses

describeClusters_filters :: Lens' DescribeClusters (Maybe (HashMap Text [Text])) Source #

One or more filters to limit the items returned in the response.

Use the clusterIds filter to return only the specified clusters. Specify clusters by their cluster identifier (ID).

Use the vpcIds filter to return only the clusters in the specified virtual private clouds (VPCs). Specify VPCs by their VPC identifier (ID).

Use the states filter to return only clusters that match the specified state.

describeClusters_maxResults :: Lens' DescribeClusters (Maybe Natural) Source #

The maximum number of clusters to return in the response. When there are more clusters than the number you specify, the response contains a NextToken value.

describeClusters_nextToken :: Lens' DescribeClusters (Maybe Text) Source #

The NextToken value that you received in the previous response. Use this value to get more clusters.

Destructuring the Response

data DescribeClustersResponse Source #

See: newDescribeClustersResponse smart constructor.

Constructors

DescribeClustersResponse' 

Fields

  • clusters :: Maybe [Cluster]

    A list of clusters.

  • nextToken :: Maybe Text

    An opaque string that indicates that the response contains only a subset of clusters. Use this value in a subsequent DescribeClusters request to get more clusters.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic DescribeClustersResponse Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Associated Types

type Rep DescribeClustersResponse :: Type -> Type #

Read DescribeClustersResponse Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Show DescribeClustersResponse Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

NFData DescribeClustersResponse Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

Eq DescribeClustersResponse Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

type Rep DescribeClustersResponse Source # 
Instance details

Defined in Amazonka.CloudHSMV2.DescribeClusters

type Rep DescribeClustersResponse = D1 ('MetaData "DescribeClustersResponse" "Amazonka.CloudHSMV2.DescribeClusters" "amazonka-cloudhsmv2-2.0-JPONnjzt63Q1wP3HCntyXZ" 'False) (C1 ('MetaCons "DescribeClustersResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "clusters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Cluster])) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeClustersResponse Source #

Create a value of DescribeClustersResponse 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:clusters:DescribeClustersResponse', describeClustersResponse_clusters - A list of clusters.

DescribeClusters, describeClustersResponse_nextToken - An opaque string that indicates that the response contains only a subset of clusters. Use this value in a subsequent DescribeClusters request to get more clusters.

$sel:httpStatus:DescribeClustersResponse', describeClustersResponse_httpStatus - The response's http status code.

Response Lenses

describeClustersResponse_nextToken :: Lens' DescribeClustersResponse (Maybe Text) Source #

An opaque string that indicates that the response contains only a subset of clusters. Use this value in a subsequent DescribeClusters request to get more clusters.