{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# LANGUAGE NamedFieldPuns #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE TypeFamilies #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# OPTIONS_GHC -fno-warn-unused-binds #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}

-- Derived from AWS service descriptions, licensed under Apache 2.0.

-- |
-- Module      : Amazonka.EC2.DescribeSubnets
-- Copyright   : (c) 2013-2023 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- Describes one or more of your subnets.
--
-- For more information, see
-- <https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html Your VPC and subnets>
-- in the /Amazon Virtual Private Cloud User Guide/.
--
-- This operation returns paginated results.
module Amazonka.EC2.DescribeSubnets
  ( -- * Creating a Request
    DescribeSubnets (..),
    newDescribeSubnets,

    -- * Request Lenses
    describeSubnets_dryRun,
    describeSubnets_filters,
    describeSubnets_maxResults,
    describeSubnets_nextToken,
    describeSubnets_subnetIds,

    -- * Destructuring the Response
    DescribeSubnetsResponse (..),
    newDescribeSubnetsResponse,

    -- * Response Lenses
    describeSubnetsResponse_nextToken,
    describeSubnetsResponse_subnets,
    describeSubnetsResponse_httpStatus,
  )
where

import qualified Amazonka.Core as Core
import qualified Amazonka.Core.Lens.Internal as Lens
import qualified Amazonka.Data as Data
import Amazonka.EC2.Types
import qualified Amazonka.Prelude as Prelude
import qualified Amazonka.Request as Request
import qualified Amazonka.Response as Response

-- | /See:/ 'newDescribeSubnets' smart constructor.
data DescribeSubnets = DescribeSubnets'
  { -- | 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@.
    DescribeSubnets -> Maybe Bool
dryRun :: Prelude.Maybe Prelude.Bool,
    -- | One or more filters.
    --
    -- -   @availability-zone@ - The Availability Zone for the subnet. You can
    --     also use @availabilityZone@ as the filter name.
    --
    -- -   @availability-zone-id@ - The ID of the Availability Zone for the
    --     subnet. You can also use @availabilityZoneId@ as the filter name.
    --
    -- -   @available-ip-address-count@ - The number of IPv4 addresses in the
    --     subnet that are available.
    --
    -- -   @cidr-block@ - The IPv4 CIDR block of the subnet. The CIDR block you
    --     specify must exactly match the subnet\'s CIDR block for information
    --     to be returned for the subnet. You can also use @cidr@ or
    --     @cidrBlock@ as the filter names.
    --
    -- -   @customer-owned-ipv4-pool@ - The customer-owned IPv4 address pool
    --     associated with the subnet.
    --
    -- -   @default-for-az@ - Indicates whether this is the default subnet for
    --     the Availability Zone (@true@ | @false@). You can also use
    --     @defaultForAz@ as the filter name.
    --
    -- -   @enable-dns64@ - Indicates whether DNS queries made to the
    --     Amazon-provided DNS Resolver in this subnet should return synthetic
    --     IPv6 addresses for IPv4-only destinations.
    --
    -- -   @enable-lni-at-device-index@ - Indicates the device position for
    --     local network interfaces in this subnet. For example, @1@ indicates
    --     local network interfaces in this subnet are the secondary network
    --     interface (eth1).
    --
    -- -   @ipv6-cidr-block-association.ipv6-cidr-block@ - An IPv6 CIDR block
    --     associated with the subnet.
    --
    -- -   @ipv6-cidr-block-association.association-id@ - An association ID for
    --     an IPv6 CIDR block associated with the subnet.
    --
    -- -   @ipv6-cidr-block-association.state@ - The state of an IPv6 CIDR
    --     block associated with the subnet.
    --
    -- -   @ipv6-native@ - Indicates whether this is an IPv6 only subnet
    --     (@true@ | @false@).
    --
    -- -   @map-customer-owned-ip-on-launch@ - Indicates whether a network
    --     interface created in this subnet (including a network interface
    --     created by RunInstances) receives a customer-owned IPv4 address.
    --
    -- -   @map-public-ip-on-launch@ - Indicates whether instances launched in
    --     this subnet receive a public IPv4 address.
    --
    -- -   @outpost-arn@ - The Amazon Resource Name (ARN) of the Outpost.
    --
    -- -   @owner-id@ - The ID of the Amazon Web Services account that owns the
    --     subnet.
    --
    -- -   @private-dns-name-options-on-launch.hostname-type@ - The type of
    --     hostname to assign to instances in the subnet at launch. For
    --     IPv4-only and dual-stack (IPv4 and IPv6) subnets, an instance DNS
    --     name can be based on the instance IPv4 address (ip-name) or the
    --     instance ID (resource-name). For IPv6 only subnets, an instance DNS
    --     name must be based on the instance ID (resource-name).
    --
    -- -   @private-dns-name-options-on-launch.enable-resource-name-dns-a-record@
    --     - Indicates whether to respond to DNS queries for instance hostnames
    --     with DNS A records.
    --
    -- -   @private-dns-name-options-on-launch.enable-resource-name-dns-aaaa-record@
    --     - Indicates whether to respond to DNS queries for instance hostnames
    --     with DNS AAAA records.
    --
    -- -   @state@ - The state of the subnet (@pending@ | @available@).
    --
    -- -   @subnet-arn@ - The Amazon Resource Name (ARN) of the subnet.
    --
    -- -   @subnet-id@ - The ID of the subnet.
    --
    -- -   @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.
    --
    -- -   @vpc-id@ - The ID of the VPC for the subnet.
    DescribeSubnets -> Maybe [Filter]
filters :: Prelude.Maybe [Filter],
    -- | The maximum number of results to return with a single call. To retrieve
    -- the remaining results, make another call with the returned @nextToken@
    -- value.
    DescribeSubnets -> Maybe Natural
maxResults :: Prelude.Maybe Prelude.Natural,
    -- | The token for the next page of results.
    DescribeSubnets -> Maybe Text
nextToken :: Prelude.Maybe Prelude.Text,
    -- | One or more subnet IDs.
    --
    -- Default: Describes all your subnets.
    DescribeSubnets -> Maybe [Text]
subnetIds :: Prelude.Maybe [Prelude.Text]
  }
  deriving (DescribeSubnets -> DescribeSubnets -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: DescribeSubnets -> DescribeSubnets -> Bool
$c/= :: DescribeSubnets -> DescribeSubnets -> Bool
== :: DescribeSubnets -> DescribeSubnets -> Bool
$c== :: DescribeSubnets -> DescribeSubnets -> Bool
Prelude.Eq, ReadPrec [DescribeSubnets]
ReadPrec DescribeSubnets
Int -> ReadS DescribeSubnets
ReadS [DescribeSubnets]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [DescribeSubnets]
$creadListPrec :: ReadPrec [DescribeSubnets]
readPrec :: ReadPrec DescribeSubnets
$creadPrec :: ReadPrec DescribeSubnets
readList :: ReadS [DescribeSubnets]
$creadList :: ReadS [DescribeSubnets]
readsPrec :: Int -> ReadS DescribeSubnets
$creadsPrec :: Int -> ReadS DescribeSubnets
Prelude.Read, Int -> DescribeSubnets -> ShowS
[DescribeSubnets] -> ShowS
DescribeSubnets -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [DescribeSubnets] -> ShowS
$cshowList :: [DescribeSubnets] -> ShowS
show :: DescribeSubnets -> String
$cshow :: DescribeSubnets -> String
showsPrec :: Int -> DescribeSubnets -> ShowS
$cshowsPrec :: Int -> DescribeSubnets -> ShowS
Prelude.Show, forall x. Rep DescribeSubnets x -> DescribeSubnets
forall x. DescribeSubnets -> Rep DescribeSubnets x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep DescribeSubnets x -> DescribeSubnets
$cfrom :: forall x. DescribeSubnets -> Rep DescribeSubnets x
Prelude.Generic)

-- |
-- Create a value of 'DescribeSubnets' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'dryRun', 'describeSubnets_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@.
--
-- 'filters', 'describeSubnets_filters' - One or more filters.
--
-- -   @availability-zone@ - The Availability Zone for the subnet. You can
--     also use @availabilityZone@ as the filter name.
--
-- -   @availability-zone-id@ - The ID of the Availability Zone for the
--     subnet. You can also use @availabilityZoneId@ as the filter name.
--
-- -   @available-ip-address-count@ - The number of IPv4 addresses in the
--     subnet that are available.
--
-- -   @cidr-block@ - The IPv4 CIDR block of the subnet. The CIDR block you
--     specify must exactly match the subnet\'s CIDR block for information
--     to be returned for the subnet. You can also use @cidr@ or
--     @cidrBlock@ as the filter names.
--
-- -   @customer-owned-ipv4-pool@ - The customer-owned IPv4 address pool
--     associated with the subnet.
--
-- -   @default-for-az@ - Indicates whether this is the default subnet for
--     the Availability Zone (@true@ | @false@). You can also use
--     @defaultForAz@ as the filter name.
--
-- -   @enable-dns64@ - Indicates whether DNS queries made to the
--     Amazon-provided DNS Resolver in this subnet should return synthetic
--     IPv6 addresses for IPv4-only destinations.
--
-- -   @enable-lni-at-device-index@ - Indicates the device position for
--     local network interfaces in this subnet. For example, @1@ indicates
--     local network interfaces in this subnet are the secondary network
--     interface (eth1).
--
-- -   @ipv6-cidr-block-association.ipv6-cidr-block@ - An IPv6 CIDR block
--     associated with the subnet.
--
-- -   @ipv6-cidr-block-association.association-id@ - An association ID for
--     an IPv6 CIDR block associated with the subnet.
--
-- -   @ipv6-cidr-block-association.state@ - The state of an IPv6 CIDR
--     block associated with the subnet.
--
-- -   @ipv6-native@ - Indicates whether this is an IPv6 only subnet
--     (@true@ | @false@).
--
-- -   @map-customer-owned-ip-on-launch@ - Indicates whether a network
--     interface created in this subnet (including a network interface
--     created by RunInstances) receives a customer-owned IPv4 address.
--
-- -   @map-public-ip-on-launch@ - Indicates whether instances launched in
--     this subnet receive a public IPv4 address.
--
-- -   @outpost-arn@ - The Amazon Resource Name (ARN) of the Outpost.
--
-- -   @owner-id@ - The ID of the Amazon Web Services account that owns the
--     subnet.
--
-- -   @private-dns-name-options-on-launch.hostname-type@ - The type of
--     hostname to assign to instances in the subnet at launch. For
--     IPv4-only and dual-stack (IPv4 and IPv6) subnets, an instance DNS
--     name can be based on the instance IPv4 address (ip-name) or the
--     instance ID (resource-name). For IPv6 only subnets, an instance DNS
--     name must be based on the instance ID (resource-name).
--
-- -   @private-dns-name-options-on-launch.enable-resource-name-dns-a-record@
--     - Indicates whether to respond to DNS queries for instance hostnames
--     with DNS A records.
--
-- -   @private-dns-name-options-on-launch.enable-resource-name-dns-aaaa-record@
--     - Indicates whether to respond to DNS queries for instance hostnames
--     with DNS AAAA records.
--
-- -   @state@ - The state of the subnet (@pending@ | @available@).
--
-- -   @subnet-arn@ - The Amazon Resource Name (ARN) of the subnet.
--
-- -   @subnet-id@ - The ID of the subnet.
--
-- -   @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.
--
-- -   @vpc-id@ - The ID of the VPC for the subnet.
--
-- 'maxResults', 'describeSubnets_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.
--
-- 'nextToken', 'describeSubnets_nextToken' - The token for the next page of results.
--
-- 'subnetIds', 'describeSubnets_subnetIds' - One or more subnet IDs.
--
-- Default: Describes all your subnets.
newDescribeSubnets ::
  DescribeSubnets
newDescribeSubnets :: DescribeSubnets
newDescribeSubnets =
  DescribeSubnets'
    { $sel:dryRun:DescribeSubnets' :: Maybe Bool
dryRun = forall a. Maybe a
Prelude.Nothing,
      $sel:filters:DescribeSubnets' :: Maybe [Filter]
filters = forall a. Maybe a
Prelude.Nothing,
      $sel:maxResults:DescribeSubnets' :: Maybe Natural
maxResults = forall a. Maybe a
Prelude.Nothing,
      $sel:nextToken:DescribeSubnets' :: Maybe Text
nextToken = forall a. Maybe a
Prelude.Nothing,
      $sel:subnetIds:DescribeSubnets' :: Maybe [Text]
subnetIds = forall a. Maybe a
Prelude.Nothing
    }

-- | 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@.
describeSubnets_dryRun :: Lens.Lens' DescribeSubnets (Prelude.Maybe Prelude.Bool)
describeSubnets_dryRun :: Lens' DescribeSubnets (Maybe Bool)
describeSubnets_dryRun = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnets' {Maybe Bool
dryRun :: Maybe Bool
$sel:dryRun:DescribeSubnets' :: DescribeSubnets -> Maybe Bool
dryRun} -> Maybe Bool
dryRun) (\s :: DescribeSubnets
s@DescribeSubnets' {} Maybe Bool
a -> DescribeSubnets
s {$sel:dryRun:DescribeSubnets' :: Maybe Bool
dryRun = Maybe Bool
a} :: DescribeSubnets)

