amazonka-network-firewall-2.0: Amazon Network Firewall 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.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

  • 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.

  • 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.

  • subnetIds :: [Text]

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

Instances

Instances details
ToJSON DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.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

AWSRequest DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Associated Types

type AWSResponse DisassociateSubnets #

Generic DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Associated Types

type Rep DisassociateSubnets :: Type -> Type #

Read DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Show DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

NFData DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Methods

rnf :: DisassociateSubnets -> () #

Eq DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Hashable DisassociateSubnets Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

type AWSResponse 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" "amazonka-network-firewall-2.0-4y6HybZBSNcEwGPO5AYVfm" 'False) (C1 ('MetaCons "DisassociateSubnets'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "firewallArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "firewallName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "updateToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "subnetIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text]))))

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:

DisassociateSubnets, disassociateSubnets_firewallArn - The Amazon Resource Name (ARN) of the firewall.

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

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.

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:subnetIds:DisassociateSubnets', disassociateSubnets_subnetIds - The unique identifiers for the subnets that you want to disassociate.

Request Lenses

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_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_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

  • 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.

  • 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.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Generic DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Associated Types

type Rep DisassociateSubnetsResponse :: Type -> Type #

Read DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Show DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

NFData DisassociateSubnetsResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.DisassociateSubnets

Eq 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" "amazonka-network-firewall-2.0-4y6HybZBSNcEwGPO5AYVfm" 'False) (C1 ('MetaCons "DisassociateSubnetsResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "firewallArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "firewallName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "subnetMappings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [SubnetMapping])) :*: (S1 ('MetaSel ('Just "updateToken") '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:

DisassociateSubnets, disassociateSubnetsResponse_firewallArn - The Amazon Resource Name (ARN) of the firewall.

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

DisassociateSubnetsResponse, disassociateSubnetsResponse_subnetMappings - The IDs of the subnets that are associated with the firewall.

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:httpStatus:DisassociateSubnetsResponse', disassociateSubnetsResponse_httpStatus - The response's http status code.

Response Lenses

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.

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.