amazonka-ec2-2.0: Amazon Elastic Compute Cloud 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.EC2.DescribeIpv6Pools

Description

Describes your IPv6 address pools.

This operation returns paginated results.

Synopsis

Creating a Request

data DescribeIpv6Pools Source #

See: newDescribeIpv6Pools smart constructor.

Constructors

DescribeIpv6Pools' 

Fields

  • dryRun :: Maybe Bool

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

  • filters :: Maybe [Filter]

    One or more filters.

    • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
    • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.
  • maxResults :: Maybe Natural

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken :: Maybe Text

    The token for the next page of results.

  • poolIds :: Maybe [Text]

    The IDs of the IPv6 address pools.

Instances

Instances details
ToHeaders DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

ToPath DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

ToQuery DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

AWSPager DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

AWSRequest DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Associated Types

type AWSResponse DescribeIpv6Pools #

Generic DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Associated Types

type Rep DescribeIpv6Pools :: Type -> Type #

Read DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Show DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

NFData DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Methods

rnf :: DescribeIpv6Pools -> () #

Eq DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Hashable DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

type AWSResponse DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

type Rep DescribeIpv6Pools Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

type Rep DescribeIpv6Pools = D1 ('MetaData "DescribeIpv6Pools" "Amazonka.EC2.DescribeIpv6Pools" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeIpv6Pools'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter]))) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "poolIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text]))))))

newDescribeIpv6Pools :: DescribeIpv6Pools Source #

Create a value of DescribeIpv6Pools 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:dryRun:DescribeIpv6Pools', describeIpv6Pools_dryRun - Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

$sel:filters:DescribeIpv6Pools', describeIpv6Pools_filters - One or more filters.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

$sel:maxResults:DescribeIpv6Pools', describeIpv6Pools_maxResults - The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

DescribeIpv6Pools, describeIpv6Pools_nextToken - The token for the next page of results.

$sel:poolIds:DescribeIpv6Pools', describeIpv6Pools_poolIds - The IDs of the IPv6 address pools.

Request Lenses

describeIpv6Pools_dryRun :: Lens' DescribeIpv6Pools (Maybe Bool) Source #

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

describeIpv6Pools_filters :: Lens' DescribeIpv6Pools (Maybe [Filter]) Source #

One or more filters.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

describeIpv6Pools_maxResults :: Lens' DescribeIpv6Pools (Maybe Natural) Source #

The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

describeIpv6Pools_nextToken :: Lens' DescribeIpv6Pools (Maybe Text) Source #

The token for the next page of results.

describeIpv6Pools_poolIds :: Lens' DescribeIpv6Pools (Maybe [Text]) Source #

The IDs of the IPv6 address pools.

Destructuring the Response

data DescribeIpv6PoolsResponse Source #

See: newDescribeIpv6PoolsResponse smart constructor.

Constructors

DescribeIpv6PoolsResponse' 

Fields

Instances

Instances details
Generic DescribeIpv6PoolsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Associated Types

type Rep DescribeIpv6PoolsResponse :: Type -> Type #

Read DescribeIpv6PoolsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Show DescribeIpv6PoolsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

NFData DescribeIpv6PoolsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

Eq DescribeIpv6PoolsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

type Rep DescribeIpv6PoolsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeIpv6Pools

type Rep DescribeIpv6PoolsResponse = D1 ('MetaData "DescribeIpv6PoolsResponse" "Amazonka.EC2.DescribeIpv6Pools" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeIpv6PoolsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "ipv6Pools") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Ipv6Pool])) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeIpv6PoolsResponse Source #

Create a value of DescribeIpv6PoolsResponse 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:ipv6Pools:DescribeIpv6PoolsResponse', describeIpv6PoolsResponse_ipv6Pools - Information about the IPv6 address pools.

DescribeIpv6Pools, describeIpv6PoolsResponse_nextToken - The token to use to retrieve the next page of results. This value is null when there are no more results to return.

$sel:httpStatus:DescribeIpv6PoolsResponse', describeIpv6PoolsResponse_httpStatus - The response's http status code.

Response Lenses

describeIpv6PoolsResponse_nextToken :: Lens' DescribeIpv6PoolsResponse (Maybe Text) Source #

The token to use to retrieve the next page of results. This value is null when there are no more results to return.