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

Description

Associates a FirewallPolicy to a Firewall.

A firewall policy defines how to monitor and manage your VPC network traffic, using a collection of inspection rule groups and other settings. Each firewall requires one firewall policy association, and you can use the same firewall policy for multiple firewalls.

Synopsis

Creating a Request

data AssociateFirewallPolicy Source #

See: newAssociateFirewallPolicy smart constructor.

Constructors

AssociateFirewallPolicy' 

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.

  • firewallPolicyArn :: Text

    The Amazon Resource Name (ARN) of the firewall policy.

Instances

Instances details
Eq AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Read AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Show AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Generic AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Associated Types

type Rep AssociateFirewallPolicy :: Type -> Type #

NFData AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Methods

rnf :: AssociateFirewallPolicy -> () #

Hashable AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

ToJSON AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

AWSRequest AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

ToHeaders AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

ToPath AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

ToQuery AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

type Rep AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

type Rep AssociateFirewallPolicy = D1 ('MetaData "AssociateFirewallPolicy" "Amazonka.NetworkFirewall.AssociateFirewallPolicy" "libZSservicesZSamazonka-network-firewallZSamazonka-network-firewall" 'False) (C1 ('MetaCons "AssociateFirewallPolicy'" '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 "firewallPolicyArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))
type AWSResponse AssociateFirewallPolicy Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

newAssociateFirewallPolicy Source #

Create a value of AssociateFirewallPolicy 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:AssociateFirewallPolicy', associateFirewallPolicy_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:AssociateFirewallPolicy', associateFirewallPolicy_firewallArn - The Amazon Resource Name (ARN) of the firewall.

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

$sel:firewallName:AssociateFirewallPolicy', associateFirewallPolicy_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:firewallPolicyArn:AssociateFirewallPolicy', associateFirewallPolicy_firewallPolicyArn - The Amazon Resource Name (ARN) of the firewall policy.

Request Lenses

associateFirewallPolicy_updateToken :: Lens' AssociateFirewallPolicy (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.

associateFirewallPolicy_firewallArn :: Lens' AssociateFirewallPolicy (Maybe Text) Source #

The Amazon Resource Name (ARN) of the firewall.

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

associateFirewallPolicy_firewallName :: Lens' AssociateFirewallPolicy (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.

associateFirewallPolicy_firewallPolicyArn :: Lens' AssociateFirewallPolicy Text Source #

The Amazon Resource Name (ARN) of the firewall policy.

Destructuring the Response

data AssociateFirewallPolicyResponse Source #

See: newAssociateFirewallPolicyResponse smart constructor.

Constructors

AssociateFirewallPolicyResponse' 

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.

  • firewallPolicyArn :: Maybe Text

    The Amazon Resource Name (ARN) of the firewall policy.

  • 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 AssociateFirewallPolicyResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Read AssociateFirewallPolicyResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Show AssociateFirewallPolicyResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Generic AssociateFirewallPolicyResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

Associated Types

type Rep AssociateFirewallPolicyResponse :: Type -> Type #

NFData AssociateFirewallPolicyResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

type Rep AssociateFirewallPolicyResponse Source # 
Instance details

Defined in Amazonka.NetworkFirewall.AssociateFirewallPolicy

type Rep AssociateFirewallPolicyResponse = D1 ('MetaData "AssociateFirewallPolicyResponse" "Amazonka.NetworkFirewall.AssociateFirewallPolicy" "libZSservicesZSamazonka-network-firewallZSamazonka-network-firewall" 'False) (C1 ('MetaCons "AssociateFirewallPolicyResponse'" '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 "firewallPolicyArn") '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)))))

newAssociateFirewallPolicyResponse Source #

Create a value of AssociateFirewallPolicyResponse 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:AssociateFirewallPolicy', associateFirewallPolicyResponse_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:AssociateFirewallPolicy', associateFirewallPolicyResponse_firewallArn - The Amazon Resource Name (ARN) of the firewall.

$sel:firewallPolicyArn:AssociateFirewallPolicy', associateFirewallPolicyResponse_firewallPolicyArn - The Amazon Resource Name (ARN) of the firewall policy.

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

$sel:httpStatus:AssociateFirewallPolicyResponse', associateFirewallPolicyResponse_httpStatus - The response's http status code.

Response Lenses

associateFirewallPolicyResponse_updateToken :: Lens' AssociateFirewallPolicyResponse (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.

associateFirewallPolicyResponse_firewallName :: Lens' AssociateFirewallPolicyResponse (Maybe Text) Source #

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