Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Releases the specified Elastic IP address.
- EC2-Classic, default VPC
- Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.
We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide.
- Nondefault VPC
- You must use DisassociateAddress to disassociate the
Elastic IP address before you can release it. Otherwise, Amazon EC2
returns an error (
InvalidIPAddress.InUse
).
After releasing an Elastic IP address, it is released to the IP address
pool. Be sure to update your DNS records and any servers or devices that
communicate with the address. If you attempt to release an Elastic IP
address that you already released, you'll get an AuthFailure
error if
the address is already allocated to another Amazon Web Services account.
- EC2-VPC
- After you release an Elastic IP address for use in a VPC, you might be able to recover it. For more information, see AllocateAddress.
For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.
Synopsis
- data ReleaseAddress = ReleaseAddress' {}
- newReleaseAddress :: ReleaseAddress
- releaseAddress_allocationId :: Lens' ReleaseAddress (Maybe Text)
- releaseAddress_dryRun :: Lens' ReleaseAddress (Maybe Bool)
- releaseAddress_networkBorderGroup :: Lens' ReleaseAddress (Maybe Text)
- releaseAddress_publicIp :: Lens' ReleaseAddress (Maybe Text)
- data ReleaseAddressResponse = ReleaseAddressResponse' {
- newReleaseAddressResponse :: ReleaseAddressResponse
Creating a Request
data ReleaseAddress Source #
See: newReleaseAddress
smart constructor.
ReleaseAddress' | |
|
Instances
newReleaseAddress :: ReleaseAddress Source #
Create a value of ReleaseAddress
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:
ReleaseAddress
, releaseAddress_allocationId
- [EC2-VPC] The allocation ID. Required for EC2-VPC.
$sel:dryRun:ReleaseAddress'
, releaseAddress_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
.
ReleaseAddress
, releaseAddress_networkBorderGroup
- The set of Availability Zones, Local Zones, or Wavelength Zones from
which Amazon Web Services advertises IP addresses.
If you provide an incorrect network border group, you receive an
InvalidAddress.NotFound
error.
You cannot use a network border group with EC2 Classic. If you attempt
this operation on EC2 classic, you receive an
InvalidParameterCombination
error.
ReleaseAddress
, releaseAddress_publicIp
- [EC2-Classic] The Elastic IP address. Required for EC2-Classic.
Request Lenses
releaseAddress_allocationId :: Lens' ReleaseAddress (Maybe Text) Source #
- EC2-VPC
- The allocation ID. Required for EC2-VPC.
releaseAddress_dryRun :: Lens' ReleaseAddress (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
.
releaseAddress_networkBorderGroup :: Lens' ReleaseAddress (Maybe Text) Source #
The set of Availability Zones, Local Zones, or Wavelength Zones from which Amazon Web Services advertises IP addresses.
If you provide an incorrect network border group, you receive an
InvalidAddress.NotFound
error.
You cannot use a network border group with EC2 Classic. If you attempt
this operation on EC2 classic, you receive an
InvalidParameterCombination
error.
releaseAddress_publicIp :: Lens' ReleaseAddress (Maybe Text) Source #
- EC2-Classic
- The Elastic IP address. Required for EC2-Classic.
Destructuring the Response
data ReleaseAddressResponse Source #
See: newReleaseAddressResponse
smart constructor.
Instances
Generic ReleaseAddressResponse Source # | |
Defined in Amazonka.EC2.ReleaseAddress type Rep ReleaseAddressResponse :: Type -> Type # | |
Read ReleaseAddressResponse Source # | |
Show ReleaseAddressResponse Source # | |
Defined in Amazonka.EC2.ReleaseAddress showsPrec :: Int -> ReleaseAddressResponse -> ShowS # show :: ReleaseAddressResponse -> String # showList :: [ReleaseAddressResponse] -> ShowS # | |
NFData ReleaseAddressResponse Source # | |
Defined in Amazonka.EC2.ReleaseAddress rnf :: ReleaseAddressResponse -> () # | |
Eq ReleaseAddressResponse Source # | |
Defined in Amazonka.EC2.ReleaseAddress | |
type Rep ReleaseAddressResponse Source # | |
newReleaseAddressResponse :: ReleaseAddressResponse Source #
Create a value of ReleaseAddressResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.