-- | One or more filters.
--
-- -   @availability-zone@ - The Availability Zone for the subnet. You can
--     also use @availabilityZone@ as the filter name.
--
-- -   @availability-zone-id@ - The ID of the Availability Zone for the
--     subnet. You can also use @availabilityZoneId@ as the filter name.
--
-- -   @available-ip-address-count@ - The number of IPv4 addresses in the
--     subnet that are available.
--
-- -   @cidr-block@ - The IPv4 CIDR block of the subnet. The CIDR block you
--     specify must exactly match the subnet\'s CIDR block for information
--     to be returned for the subnet. You can also use @cidr@ or
--     @cidrBlock@ as the filter names.
--
-- -   @customer-owned-ipv4-pool@ - The customer-owned IPv4 address pool
--     associated with the subnet.
--
-- -   @default-for-az@ - Indicates whether this is the default subnet for
--     the Availability Zone (@true@ | @false@). You can also use
--     @defaultForAz@ as the filter name.
--
-- -   @enable-dns64@ - Indicates whether DNS queries made to the
--     Amazon-provided DNS Resolver in this subnet should return synthetic
--     IPv6 addresses for IPv4-only destinations.
--
-- -   @enable-lni-at-device-index@ - Indicates the device position for
--     local network interfaces in this subnet. For example, @1@ indicates
--     local network interfaces in this subnet are the secondary network
--     interface (eth1).
--
-- -   @ipv6-cidr-block-association.ipv6-cidr-block@ - An IPv6 CIDR block
--     associated with the subnet.
--
-- -   @ipv6-cidr-block-association.association-id@ - An association ID for
--     an IPv6 CIDR block associated with the subnet.
--
-- -   @ipv6-cidr-block-association.state@ - The state of an IPv6 CIDR
--     block associated with the subnet.
--
-- -   @ipv6-native@ - Indicates whether this is an IPv6 only subnet
--     (@true@ | @false@).
--
-- -   @map-customer-owned-ip-on-launch@ - Indicates whether a network
--     interface created in this subnet (including a network interface
--     created by RunInstances) receives a customer-owned IPv4 address.
--
-- -   @map-public-ip-on-launch@ - Indicates whether instances launched in
--     this subnet receive a public IPv4 address.
--
-- -   @outpost-arn@ - The Amazon Resource Name (ARN) of the Outpost.
--
-- -   @owner-id@ - The ID of the Amazon Web Services account that owns the
--     subnet.
--
-- -   @private-dns-name-options-on-launch.hostname-type@ - The type of
--     hostname to assign to instances in the subnet at launch. For
--     IPv4-only and dual-stack (IPv4 and IPv6) subnets, an instance DNS
--     name can be based on the instance IPv4 address (ip-name) or the
--     instance ID (resource-name). For IPv6 only subnets, an instance DNS
--     name must be based on the instance ID (resource-name).
--
-- -   @private-dns-name-options-on-launch.enable-resource-name-dns-a-record@
--     - Indicates whether to respond to DNS queries for instance hostnames
--     with DNS A records.
--
-- -   @private-dns-name-options-on-launch.enable-resource-name-dns-aaaa-record@
--     - Indicates whether to respond to DNS queries for instance hostnames
--     with DNS AAAA records.
--
-- -   @state@ - The state of the subnet (@pending@ | @available@).
--
-- -   @subnet-arn@ - The Amazon Resource Name (ARN) of the subnet.
--
-- -   @subnet-id@ - The ID of the subnet.
--
-- -   @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.
--
-- -   @vpc-id@ - The ID of the VPC for the subnet.
describeSubnets_filters :: Lens.Lens' DescribeSubnets (Prelude.Maybe [Filter])
describeSubnets_filters :: Lens' DescribeSubnets (Maybe [Filter])
describeSubnets_filters = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnets' {Maybe [Filter]
filters :: Maybe [Filter]
$sel:filters:DescribeSubnets' :: DescribeSubnets -> Maybe [Filter]
filters} -> Maybe [Filter]
filters) (\s :: DescribeSubnets
s@DescribeSubnets' {} Maybe [Filter]
a -> DescribeSubnets
s {$sel:filters:DescribeSubnets' :: Maybe [Filter]
filters = Maybe [Filter]
a} :: DescribeSubnets) forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall (f :: * -> *) (g :: * -> *) s t a b.
(Functor f, Functor g) =>
AnIso s t a b -> Iso (f s) (g t) (f a) (g b)
Lens.mapping forall s t a b. (Coercible s a, Coercible t b) => Iso s t a b
Lens.coerced

