amazonka-eks-2.0: Amazon Elastic Kubernetes Service 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.EKS.ListNodegroups

Description

Lists the Amazon EKS managed node groups associated with the specified cluster in your Amazon Web Services account in the specified Region. Self-managed node groups are not listed.

This operation returns paginated results.

Synopsis

Creating a Request

data ListNodegroups Source #

See: newListNodegroups smart constructor.

Constructors

ListNodegroups' 

Fields

  • maxResults :: Maybe Natural

    The maximum number of node group results returned by ListNodegroups in paginated output. When you use this parameter, ListNodegroups returns only maxResults results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListNodegroups request with the returned nextToken value. This value can be between 1 and 100. If you don't use this parameter, ListNodegroups returns up to 100 results and a nextToken value if applicable.

  • nextToken :: Maybe Text

    The nextToken value returned from a previous paginated ListNodegroups request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

  • clusterName :: Text

    The name of the Amazon EKS cluster that you would like to list node groups in.

Instances

Instances details
ToHeaders ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

ToPath ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

ToQuery ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

AWSPager ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

AWSRequest ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Associated Types

type AWSResponse ListNodegroups #

Generic ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Associated Types

type Rep ListNodegroups :: Type -> Type #

Read ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Show ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

NFData ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Methods

rnf :: ListNodegroups -> () #

Eq ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Hashable ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

type AWSResponse ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

type Rep ListNodegroups Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

type Rep ListNodegroups = D1 ('MetaData "ListNodegroups" "Amazonka.EKS.ListNodegroups" "amazonka-eks-2.0-7cAibD4zEbE2zPO6gnUh5m" 'False) (C1 ('MetaCons "ListNodegroups'" 'PrefixI 'True) (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "clusterName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))

newListNodegroups Source #

Create a value of ListNodegroups 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:maxResults:ListNodegroups', listNodegroups_maxResults - The maximum number of node group results returned by ListNodegroups in paginated output. When you use this parameter, ListNodegroups returns only maxResults results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListNodegroups request with the returned nextToken value. This value can be between 1 and 100. If you don't use this parameter, ListNodegroups returns up to 100 results and a nextToken value if applicable.

ListNodegroups, listNodegroups_nextToken - The nextToken value returned from a previous paginated ListNodegroups request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

ListNodegroups, listNodegroups_clusterName - The name of the Amazon EKS cluster that you would like to list node groups in.

Request Lenses

listNodegroups_maxResults :: Lens' ListNodegroups (Maybe Natural) Source #

The maximum number of node group results returned by ListNodegroups in paginated output. When you use this parameter, ListNodegroups returns only maxResults results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListNodegroups request with the returned nextToken value. This value can be between 1 and 100. If you don't use this parameter, ListNodegroups returns up to 100 results and a nextToken value if applicable.

listNodegroups_nextToken :: Lens' ListNodegroups (Maybe Text) Source #

The nextToken value returned from a previous paginated ListNodegroups request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

listNodegroups_clusterName :: Lens' ListNodegroups Text Source #

The name of the Amazon EKS cluster that you would like to list node groups in.

Destructuring the Response

data ListNodegroupsResponse Source #

See: newListNodegroupsResponse smart constructor.

Constructors

ListNodegroupsResponse' 

Fields

  • nextToken :: Maybe Text

    The nextToken value to include in a future ListNodegroups request. When the results of a ListNodegroups request exceed maxResults, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • nodegroups :: Maybe [Text]

    A list of all of the node groups associated with the specified cluster.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic ListNodegroupsResponse Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Associated Types

type Rep ListNodegroupsResponse :: Type -> Type #

Read ListNodegroupsResponse Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Show ListNodegroupsResponse Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

NFData ListNodegroupsResponse Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

Methods

rnf :: ListNodegroupsResponse -> () #

Eq ListNodegroupsResponse Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

type Rep ListNodegroupsResponse Source # 
Instance details

Defined in Amazonka.EKS.ListNodegroups

type Rep ListNodegroupsResponse = D1 ('MetaData "ListNodegroupsResponse" "Amazonka.EKS.ListNodegroups" "amazonka-eks-2.0-7cAibD4zEbE2zPO6gnUh5m" 'False) (C1 ('MetaCons "ListNodegroupsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "nodegroups") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListNodegroupsResponse Source #

Create a value of ListNodegroupsResponse 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:

ListNodegroups, listNodegroupsResponse_nextToken - The nextToken value to include in a future ListNodegroups request. When the results of a ListNodegroups request exceed maxResults, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

$sel:nodegroups:ListNodegroupsResponse', listNodegroupsResponse_nodegroups - A list of all of the node groups associated with the specified cluster.

$sel:httpStatus:ListNodegroupsResponse', listNodegroupsResponse_httpStatus - The response's http status code.

Response Lenses

listNodegroupsResponse_nextToken :: Lens' ListNodegroupsResponse (Maybe Text) Source #

The nextToken value to include in a future ListNodegroups request. When the results of a ListNodegroups request exceed maxResults, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

listNodegroupsResponse_nodegroups :: Lens' ListNodegroupsResponse (Maybe [Text]) Source #

A list of all of the node groups associated with the specified cluster.