libZSservicesZSamazonka-network-firewallZSamazonka-network-firewall
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.NetworkFirewall.DisassociateSubnets

Description

Removes the specified subnet associations from the firewall. This removes the firewall endpoints from the subnets and removes any network filtering protections that the endpoints were providing.

Synopsis

Creating a Request

data DisassociateSubnets Source #

See: newDisassociateSubnets smart constructor.

Constructors

DisassociateSubnets' 

Fields

  • updateToken :: Maybe Text

    An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request.

    To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.

    To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

  • firewallArn :: Maybe Text

    The Amazon Resource Name (ARN) of the firewall.

    You must specify the ARN or the name, and you can specify both.

  • firewallName :: Maybe Text

    The descriptive name of the firewall. You can't change the name of a firewall after you create it.

    You must specify the ARN or the name, and you can specify both.

  • subnetIds :: [Text]

    The unique identifiers for the subnets that you want to disassociate.

Instances

Instances details
Eq DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Read DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Show DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Generic DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Associated Types

type Rep DisassociateSubnets :: Type -> Type #

NFData DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Methods

rnf :: DisassociateSubnets -> () #

Hashable DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

ToJSON DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

AWSRequest DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Associated Types

type AWSResponse DisassociateSubnets #

ToHeaders DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

ToPath DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

ToQuery DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

type Rep DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

type Rep DisassociateSubnets = D1 ('MetaData "DisassociateSubnets" "Amazonka.NetworkFirewall.DisassociateSubnets" "libZSservicesZSamazonka-network-firewallZSamazonka-network-firewall" 'False) (C1 ('MetaCons "DisassociateSubnets'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "updateToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "firewallArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "firewallName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "subnetIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text]))))
type AWSResponse DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

newDisassociateSubnets :: DisassociateSubnets Source #

Create a value of DisassociateSubnets 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:updateToken:DisassociateSubnets', disassociateSubnets_updateToken - An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request.

To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.

To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

$sel:firewallArn:DisassociateSubnets', disassociateSubnets_firewallArn - The Amazon Resource Name (ARN) of the firewall.

You must specify the ARN or the name, and you can specify both.

$sel:firewallName:DisassociateSubnets', disassociateSubnets_firewallName - The descriptive name of the firewall. You can't change the name of a firewall after you create it.

You must specify the ARN or the name, and you can specify both.

$sel:subnetIds:DisassociateSubnets', disassociateSubnets_subnetIds - The unique identifiers for the subnets that you want to disassociate.

Request Lenses

disassociateSubnets_updateToken :: Lens' DisassociateSubnets (Maybe Text) Source #

An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request.

To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.

To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

disassociateSubnets_firewallArn :: Lens' DisassociateSubnets (Maybe Text) Source #

The Amazon Resource Name (ARN) of the firewall.

You must specify the ARN or the name, and you can specify both.

disassociateSubnets_firewallName :: Lens' DisassociateSubnets (Maybe Text) Source #

The descriptive name of the firewall. You can't change the name of a firewall after you create it.

You must specify the ARN or the name, and you can specify both.

disassociateSubnets_subnetIds :: Lens' DisassociateSubnets [Text] Source #

The unique identifiers for the subnets that you want to disassociate.

Destructuring the Response

data DisassociateSubnetsResponse Source #

See: newDisassociateSubnetsResponse smart constructor.

Constructors

DisassociateSubnetsResponse' 

Fields

  • subnetMappings :: Maybe [SubnetMapping]

    The IDs of the subnets that are associated with the firewall.

  • updateToken :: Maybe Text

    An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request.

    To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.

    To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

  • firewallArn :: Maybe Text

    The Amazon Resource Name (ARN) of the firewall.

  • firewallName :: Maybe Text

    The descriptive name of the firewall. You can't change the name of a firewall after you create it.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Read DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Show DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Generic DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Associated Types

type Rep DisassociateSubnetsResponse :: Type -> Type #

NFData DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

type Rep DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

type Rep DisassociateSubnetsResponse = D1 ('MetaData "DisassociateSubnetsResponse" "Amazonka.NetworkFirewall.DisassociateSubnets" "libZSservicesZSamazonka-network-firewallZSamazonka-network-firewall" 'False) (C1 ('MetaCons "DisassociateSubnetsResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "subnetMappings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [SubnetMapping])) :*: S1 ('MetaSel ('Just "updateToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "firewallArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "firewallName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newDisassociateSubnetsResponse Source #

Create a value of DisassociateSubnetsResponse 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:subnetMappings:DisassociateSubnetsResponse', disassociateSubnetsResponse_subnetMappings - The IDs of the subnets that are associated with the firewall.

$sel:updateToken:DisassociateSubnets', disassociateSubnetsResponse_updateToken - An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request.

To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.

To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

$sel:firewallArn:DisassociateSubnets', disassociateSubnetsResponse_firewallArn - The Amazon Resource Name (ARN) of the firewall.

$sel:firewallName:DisassociateSubnets', disassociateSubnetsResponse_firewallName - The descriptive name of the firewall. You can't change the name of a firewall after you create it.

$sel:httpStatus:DisassociateSubnetsResponse', disassociateSubnetsResponse_httpStatus - The response's http status code.

Response Lenses

disassociateSubnetsResponse_subnetMappings :: Lens' DisassociateSubnetsResponse (Maybe [SubnetMapping]) Source #

The IDs of the subnets that are associated with the firewall.

disassociateSubnetsResponse_updateToken :: Lens' DisassociateSubnetsResponse (Maybe Text) Source #

An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request.

To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.

To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

disassociateSubnetsResponse_firewallArn :: Lens' DisassociateSubnetsResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the firewall.

disassociateSubnetsResponse_firewallName :: Lens' DisassociateSubnetsResponse (Maybe Text) Source #

The descriptive name of the firewall. You can't change the name of a firewall after you create it.