-- | The maximum number of results to return with a single call. To retrieve
-- the remaining results, make another call with the returned @nextToken@
-- value.
describeSubnets_maxResults :: Lens.Lens' DescribeSubnets (Prelude.Maybe Prelude.Natural)
describeSubnets_maxResults :: Lens' DescribeSubnets (Maybe Natural)
describeSubnets_maxResults = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnets' {Maybe Natural
maxResults :: Maybe Natural
$sel:maxResults:DescribeSubnets' :: DescribeSubnets -> Maybe Natural
maxResults} -> Maybe Natural
maxResults) (\s :: DescribeSubnets
s@DescribeSubnets' {} Maybe Natural
a -> DescribeSubnets
s {$sel:maxResults:DescribeSubnets' :: Maybe Natural
maxResults = Maybe Natural
a} :: DescribeSubnets)

-- | The token for the next page of results.
describeSubnets_nextToken :: Lens.Lens' DescribeSubnets (Prelude.Maybe Prelude.Text)
describeSubnets_nextToken :: Lens' DescribeSubnets (Maybe Text)
describeSubnets_nextToken = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnets' {Maybe Text
nextToken :: Maybe Text
$sel:nextToken:DescribeSubnets' :: DescribeSubnets -> Maybe Text
nextToken} -> Maybe Text
nextToken) (\s :: DescribeSubnets
s@DescribeSubnets' {} Maybe Text
a -> DescribeSubnets
s {$sel:nextToken:DescribeSubnets' :: Maybe Text
nextToken = Maybe Text
a} :: DescribeSubnets)

