Interface CreateFirewallRequest.Builder
- All Superinterfaces:
AwsRequest.Builder,Buildable,CopyableBuilder<CreateFirewallRequest.Builder,,CreateFirewallRequest> NetworkFirewallRequest.Builder,SdkBuilder<CreateFirewallRequest.Builder,,CreateFirewallRequest> SdkPojo,SdkRequest.Builder
- Enclosing class:
CreateFirewallRequest
-
Method Summary
Modifier and TypeMethodDescriptionavailabilityZoneChangeProtection(Boolean availabilityZoneChangeProtection) Optional.availabilityZoneMappings(Collection<AvailabilityZoneMapping> availabilityZoneMappings) Required.availabilityZoneMappings(Consumer<AvailabilityZoneMapping.Builder>... availabilityZoneMappings) Required.availabilityZoneMappings(AvailabilityZoneMapping... availabilityZoneMappings) Required.deleteProtection(Boolean deleteProtection) A flag indicating whether it is possible to delete the firewall.description(String description) A description of the firewall.enabledAnalysisTypes(Collection<EnabledAnalysisType> enabledAnalysisTypes) An optional setting indicating the specific traffic analysis types to enable on the firewall.enabledAnalysisTypes(EnabledAnalysisType... enabledAnalysisTypes) An optional setting indicating the specific traffic analysis types to enable on the firewall.enabledAnalysisTypesWithStrings(String... enabledAnalysisTypes) An optional setting indicating the specific traffic analysis types to enable on the firewall.enabledAnalysisTypesWithStrings(Collection<String> enabledAnalysisTypes) An optional setting indicating the specific traffic analysis types to enable on the firewall.default CreateFirewallRequest.BuilderencryptionConfiguration(Consumer<EncryptionConfiguration.Builder> encryptionConfiguration) A complex type that contains settings for encryption of your firewall resources.encryptionConfiguration(EncryptionConfiguration encryptionConfiguration) A complex type that contains settings for encryption of your firewall resources.firewallName(String firewallName) The descriptive name of the firewall.firewallPolicyArn(String firewallPolicyArn) The Amazon Resource Name (ARN) of the FirewallPolicy that you want to use for the firewall.firewallPolicyChangeProtection(Boolean firewallPolicyChangeProtection) A setting indicating whether the firewall is protected against a change to the firewall policy association.natGatewayCreateMappings(Collection<NatGatewayCreateMapping> natGatewayCreateMappings) The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone.natGatewayCreateMappings(Consumer<NatGatewayCreateMapping.Builder>... natGatewayCreateMappings) The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone.natGatewayCreateMappings(NatGatewayCreateMapping... natGatewayCreateMappings) The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone.overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.default CreateFirewallRequest.BuilderproxySettings(Consumer<ProxySettings.Builder> proxySettings) The proxy settings for a proxy mode firewall: the ports and protocols on which the firewall's proxy listens for traffic, and optionally your own domain name and certificate.proxySettings(ProxySettings proxySettings) The proxy settings for a proxy mode firewall: the ports and protocols on which the firewall's proxy listens for traffic, and optionally your own domain name and certificate.subnetChangeProtection(Boolean subnetChangeProtection) A setting indicating whether the firewall is protected against changes to the subnet associations.subnetMappings(Collection<SubnetMapping> subnetMappings) The public subnets to use for your Network Firewall firewalls.subnetMappings(Consumer<SubnetMapping.Builder>... subnetMappings) The public subnets to use for your Network Firewall firewalls.subnetMappings(SubnetMapping... subnetMappings) The public subnets to use for your Network Firewall firewalls.tags(Collection<Tag> tags) The key:value pairs to associate with the resource.tags(Consumer<Tag.Builder>... tags) The key:value pairs to associate with the resource.The key:value pairs to associate with the resource.transitGatewayId(String transitGatewayId) Required when creating a transit gateway-attached firewall.transparentFilteringNatScope(String transparentFilteringNatScope) How a proxy mode firewall handles traffic that isn't sent to its proxy listener.transparentFilteringNatScope(TransparentFilteringNatScope transparentFilteringNatScope) How a proxy mode firewall handles traffic that isn't sent to its proxy listener.default CreateFirewallRequest.BuildervpcEndpoint(Consumer<VpcEndpoint.Builder> vpcEndpoint) The VPC and subnets for the endpoints of a proxy mode firewall.vpcEndpoint(VpcEndpoint vpcEndpoint) The VPC and subnets for the endpoints of a proxy mode firewall.The unique identifier of the VPC where Network Firewall should create the firewall.Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder
overrideConfigurationMethods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copyMethods inherited from interface software.amazon.awssdk.services.networkfirewall.model.NetworkFirewallRequest.Builder
buildMethods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, buildMethods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Method Details
-
firewallName
The descriptive name of the firewall. You can't change the name of a firewall after you create it.
- Parameters:
firewallName- The descriptive name of the firewall. You can't change the name of a firewall after you create it.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
firewallPolicyArn
The Amazon Resource Name (ARN) of the FirewallPolicy that you want to use for the firewall.
- Parameters:
firewallPolicyArn- The Amazon Resource Name (ARN) of the FirewallPolicy that you want to use for the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
vpcId
The unique identifier of the VPC where Network Firewall should create the firewall.
You can't change this setting after you create the firewall.
- Parameters:
vpcId- The unique identifier of the VPC where Network Firewall should create the firewall.You can't change this setting after you create the firewall.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subnetMappings
The public subnets to use for your Network Firewall firewalls. Each subnet must belong to a different Availability Zone in the VPC. Network Firewall creates a firewall endpoint in each subnet.
- Parameters:
subnetMappings- The public subnets to use for your Network Firewall firewalls. Each subnet must belong to a different Availability Zone in the VPC. Network Firewall creates a firewall endpoint in each subnet.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subnetMappings
The public subnets to use for your Network Firewall firewalls. Each subnet must belong to a different Availability Zone in the VPC. Network Firewall creates a firewall endpoint in each subnet.
- Parameters:
subnetMappings- The public subnets to use for your Network Firewall firewalls. Each subnet must belong to a different Availability Zone in the VPC. Network Firewall creates a firewall endpoint in each subnet.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subnetMappings
The public subnets to use for your Network Firewall firewalls. Each subnet must belong to a different Availability Zone in the VPC. Network Firewall creates a firewall endpoint in each subnet.
This is a convenience method that creates an instance of theSubnetMapping.Builderavoiding the need to create one manually viaSubnetMapping.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tosubnetMappings(List<SubnetMapping>).- Parameters:
subnetMappings- a consumer that will call methods onSubnetMapping.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
deleteProtection
A flag indicating whether it is possible to delete the firewall. A setting of
TRUEindicates that the firewall is protected against deletion. Use this setting to protect against accidentally deleting a firewall that is in use. When you create a firewall, the operation initializes this flag toTRUE.- Parameters:
deleteProtection- A flag indicating whether it is possible to delete the firewall. A setting ofTRUEindicates that the firewall is protected against deletion. Use this setting to protect against accidentally deleting a firewall that is in use. When you create a firewall, the operation initializes this flag toTRUE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subnetChangeProtection
A setting indicating whether the firewall is protected against changes to the subnet associations. Use this setting to protect against accidentally modifying the subnet associations for a firewall that is in use. When you create a firewall, the operation initializes this setting to
TRUE.- Parameters:
subnetChangeProtection- A setting indicating whether the firewall is protected against changes to the subnet associations. Use this setting to protect against accidentally modifying the subnet associations for a firewall that is in use. When you create a firewall, the operation initializes this setting toTRUE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
firewallPolicyChangeProtection
CreateFirewallRequest.Builder firewallPolicyChangeProtection(Boolean firewallPolicyChangeProtection) A setting indicating whether the firewall is protected against a change to the firewall policy association. Use this setting to protect against accidentally modifying the firewall policy for a firewall that is in use. When you create a firewall, the operation initializes this setting to
TRUE.- Parameters:
firewallPolicyChangeProtection- A setting indicating whether the firewall is protected against a change to the firewall policy association. Use this setting to protect against accidentally modifying the firewall policy for a firewall that is in use. When you create a firewall, the operation initializes this setting toTRUE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
description
A description of the firewall.
- Parameters:
description- A description of the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The key:value pairs to associate with the resource.
- Parameters:
tags- The key:value pairs to associate with the resource.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The key:value pairs to associate with the resource.
- Parameters:
tags- The key:value pairs to associate with the resource.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The key:value pairs to associate with the resource.
This is a convenience method that creates an instance of theTag.Builderavoiding the need to create one manually viaTag.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed totags(List<Tag>).- Parameters:
tags- a consumer that will call methods onTag.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
encryptionConfiguration
CreateFirewallRequest.Builder encryptionConfiguration(EncryptionConfiguration encryptionConfiguration) A complex type that contains settings for encryption of your firewall resources.
- Parameters:
encryptionConfiguration- A complex type that contains settings for encryption of your firewall resources.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encryptionConfiguration
default CreateFirewallRequest.Builder encryptionConfiguration(Consumer<EncryptionConfiguration.Builder> encryptionConfiguration) A complex type that contains settings for encryption of your firewall resources.
This is a convenience method that creates an instance of theEncryptionConfiguration.Builderavoiding the need to create one manually viaEncryptionConfiguration.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toencryptionConfiguration(EncryptionConfiguration).- Parameters:
encryptionConfiguration- a consumer that will call methods onEncryptionConfiguration.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
enabledAnalysisTypesWithStrings
CreateFirewallRequest.Builder enabledAnalysisTypesWithStrings(Collection<String> enabledAnalysisTypes) An optional setting indicating the specific traffic analysis types to enable on the firewall.
- Parameters:
enabledAnalysisTypes- An optional setting indicating the specific traffic analysis types to enable on the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
enabledAnalysisTypesWithStrings
An optional setting indicating the specific traffic analysis types to enable on the firewall.
- Parameters:
enabledAnalysisTypes- An optional setting indicating the specific traffic analysis types to enable on the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
enabledAnalysisTypes
CreateFirewallRequest.Builder enabledAnalysisTypes(Collection<EnabledAnalysisType> enabledAnalysisTypes) An optional setting indicating the specific traffic analysis types to enable on the firewall.
- Parameters:
enabledAnalysisTypes- An optional setting indicating the specific traffic analysis types to enable on the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
enabledAnalysisTypes
An optional setting indicating the specific traffic analysis types to enable on the firewall.
- Parameters:
enabledAnalysisTypes- An optional setting indicating the specific traffic analysis types to enable on the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
transitGatewayId
Required when creating a transit gateway-attached firewall. The unique identifier of the transit gateway to attach to this firewall. You can provide either a transit gateway from your account or one that has been shared with you through Resource Access Manager.
After creating the firewall, you cannot change the transit gateway association. To use a different transit gateway, you must create a new firewall.
For information about creating firewalls, see CreateFirewall. For specific guidance about transit gateway-attached firewalls, see Considerations for transit gateway-attached firewalls in the Network Firewall Developer Guide.
- Parameters:
transitGatewayId- Required when creating a transit gateway-attached firewall. The unique identifier of the transit gateway to attach to this firewall. You can provide either a transit gateway from your account or one that has been shared with you through Resource Access Manager.After creating the firewall, you cannot change the transit gateway association. To use a different transit gateway, you must create a new firewall.
For information about creating firewalls, see CreateFirewall. For specific guidance about transit gateway-attached firewalls, see Considerations for transit gateway-attached firewalls in the Network Firewall Developer Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
availabilityZoneMappings
CreateFirewallRequest.Builder availabilityZoneMappings(Collection<AvailabilityZoneMapping> availabilityZoneMappings) Required. The Availability Zones where you want to create firewall endpoints for a transit gateway-attached firewall. You must specify at least one Availability Zone. Consider enabling the firewall in every Availability Zone where you have workloads to maintain Availability Zone isolation.
You can modify Availability Zones later using AssociateAvailabilityZones or DisassociateAvailabilityZones, but this may briefly disrupt traffic. The
AvailabilityZoneChangeProtectionsetting controls whether you can make these modifications.- Parameters:
availabilityZoneMappings- Required. The Availability Zones where you want to create firewall endpoints for a transit gateway-attached firewall. You must specify at least one Availability Zone. Consider enabling the firewall in every Availability Zone where you have workloads to maintain Availability Zone isolation.You can modify Availability Zones later using AssociateAvailabilityZones or DisassociateAvailabilityZones, but this may briefly disrupt traffic. The
AvailabilityZoneChangeProtectionsetting controls whether you can make these modifications.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
availabilityZoneMappings
CreateFirewallRequest.Builder availabilityZoneMappings(AvailabilityZoneMapping... availabilityZoneMappings) Required. The Availability Zones where you want to create firewall endpoints for a transit gateway-attached firewall. You must specify at least one Availability Zone. Consider enabling the firewall in every Availability Zone where you have workloads to maintain Availability Zone isolation.
You can modify Availability Zones later using AssociateAvailabilityZones or DisassociateAvailabilityZones, but this may briefly disrupt traffic. The
AvailabilityZoneChangeProtectionsetting controls whether you can make these modifications.- Parameters:
availabilityZoneMappings- Required. The Availability Zones where you want to create firewall endpoints for a transit gateway-attached firewall. You must specify at least one Availability Zone. Consider enabling the firewall in every Availability Zone where you have workloads to maintain Availability Zone isolation.You can modify Availability Zones later using AssociateAvailabilityZones or DisassociateAvailabilityZones, but this may briefly disrupt traffic. The
AvailabilityZoneChangeProtectionsetting controls whether you can make these modifications.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
availabilityZoneMappings
CreateFirewallRequest.Builder availabilityZoneMappings(Consumer<AvailabilityZoneMapping.Builder>... availabilityZoneMappings) Required. The Availability Zones where you want to create firewall endpoints for a transit gateway-attached firewall. You must specify at least one Availability Zone. Consider enabling the firewall in every Availability Zone where you have workloads to maintain Availability Zone isolation.
You can modify Availability Zones later using AssociateAvailabilityZones or DisassociateAvailabilityZones, but this may briefly disrupt traffic. The
This is a convenience method that creates an instance of theAvailabilityZoneChangeProtectionsetting controls whether you can make these modifications.AvailabilityZoneMapping.Builderavoiding the need to create one manually viaAvailabilityZoneMapping.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toavailabilityZoneMappings(List<AvailabilityZoneMapping>).- Parameters:
availabilityZoneMappings- a consumer that will call methods onAvailabilityZoneMapping.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
availabilityZoneChangeProtection
CreateFirewallRequest.Builder availabilityZoneChangeProtection(Boolean availabilityZoneChangeProtection) Optional. A setting indicating whether the firewall is protected against changes to its Availability Zone configuration. When set to
TRUE, you cannot add or remove Availability Zones without first disabling this protection using UpdateAvailabilityZoneChangeProtection.Default value:
FALSE- Parameters:
availabilityZoneChangeProtection- Optional. A setting indicating whether the firewall is protected against changes to its Availability Zone configuration. When set toTRUE, you cannot add or remove Availability Zones without first disabling this protection using UpdateAvailabilityZoneChangeProtection.Default value:
FALSE- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
natGatewayCreateMappings
CreateFirewallRequest.Builder natGatewayCreateMappings(Collection<NatGatewayCreateMapping> natGatewayCreateMappings) The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone. When you specify this, you create a proxy mode firewall. Destinations see the IP address of the NAT gateway in the client's Availability Zone as the source of the traffic.
Specify one mapping for each Availability Zone in
VpcEndpoint, and no other Availability Zones. Each NAT gateway subnet must be in theVpcEndpointVPC and can't be one of the firewall endpoint subnets.You need permission to call the Amazon EC2
CreateNatGatewayaction.If Network Firewall can't set up an Availability Zone, for example because Amazon EC2 rejects the NAT gateway, it removes the Availability Zone from the firewall. It also deletes the NAT gateway that it created there. The Availability Zone's
Attachmentstatus isFAILED, and its status message explains why. You can add the Availability Zone again withAssociateSubnets. If no Availability Zone can be set up, the firewall status isFAILED.- Parameters:
natGatewayCreateMappings- The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone. When you specify this, you create a proxy mode firewall. Destinations see the IP address of the NAT gateway in the client's Availability Zone as the source of the traffic.Specify one mapping for each Availability Zone in
VpcEndpoint, and no other Availability Zones. Each NAT gateway subnet must be in theVpcEndpointVPC and can't be one of the firewall endpoint subnets.You need permission to call the Amazon EC2
CreateNatGatewayaction.If Network Firewall can't set up an Availability Zone, for example because Amazon EC2 rejects the NAT gateway, it removes the Availability Zone from the firewall. It also deletes the NAT gateway that it created there. The Availability Zone's
Attachmentstatus isFAILED, and its status message explains why. You can add the Availability Zone again withAssociateSubnets. If no Availability Zone can be set up, the firewall status isFAILED.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
natGatewayCreateMappings
CreateFirewallRequest.Builder natGatewayCreateMappings(NatGatewayCreateMapping... natGatewayCreateMappings) The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone. When you specify this, you create a proxy mode firewall. Destinations see the IP address of the NAT gateway in the client's Availability Zone as the source of the traffic.
Specify one mapping for each Availability Zone in
VpcEndpoint, and no other Availability Zones. Each NAT gateway subnet must be in theVpcEndpointVPC and can't be one of the firewall endpoint subnets.You need permission to call the Amazon EC2
CreateNatGatewayaction.If Network Firewall can't set up an Availability Zone, for example because Amazon EC2 rejects the NAT gateway, it removes the Availability Zone from the firewall. It also deletes the NAT gateway that it created there. The Availability Zone's
Attachmentstatus isFAILED, and its status message explains why. You can add the Availability Zone again withAssociateSubnets. If no Availability Zone can be set up, the firewall status isFAILED.- Parameters:
natGatewayCreateMappings- The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone. When you specify this, you create a proxy mode firewall. Destinations see the IP address of the NAT gateway in the client's Availability Zone as the source of the traffic.Specify one mapping for each Availability Zone in
VpcEndpoint, and no other Availability Zones. Each NAT gateway subnet must be in theVpcEndpointVPC and can't be one of the firewall endpoint subnets.You need permission to call the Amazon EC2
CreateNatGatewayaction.If Network Firewall can't set up an Availability Zone, for example because Amazon EC2 rejects the NAT gateway, it removes the Availability Zone from the firewall. It also deletes the NAT gateway that it created there. The Availability Zone's
Attachmentstatus isFAILED, and its status message explains why. You can add the Availability Zone again withAssociateSubnets. If no Availability Zone can be set up, the firewall status isFAILED.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
natGatewayCreateMappings
CreateFirewallRequest.Builder natGatewayCreateMappings(Consumer<NatGatewayCreateMapping.Builder>... natGatewayCreateMappings) The NAT gateways that Network Firewall creates for a proxy mode firewall, one for each Availability Zone. When you specify this, you create a proxy mode firewall. Destinations see the IP address of the NAT gateway in the client's Availability Zone as the source of the traffic.
Specify one mapping for each Availability Zone in
VpcEndpoint, and no other Availability Zones. Each NAT gateway subnet must be in theVpcEndpointVPC and can't be one of the firewall endpoint subnets.You need permission to call the Amazon EC2
CreateNatGatewayaction.If Network Firewall can't set up an Availability Zone, for example because Amazon EC2 rejects the NAT gateway, it removes the Availability Zone from the firewall. It also deletes the NAT gateway that it created there. The Availability Zone's
This is a convenience method that creates an instance of theAttachmentstatus isFAILED, and its status message explains why. You can add the Availability Zone again withAssociateSubnets. If no Availability Zone can be set up, the firewall status isFAILED.NatGatewayCreateMapping.Builderavoiding the need to create one manually viaNatGatewayCreateMapping.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tonatGatewayCreateMappings(List<NatGatewayCreateMapping>).- Parameters:
natGatewayCreateMappings- a consumer that will call methods onNatGatewayCreateMapping.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
proxySettings
The proxy settings for a proxy mode firewall: the ports and protocols on which the firewall's proxy listens for traffic, and optionally your own domain name and certificate. If you don't specify listeners, the firewall listens for HTTP on port 3128 and HTTPS on port 8443.
To change the listeners later, use
UpdateProxySettings.- Parameters:
proxySettings- The proxy settings for a proxy mode firewall: the ports and protocols on which the firewall's proxy listens for traffic, and optionally your own domain name and certificate. If you don't specify listeners, the firewall listens for HTTP on port 3128 and HTTPS on port 8443.To change the listeners later, use
UpdateProxySettings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
proxySettings
The proxy settings for a proxy mode firewall: the ports and protocols on which the firewall's proxy listens for traffic, and optionally your own domain name and certificate. If you don't specify listeners, the firewall listens for HTTP on port 3128 and HTTPS on port 8443.
To change the listeners later, use
This is a convenience method that creates an instance of theUpdateProxySettings.ProxySettings.Builderavoiding the need to create one manually viaProxySettings.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toproxySettings(ProxySettings).- Parameters:
proxySettings- a consumer that will call methods onProxySettings.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
vpcEndpoint
The VPC and subnets for the endpoints of a proxy mode firewall. Network Firewall creates a firewall endpoint in each subnet that you specify. It also creates the firewall's NAT gateways in this VPC, in the subnets that you specify in
NatGatewayCreateMappings.To create a proxy mode firewall, you must specify
VpcEndpointandNatGatewayCreateMappings, and you must not specify the top-levelVpcIdandSubnetMappings. Specify one subnet for each Availability Zone where you want to use the firewall.- Parameters:
vpcEndpoint- The VPC and subnets for the endpoints of a proxy mode firewall. Network Firewall creates a firewall endpoint in each subnet that you specify. It also creates the firewall's NAT gateways in this VPC, in the subnets that you specify inNatGatewayCreateMappings.To create a proxy mode firewall, you must specify
VpcEndpointandNatGatewayCreateMappings, and you must not specify the top-levelVpcIdandSubnetMappings. Specify one subnet for each Availability Zone where you want to use the firewall.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
vpcEndpoint
The VPC and subnets for the endpoints of a proxy mode firewall. Network Firewall creates a firewall endpoint in each subnet that you specify. It also creates the firewall's NAT gateways in this VPC, in the subnets that you specify in
NatGatewayCreateMappings.To create a proxy mode firewall, you must specify
This is a convenience method that creates an instance of theVpcEndpointandNatGatewayCreateMappings, and you must not specify the top-levelVpcIdandSubnetMappings. Specify one subnet for each Availability Zone where you want to use the firewall.VpcEndpoint.Builderavoiding the need to create one manually viaVpcEndpoint.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tovpcEndpoint(VpcEndpoint).- Parameters:
vpcEndpoint- a consumer that will call methods onVpcEndpoint.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
transparentFilteringNatScope
How a proxy mode firewall handles traffic that isn't sent to its proxy listener. If you don't specify a value, the firewall uses
NAT_ALL. You can choose from the following values:-
NAT_ALL- After inspection, the firewall sends this traffic out through its NAT gateway, which translates the source address. -
NAT_NONE- After inspection, the firewall returns this traffic to the firewall endpoint without address translation.
You can specify this only for a proxy mode firewall, and you can't change it after you create the firewall.
- Parameters:
transparentFilteringNatScope- How a proxy mode firewall handles traffic that isn't sent to its proxy listener. If you don't specify a value, the firewall usesNAT_ALL. You can choose from the following values:-
NAT_ALL- After inspection, the firewall sends this traffic out through its NAT gateway, which translates the source address. -
NAT_NONE- After inspection, the firewall returns this traffic to the firewall endpoint without address translation.
You can specify this only for a proxy mode firewall, and you can't change it after you create the firewall.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
transparentFilteringNatScope
CreateFirewallRequest.Builder transparentFilteringNatScope(TransparentFilteringNatScope transparentFilteringNatScope) How a proxy mode firewall handles traffic that isn't sent to its proxy listener. If you don't specify a value, the firewall uses
NAT_ALL. You can choose from the following values:-
NAT_ALL- After inspection, the firewall sends this traffic out through its NAT gateway, which translates the source address. -
NAT_NONE- After inspection, the firewall returns this traffic to the firewall endpoint without address translation.
You can specify this only for a proxy mode firewall, and you can't change it after you create the firewall.
- Parameters:
transparentFilteringNatScope- How a proxy mode firewall handles traffic that isn't sent to its proxy listener. If you don't specify a value, the firewall usesNAT_ALL. You can choose from the following values:-
NAT_ALL- After inspection, the firewall sends this traffic out through its NAT gateway, which translates the source address. -
NAT_NONE- After inspection, the firewall returns this traffic to the firewall endpoint without address translation.
You can specify this only for a proxy mode firewall, and you can't change it after you create the firewall.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
overrideConfiguration
CreateFirewallRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Description copied from interface:AwsRequest.BuilderAdd an optional request override configuration.- Specified by:
overrideConfigurationin interfaceAwsRequest.Builder- Parameters:
overrideConfiguration- The override configuration.- Returns:
- This object for method chaining.
-
overrideConfiguration
CreateFirewallRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Description copied from interface:AwsRequest.BuilderAdd an optional request override configuration.- Specified by:
overrideConfigurationin interfaceAwsRequest.Builder- Parameters:
builderConsumer- AConsumerto which an emptyAwsRequestOverrideConfiguration.Builderwill be given.- Returns:
- This object for method chaining.
-