Network.AWS.EC2.DescribeAddresses

Describes one or more of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide .

Creating a Request

describeAddresses :: DescribeAddresses

Creates a value of DescribeAddresses with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• daFilters - One or more filters. Filter names and values are case-sensitive. * allocation-id - [EC2-VPC] The allocation ID for the address. * association-id - [EC2-VPC] The association ID for the address. * domain - Indicates whether the address is for use in EC2-Classic (standard ) or in a VPC (vpc ). * instance-id - The ID of the instance the address is associated with, if any. * network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any. * network-interface-owner-id - The AWS account ID of the owner. * private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address. * public-ip - The Elastic IP address. * tag :key =value - The keyvalue combination of a tag assigned to the resource. Specify the key of the tag in the filter name and the value of the tag in the filter value. For example, for the tag Purpose=X, specify tag:Purpose for the filter name and X for the filter value. * tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter "tag-key=Purpose" and the filter "tag-value=X", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of the tag's key). If you want to list only resources where Purpose is X, see the tag :key =value/ filter.
• daPublicIPs - [EC2-Classic] One or more Elastic IP addresses. Default: Describes all your Elastic IP addresses.
• daAllocationIds - [EC2-VPC] One or more allocation IDs. Default: Describes all your Elastic IP addresses.
• daDryRun - 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 .

data DescribeAddresses

Contains the parameters for DescribeAddresses.

See: describeAddresses smart constructor.

Instances

Eq DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

(==) :: DescribeAddresses -> DescribeAddresses -> Bool

(/=) :: DescribeAddresses -> DescribeAddresses -> Bool

Data DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeAddresses -> c DescribeAddresses

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeAddresses

toConstr :: DescribeAddresses -> Constr

dataTypeOf :: DescribeAddresses -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c DescribeAddresses)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeAddresses)

gmapT :: (forall b. Data b => b -> b) -> DescribeAddresses -> DescribeAddresses

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeAddresses -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeAddresses -> r

gmapQ :: (forall d. Data d => d -> u) -> DescribeAddresses -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeAddresses -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeAddresses -> m DescribeAddresses

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeAddresses -> m DescribeAddresses

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeAddresses -> m DescribeAddresses

Read DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

readsPrec :: Int -> ReadS DescribeAddresses

readList :: ReadS [DescribeAddresses]

readPrec :: ReadPrec DescribeAddresses

readListPrec :: ReadPrec [DescribeAddresses]

Show DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

showsPrec :: Int -> DescribeAddresses -> ShowS

show :: DescribeAddresses -> String

showList :: [DescribeAddresses] -> ShowS

Generic DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Associated Types

type Rep DescribeAddresses :: Type -> Type

Methods

from :: DescribeAddresses -> Rep DescribeAddresses x

to :: Rep DescribeAddresses x -> DescribeAddresses

Hashable DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

hashWithSalt :: Int -> DescribeAddresses -> Int

hash :: DescribeAddresses -> Int

AWSRequest DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Associated Types

type Rs DescribeAddresses :: Type

Methods

request :: DescribeAddresses -> Request DescribeAddresses

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy DescribeAddresses -> ClientResponse -> m (Response DescribeAddresses)

ToHeaders DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

toHeaders :: DescribeAddresses -> [Header]

ToPath DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

toPath :: DescribeAddresses -> ByteString

ToQuery DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

toQuery :: DescribeAddresses -> QueryString

NFData DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

Methods

rnf :: DescribeAddresses -> ()

type Rep DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