-- | One or more subnet IDs.
--
-- Default: Describes all your subnets.
describeSubnets_subnetIds :: Lens.Lens' DescribeSubnets (Prelude.Maybe [Prelude.Text])
describeSubnets_subnetIds :: Lens' DescribeSubnets (Maybe [Text])
describeSubnets_subnetIds = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnets' {Maybe [Text]
subnetIds :: Maybe [Text]
$sel:subnetIds:DescribeSubnets' :: DescribeSubnets -> Maybe [Text]
subnetIds} -> Maybe [Text]
subnetIds) (\s :: DescribeSubnets
s@DescribeSubnets' {} Maybe [Text]
a -> DescribeSubnets
s {$sel:subnetIds:DescribeSubnets' :: Maybe [Text]
subnetIds = Maybe [Text]
a} :: DescribeSubnets) forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall (f :: * -> *) (g :: * -> *) s t a b.
(Functor f, Functor g) =>
AnIso s t a b -> Iso (f s) (g t) (f a) (g b)
Lens.mapping forall s t a b. (Coercible s a, Coercible t b) => Iso s t a b
Lens.coerced

instance Core.AWSPager DescribeSubnets where
  page :: DescribeSubnets
-> AWSResponse DescribeSubnets -> Maybe DescribeSubnets
page DescribeSubnets
rq AWSResponse DescribeSubnets
rs
    | forall a. AWSTruncated a => a -> Bool
Core.stop
        ( AWSResponse DescribeSubnets
rs
            forall s a. s -> Getting (First a) s a -> Maybe a
Lens.^? Lens' DescribeSubnetsResponse (Maybe Text)
describeSubnetsResponse_nextToken
            forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall a b. Prism (Maybe a) (Maybe b) a b
Lens._Just
        ) =
        forall a. Maybe a
Prelude.Nothing
    | forall a. AWSTruncated a => a -> Bool
Core.stop
        ( AWSResponse DescribeSubnets
rs
            forall s a. s -> Getting (First a) s a -> Maybe a
Lens.^? Lens' DescribeSubnetsResponse (Maybe [Subnet])
describeSubnetsResponse_subnets
            forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall a b. Prism (Maybe a) (Maybe b) a b
Lens._Just
        ) =
        forall a. Maybe a
Prelude.Nothing
    | Bool
Prelude.otherwise =
        forall a. a -> Maybe a
Prelude.Just
          forall a b. (a -> b) -> a -> b
Prelude.$ DescribeSubnets
rq
          forall a b. a -> (a -> b) -> b
Prelude.& Lens' DescribeSubnets (Maybe Text)
describeSubnets_nextToken
          forall s t a b. ASetter s t a b -> b -> s -> t
Lens..~ AWSResponse DescribeSubnets
rs
          forall s a. s -> Getting (First a) s a -> Maybe a
Lens.^? Lens' DescribeSubnetsResponse (Maybe Text)
describeSubnetsResponse_nextToken
          forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall a b. Prism (Maybe a) (Maybe b) a b
Lens._Just

instance Core.AWSRequest DescribeSubnets where
  type
    AWSResponse DescribeSubnets =
      DescribeSubnetsResponse
  request :: (Service -> Service) -> DescribeSubnets -> Request DescribeSubnets
request Service -> Service
overrides =
    forall a. ToRequest a => Service -> a -> Request a
Request.postQuery (Service -> Service
overrides Service
defaultService)
  response :: forall (m :: * -> *).