type Rep DescribeAddresses = D1 (MetaData "DescribeAddresses" "Network.AWS.EC2.DescribeAddresses" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeAddresses'" PrefixI True) ((S1 (MetaSel (Just "_daFilters") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Filter])) :*: S1 (MetaSel (Just "_daPublicIPs") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text]))) :*: (S1 (MetaSel (Just "_daAllocationIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 (MetaSel (Just "_daDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)))))

type Rs DescribeAddresses

Defined in Network.AWS.EC2.DescribeAddresses

type Rs DescribeAddresses = DescribeAddressesResponse

Request Lenses

daFilters :: Lens' DescribeAddresses [Filter]

One or more filters. Filter names and values are case-sensitive. * allocation-id - [EC2-VPC] The allocation ID for the address. * association-id - [EC2-VPC] The association ID for the address. * domain - Indicates whether the address is for use in EC2-Classic (standard ) or in a VPC (vpc ). * instance-id - The ID of the instance the address is associated with, if any. * network-interface-id - [EC2-VPC] The ID of the network interface that the address is associated with, if any. * network-interface-owner-id - The AWS account ID of the owner. * private-ip-address - [EC2-VPC] The private IP address associated with the Elastic IP address. * public-ip - The Elastic IP address. * tag :key =value - The keyvalue combination of a tag assigned to the resource. Specify the key of the tag in the filter name and the value of the tag in the filter value. For example, for the tag Purpose=X, specify tag:Purpose for the filter name and X for the filter value. * tag-key - The key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter "tag-key=Purpose" and the filter "tag-value=X", you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of the tag's key). If you want to list only resources where Purpose is X, see the tag :key =value/ filter.

daPublicIPs :: Lens' DescribeAddresses [Text]

EC2-Classic

One or more Elastic IP addresses. Default: Describes all your Elastic IP addresses.

daAllocationIds :: Lens' DescribeAddresses [Text]

EC2-VPC

One or more allocation IDs. Default: Describes all your Elastic IP addresses.

daDryRun :: Lens' DescribeAddresses (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 .

Destructuring the Response

describeAddressesResponse

Arguments

:: Int

darsResponseStatus

-> DescribeAddressesResponse

Creates a value of DescribeAddressesResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• darsAddresses - Information about one or more Elastic IP addresses.
• darsResponseStatus - -- | The response status code.

data DescribeAddressesResponse

Contains the output of DescribeAddresses.

See: describeAddressesResponse smart constructor.

Instances

Eq DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

Methods

(==) :: DescribeAddressesResponse -> DescribeAddressesResponse -> Bool

(/=) :: DescribeAddressesResponse -> DescribeAddressesResponse -> Bool

Data DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribeAddressesResponse -> c DescribeAddressesResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribeAddressesResponse

toConstr :: DescribeAddressesResponse -> Constr

dataTypeOf :: DescribeAddressesResponse -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c DescribeAddressesResponse)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribeAddressesResponse)

gmapT :: (forall b. Data b => b -> b) -> DescribeAddressesResponse -> DescribeAddressesResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribeAddressesResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribeAddressesResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> DescribeAddressesResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribeAddressesResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribeAddressesResponse -> m DescribeAddressesResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeAddressesResponse -> m DescribeAddressesResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribeAddressesResponse -> m DescribeAddressesResponse

Read DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

Methods

readsPrec :: Int -> ReadS DescribeAddressesResponse

readList :: ReadS [DescribeAddressesResponse]

readPrec :: ReadPrec DescribeAddressesResponse

readListPrec :: ReadPrec [DescribeAddressesResponse]

Show DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

Methods

showsPrec :: Int -> DescribeAddressesResponse -> ShowS

show :: DescribeAddressesResponse -> String

showList :: [DescribeAddressesResponse] -> ShowS

Generic DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

Associated Types

type Rep DescribeAddressesResponse :: Type -> Type

Methods

from :: DescribeAddressesResponse -> Rep DescribeAddressesResponse x

to :: Rep DescribeAddressesResponse x -> DescribeAddressesResponse

NFData DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

Methods

rnf :: DescribeAddressesResponse -> ()

type Rep DescribeAddressesResponse

Defined in Network.AWS.EC2.DescribeAddresses

type Rep DescribeAddressesResponse = D1 (MetaData "DescribeAddressesResponse" "Network.AWS.EC2.DescribeAddresses" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "DescribeAddressesResponse'" PrefixI True) (S1 (MetaSel (Just "_darsAddresses") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Address])) :*: S1 (MetaSel (Just "_darsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

darsAddresses :: Lens' DescribeAddressesResponse [Address]

Information about one or more Elastic IP addresses.

darsResponseStatus :: Lens' DescribeAddressesResponse Int

• - | The response status code.