MonadResource m =>
(ByteStringLazy -> IO ByteStringLazy)
-> Service
-> Proxy DescribeSubnets
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse DescribeSubnets)))
response =
    forall (m :: * -> *) a.
MonadResource m =>
(Int -> ResponseHeaders -> [Node] -> Either String (AWSResponse a))
-> (ByteStringLazy -> IO ByteStringLazy)
-> Service
-> Proxy a
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse a)))
Response.receiveXML
      ( \Int
s ResponseHeaders
h [Node]
x ->
          Maybe Text -> Maybe [Subnet] -> Int -> DescribeSubnetsResponse
DescribeSubnetsResponse'
            forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> ([Node]
x forall a. FromXML a => [Node] -> Text -> Either String (Maybe a)
Data..@? Text
"nextToken")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> ( [Node]
x
                            forall a. FromXML a => [Node] -> Text -> Either String (Maybe a)
Data..@? Text
"subnetSet"
                            forall (f :: * -> *) a. Functor f => f (Maybe a) -> a -> f a
Core..!@ forall a. Monoid a => a
Prelude.mempty
                            forall (m :: * -> *) a b. Monad m => m a -> (a -> m b) -> m b
Prelude.>>= forall (f :: * -> *) a b.
Applicative f =>
([a] -> f b) -> [a] -> f (Maybe b)
Core.may (forall a. FromXML a => Text -> [Node] -> Either String [a]
Data.parseXMLList Text
"item")
                        )
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (forall (f :: * -> *) a. Applicative f => a -> f a
Prelude.pure (forall a. Enum a => a -> Int
Prelude.fromEnum Int
s))
      )

instance Prelude.Hashable DescribeSubnets where
  hashWithSalt :: Int -> DescribeSubnets -> Int
hashWithSalt Int
_salt DescribeSubnets' {Maybe Bool
Maybe Natural
Maybe [Text]
Maybe [Filter]
Maybe Text
subnetIds :: Maybe [Text]
nextToken :: Maybe Text
maxResults :: Maybe Natural
filters :: Maybe [Filter]
dryRun :: Maybe Bool
$sel:subnetIds:DescribeSubnets' :: DescribeSubnets -> Maybe [Text]
$sel:nextToken:DescribeSubnets' :: DescribeSubnets -> Maybe Text
$sel:maxResults:DescribeSubnets' :: DescribeSubnets -> Maybe Natural
$sel:filters:DescribeSubnets' :: DescribeSubnets -> Maybe [Filter]
$sel:dryRun:DescribeSubnets' :: DescribeSubnets -> Maybe Bool
..} =
    Int
_salt
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Bool
dryRun
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe [Filter]
filters
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Natural
maxResults
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
nextToken
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe [Text]
subnetIds

instance Prelude.NFData DescribeSubnets where
  rnf :: DescribeSubnets -> ()
rnf DescribeSubnets' {Maybe Bool
Maybe Natural
Maybe [Text]
Maybe [Filter]
Maybe Text
subnetIds :: Maybe [Text]
nextToken :: Maybe Text
maxResults :: Maybe Natural
filters :: Maybe [Filter]
dryRun :: Maybe Bool
$sel:subnetIds:DescribeSubnets' :: DescribeSubnets -> Maybe [Text]
$sel:nextToken:DescribeSubnets' :: DescribeSubnets -> Maybe Text
$sel:maxResults:DescribeSubnets' :: DescribeSubnets -> Maybe Natural
$sel:filters:DescribeSubnets' :: DescribeSubnets -> Maybe [Filter]
$sel:dryRun:DescribeSubnets' :: DescribeSubnets -> Maybe Bool
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe Bool
dryRun
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe [Filter]
filters
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Natural
maxResults
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
nextToken
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe [Text]
subnetIds

instance Data.ToHeaders DescribeSubnets where
  toHeaders :: DescribeSubnets -> ResponseHeaders
toHeaders = forall a b. a -> b -> a
Prelude.const forall a. Monoid a => a
Prelude.mempty

instance Data.ToPath DescribeSubnets where
  toPath :: DescribeSubnets -> ByteString
toPath = forall a b. a -> b -> a
Prelude.const ByteString
"/"

instance Data.ToQuery DescribeSubnets where
  toQuery :: DescribeSubnets -> QueryString
toQuery DescribeSubnets' {Maybe Bool
Maybe Natural
Maybe [Text]
Maybe [Filter]
Maybe Text
subnetIds :: Maybe [Text]
nextToken :: Maybe Text
maxResults :: Maybe Natural
filters :: Maybe [Filter]
dryRun :: Maybe Bool
$sel:subnetIds:DescribeSubnets' :: DescribeSubnets -> Maybe [Text]
$sel:nextToken:DescribeSubnets' :: DescribeSubnets -> Maybe Text
$sel:maxResults:DescribeSubnets' :: DescribeSubnets -> Maybe Natural
$sel:filters:DescribeSubnets' :: DescribeSubnets -> Maybe [Filter]
$sel:dryRun:DescribeSubnets' :: DescribeSubnets -> Maybe Bool
..} =
    forall a. Monoid a => [a] -> a
Prelude.mconcat
      [ ByteString
"Action"
          forall a. ToQuery a => ByteString -> a -> QueryString
Data.=: (ByteString
"DescribeSubnets" :: Prelude.ByteString),
        ByteString
"Version"
          forall a. ToQuery a => ByteString -> a -> QueryString
Data.=: (ByteString
"2016-11-15" :: Prelude.ByteString),
        ByteString
"DryRun" forall a. ToQuery a => ByteString -> a -> QueryString
Data.=: Maybe Bool
dryRun,
        forall a. ToQuery a => a -> QueryString
Data.toQuery
          (forall a.
(IsList a, ToQuery (Item a)) =>
ByteString -> a -> QueryString
Data.toQueryList ByteString
"Filter" forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe [Filter]
filters),
        ByteString
"MaxResults" forall a. ToQuery a => ByteString -> a -> QueryString
Data.=: Maybe Natural
maxResults,
        ByteString
"NextToken" forall a. ToQuery a => ByteString -> a -> QueryString
Data.=: Maybe Text
nextToken,
        forall a. ToQuery a => a -> QueryString
Data.toQuery
          (forall a.
(IsList a, ToQuery (Item a)) =>
ByteString -> a -> QueryString
Data.toQueryList ByteString
"SubnetId" forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe [Text]
subnetIds)
      ]

-- | /See:/ 'newDescribeSubnetsResponse' smart constructor.
data DescribeSubnetsResponse = DescribeSubnetsResponse'
  { -- | The token to use to retrieve the next page of results. This value is
    -- @null@ when there are no more results to return.
    DescribeSubnetsResponse -> Maybe Text
nextToken :: Prelude.Maybe Prelude.Text,
    -- | Information about one or more subnets.
    DescribeSubnetsResponse -> Maybe [Subnet]
subnets :: Prelude.Maybe [Subnet],
    -- | The response's http status code.
    DescribeSubnetsResponse -> Int
httpStatus :: Prelude.Int
  }
  deriving (DescribeSubnetsResponse -> DescribeSubnetsResponse -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: DescribeSubnetsResponse -> DescribeSubnetsResponse -> Bool
$c/= :: DescribeSubnetsResponse -> DescribeSubnetsResponse -> Bool
== :: DescribeSubnetsResponse -> DescribeSubnetsResponse -> Bool
$c== :: DescribeSubnetsResponse -> DescribeSubnetsResponse -> Bool
Prelude.Eq, ReadPrec [DescribeSubnetsResponse]
ReadPrec DescribeSubnetsResponse
Int -> ReadS DescribeSubnetsResponse
ReadS [DescribeSubnetsResponse]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [DescribeSubnetsResponse]
$creadListPrec :: ReadPrec [DescribeSubnetsResponse]
readPrec :: ReadPrec DescribeSubnetsResponse
$creadPrec :: ReadPrec DescribeSubnetsResponse
readList :: ReadS [DescribeSubnetsResponse]
$creadList :: ReadS [DescribeSubnetsResponse]
readsPrec :: Int -> ReadS DescribeSubnetsResponse
$creadsPrec :: Int -> ReadS DescribeSubnetsResponse
Prelude.Read, Int -> DescribeSubnetsResponse -> ShowS
[DescribeSubnetsResponse] -> ShowS
DescribeSubnetsResponse -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [DescribeSubnetsResponse] -> ShowS
$cshowList :: [DescribeSubnetsResponse] -> ShowS
show :: DescribeSubnetsResponse -> String
$cshow :: DescribeSubnetsResponse -> String
showsPrec :: Int -> DescribeSubnetsResponse -> ShowS
$cshowsPrec :: Int -> DescribeSubnetsResponse -> ShowS
Prelude.Show, forall x. Rep DescribeSubnetsResponse x -> DescribeSubnetsResponse
forall x. DescribeSubnetsResponse -> Rep DescribeSubnetsResponse x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep DescribeSubnetsResponse x -> DescribeSubnetsResponse
$cfrom :: forall x. DescribeSubnetsResponse -> Rep DescribeSubnetsResponse x
Prelude.Generic)

-- |
-- Create a value of 'DescribeSubnetsResponse' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'nextToken', 'describeSubnetsResponse_nextToken' - The token to use to retrieve the next page of results. This value is
-- @null@ when there are no more results to return.
--
-- 'subnets', 'describeSubnetsResponse_subnets' - Information about one or more subnets.
--
-- 'httpStatus', 'describeSubnetsResponse_httpStatus' - The response's http status code.
newDescribeSubnetsResponse ::
  -- | 'httpStatus'
  Prelude.Int ->
  DescribeSubnetsResponse
newDescribeSubnetsResponse :: Int -> DescribeSubnetsResponse
newDescribeSubnetsResponse Int
pHttpStatus_ =
  DescribeSubnetsResponse'
    { $sel:nextToken:DescribeSubnetsResponse' :: Maybe Text
nextToken =
        forall a. Maybe a
Prelude.Nothing,
      $sel:subnets:DescribeSubnetsResponse' :: Maybe [Subnet]
subnets = forall a. Maybe a
Prelude.Nothing,
      $sel:httpStatus:DescribeSubnetsResponse' :: Int
httpStatus = Int
pHttpStatus_
    }

-- | The token to use to retrieve the next page of results. This value is
-- @null@ when there are no more results to return.
describeSubnetsResponse_nextToken :: Lens.Lens' DescribeSubnetsResponse (Prelude.Maybe Prelude.Text)
describeSubnetsResponse_nextToken :: Lens' DescribeSubnetsResponse (Maybe Text)
describeSubnetsResponse_nextToken = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnetsResponse' {Maybe Text
nextToken :: Maybe Text
$sel:nextToken:DescribeSubnetsResponse' :: DescribeSubnetsResponse -> Maybe Text
nextToken} -> Maybe Text
nextToken) (\s :: DescribeSubnetsResponse
s@DescribeSubnetsResponse' {} Maybe Text
a -> DescribeSubnetsResponse
s {$sel:nextToken:DescribeSubnetsResponse' :: Maybe Text
nextToken = Maybe Text
a} :: DescribeSubnetsResponse)

-- | Information about one or more subnets.
describeSubnetsResponse_subnets :: Lens.Lens' DescribeSubnetsResponse (Prelude.Maybe [Subnet])
describeSubnetsResponse_subnets :: Lens' DescribeSubnetsResponse (Maybe [Subnet])
describeSubnetsResponse_subnets = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnetsResponse' {Maybe [Subnet]
subnets :: Maybe [Subnet]
$sel:subnets:DescribeSubnetsResponse' :: DescribeSubnetsResponse -> Maybe [Subnet]
subnets} -> Maybe [Subnet]
subnets) (\s :: DescribeSubnetsResponse
s@DescribeSubnetsResponse' {} Maybe [Subnet]
a -> DescribeSubnetsResponse
s {$sel:subnets:DescribeSubnetsResponse' :: Maybe [Subnet]
subnets = Maybe [Subnet]
a} :: DescribeSubnetsResponse) forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall (f :: * -> *) (g :: * -> *) s t a b.
(Functor f, Functor g) =>
AnIso s t a b -> Iso (f s) (g t) (f a) (g b)
Lens.mapping forall s t a b. (Coercible s a, Coercible t b) => Iso s t a b
Lens.coerced

-- | The response's http status code.
describeSubnetsResponse_httpStatus :: Lens.Lens' DescribeSubnetsResponse Prelude.Int
describeSubnetsResponse_httpStatus :: Lens' DescribeSubnetsResponse Int
describeSubnetsResponse_httpStatus = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DescribeSubnetsResponse' {Int
httpStatus :: Int
$sel:httpStatus:DescribeSubnetsResponse' :: DescribeSubnetsResponse -> Int
httpStatus} -> Int
httpStatus) (\s :: DescribeSubnetsResponse
s@DescribeSubnetsResponse' {} Int
a -> DescribeSubnetsResponse
s {$sel:httpStatus:DescribeSubnetsResponse' :: Int
httpStatus = Int
a} :: DescribeSubnetsResponse)

instance Prelude.NFData DescribeSubnetsResponse where
  rnf :: DescribeSubnetsResponse -> ()
rnf DescribeSubnetsResponse' {Int
Maybe [Subnet]
Maybe Text
httpStatus :: Int
subnets :: Maybe [Subnet]
nextToken :: Maybe Text
$sel:httpStatus:DescribeSubnetsResponse' :: DescribeSubnetsResponse -> Int
$sel:subnets:DescribeSubnetsResponse' :: DescribeSubnetsResponse -> Maybe [Subnet]
$sel:nextToken:DescribeSubnetsResponse' :: DescribeSubnetsResponse -> Maybe Text
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
nextToken
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe [Subnet]
subnets
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Int
httpStatus