Interface NetworkFirewallAsyncClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient
supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in
some cases such as credentials retrieval and endpoint discovery as part of the async API call.
This is the API Reference for Network Firewall. This guide is for developers who need detailed information about the Network Firewall API actions, data types, and errors.
The REST API requires you to handle connection details, such as calculating signatures, handling request retries, and error handling. For general information about using the Amazon Web Services REST APIs, see Amazon Web Services APIs.
To view the complete list of Amazon Web Services Regions where Network Firewall is available, see Service endpoints and quotas in the Amazon Web Services General Reference.
To access Network Firewall using the IPv4 REST API endpoint:
https://network-firewall.<region>.amazonaws.com
To access Network Firewall using the Dualstack (IPv4 and IPv6) REST API endpoint:
https://network-firewall.<region>.aws.api
Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the programming language or platform that you're using. For more information, see Amazon Web Services SDKs.
For descriptions of Network Firewall features, including and step-by-step instructions on how to use them through the Network Firewall console, see the Network Firewall Developer Guide.
Network Firewall is a stateful, managed, network firewall and intrusion detection and prevention service for Amazon Virtual Private Cloud (Amazon VPC). With Network Firewall, you can filter traffic at the perimeter of your VPC. This includes filtering traffic going to and coming from an internet gateway, NAT gateway, or over VPN or Direct Connect. Network Firewall uses rules that are compatible with Suricata, a free, open source network analysis and threat detection engine. Network Firewall supports Suricata version 7.0.3. For information about Suricata, see the Suricata website and the Suricata User Guide.
You can use Network Firewall to monitor and protect your VPC traffic in a number of ways. The following are just a few examples:
-
Allow domains or IP addresses for known Amazon Web Services service endpoints, such as Amazon S3, and block all other forms of traffic.
-
Use custom lists of known bad domains to limit the types of domain names that your applications can access.
-
Perform deep packet inspection on traffic entering or leaving your VPC.
-
Use stateful protocol detection to filter protocols like HTTPS, regardless of the port used.
To enable Network Firewall for your VPCs, you perform steps in both Amazon VPC and in Network Firewall. For information about using Amazon VPC, see Amazon VPC User Guide.
To start using Network Firewall, do the following:
-
(Optional) If you don't already have a VPC that you want to protect, create it in Amazon VPC.
-
In Amazon VPC, in each Availability Zone where you want to have a firewall endpoint, create a subnet for the sole use of Network Firewall.
-
In Network Firewall, define the firewall behavior as follows:
-
Create stateless and stateful rule groups, to define the components of the network traffic filtering behavior that you want your firewall to have.
-
Create a firewall policy that uses your rule groups and specifies additional default traffic filtering behavior.
-
-
In Network Firewall, create a firewall and specify your new firewall policy and VPC subnets. Network Firewall creates a firewall endpoint in each subnet that you specify, with the behavior that's defined in the firewall policy.
-
In Amazon VPC, use ingress routing enhancements to route traffic through the new firewall endpoints.
After your firewall is established, you can add firewall endpoints for new Availability Zones by following the prior steps for the Amazon VPC setup and firewall subnet definitions. You can also add endpoints to Availability Zones that you're using in the firewall, either for the same VPC or for another VPC, by following the prior steps for the Amazon VPC setup, and defining the new VPC subnets as VPC endpoint associations.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionacceptNetworkFirewallTransitGatewayAttachment
(Consumer<AcceptNetworkFirewallTransitGatewayAttachmentRequest.Builder> acceptNetworkFirewallTransitGatewayAttachmentRequest) Accepts a transit gateway attachment request for Network Firewall.acceptNetworkFirewallTransitGatewayAttachment
(AcceptNetworkFirewallTransitGatewayAttachmentRequest acceptNetworkFirewallTransitGatewayAttachmentRequest) Accepts a transit gateway attachment request for Network Firewall.associateAvailabilityZones
(Consumer<AssociateAvailabilityZonesRequest.Builder> associateAvailabilityZonesRequest) Associates the specified Availability Zones with a transit gateway-attached firewall.associateAvailabilityZones
(AssociateAvailabilityZonesRequest associateAvailabilityZonesRequest) Associates the specified Availability Zones with a transit gateway-attached firewall.associateFirewallPolicy
(Consumer<AssociateFirewallPolicyRequest.Builder> associateFirewallPolicyRequest) Associates a FirewallPolicy to a Firewall.associateFirewallPolicy
(AssociateFirewallPolicyRequest associateFirewallPolicyRequest) Associates a FirewallPolicy to a Firewall.associateSubnets
(Consumer<AssociateSubnetsRequest.Builder> associateSubnetsRequest) Associates the specified subnets in the Amazon VPC to the firewall.associateSubnets
(AssociateSubnetsRequest associateSubnetsRequest) Associates the specified subnets in the Amazon VPC to the firewall.builder()
Create a builder that can be used to configure and create aNetworkFirewallAsyncClient
.static NetworkFirewallAsyncClient
create()
Create aNetworkFirewallAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default CompletableFuture
<CreateFirewallResponse> createFirewall
(Consumer<CreateFirewallRequest.Builder> createFirewallRequest) Creates an Network Firewall Firewall and accompanying FirewallStatus for a VPC.default CompletableFuture
<CreateFirewallResponse> createFirewall
(CreateFirewallRequest createFirewallRequest) Creates an Network Firewall Firewall and accompanying FirewallStatus for a VPC.createFirewallPolicy
(Consumer<CreateFirewallPolicyRequest.Builder> createFirewallPolicyRequest) Creates the firewall policy for the firewall according to the specifications.createFirewallPolicy
(CreateFirewallPolicyRequest createFirewallPolicyRequest) Creates the firewall policy for the firewall according to the specifications.default CompletableFuture
<CreateRuleGroupResponse> createRuleGroup
(Consumer<CreateRuleGroupRequest.Builder> createRuleGroupRequest) Creates the specified stateless or stateful rule group, which includes the rules for network traffic inspection, a capacity setting, and tags.default CompletableFuture
<CreateRuleGroupResponse> createRuleGroup
(CreateRuleGroupRequest createRuleGroupRequest) Creates the specified stateless or stateful rule group, which includes the rules for network traffic inspection, a capacity setting, and tags.createTLSInspectionConfiguration
(Consumer<CreateTlsInspectionConfigurationRequest.Builder> createTlsInspectionConfigurationRequest) Creates an Network Firewall TLS inspection configuration.createTLSInspectionConfiguration
(CreateTlsInspectionConfigurationRequest createTlsInspectionConfigurationRequest) Creates an Network Firewall TLS inspection configuration.createVpcEndpointAssociation
(Consumer<CreateVpcEndpointAssociationRequest.Builder> createVpcEndpointAssociationRequest) Creates a firewall endpoint for an Network Firewall firewall.createVpcEndpointAssociation
(CreateVpcEndpointAssociationRequest createVpcEndpointAssociationRequest) Creates a firewall endpoint for an Network Firewall firewall.default CompletableFuture
<DeleteFirewallResponse> deleteFirewall
(Consumer<DeleteFirewallRequest.Builder> deleteFirewallRequest) Deletes the specified Firewall and its FirewallStatus.default CompletableFuture
<DeleteFirewallResponse> deleteFirewall
(DeleteFirewallRequest deleteFirewallRequest) Deletes the specified Firewall and its FirewallStatus.deleteFirewallPolicy
(Consumer<DeleteFirewallPolicyRequest.Builder> deleteFirewallPolicyRequest) Deletes the specified FirewallPolicy.deleteFirewallPolicy
(DeleteFirewallPolicyRequest deleteFirewallPolicyRequest) Deletes the specified FirewallPolicy.deleteNetworkFirewallTransitGatewayAttachment
(Consumer<DeleteNetworkFirewallTransitGatewayAttachmentRequest.Builder> deleteNetworkFirewallTransitGatewayAttachmentRequest) Deletes a transit gateway attachment from a Network Firewall.deleteNetworkFirewallTransitGatewayAttachment
(DeleteNetworkFirewallTransitGatewayAttachmentRequest deleteNetworkFirewallTransitGatewayAttachmentRequest) Deletes a transit gateway attachment from a Network Firewall.deleteResourcePolicy
(Consumer<DeleteResourcePolicyRequest.Builder> deleteResourcePolicyRequest) Deletes a resource policy that you created in a PutResourcePolicy request.deleteResourcePolicy
(DeleteResourcePolicyRequest deleteResourcePolicyRequest) Deletes a resource policy that you created in a PutResourcePolicy request.default CompletableFuture
<DeleteRuleGroupResponse> deleteRuleGroup
(Consumer<DeleteRuleGroupRequest.Builder> deleteRuleGroupRequest) Deletes the specified RuleGroup.default CompletableFuture
<DeleteRuleGroupResponse> deleteRuleGroup
(DeleteRuleGroupRequest deleteRuleGroupRequest) Deletes the specified RuleGroup.deleteTLSInspectionConfiguration
(Consumer<DeleteTlsInspectionConfigurationRequest.Builder> deleteTlsInspectionConfigurationRequest) Deletes the specified TLSInspectionConfiguration.deleteTLSInspectionConfiguration
(DeleteTlsInspectionConfigurationRequest deleteTlsInspectionConfigurationRequest) Deletes the specified TLSInspectionConfiguration.deleteVpcEndpointAssociation
(Consumer<DeleteVpcEndpointAssociationRequest.Builder> deleteVpcEndpointAssociationRequest) Deletes the specified VpcEndpointAssociation.deleteVpcEndpointAssociation
(DeleteVpcEndpointAssociationRequest deleteVpcEndpointAssociationRequest) Deletes the specified VpcEndpointAssociation.describeFirewall
(Consumer<DescribeFirewallRequest.Builder> describeFirewallRequest) Returns the data objects for the specified firewall.describeFirewall
(DescribeFirewallRequest describeFirewallRequest) Returns the data objects for the specified firewall.describeFirewallMetadata
(Consumer<DescribeFirewallMetadataRequest.Builder> describeFirewallMetadataRequest) Returns the high-level information about a firewall, including the Availability Zones where the Firewall is currently in use.describeFirewallMetadata
(DescribeFirewallMetadataRequest describeFirewallMetadataRequest) Returns the high-level information about a firewall, including the Availability Zones where the Firewall is currently in use.describeFirewallPolicy
(Consumer<DescribeFirewallPolicyRequest.Builder> describeFirewallPolicyRequest) Returns the data objects for the specified firewall policy.describeFirewallPolicy
(DescribeFirewallPolicyRequest describeFirewallPolicyRequest) Returns the data objects for the specified firewall policy.describeFlowOperation
(Consumer<DescribeFlowOperationRequest.Builder> describeFlowOperationRequest) Returns key information about a specific flow operation.describeFlowOperation
(DescribeFlowOperationRequest describeFlowOperationRequest) Returns key information about a specific flow operation.describeLoggingConfiguration
(Consumer<DescribeLoggingConfigurationRequest.Builder> describeLoggingConfigurationRequest) Returns the logging configuration for the specified firewall.describeLoggingConfiguration
(DescribeLoggingConfigurationRequest describeLoggingConfigurationRequest) Returns the logging configuration for the specified firewall.describeResourcePolicy
(Consumer<DescribeResourcePolicyRequest.Builder> describeResourcePolicyRequest) Retrieves a resource policy that you created in a PutResourcePolicy request.describeResourcePolicy
(DescribeResourcePolicyRequest describeResourcePolicyRequest) Retrieves a resource policy that you created in a PutResourcePolicy request.describeRuleGroup
(Consumer<DescribeRuleGroupRequest.Builder> describeRuleGroupRequest) Returns the data objects for the specified rule group.describeRuleGroup
(DescribeRuleGroupRequest describeRuleGroupRequest) Returns the data objects for the specified rule group.describeRuleGroupMetadata
(Consumer<DescribeRuleGroupMetadataRequest.Builder> describeRuleGroupMetadataRequest) High-level information about a rule group, returned by operations like create and describe.describeRuleGroupMetadata
(DescribeRuleGroupMetadataRequest describeRuleGroupMetadataRequest) High-level information about a rule group, returned by operations like create and describe.describeRuleGroupSummary
(Consumer<DescribeRuleGroupSummaryRequest.Builder> describeRuleGroupSummaryRequest) Returns detailed information for a stateful rule group.describeRuleGroupSummary
(DescribeRuleGroupSummaryRequest describeRuleGroupSummaryRequest) Returns detailed information for a stateful rule group.describeTLSInspectionConfiguration
(Consumer<DescribeTlsInspectionConfigurationRequest.Builder> describeTlsInspectionConfigurationRequest) Returns the data objects for the specified TLS inspection configuration.describeTLSInspectionConfiguration
(DescribeTlsInspectionConfigurationRequest describeTlsInspectionConfigurationRequest) Returns the data objects for the specified TLS inspection configuration.describeVpcEndpointAssociation
(Consumer<DescribeVpcEndpointAssociationRequest.Builder> describeVpcEndpointAssociationRequest) Returns the data object for the specified VPC endpoint association.describeVpcEndpointAssociation
(DescribeVpcEndpointAssociationRequest describeVpcEndpointAssociationRequest) Returns the data object for the specified VPC endpoint association.disassociateAvailabilityZones
(Consumer<DisassociateAvailabilityZonesRequest.Builder> disassociateAvailabilityZonesRequest) Removes the specified Availability Zone associations from a transit gateway-attached firewall.disassociateAvailabilityZones
(DisassociateAvailabilityZonesRequest disassociateAvailabilityZonesRequest) Removes the specified Availability Zone associations from a transit gateway-attached firewall.disassociateSubnets
(Consumer<DisassociateSubnetsRequest.Builder> disassociateSubnetsRequest) Removes the specified subnet associations from the firewall.disassociateSubnets
(DisassociateSubnetsRequest disassociateSubnetsRequest) Removes the specified subnet associations from the firewall.getAnalysisReportResults
(Consumer<GetAnalysisReportResultsRequest.Builder> getAnalysisReportResultsRequest) The results of aCOMPLETED
analysis report generated with StartAnalysisReport.getAnalysisReportResults
(GetAnalysisReportResultsRequest getAnalysisReportResultsRequest) The results of aCOMPLETED
analysis report generated with StartAnalysisReport.getAnalysisReportResultsPaginator
(Consumer<GetAnalysisReportResultsRequest.Builder> getAnalysisReportResultsRequest) This is a variant ofgetAnalysisReportResults(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsRequest)
operation.getAnalysisReportResultsPaginator
(GetAnalysisReportResultsRequest getAnalysisReportResultsRequest) This is a variant ofgetAnalysisReportResults(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsRequest)
operation.listAnalysisReports
(Consumer<ListAnalysisReportsRequest.Builder> listAnalysisReportsRequest) Returns a list of all traffic analysis reports generated within the last 30 days.listAnalysisReports
(ListAnalysisReportsRequest listAnalysisReportsRequest) Returns a list of all traffic analysis reports generated within the last 30 days.default ListAnalysisReportsPublisher
listAnalysisReportsPaginator
(Consumer<ListAnalysisReportsRequest.Builder> listAnalysisReportsRequest) This is a variant oflistAnalysisReports(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsRequest)
operation.default ListAnalysisReportsPublisher
listAnalysisReportsPaginator
(ListAnalysisReportsRequest listAnalysisReportsRequest) This is a variant oflistAnalysisReports(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsRequest)
operation.listFirewallPolicies
(Consumer<ListFirewallPoliciesRequest.Builder> listFirewallPoliciesRequest) Retrieves the metadata for the firewall policies that you have defined.listFirewallPolicies
(ListFirewallPoliciesRequest listFirewallPoliciesRequest) Retrieves the metadata for the firewall policies that you have defined.default ListFirewallPoliciesPublisher
listFirewallPoliciesPaginator
(Consumer<ListFirewallPoliciesRequest.Builder> listFirewallPoliciesRequest) This is a variant oflistFirewallPolicies(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesRequest)
operation.default ListFirewallPoliciesPublisher
listFirewallPoliciesPaginator
(ListFirewallPoliciesRequest listFirewallPoliciesRequest) This is a variant oflistFirewallPolicies(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesRequest)
operation.default CompletableFuture
<ListFirewallsResponse> listFirewalls
(Consumer<ListFirewallsRequest.Builder> listFirewallsRequest) Retrieves the metadata for the firewalls that you have defined.default CompletableFuture
<ListFirewallsResponse> listFirewalls
(ListFirewallsRequest listFirewallsRequest) Retrieves the metadata for the firewalls that you have defined.default ListFirewallsPublisher
listFirewallsPaginator
(Consumer<ListFirewallsRequest.Builder> listFirewallsRequest) This is a variant oflistFirewalls(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsRequest)
operation.default ListFirewallsPublisher
listFirewallsPaginator
(ListFirewallsRequest listFirewallsRequest) This is a variant oflistFirewalls(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsRequest)
operation.listFlowOperationResults
(Consumer<ListFlowOperationResultsRequest.Builder> listFlowOperationResultsRequest) Returns the results of a specific flow operation.listFlowOperationResults
(ListFlowOperationResultsRequest listFlowOperationResultsRequest) Returns the results of a specific flow operation.listFlowOperationResultsPaginator
(Consumer<ListFlowOperationResultsRequest.Builder> listFlowOperationResultsRequest) This is a variant oflistFlowOperationResults(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsRequest)
operation.listFlowOperationResultsPaginator
(ListFlowOperationResultsRequest listFlowOperationResultsRequest) This is a variant oflistFlowOperationResults(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsRequest)
operation.listFlowOperations
(Consumer<ListFlowOperationsRequest.Builder> listFlowOperationsRequest) Returns a list of all flow operations ran in a specific firewall.listFlowOperations
(ListFlowOperationsRequest listFlowOperationsRequest) Returns a list of all flow operations ran in a specific firewall.default ListFlowOperationsPublisher
listFlowOperationsPaginator
(Consumer<ListFlowOperationsRequest.Builder> listFlowOperationsRequest) This is a variant oflistFlowOperations(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsRequest)
operation.default ListFlowOperationsPublisher
listFlowOperationsPaginator
(ListFlowOperationsRequest listFlowOperationsRequest) This is a variant oflistFlowOperations(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsRequest)
operation.default CompletableFuture
<ListRuleGroupsResponse> listRuleGroups
(Consumer<ListRuleGroupsRequest.Builder> listRuleGroupsRequest) Retrieves the metadata for the rule groups that you have defined.default CompletableFuture
<ListRuleGroupsResponse> listRuleGroups
(ListRuleGroupsRequest listRuleGroupsRequest) Retrieves the metadata for the rule groups that you have defined.default ListRuleGroupsPublisher
listRuleGroupsPaginator
(Consumer<ListRuleGroupsRequest.Builder> listRuleGroupsRequest) This is a variant oflistRuleGroups(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsRequest)
operation.default ListRuleGroupsPublisher
listRuleGroupsPaginator
(ListRuleGroupsRequest listRuleGroupsRequest) This is a variant oflistRuleGroups(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsRequest)
operation.listTagsForResource
(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Retrieves the tags associated with the specified resource.listTagsForResource
(ListTagsForResourceRequest listTagsForResourceRequest) Retrieves the tags associated with the specified resource.default ListTagsForResourcePublisher
listTagsForResourcePaginator
(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) This is a variant oflistTagsForResource(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceRequest)
operation.default ListTagsForResourcePublisher
listTagsForResourcePaginator
(ListTagsForResourceRequest listTagsForResourceRequest) This is a variant oflistTagsForResource(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceRequest)
operation.listTLSInspectionConfigurations
(Consumer<ListTlsInspectionConfigurationsRequest.Builder> listTlsInspectionConfigurationsRequest) Retrieves the metadata for the TLS inspection configurations that you have defined.listTLSInspectionConfigurations
(ListTlsInspectionConfigurationsRequest listTlsInspectionConfigurationsRequest) Retrieves the metadata for the TLS inspection configurations that you have defined.listTLSInspectionConfigurationsPaginator
(Consumer<ListTlsInspectionConfigurationsRequest.Builder> listTlsInspectionConfigurationsRequest) This is a variant oflistTLSInspectionConfigurations(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsRequest)
operation.listTLSInspectionConfigurationsPaginator
(ListTlsInspectionConfigurationsRequest listTlsInspectionConfigurationsRequest) This is a variant oflistTLSInspectionConfigurations(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsRequest)
operation.listVpcEndpointAssociations
(Consumer<ListVpcEndpointAssociationsRequest.Builder> listVpcEndpointAssociationsRequest) Retrieves the metadata for the VPC endpoint associations that you have defined.listVpcEndpointAssociations
(ListVpcEndpointAssociationsRequest listVpcEndpointAssociationsRequest) Retrieves the metadata for the VPC endpoint associations that you have defined.listVpcEndpointAssociationsPaginator
(Consumer<ListVpcEndpointAssociationsRequest.Builder> listVpcEndpointAssociationsRequest) This is a variant oflistVpcEndpointAssociations(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsRequest)
operation.listVpcEndpointAssociationsPaginator
(ListVpcEndpointAssociationsRequest listVpcEndpointAssociationsRequest) This is a variant oflistVpcEndpointAssociations(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsRequest)
operation.putResourcePolicy
(Consumer<PutResourcePolicyRequest.Builder> putResourcePolicyRequest) Creates or updates an IAM policy for your rule group, firewall policy, or firewall.putResourcePolicy
(PutResourcePolicyRequest putResourcePolicyRequest) Creates or updates an IAM policy for your rule group, firewall policy, or firewall.rejectNetworkFirewallTransitGatewayAttachment
(Consumer<RejectNetworkFirewallTransitGatewayAttachmentRequest.Builder> rejectNetworkFirewallTransitGatewayAttachmentRequest) Rejects a transit gateway attachment request for Network Firewall.rejectNetworkFirewallTransitGatewayAttachment
(RejectNetworkFirewallTransitGatewayAttachmentRequest rejectNetworkFirewallTransitGatewayAttachmentRequest) Rejects a transit gateway attachment request for Network Firewall.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstartAnalysisReport
(Consumer<StartAnalysisReportRequest.Builder> startAnalysisReportRequest) Generates a traffic analysis report for the timeframe and traffic type you specify.startAnalysisReport
(StartAnalysisReportRequest startAnalysisReportRequest) Generates a traffic analysis report for the timeframe and traffic type you specify.startFlowCapture
(Consumer<StartFlowCaptureRequest.Builder> startFlowCaptureRequest) Begins capturing the flows in a firewall, according to the filters you define.startFlowCapture
(StartFlowCaptureRequest startFlowCaptureRequest) Begins capturing the flows in a firewall, according to the filters you define.default CompletableFuture
<StartFlowFlushResponse> startFlowFlush
(Consumer<StartFlowFlushRequest.Builder> startFlowFlushRequest) Begins the flushing of traffic from the firewall, according to the filters you define.default CompletableFuture
<StartFlowFlushResponse> startFlowFlush
(StartFlowFlushRequest startFlowFlushRequest) Begins the flushing of traffic from the firewall, according to the filters you define.default CompletableFuture
<TagResourceResponse> tagResource
(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds the specified tags to the specified resource.default CompletableFuture
<TagResourceResponse> tagResource
(TagResourceRequest tagResourceRequest) Adds the specified tags to the specified resource.default CompletableFuture
<UntagResourceResponse> untagResource
(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes the tags with the specified keys from the specified resource.default CompletableFuture
<UntagResourceResponse> untagResource
(UntagResourceRequest untagResourceRequest) Removes the tags with the specified keys from the specified resource.updateAvailabilityZoneChangeProtection
(Consumer<UpdateAvailabilityZoneChangeProtectionRequest.Builder> updateAvailabilityZoneChangeProtectionRequest) Modifies theAvailabilityZoneChangeProtection
setting for a transit gateway-attached firewall.updateAvailabilityZoneChangeProtection
(UpdateAvailabilityZoneChangeProtectionRequest updateAvailabilityZoneChangeProtectionRequest) Modifies theAvailabilityZoneChangeProtection
setting for a transit gateway-attached firewall.updateFirewallAnalysisSettings
(Consumer<UpdateFirewallAnalysisSettingsRequest.Builder> updateFirewallAnalysisSettingsRequest) Enables specific types of firewall analysis on a specific firewall you define.updateFirewallAnalysisSettings
(UpdateFirewallAnalysisSettingsRequest updateFirewallAnalysisSettingsRequest) Enables specific types of firewall analysis on a specific firewall you define.updateFirewallDeleteProtection
(Consumer<UpdateFirewallDeleteProtectionRequest.Builder> updateFirewallDeleteProtectionRequest) Modifies the flag,DeleteProtection
, which indicates whether it is possible to delete the firewall.updateFirewallDeleteProtection
(UpdateFirewallDeleteProtectionRequest updateFirewallDeleteProtectionRequest) Modifies the flag,DeleteProtection
, which indicates whether it is possible to delete the firewall.updateFirewallDescription
(Consumer<UpdateFirewallDescriptionRequest.Builder> updateFirewallDescriptionRequest) Modifies the description for the specified firewall.updateFirewallDescription
(UpdateFirewallDescriptionRequest updateFirewallDescriptionRequest) Modifies the description for the specified firewall.updateFirewallEncryptionConfiguration
(Consumer<UpdateFirewallEncryptionConfigurationRequest.Builder> updateFirewallEncryptionConfigurationRequest) A complex type that contains settings for encryption of your firewall resources.updateFirewallEncryptionConfiguration
(UpdateFirewallEncryptionConfigurationRequest updateFirewallEncryptionConfigurationRequest) A complex type that contains settings for encryption of your firewall resources.updateFirewallPolicy
(Consumer<UpdateFirewallPolicyRequest.Builder> updateFirewallPolicyRequest) Updates the properties of the specified firewall policy.updateFirewallPolicy
(UpdateFirewallPolicyRequest updateFirewallPolicyRequest) Updates the properties of the specified firewall policy.updateFirewallPolicyChangeProtection
(Consumer<UpdateFirewallPolicyChangeProtectionRequest.Builder> updateFirewallPolicyChangeProtectionRequest) Modifies the flag,ChangeProtection
, which indicates whether it is possible to change the firewall.updateFirewallPolicyChangeProtection
(UpdateFirewallPolicyChangeProtectionRequest updateFirewallPolicyChangeProtectionRequest) Modifies the flag,ChangeProtection
, which indicates whether it is possible to change the firewall.updateLoggingConfiguration
(Consumer<UpdateLoggingConfigurationRequest.Builder> updateLoggingConfigurationRequest) Sets the logging configuration for the specified firewall.updateLoggingConfiguration
(UpdateLoggingConfigurationRequest updateLoggingConfigurationRequest) Sets the logging configuration for the specified firewall.default CompletableFuture
<UpdateRuleGroupResponse> updateRuleGroup
(Consumer<UpdateRuleGroupRequest.Builder> updateRuleGroupRequest) Updates the rule settings for the specified rule group.default CompletableFuture
<UpdateRuleGroupResponse> updateRuleGroup
(UpdateRuleGroupRequest updateRuleGroupRequest) Updates the rule settings for the specified rule group.updateSubnetChangeProtection
(Consumer<UpdateSubnetChangeProtectionRequest.Builder> updateSubnetChangeProtectionRequest) updateSubnetChangeProtection
(UpdateSubnetChangeProtectionRequest updateSubnetChangeProtectionRequest) updateTLSInspectionConfiguration
(Consumer<UpdateTlsInspectionConfigurationRequest.Builder> updateTlsInspectionConfigurationRequest) Updates the TLS inspection configuration settings for the specified TLS inspection configuration.updateTLSInspectionConfiguration
(UpdateTlsInspectionConfigurationRequest updateTlsInspectionConfigurationRequest) Updates the TLS inspection configuration settings for the specified TLS inspection configuration.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.- See Also:
-
-
Method Details
-
acceptNetworkFirewallTransitGatewayAttachment
default CompletableFuture<AcceptNetworkFirewallTransitGatewayAttachmentResponse> acceptNetworkFirewallTransitGatewayAttachment(AcceptNetworkFirewallTransitGatewayAttachmentRequest acceptNetworkFirewallTransitGatewayAttachmentRequest) Accepts a transit gateway attachment request for Network Firewall. When you accept the attachment request, Network Firewall creates the necessary routing components to enable traffic flow between the transit gateway and firewall endpoints.
You must accept a transit gateway attachment to complete the creation of a transit gateway-attached firewall, unless auto-accept is enabled on the transit gateway. After acceptance, use DescribeFirewall to verify the firewall status.
To reject an attachment instead of accepting it, use RejectNetworkFirewallTransitGatewayAttachment.
It can take several minutes for the attachment acceptance to complete and the firewall to become available.
- Parameters:
acceptNetworkFirewallTransitGatewayAttachmentRequest
-- Returns:
- A Java Future containing the result of the AcceptNetworkFirewallTransitGatewayAttachment operation
returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
acceptNetworkFirewallTransitGatewayAttachment
default CompletableFuture<AcceptNetworkFirewallTransitGatewayAttachmentResponse> acceptNetworkFirewallTransitGatewayAttachment(Consumer<AcceptNetworkFirewallTransitGatewayAttachmentRequest.Builder> acceptNetworkFirewallTransitGatewayAttachmentRequest) Accepts a transit gateway attachment request for Network Firewall. When you accept the attachment request, Network Firewall creates the necessary routing components to enable traffic flow between the transit gateway and firewall endpoints.
You must accept a transit gateway attachment to complete the creation of a transit gateway-attached firewall, unless auto-accept is enabled on the transit gateway. After acceptance, use DescribeFirewall to verify the firewall status.
To reject an attachment instead of accepting it, use RejectNetworkFirewallTransitGatewayAttachment.
It can take several minutes for the attachment acceptance to complete and the firewall to become available.
This is a convenience which creates an instance of the
AcceptNetworkFirewallTransitGatewayAttachmentRequest.Builder
avoiding the need to create one manually viaAcceptNetworkFirewallTransitGatewayAttachmentRequest.builder()
- Parameters:
acceptNetworkFirewallTransitGatewayAttachmentRequest
- AConsumer
that will call methods onAcceptNetworkFirewallTransitGatewayAttachmentRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the AcceptNetworkFirewallTransitGatewayAttachment operation
returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
associateAvailabilityZones
default CompletableFuture<AssociateAvailabilityZonesResponse> associateAvailabilityZones(AssociateAvailabilityZonesRequest associateAvailabilityZonesRequest) Associates the specified Availability Zones with a transit gateway-attached firewall. For each Availability Zone, Network Firewall creates a firewall endpoint to process traffic. You can specify one or more Availability Zones where you want to deploy the firewall.
After adding Availability Zones, you must update your transit gateway route tables to direct traffic through the new firewall endpoints. Use DescribeFirewall to monitor the status of the new endpoints.
- Parameters:
associateAvailabilityZonesRequest
-- Returns:
- A Java Future containing the result of the AssociateAvailabilityZones operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
associateAvailabilityZones
default CompletableFuture<AssociateAvailabilityZonesResponse> associateAvailabilityZones(Consumer<AssociateAvailabilityZonesRequest.Builder> associateAvailabilityZonesRequest) Associates the specified Availability Zones with a transit gateway-attached firewall. For each Availability Zone, Network Firewall creates a firewall endpoint to process traffic. You can specify one or more Availability Zones where you want to deploy the firewall.
After adding Availability Zones, you must update your transit gateway route tables to direct traffic through the new firewall endpoints. Use DescribeFirewall to monitor the status of the new endpoints.
This is a convenience which creates an instance of the
AssociateAvailabilityZonesRequest.Builder
avoiding the need to create one manually viaAssociateAvailabilityZonesRequest.builder()
- Parameters:
associateAvailabilityZonesRequest
- AConsumer
that will call methods onAssociateAvailabilityZonesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the AssociateAvailabilityZones operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
associateFirewallPolicy
default CompletableFuture<AssociateFirewallPolicyResponse> associateFirewallPolicy(AssociateFirewallPolicyRequest associateFirewallPolicyRequest) 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.
- Parameters:
associateFirewallPolicyRequest
-- Returns:
- A Java Future containing the result of the AssociateFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
associateFirewallPolicy
default CompletableFuture<AssociateFirewallPolicyResponse> associateFirewallPolicy(Consumer<AssociateFirewallPolicyRequest.Builder> associateFirewallPolicyRequest) 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.
This is a convenience which creates an instance of the
AssociateFirewallPolicyRequest.Builder
avoiding the need to create one manually viaAssociateFirewallPolicyRequest.builder()
- Parameters:
associateFirewallPolicyRequest
- AConsumer
that will call methods onAssociateFirewallPolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the AssociateFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
associateSubnets
default CompletableFuture<AssociateSubnetsResponse> associateSubnets(AssociateSubnetsRequest associateSubnetsRequest) Associates the specified subnets in the Amazon VPC to the firewall. You can specify one subnet for each of the Availability Zones that the VPC spans.
This request creates an Network Firewall firewall endpoint in each of the subnets. To enable the firewall's protections, you must also modify the VPC's route tables for each subnet's Availability Zone, to redirect the traffic that's coming into and going out of the zone through the firewall endpoint.
- Parameters:
associateSubnetsRequest
-- Returns:
- A Java Future containing the result of the AssociateSubnets operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
associateSubnets
default CompletableFuture<AssociateSubnetsResponse> associateSubnets(Consumer<AssociateSubnetsRequest.Builder> associateSubnetsRequest) Associates the specified subnets in the Amazon VPC to the firewall. You can specify one subnet for each of the Availability Zones that the VPC spans.
This request creates an Network Firewall firewall endpoint in each of the subnets. To enable the firewall's protections, you must also modify the VPC's route tables for each subnet's Availability Zone, to redirect the traffic that's coming into and going out of the zone through the firewall endpoint.
This is a convenience which creates an instance of the
AssociateSubnetsRequest.Builder
avoiding the need to create one manually viaAssociateSubnetsRequest.builder()
- Parameters:
associateSubnetsRequest
- AConsumer
that will call methods onAssociateSubnetsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the AssociateSubnets operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
createFirewall
default CompletableFuture<CreateFirewallResponse> createFirewall(CreateFirewallRequest createFirewallRequest) Creates an Network Firewall Firewall and accompanying FirewallStatus for a VPC.
The firewall defines the configuration settings for an Network Firewall firewall. The settings that you can define at creation include the firewall policy, the subnets in your VPC to use for the firewall endpoints, and any tags that are attached to the firewall Amazon Web Services resource.
After you create a firewall, you can provide additional settings, like the logging configuration.
To update the settings for a firewall, you use the operations that apply to the settings themselves, for example UpdateLoggingConfiguration, AssociateSubnets, and UpdateFirewallDeleteProtection.
To manage a firewall's tags, use the standard Amazon Web Services resource tagging operations, ListTagsForResource, TagResource, and UntagResource.
To retrieve information about firewalls, use ListFirewalls and DescribeFirewall.
To generate a report on the last 30 days of traffic monitored by a firewall, use StartAnalysisReport.
- Parameters:
createFirewallRequest
-- Returns:
- A Java Future containing the result of the CreateFirewall operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
createFirewall
default CompletableFuture<CreateFirewallResponse> createFirewall(Consumer<CreateFirewallRequest.Builder> createFirewallRequest) Creates an Network Firewall Firewall and accompanying FirewallStatus for a VPC.
The firewall defines the configuration settings for an Network Firewall firewall. The settings that you can define at creation include the firewall policy, the subnets in your VPC to use for the firewall endpoints, and any tags that are attached to the firewall Amazon Web Services resource.
After you create a firewall, you can provide additional settings, like the logging configuration.
To update the settings for a firewall, you use the operations that apply to the settings themselves, for example UpdateLoggingConfiguration, AssociateSubnets, and UpdateFirewallDeleteProtection.
To manage a firewall's tags, use the standard Amazon Web Services resource tagging operations, ListTagsForResource, TagResource, and UntagResource.
To retrieve information about firewalls, use ListFirewalls and DescribeFirewall.
To generate a report on the last 30 days of traffic monitored by a firewall, use StartAnalysisReport.
This is a convenience which creates an instance of the
CreateFirewallRequest.Builder
avoiding the need to create one manually viaCreateFirewallRequest.builder()
- Parameters:
createFirewallRequest
- AConsumer
that will call methods onCreateFirewallRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateFirewall operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
createFirewallPolicy
default CompletableFuture<CreateFirewallPolicyResponse> createFirewallPolicy(CreateFirewallPolicyRequest createFirewallPolicyRequest) Creates the firewall policy for the firewall according to the specifications.
An Network Firewall firewall policy defines the behavior of a firewall, in a collection of stateless and stateful rule groups and other settings. You can use one firewall policy for multiple firewalls.
- Parameters:
createFirewallPolicyRequest
-- Returns:
- A Java Future containing the result of the CreateFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createFirewallPolicy
default CompletableFuture<CreateFirewallPolicyResponse> createFirewallPolicy(Consumer<CreateFirewallPolicyRequest.Builder> createFirewallPolicyRequest) Creates the firewall policy for the firewall according to the specifications.
An Network Firewall firewall policy defines the behavior of a firewall, in a collection of stateless and stateful rule groups and other settings. You can use one firewall policy for multiple firewalls.
This is a convenience which creates an instance of the
CreateFirewallPolicyRequest.Builder
avoiding the need to create one manually viaCreateFirewallPolicyRequest.builder()
- Parameters:
createFirewallPolicyRequest
- AConsumer
that will call methods onCreateFirewallPolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createRuleGroup
default CompletableFuture<CreateRuleGroupResponse> createRuleGroup(CreateRuleGroupRequest createRuleGroupRequest) Creates the specified stateless or stateful rule group, which includes the rules for network traffic inspection, a capacity setting, and tags.
You provide your rule group specification in your request using either
RuleGroup
orRules
.- Parameters:
createRuleGroupRequest
-- Returns:
- A Java Future containing the result of the CreateRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createRuleGroup
default CompletableFuture<CreateRuleGroupResponse> createRuleGroup(Consumer<CreateRuleGroupRequest.Builder> createRuleGroupRequest) Creates the specified stateless or stateful rule group, which includes the rules for network traffic inspection, a capacity setting, and tags.
You provide your rule group specification in your request using either
RuleGroup
orRules
.
This is a convenience which creates an instance of the
CreateRuleGroupRequest.Builder
avoiding the need to create one manually viaCreateRuleGroupRequest.builder()
- Parameters:
createRuleGroupRequest
- AConsumer
that will call methods onCreateRuleGroupRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createTLSInspectionConfiguration
default CompletableFuture<CreateTlsInspectionConfigurationResponse> createTLSInspectionConfiguration(CreateTlsInspectionConfigurationRequest createTlsInspectionConfigurationRequest) Creates an Network Firewall TLS inspection configuration. Network Firewall uses TLS inspection configurations to decrypt your firewall's inbound and outbound SSL/TLS traffic. After decryption, Network Firewall inspects the traffic according to your firewall policy's stateful rules, and then re-encrypts it before sending it to its destination. You can enable inspection of your firewall's inbound traffic, outbound traffic, or both. To use TLS inspection with your firewall, you must first import or provision certificates using ACM, create a TLS inspection configuration, add that configuration to a new firewall policy, and then associate that policy with your firewall.
To update the settings for a TLS inspection configuration, use UpdateTLSInspectionConfiguration.
To manage a TLS inspection configuration's tags, use the standard Amazon Web Services resource tagging operations, ListTagsForResource, TagResource, and UntagResource.
To retrieve information about TLS inspection configurations, use ListTLSInspectionConfigurations and DescribeTLSInspectionConfiguration.
For more information about TLS inspection configurations, see Inspecting SSL/TLS traffic with TLS inspection configurations in the Network Firewall Developer Guide.
- Parameters:
createTlsInspectionConfigurationRequest
-- Returns:
- A Java Future containing the result of the CreateTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
createTLSInspectionConfiguration
default CompletableFuture<CreateTlsInspectionConfigurationResponse> createTLSInspectionConfiguration(Consumer<CreateTlsInspectionConfigurationRequest.Builder> createTlsInspectionConfigurationRequest) Creates an Network Firewall TLS inspection configuration. Network Firewall uses TLS inspection configurations to decrypt your firewall's inbound and outbound SSL/TLS traffic. After decryption, Network Firewall inspects the traffic according to your firewall policy's stateful rules, and then re-encrypts it before sending it to its destination. You can enable inspection of your firewall's inbound traffic, outbound traffic, or both. To use TLS inspection with your firewall, you must first import or provision certificates using ACM, create a TLS inspection configuration, add that configuration to a new firewall policy, and then associate that policy with your firewall.
To update the settings for a TLS inspection configuration, use UpdateTLSInspectionConfiguration.
To manage a TLS inspection configuration's tags, use the standard Amazon Web Services resource tagging operations, ListTagsForResource, TagResource, and UntagResource.
To retrieve information about TLS inspection configurations, use ListTLSInspectionConfigurations and DescribeTLSInspectionConfiguration.
For more information about TLS inspection configurations, see Inspecting SSL/TLS traffic with TLS inspection configurations in the Network Firewall Developer Guide.
This is a convenience which creates an instance of the
CreateTlsInspectionConfigurationRequest.Builder
avoiding the need to create one manually viaCreateTlsInspectionConfigurationRequest.builder()
- Parameters:
createTlsInspectionConfigurationRequest
- AConsumer
that will call methods onCreateTlsInspectionConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
createVpcEndpointAssociation
default CompletableFuture<CreateVpcEndpointAssociationResponse> createVpcEndpointAssociation(CreateVpcEndpointAssociationRequest createVpcEndpointAssociationRequest) Creates a firewall endpoint for an Network Firewall firewall. This type of firewall endpoint is independent of the firewall endpoints that you specify in the
Firewall
itself, and you define it in addition to those endpoints after the firewall has been created. You can define a VPC endpoint association using a different VPC than the one you used in the firewall specifications.- Parameters:
createVpcEndpointAssociationRequest
-- Returns:
- A Java Future containing the result of the CreateVpcEndpointAssociation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createVpcEndpointAssociation
default CompletableFuture<CreateVpcEndpointAssociationResponse> createVpcEndpointAssociation(Consumer<CreateVpcEndpointAssociationRequest.Builder> createVpcEndpointAssociationRequest) Creates a firewall endpoint for an Network Firewall firewall. This type of firewall endpoint is independent of the firewall endpoints that you specify in the
Firewall
itself, and you define it in addition to those endpoints after the firewall has been created. You can define a VPC endpoint association using a different VPC than the one you used in the firewall specifications.
This is a convenience which creates an instance of the
CreateVpcEndpointAssociationRequest.Builder
avoiding the need to create one manually viaCreateVpcEndpointAssociationRequest.builder()
- Parameters:
createVpcEndpointAssociationRequest
- AConsumer
that will call methods onCreateVpcEndpointAssociationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the CreateVpcEndpointAssociation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- LimitExceededException Unable to perform the operation because doing so would violate a limit setting.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InsufficientCapacityException Amazon Web Services doesn't currently have enough available capacity to fulfill your request. Try your request later.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteFirewall
default CompletableFuture<DeleteFirewallResponse> deleteFirewall(DeleteFirewallRequest deleteFirewallRequest) Deletes the specified Firewall and its FirewallStatus. This operation requires the firewall's
DeleteProtection
flag to beFALSE
. You can't revert this operation.You can check whether a firewall is in use by reviewing the route tables for the Availability Zones where you have firewall subnet mappings. Retrieve the subnet mappings by calling DescribeFirewall. You define and update the route tables through Amazon VPC. As needed, update the route tables for the zones to remove the firewall endpoints. When the route tables no longer use the firewall endpoints, you can remove the firewall safely.
To delete a firewall, remove the delete protection if you need to using UpdateFirewallDeleteProtection, then delete the firewall by calling DeleteFirewall.
- Parameters:
deleteFirewallRequest
-- Returns:
- A Java Future containing the result of the DeleteFirewall operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- UnsupportedOperationException The operation you requested isn't supported by Network Firewall.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteFirewall
default CompletableFuture<DeleteFirewallResponse> deleteFirewall(Consumer<DeleteFirewallRequest.Builder> deleteFirewallRequest) Deletes the specified Firewall and its FirewallStatus. This operation requires the firewall's
DeleteProtection
flag to beFALSE
. You can't revert this operation.You can check whether a firewall is in use by reviewing the route tables for the Availability Zones where you have firewall subnet mappings. Retrieve the subnet mappings by calling DescribeFirewall. You define and update the route tables through Amazon VPC. As needed, update the route tables for the zones to remove the firewall endpoints. When the route tables no longer use the firewall endpoints, you can remove the firewall safely.
To delete a firewall, remove the delete protection if you need to using UpdateFirewallDeleteProtection, then delete the firewall by calling DeleteFirewall.
This is a convenience which creates an instance of the
DeleteFirewallRequest.Builder
avoiding the need to create one manually viaDeleteFirewallRequest.builder()
- Parameters:
deleteFirewallRequest
- AConsumer
that will call methods onDeleteFirewallRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteFirewall operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- UnsupportedOperationException The operation you requested isn't supported by Network Firewall.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteFirewallPolicy
default CompletableFuture<DeleteFirewallPolicyResponse> deleteFirewallPolicy(DeleteFirewallPolicyRequest deleteFirewallPolicyRequest) Deletes the specified FirewallPolicy.
- Parameters:
deleteFirewallPolicyRequest
-- Returns:
- A Java Future containing the result of the DeleteFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- UnsupportedOperationException The operation you requested isn't supported by Network Firewall.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteFirewallPolicy
default CompletableFuture<DeleteFirewallPolicyResponse> deleteFirewallPolicy(Consumer<DeleteFirewallPolicyRequest.Builder> deleteFirewallPolicyRequest) Deletes the specified FirewallPolicy.
This is a convenience which creates an instance of the
DeleteFirewallPolicyRequest.Builder
avoiding the need to create one manually viaDeleteFirewallPolicyRequest.builder()
- Parameters:
deleteFirewallPolicyRequest
- AConsumer
that will call methods onDeleteFirewallPolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- UnsupportedOperationException The operation you requested isn't supported by Network Firewall.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteNetworkFirewallTransitGatewayAttachment
default CompletableFuture<DeleteNetworkFirewallTransitGatewayAttachmentResponse> deleteNetworkFirewallTransitGatewayAttachment(DeleteNetworkFirewallTransitGatewayAttachmentRequest deleteNetworkFirewallTransitGatewayAttachmentRequest) Deletes a transit gateway attachment from a Network Firewall. Either the firewall owner or the transit gateway owner can delete the attachment.
After you delete a transit gateway attachment, raffic will no longer flow through the firewall endpoints.
After you initiate the delete operation, use DescribeFirewall to monitor the deletion status.
- Parameters:
deleteNetworkFirewallTransitGatewayAttachmentRequest
-- Returns:
- A Java Future containing the result of the DeleteNetworkFirewallTransitGatewayAttachment operation
returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteNetworkFirewallTransitGatewayAttachment
default CompletableFuture<DeleteNetworkFirewallTransitGatewayAttachmentResponse> deleteNetworkFirewallTransitGatewayAttachment(Consumer<DeleteNetworkFirewallTransitGatewayAttachmentRequest.Builder> deleteNetworkFirewallTransitGatewayAttachmentRequest) Deletes a transit gateway attachment from a Network Firewall. Either the firewall owner or the transit gateway owner can delete the attachment.
After you delete a transit gateway attachment, raffic will no longer flow through the firewall endpoints.
After you initiate the delete operation, use DescribeFirewall to monitor the deletion status.
This is a convenience which creates an instance of the
DeleteNetworkFirewallTransitGatewayAttachmentRequest.Builder
avoiding the need to create one manually viaDeleteNetworkFirewallTransitGatewayAttachmentRequest.builder()
- Parameters:
deleteNetworkFirewallTransitGatewayAttachmentRequest
- AConsumer
that will call methods onDeleteNetworkFirewallTransitGatewayAttachmentRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteNetworkFirewallTransitGatewayAttachment operation
returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteResourcePolicy
default CompletableFuture<DeleteResourcePolicyResponse> deleteResourcePolicy(DeleteResourcePolicyRequest deleteResourcePolicyRequest) Deletes a resource policy that you created in a PutResourcePolicy request.
- Parameters:
deleteResourcePolicyRequest
-- Returns:
- A Java Future containing the result of the DeleteResourcePolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidResourcePolicyException The policy statement failed validation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteResourcePolicy
default CompletableFuture<DeleteResourcePolicyResponse> deleteResourcePolicy(Consumer<DeleteResourcePolicyRequest.Builder> deleteResourcePolicyRequest) Deletes a resource policy that you created in a PutResourcePolicy request.
This is a convenience which creates an instance of the
DeleteResourcePolicyRequest.Builder
avoiding the need to create one manually viaDeleteResourcePolicyRequest.builder()
- Parameters:
deleteResourcePolicyRequest
- AConsumer
that will call methods onDeleteResourcePolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteResourcePolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidResourcePolicyException The policy statement failed validation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteRuleGroup
default CompletableFuture<DeleteRuleGroupResponse> deleteRuleGroup(DeleteRuleGroupRequest deleteRuleGroupRequest) Deletes the specified RuleGroup.
- Parameters:
deleteRuleGroupRequest
-- Returns:
- A Java Future containing the result of the DeleteRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- UnsupportedOperationException The operation you requested isn't supported by Network Firewall.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteRuleGroup
default CompletableFuture<DeleteRuleGroupResponse> deleteRuleGroup(Consumer<DeleteRuleGroupRequest.Builder> deleteRuleGroupRequest) Deletes the specified RuleGroup.
This is a convenience which creates an instance of the
DeleteRuleGroupRequest.Builder
avoiding the need to create one manually viaDeleteRuleGroupRequest.builder()
- Parameters:
deleteRuleGroupRequest
- AConsumer
that will call methods onDeleteRuleGroupRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- UnsupportedOperationException The operation you requested isn't supported by Network Firewall.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteTLSInspectionConfiguration
default CompletableFuture<DeleteTlsInspectionConfigurationResponse> deleteTLSInspectionConfiguration(DeleteTlsInspectionConfigurationRequest deleteTlsInspectionConfigurationRequest) Deletes the specified TLSInspectionConfiguration.
- Parameters:
deleteTlsInspectionConfigurationRequest
-- Returns:
- A Java Future containing the result of the DeleteTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteTLSInspectionConfiguration
default CompletableFuture<DeleteTlsInspectionConfigurationResponse> deleteTLSInspectionConfiguration(Consumer<DeleteTlsInspectionConfigurationRequest.Builder> deleteTlsInspectionConfigurationRequest) Deletes the specified TLSInspectionConfiguration.
This is a convenience which creates an instance of the
DeleteTlsInspectionConfigurationRequest.Builder
avoiding the need to create one manually viaDeleteTlsInspectionConfigurationRequest.builder()
- Parameters:
deleteTlsInspectionConfigurationRequest
- AConsumer
that will call methods onDeleteTlsInspectionConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteVpcEndpointAssociation
default CompletableFuture<DeleteVpcEndpointAssociationResponse> deleteVpcEndpointAssociation(DeleteVpcEndpointAssociationRequest deleteVpcEndpointAssociationRequest) Deletes the specified VpcEndpointAssociation.
You can check whether an endpoint association is in use by reviewing the route tables for the Availability Zones where you have the endpoint subnet mapping. You can retrieve the subnet mapping by calling DescribeVpcEndpointAssociation. You define and update the route tables through Amazon VPC. As needed, update the route tables for the Availability Zone to remove the firewall endpoint for the association. When the route tables no longer use the firewall endpoint, you can remove the endpoint association safely.
- Parameters:
deleteVpcEndpointAssociationRequest
-- Returns:
- A Java Future containing the result of the DeleteVpcEndpointAssociation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
deleteVpcEndpointAssociation
default CompletableFuture<DeleteVpcEndpointAssociationResponse> deleteVpcEndpointAssociation(Consumer<DeleteVpcEndpointAssociationRequest.Builder> deleteVpcEndpointAssociationRequest) Deletes the specified VpcEndpointAssociation.
You can check whether an endpoint association is in use by reviewing the route tables for the Availability Zones where you have the endpoint subnet mapping. You can retrieve the subnet mapping by calling DescribeVpcEndpointAssociation. You define and update the route tables through Amazon VPC. As needed, update the route tables for the Availability Zone to remove the firewall endpoint for the association. When the route tables no longer use the firewall endpoint, you can remove the endpoint association safely.
This is a convenience which creates an instance of the
DeleteVpcEndpointAssociationRequest.Builder
avoiding the need to create one manually viaDeleteVpcEndpointAssociationRequest.builder()
- Parameters:
deleteVpcEndpointAssociationRequest
- AConsumer
that will call methods onDeleteVpcEndpointAssociationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DeleteVpcEndpointAssociation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFirewall
default CompletableFuture<DescribeFirewallResponse> describeFirewall(DescribeFirewallRequest describeFirewallRequest) Returns the data objects for the specified firewall.
- Parameters:
describeFirewallRequest
-- Returns:
- A Java Future containing the result of the DescribeFirewall operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFirewall
default CompletableFuture<DescribeFirewallResponse> describeFirewall(Consumer<DescribeFirewallRequest.Builder> describeFirewallRequest) Returns the data objects for the specified firewall.
This is a convenience which creates an instance of the
DescribeFirewallRequest.Builder
avoiding the need to create one manually viaDescribeFirewallRequest.builder()
- Parameters:
describeFirewallRequest
- AConsumer
that will call methods onDescribeFirewallRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeFirewall operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFirewallMetadata
default CompletableFuture<DescribeFirewallMetadataResponse> describeFirewallMetadata(DescribeFirewallMetadataRequest describeFirewallMetadataRequest) Returns the high-level information about a firewall, including the Availability Zones where the Firewall is currently in use.
- Parameters:
describeFirewallMetadataRequest
-- Returns:
- A Java Future containing the result of the DescribeFirewallMetadata operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFirewallMetadata
default CompletableFuture<DescribeFirewallMetadataResponse> describeFirewallMetadata(Consumer<DescribeFirewallMetadataRequest.Builder> describeFirewallMetadataRequest) Returns the high-level information about a firewall, including the Availability Zones where the Firewall is currently in use.
This is a convenience which creates an instance of the
DescribeFirewallMetadataRequest.Builder
avoiding the need to create one manually viaDescribeFirewallMetadataRequest.builder()
- Parameters:
describeFirewallMetadataRequest
- AConsumer
that will call methods onDescribeFirewallMetadataRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeFirewallMetadata operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFirewallPolicy
default CompletableFuture<DescribeFirewallPolicyResponse> describeFirewallPolicy(DescribeFirewallPolicyRequest describeFirewallPolicyRequest) Returns the data objects for the specified firewall policy.
- Parameters:
describeFirewallPolicyRequest
-- Returns:
- A Java Future containing the result of the DescribeFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFirewallPolicy
default CompletableFuture<DescribeFirewallPolicyResponse> describeFirewallPolicy(Consumer<DescribeFirewallPolicyRequest.Builder> describeFirewallPolicyRequest) Returns the data objects for the specified firewall policy.
This is a convenience which creates an instance of the
DescribeFirewallPolicyRequest.Builder
avoiding the need to create one manually viaDescribeFirewallPolicyRequest.builder()
- Parameters:
describeFirewallPolicyRequest
- AConsumer
that will call methods onDescribeFirewallPolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFlowOperation
default CompletableFuture<DescribeFlowOperationResponse> describeFlowOperation(DescribeFlowOperationRequest describeFlowOperationRequest) Returns key information about a specific flow operation.
- Parameters:
describeFlowOperationRequest
-- Returns:
- A Java Future containing the result of the DescribeFlowOperation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeFlowOperation
default CompletableFuture<DescribeFlowOperationResponse> describeFlowOperation(Consumer<DescribeFlowOperationRequest.Builder> describeFlowOperationRequest) Returns key information about a specific flow operation.
This is a convenience which creates an instance of the
DescribeFlowOperationRequest.Builder
avoiding the need to create one manually viaDescribeFlowOperationRequest.builder()
- Parameters:
describeFlowOperationRequest
- AConsumer
that will call methods onDescribeFlowOperationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeFlowOperation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeLoggingConfiguration
default CompletableFuture<DescribeLoggingConfigurationResponse> describeLoggingConfiguration(DescribeLoggingConfigurationRequest describeLoggingConfigurationRequest) Returns the logging configuration for the specified firewall.
- Parameters:
describeLoggingConfigurationRequest
-- Returns:
- A Java Future containing the result of the DescribeLoggingConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeLoggingConfiguration
default CompletableFuture<DescribeLoggingConfigurationResponse> describeLoggingConfiguration(Consumer<DescribeLoggingConfigurationRequest.Builder> describeLoggingConfigurationRequest) Returns the logging configuration for the specified firewall.
This is a convenience which creates an instance of the
DescribeLoggingConfigurationRequest.Builder
avoiding the need to create one manually viaDescribeLoggingConfigurationRequest.builder()
- Parameters:
describeLoggingConfigurationRequest
- AConsumer
that will call methods onDescribeLoggingConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeLoggingConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeResourcePolicy
default CompletableFuture<DescribeResourcePolicyResponse> describeResourcePolicy(DescribeResourcePolicyRequest describeResourcePolicyRequest) Retrieves a resource policy that you created in a PutResourcePolicy request.
- Parameters:
describeResourcePolicyRequest
-- Returns:
- A Java Future containing the result of the DescribeResourcePolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeResourcePolicy
default CompletableFuture<DescribeResourcePolicyResponse> describeResourcePolicy(Consumer<DescribeResourcePolicyRequest.Builder> describeResourcePolicyRequest) Retrieves a resource policy that you created in a PutResourcePolicy request.
This is a convenience which creates an instance of the
DescribeResourcePolicyRequest.Builder
avoiding the need to create one manually viaDescribeResourcePolicyRequest.builder()
- Parameters:
describeResourcePolicyRequest
- AConsumer
that will call methods onDescribeResourcePolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeResourcePolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeRuleGroup
default CompletableFuture<DescribeRuleGroupResponse> describeRuleGroup(DescribeRuleGroupRequest describeRuleGroupRequest) Returns the data objects for the specified rule group.
- Parameters:
describeRuleGroupRequest
-- Returns:
- A Java Future containing the result of the DescribeRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeRuleGroup
default CompletableFuture<DescribeRuleGroupResponse> describeRuleGroup(Consumer<DescribeRuleGroupRequest.Builder> describeRuleGroupRequest) Returns the data objects for the specified rule group.
This is a convenience which creates an instance of the
DescribeRuleGroupRequest.Builder
avoiding the need to create one manually viaDescribeRuleGroupRequest.builder()
- Parameters:
describeRuleGroupRequest
- AConsumer
that will call methods onDescribeRuleGroupRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeRuleGroupMetadata
default CompletableFuture<DescribeRuleGroupMetadataResponse> describeRuleGroupMetadata(DescribeRuleGroupMetadataRequest describeRuleGroupMetadataRequest) High-level information about a rule group, returned by operations like create and describe. You can use the information provided in the metadata to retrieve and manage a rule group. You can retrieve all objects for a rule group by calling DescribeRuleGroup.
- Parameters:
describeRuleGroupMetadataRequest
-- Returns:
- A Java Future containing the result of the DescribeRuleGroupMetadata operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeRuleGroupMetadata
default CompletableFuture<DescribeRuleGroupMetadataResponse> describeRuleGroupMetadata(Consumer<DescribeRuleGroupMetadataRequest.Builder> describeRuleGroupMetadataRequest) High-level information about a rule group, returned by operations like create and describe. You can use the information provided in the metadata to retrieve and manage a rule group. You can retrieve all objects for a rule group by calling DescribeRuleGroup.
This is a convenience which creates an instance of the
DescribeRuleGroupMetadataRequest.Builder
avoiding the need to create one manually viaDescribeRuleGroupMetadataRequest.builder()
- Parameters:
describeRuleGroupMetadataRequest
- AConsumer
that will call methods onDescribeRuleGroupMetadataRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeRuleGroupMetadata operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeRuleGroupSummary
default CompletableFuture<DescribeRuleGroupSummaryResponse> describeRuleGroupSummary(DescribeRuleGroupSummaryRequest describeRuleGroupSummaryRequest) Returns detailed information for a stateful rule group.
For active threat defense Amazon Web Services managed rule groups, this operation provides insight into the protections enabled by the rule group, based on Suricata rule metadata fields. Summaries are available for rule groups you manage and for active threat defense Amazon Web Services managed rule groups.
To modify how threat information appears in summaries, use the
SummaryConfiguration
parameter in UpdateRuleGroup.- Parameters:
describeRuleGroupSummaryRequest
-- Returns:
- A Java Future containing the result of the DescribeRuleGroupSummary operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeRuleGroupSummary
default CompletableFuture<DescribeRuleGroupSummaryResponse> describeRuleGroupSummary(Consumer<DescribeRuleGroupSummaryRequest.Builder> describeRuleGroupSummaryRequest) Returns detailed information for a stateful rule group.
For active threat defense Amazon Web Services managed rule groups, this operation provides insight into the protections enabled by the rule group, based on Suricata rule metadata fields. Summaries are available for rule groups you manage and for active threat defense Amazon Web Services managed rule groups.
To modify how threat information appears in summaries, use the
SummaryConfiguration
parameter in UpdateRuleGroup.
This is a convenience which creates an instance of the
DescribeRuleGroupSummaryRequest.Builder
avoiding the need to create one manually viaDescribeRuleGroupSummaryRequest.builder()
- Parameters:
describeRuleGroupSummaryRequest
- AConsumer
that will call methods onDescribeRuleGroupSummaryRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeRuleGroupSummary operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeTLSInspectionConfiguration
default CompletableFuture<DescribeTlsInspectionConfigurationResponse> describeTLSInspectionConfiguration(DescribeTlsInspectionConfigurationRequest describeTlsInspectionConfigurationRequest) Returns the data objects for the specified TLS inspection configuration.
- Parameters:
describeTlsInspectionConfigurationRequest
-- Returns:
- A Java Future containing the result of the DescribeTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeTLSInspectionConfiguration
default CompletableFuture<DescribeTlsInspectionConfigurationResponse> describeTLSInspectionConfiguration(Consumer<DescribeTlsInspectionConfigurationRequest.Builder> describeTlsInspectionConfigurationRequest) Returns the data objects for the specified TLS inspection configuration.
This is a convenience which creates an instance of the
DescribeTlsInspectionConfigurationRequest.Builder
avoiding the need to create one manually viaDescribeTlsInspectionConfigurationRequest.builder()
- Parameters:
describeTlsInspectionConfigurationRequest
- AConsumer
that will call methods onDescribeTlsInspectionConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeVpcEndpointAssociation
default CompletableFuture<DescribeVpcEndpointAssociationResponse> describeVpcEndpointAssociation(DescribeVpcEndpointAssociationRequest describeVpcEndpointAssociationRequest) Returns the data object for the specified VPC endpoint association.
- Parameters:
describeVpcEndpointAssociationRequest
-- Returns:
- A Java Future containing the result of the DescribeVpcEndpointAssociation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
describeVpcEndpointAssociation
default CompletableFuture<DescribeVpcEndpointAssociationResponse> describeVpcEndpointAssociation(Consumer<DescribeVpcEndpointAssociationRequest.Builder> describeVpcEndpointAssociationRequest) Returns the data object for the specified VPC endpoint association.
This is a convenience which creates an instance of the
DescribeVpcEndpointAssociationRequest.Builder
avoiding the need to create one manually viaDescribeVpcEndpointAssociationRequest.builder()
- Parameters:
describeVpcEndpointAssociationRequest
- AConsumer
that will call methods onDescribeVpcEndpointAssociationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DescribeVpcEndpointAssociation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
disassociateAvailabilityZones
default CompletableFuture<DisassociateAvailabilityZonesResponse> disassociateAvailabilityZones(DisassociateAvailabilityZonesRequest disassociateAvailabilityZonesRequest) Removes the specified Availability Zone associations from a transit gateway-attached firewall. This removes the firewall endpoints from these Availability Zones and stops traffic filtering in those zones. Before removing an Availability Zone, ensure you've updated your transit gateway route tables to redirect traffic appropriately.
If
AvailabilityZoneChangeProtection
is enabled, you must first disable it using UpdateAvailabilityZoneChangeProtection.To verify the status of your Availability Zone changes, use DescribeFirewall.
- Parameters:
disassociateAvailabilityZonesRequest
-- Returns:
- A Java Future containing the result of the DisassociateAvailabilityZones operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
disassociateAvailabilityZones
default CompletableFuture<DisassociateAvailabilityZonesResponse> disassociateAvailabilityZones(Consumer<DisassociateAvailabilityZonesRequest.Builder> disassociateAvailabilityZonesRequest) Removes the specified Availability Zone associations from a transit gateway-attached firewall. This removes the firewall endpoints from these Availability Zones and stops traffic filtering in those zones. Before removing an Availability Zone, ensure you've updated your transit gateway route tables to redirect traffic appropriately.
If
AvailabilityZoneChangeProtection
is enabled, you must first disable it using UpdateAvailabilityZoneChangeProtection.To verify the status of your Availability Zone changes, use DescribeFirewall.
This is a convenience which creates an instance of the
DisassociateAvailabilityZonesRequest.Builder
avoiding the need to create one manually viaDisassociateAvailabilityZonesRequest.builder()
- Parameters:
disassociateAvailabilityZonesRequest
- AConsumer
that will call methods onDisassociateAvailabilityZonesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DisassociateAvailabilityZones operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
disassociateSubnets
default CompletableFuture<DisassociateSubnetsResponse> disassociateSubnets(DisassociateSubnetsRequest disassociateSubnetsRequest) 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.
- Parameters:
disassociateSubnetsRequest
-- Returns:
- A Java Future containing the result of the DisassociateSubnets operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
disassociateSubnets
default CompletableFuture<DisassociateSubnetsResponse> disassociateSubnets(Consumer<DisassociateSubnetsRequest.Builder> disassociateSubnetsRequest) 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.
This is a convenience which creates an instance of the
DisassociateSubnetsRequest.Builder
avoiding the need to create one manually viaDisassociateSubnetsRequest.builder()
- Parameters:
disassociateSubnetsRequest
- AConsumer
that will call methods onDisassociateSubnetsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the DisassociateSubnets operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- InvalidOperationException The operation failed because it's not valid. For example, you might have tried to delete a rule group or firewall policy that's in use.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
getAnalysisReportResults
default CompletableFuture<GetAnalysisReportResultsResponse> getAnalysisReportResults(GetAnalysisReportResultsRequest getAnalysisReportResultsRequest) The results of a
COMPLETED
analysis report generated with StartAnalysisReport.For more information, see AnalysisTypeReportResult.
- Parameters:
getAnalysisReportResultsRequest
-- Returns:
- A Java Future containing the result of the GetAnalysisReportResults operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
getAnalysisReportResults
default CompletableFuture<GetAnalysisReportResultsResponse> getAnalysisReportResults(Consumer<GetAnalysisReportResultsRequest.Builder> getAnalysisReportResultsRequest) The results of a
COMPLETED
analysis report generated with StartAnalysisReport.For more information, see AnalysisTypeReportResult.
This is a convenience which creates an instance of the
GetAnalysisReportResultsRequest.Builder
avoiding the need to create one manually viaGetAnalysisReportResultsRequest.builder()
- Parameters:
getAnalysisReportResultsRequest
- AConsumer
that will call methods onGetAnalysisReportResultsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the GetAnalysisReportResults operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
getAnalysisReportResultsPaginator
default GetAnalysisReportResultsPublisher getAnalysisReportResultsPaginator(GetAnalysisReportResultsRequest getAnalysisReportResultsRequest) This is a variant of
getAnalysisReportResults(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.GetAnalysisReportResultsPublisher publisher = client.getAnalysisReportResultsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.GetAnalysisReportResultsPublisher publisher = client.getAnalysisReportResultsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getAnalysisReportResults(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsRequest)
operation.- Parameters:
getAnalysisReportResultsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
getAnalysisReportResultsPaginator
default GetAnalysisReportResultsPublisher getAnalysisReportResultsPaginator(Consumer<GetAnalysisReportResultsRequest.Builder> getAnalysisReportResultsRequest) This is a variant of
getAnalysisReportResults(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.GetAnalysisReportResultsPublisher publisher = client.getAnalysisReportResultsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.GetAnalysisReportResultsPublisher publisher = client.getAnalysisReportResultsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getAnalysisReportResults(software.amazon.awssdk.services.networkfirewall.model.GetAnalysisReportResultsRequest)
operation.
This is a convenience which creates an instance of the
GetAnalysisReportResultsRequest.Builder
avoiding the need to create one manually viaGetAnalysisReportResultsRequest.builder()
- Parameters:
getAnalysisReportResultsRequest
- AConsumer
that will call methods onGetAnalysisReportResultsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listAnalysisReports
default CompletableFuture<ListAnalysisReportsResponse> listAnalysisReports(ListAnalysisReportsRequest listAnalysisReportsRequest) Returns a list of all traffic analysis reports generated within the last 30 days.
- Parameters:
listAnalysisReportsRequest
-- Returns:
- A Java Future containing the result of the ListAnalysisReports operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listAnalysisReports
default CompletableFuture<ListAnalysisReportsResponse> listAnalysisReports(Consumer<ListAnalysisReportsRequest.Builder> listAnalysisReportsRequest) Returns a list of all traffic analysis reports generated within the last 30 days.
This is a convenience which creates an instance of the
ListAnalysisReportsRequest.Builder
avoiding the need to create one manually viaListAnalysisReportsRequest.builder()
- Parameters:
listAnalysisReportsRequest
- AConsumer
that will call methods onListAnalysisReportsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListAnalysisReports operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listAnalysisReportsPaginator
default ListAnalysisReportsPublisher listAnalysisReportsPaginator(ListAnalysisReportsRequest listAnalysisReportsRequest) This is a variant of
listAnalysisReports(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListAnalysisReportsPublisher publisher = client.listAnalysisReportsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListAnalysisReportsPublisher publisher = client.listAnalysisReportsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAnalysisReports(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsRequest)
operation.- Parameters:
listAnalysisReportsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listAnalysisReportsPaginator
default ListAnalysisReportsPublisher listAnalysisReportsPaginator(Consumer<ListAnalysisReportsRequest.Builder> listAnalysisReportsRequest) This is a variant of
listAnalysisReports(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListAnalysisReportsPublisher publisher = client.listAnalysisReportsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListAnalysisReportsPublisher publisher = client.listAnalysisReportsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAnalysisReports(software.amazon.awssdk.services.networkfirewall.model.ListAnalysisReportsRequest)
operation.
This is a convenience which creates an instance of the
ListAnalysisReportsRequest.Builder
avoiding the need to create one manually viaListAnalysisReportsRequest.builder()
- Parameters:
listAnalysisReportsRequest
- AConsumer
that will call methods onListAnalysisReportsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewallPolicies
default CompletableFuture<ListFirewallPoliciesResponse> listFirewallPolicies(ListFirewallPoliciesRequest listFirewallPoliciesRequest) Retrieves the metadata for the firewall policies that you have defined. Depending on your setting for max results and the number of firewall policies, a single call might not return the full list.
- Parameters:
listFirewallPoliciesRequest
-- Returns:
- A Java Future containing the result of the ListFirewallPolicies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewallPolicies
default CompletableFuture<ListFirewallPoliciesResponse> listFirewallPolicies(Consumer<ListFirewallPoliciesRequest.Builder> listFirewallPoliciesRequest) Retrieves the metadata for the firewall policies that you have defined. Depending on your setting for max results and the number of firewall policies, a single call might not return the full list.
This is a convenience which creates an instance of the
ListFirewallPoliciesRequest.Builder
avoiding the need to create one manually viaListFirewallPoliciesRequest.builder()
- Parameters:
listFirewallPoliciesRequest
- AConsumer
that will call methods onListFirewallPoliciesRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListFirewallPolicies operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewallPoliciesPaginator
default ListFirewallPoliciesPublisher listFirewallPoliciesPaginator(ListFirewallPoliciesRequest listFirewallPoliciesRequest) This is a variant of
listFirewallPolicies(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFirewallPoliciesPublisher publisher = client.listFirewallPoliciesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFirewallPoliciesPublisher publisher = client.listFirewallPoliciesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFirewallPolicies(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesRequest)
operation.- Parameters:
listFirewallPoliciesRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewallPoliciesPaginator
default ListFirewallPoliciesPublisher listFirewallPoliciesPaginator(Consumer<ListFirewallPoliciesRequest.Builder> listFirewallPoliciesRequest) This is a variant of
listFirewallPolicies(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFirewallPoliciesPublisher publisher = client.listFirewallPoliciesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFirewallPoliciesPublisher publisher = client.listFirewallPoliciesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFirewallPolicies(software.amazon.awssdk.services.networkfirewall.model.ListFirewallPoliciesRequest)
operation.
This is a convenience which creates an instance of the
ListFirewallPoliciesRequest.Builder
avoiding the need to create one manually viaListFirewallPoliciesRequest.builder()
- Parameters:
listFirewallPoliciesRequest
- AConsumer
that will call methods onListFirewallPoliciesRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewalls
default CompletableFuture<ListFirewallsResponse> listFirewalls(ListFirewallsRequest listFirewallsRequest) Retrieves the metadata for the firewalls that you have defined. If you provide VPC identifiers in your request, this returns only the firewalls for those VPCs.
Depending on your setting for max results and the number of firewalls, a single call might not return the full list.
- Parameters:
listFirewallsRequest
-- Returns:
- A Java Future containing the result of the ListFirewalls operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewalls
default CompletableFuture<ListFirewallsResponse> listFirewalls(Consumer<ListFirewallsRequest.Builder> listFirewallsRequest) Retrieves the metadata for the firewalls that you have defined. If you provide VPC identifiers in your request, this returns only the firewalls for those VPCs.
Depending on your setting for max results and the number of firewalls, a single call might not return the full list.
This is a convenience which creates an instance of the
ListFirewallsRequest.Builder
avoiding the need to create one manually viaListFirewallsRequest.builder()
- Parameters:
listFirewallsRequest
- AConsumer
that will call methods onListFirewallsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListFirewalls operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewallsPaginator
This is a variant of
listFirewalls(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFirewallsPublisher publisher = client.listFirewallsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFirewallsPublisher publisher = client.listFirewallsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFirewallsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFirewalls(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsRequest)
operation.- Parameters:
listFirewallsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFirewallsPaginator
default ListFirewallsPublisher listFirewallsPaginator(Consumer<ListFirewallsRequest.Builder> listFirewallsRequest) This is a variant of
listFirewalls(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFirewallsPublisher publisher = client.listFirewallsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFirewallsPublisher publisher = client.listFirewallsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFirewallsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFirewalls(software.amazon.awssdk.services.networkfirewall.model.ListFirewallsRequest)
operation.
This is a convenience which creates an instance of the
ListFirewallsRequest.Builder
avoiding the need to create one manually viaListFirewallsRequest.builder()
- Parameters:
listFirewallsRequest
- AConsumer
that will call methods onListFirewallsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperationResults
default CompletableFuture<ListFlowOperationResultsResponse> listFlowOperationResults(ListFlowOperationResultsRequest listFlowOperationResultsRequest) Returns the results of a specific flow operation.
Flow operations let you manage the flows tracked in the flow table, also known as the firewall table.
A flow is network traffic that is monitored by a firewall, either by stateful or stateless rules. For traffic to be considered part of a flow, it must share Destination, DestinationPort, Direction, Protocol, Source, and SourcePort.
- Parameters:
listFlowOperationResultsRequest
-- Returns:
- A Java Future containing the result of the ListFlowOperationResults operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperationResults
default CompletableFuture<ListFlowOperationResultsResponse> listFlowOperationResults(Consumer<ListFlowOperationResultsRequest.Builder> listFlowOperationResultsRequest) Returns the results of a specific flow operation.
Flow operations let you manage the flows tracked in the flow table, also known as the firewall table.
A flow is network traffic that is monitored by a firewall, either by stateful or stateless rules. For traffic to be considered part of a flow, it must share Destination, DestinationPort, Direction, Protocol, Source, and SourcePort.
This is a convenience which creates an instance of the
ListFlowOperationResultsRequest.Builder
avoiding the need to create one manually viaListFlowOperationResultsRequest.builder()
- Parameters:
listFlowOperationResultsRequest
- AConsumer
that will call methods onListFlowOperationResultsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListFlowOperationResults operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperationResultsPaginator
default ListFlowOperationResultsPublisher listFlowOperationResultsPaginator(ListFlowOperationResultsRequest listFlowOperationResultsRequest) This is a variant of
listFlowOperationResults(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationResultsPublisher publisher = client.listFlowOperationResultsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationResultsPublisher publisher = client.listFlowOperationResultsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFlowOperationResults(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsRequest)
operation.- Parameters:
listFlowOperationResultsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperationResultsPaginator
default ListFlowOperationResultsPublisher listFlowOperationResultsPaginator(Consumer<ListFlowOperationResultsRequest.Builder> listFlowOperationResultsRequest) This is a variant of
listFlowOperationResults(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationResultsPublisher publisher = client.listFlowOperationResultsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationResultsPublisher publisher = client.listFlowOperationResultsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFlowOperationResults(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationResultsRequest)
operation.
This is a convenience which creates an instance of the
ListFlowOperationResultsRequest.Builder
avoiding the need to create one manually viaListFlowOperationResultsRequest.builder()
- Parameters:
listFlowOperationResultsRequest
- AConsumer
that will call methods onListFlowOperationResultsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperations
default CompletableFuture<ListFlowOperationsResponse> listFlowOperations(ListFlowOperationsRequest listFlowOperationsRequest) Returns a list of all flow operations ran in a specific firewall. You can optionally narrow the request scope by specifying the operation type or Availability Zone associated with a firewall's flow operations.
Flow operations let you manage the flows tracked in the flow table, also known as the firewall table.
A flow is network traffic that is monitored by a firewall, either by stateful or stateless rules. For traffic to be considered part of a flow, it must share Destination, DestinationPort, Direction, Protocol, Source, and SourcePort.
- Parameters:
listFlowOperationsRequest
-- Returns:
- A Java Future containing the result of the ListFlowOperations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperations
default CompletableFuture<ListFlowOperationsResponse> listFlowOperations(Consumer<ListFlowOperationsRequest.Builder> listFlowOperationsRequest) Returns a list of all flow operations ran in a specific firewall. You can optionally narrow the request scope by specifying the operation type or Availability Zone associated with a firewall's flow operations.
Flow operations let you manage the flows tracked in the flow table, also known as the firewall table.
A flow is network traffic that is monitored by a firewall, either by stateful or stateless rules. For traffic to be considered part of a flow, it must share Destination, DestinationPort, Direction, Protocol, Source, and SourcePort.
This is a convenience which creates an instance of the
ListFlowOperationsRequest.Builder
avoiding the need to create one manually viaListFlowOperationsRequest.builder()
- Parameters:
listFlowOperationsRequest
- AConsumer
that will call methods onListFlowOperationsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListFlowOperations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperationsPaginator
default ListFlowOperationsPublisher listFlowOperationsPaginator(ListFlowOperationsRequest listFlowOperationsRequest) This is a variant of
listFlowOperations(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationsPublisher publisher = client.listFlowOperationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationsPublisher publisher = client.listFlowOperationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFlowOperations(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsRequest)
operation.- Parameters:
listFlowOperationsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listFlowOperationsPaginator
default ListFlowOperationsPublisher listFlowOperationsPaginator(Consumer<ListFlowOperationsRequest.Builder> listFlowOperationsRequest) This is a variant of
listFlowOperations(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationsPublisher publisher = client.listFlowOperationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListFlowOperationsPublisher publisher = client.listFlowOperationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listFlowOperations(software.amazon.awssdk.services.networkfirewall.model.ListFlowOperationsRequest)
operation.
This is a convenience which creates an instance of the
ListFlowOperationsRequest.Builder
avoiding the need to create one manually viaListFlowOperationsRequest.builder()
- Parameters:
listFlowOperationsRequest
- AConsumer
that will call methods onListFlowOperationsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listRuleGroups
default CompletableFuture<ListRuleGroupsResponse> listRuleGroups(ListRuleGroupsRequest listRuleGroupsRequest) Retrieves the metadata for the rule groups that you have defined. Depending on your setting for max results and the number of rule groups, a single call might not return the full list.
- Parameters:
listRuleGroupsRequest
-- Returns:
- A Java Future containing the result of the ListRuleGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listRuleGroups
default CompletableFuture<ListRuleGroupsResponse> listRuleGroups(Consumer<ListRuleGroupsRequest.Builder> listRuleGroupsRequest) Retrieves the metadata for the rule groups that you have defined. Depending on your setting for max results and the number of rule groups, a single call might not return the full list.
This is a convenience which creates an instance of the
ListRuleGroupsRequest.Builder
avoiding the need to create one manually viaListRuleGroupsRequest.builder()
- Parameters:
listRuleGroupsRequest
- AConsumer
that will call methods onListRuleGroupsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListRuleGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listRuleGroupsPaginator
default ListRuleGroupsPublisher listRuleGroupsPaginator(ListRuleGroupsRequest listRuleGroupsRequest) This is a variant of
listRuleGroups(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListRuleGroupsPublisher publisher = client.listRuleGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListRuleGroupsPublisher publisher = client.listRuleGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listRuleGroups(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsRequest)
operation.- Parameters:
listRuleGroupsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listRuleGroupsPaginator
default ListRuleGroupsPublisher listRuleGroupsPaginator(Consumer<ListRuleGroupsRequest.Builder> listRuleGroupsRequest) This is a variant of
listRuleGroups(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListRuleGroupsPublisher publisher = client.listRuleGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListRuleGroupsPublisher publisher = client.listRuleGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listRuleGroups(software.amazon.awssdk.services.networkfirewall.model.ListRuleGroupsRequest)
operation.
This is a convenience which creates an instance of the
ListRuleGroupsRequest.Builder
avoiding the need to create one manually viaListRuleGroupsRequest.builder()
- Parameters:
listRuleGroupsRequest
- AConsumer
that will call methods onListRuleGroupsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listTLSInspectionConfigurations
default CompletableFuture<ListTlsInspectionConfigurationsResponse> listTLSInspectionConfigurations(ListTlsInspectionConfigurationsRequest listTlsInspectionConfigurationsRequest) Retrieves the metadata for the TLS inspection configurations that you have defined. Depending on your setting for max results and the number of TLS inspection configurations, a single call might not return the full list.
- Parameters:
listTlsInspectionConfigurationsRequest
-- Returns:
- A Java Future containing the result of the ListTLSInspectionConfigurations operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listTLSInspectionConfigurations
default CompletableFuture<ListTlsInspectionConfigurationsResponse> listTLSInspectionConfigurations(Consumer<ListTlsInspectionConfigurationsRequest.Builder> listTlsInspectionConfigurationsRequest) Retrieves the metadata for the TLS inspection configurations that you have defined. Depending on your setting for max results and the number of TLS inspection configurations, a single call might not return the full list.
This is a convenience which creates an instance of the
ListTlsInspectionConfigurationsRequest.Builder
avoiding the need to create one manually viaListTlsInspectionConfigurationsRequest.builder()
- Parameters:
listTlsInspectionConfigurationsRequest
- AConsumer
that will call methods onListTlsInspectionConfigurationsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListTLSInspectionConfigurations operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listTLSInspectionConfigurationsPaginator
default ListTLSInspectionConfigurationsPublisher listTLSInspectionConfigurationsPaginator(ListTlsInspectionConfigurationsRequest listTlsInspectionConfigurationsRequest) This is a variant of
listTLSInspectionConfigurations(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListTLSInspectionConfigurationsPublisher publisher = client.listTLSInspectionConfigurationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListTLSInspectionConfigurationsPublisher publisher = client.listTLSInspectionConfigurationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listTLSInspectionConfigurations(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsRequest)
operation.- Parameters:
listTlsInspectionConfigurationsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listTLSInspectionConfigurationsPaginator
default ListTLSInspectionConfigurationsPublisher listTLSInspectionConfigurationsPaginator(Consumer<ListTlsInspectionConfigurationsRequest.Builder> listTlsInspectionConfigurationsRequest) This is a variant of
listTLSInspectionConfigurations(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListTLSInspectionConfigurationsPublisher publisher = client.listTLSInspectionConfigurationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListTLSInspectionConfigurationsPublisher publisher = client.listTLSInspectionConfigurationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listTLSInspectionConfigurations(software.amazon.awssdk.services.networkfirewall.model.ListTlsInspectionConfigurationsRequest)
operation.
This is a convenience which creates an instance of the
ListTlsInspectionConfigurationsRequest.Builder
avoiding the need to create one manually viaListTlsInspectionConfigurationsRequest.builder()
- Parameters:
listTlsInspectionConfigurationsRequest
- AConsumer
that will call methods onListTlsInspectionConfigurationsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Retrieves the tags associated with the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
You can tag the Amazon Web Services resources that you manage through Network Firewall: firewalls, firewall policies, and rule groups.
- Parameters:
listTagsForResourceRequest
-- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Retrieves the tags associated with the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
You can tag the Amazon Web Services resources that you manage through Network Firewall: firewalls, firewall policies, and rule groups.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builder
avoiding the need to create one manually viaListTagsForResourceRequest.builder()
- Parameters:
listTagsForResourceRequest
- AConsumer
that will call methods onListTagsForResourceRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResourcePaginator
default ListTagsForResourcePublisher listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest) This is a variant of
listTagsForResource(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listTagsForResource(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceRequest)
operation.- Parameters:
listTagsForResourceRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResourcePaginator
default ListTagsForResourcePublisher listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) This is a variant of
listTagsForResource(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listTagsForResource(software.amazon.awssdk.services.networkfirewall.model.ListTagsForResourceRequest)
operation.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builder
avoiding the need to create one manually viaListTagsForResourceRequest.builder()
- Parameters:
listTagsForResourceRequest
- AConsumer
that will call methods onListTagsForResourceRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listVpcEndpointAssociations
default CompletableFuture<ListVpcEndpointAssociationsResponse> listVpcEndpointAssociations(ListVpcEndpointAssociationsRequest listVpcEndpointAssociationsRequest) Retrieves the metadata for the VPC endpoint associations that you have defined. If you specify a fireawll, this returns only the endpoint associations for that firewall.
Depending on your setting for max results and the number of associations, a single call might not return the full list.
- Parameters:
listVpcEndpointAssociationsRequest
-- Returns:
- A Java Future containing the result of the ListVpcEndpointAssociations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listVpcEndpointAssociations
default CompletableFuture<ListVpcEndpointAssociationsResponse> listVpcEndpointAssociations(Consumer<ListVpcEndpointAssociationsRequest.Builder> listVpcEndpointAssociationsRequest) Retrieves the metadata for the VPC endpoint associations that you have defined. If you specify a fireawll, this returns only the endpoint associations for that firewall.
Depending on your setting for max results and the number of associations, a single call might not return the full list.
This is a convenience which creates an instance of the
ListVpcEndpointAssociationsRequest.Builder
avoiding the need to create one manually viaListVpcEndpointAssociationsRequest.builder()
- Parameters:
listVpcEndpointAssociationsRequest
- AConsumer
that will call methods onListVpcEndpointAssociationsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the ListVpcEndpointAssociations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listVpcEndpointAssociationsPaginator
default ListVpcEndpointAssociationsPublisher listVpcEndpointAssociationsPaginator(ListVpcEndpointAssociationsRequest listVpcEndpointAssociationsRequest) This is a variant of
listVpcEndpointAssociations(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListVpcEndpointAssociationsPublisher publisher = client.listVpcEndpointAssociationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListVpcEndpointAssociationsPublisher publisher = client.listVpcEndpointAssociationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listVpcEndpointAssociations(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsRequest)
operation.- Parameters:
listVpcEndpointAssociationsRequest
-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
listVpcEndpointAssociationsPaginator
default ListVpcEndpointAssociationsPublisher listVpcEndpointAssociationsPaginator(Consumer<ListVpcEndpointAssociationsRequest.Builder> listVpcEndpointAssociationsRequest) This is a variant of
listVpcEndpointAssociations(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsRequest)
operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber)
. Each call to the subscribe method will result in a newSubscription
i.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper methodsoftware.amazon.awssdk.services.networkfirewall.paginators.ListVpcEndpointAssociationsPublisher publisher = client.listVpcEndpointAssociationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
software.amazon.awssdk.services.networkfirewall.paginators.ListVpcEndpointAssociationsPublisher publisher = client.listVpcEndpointAssociationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsResponse response) { //... }; });
Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listVpcEndpointAssociations(software.amazon.awssdk.services.networkfirewall.model.ListVpcEndpointAssociationsRequest)
operation.
This is a convenience which creates an instance of the
ListVpcEndpointAssociationsRequest.Builder
avoiding the need to create one manually viaListVpcEndpointAssociationsRequest.builder()
- Parameters:
listVpcEndpointAssociationsRequest
- AConsumer
that will call methods onListVpcEndpointAssociationsRequest.Builder
to create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
putResourcePolicy
default CompletableFuture<PutResourcePolicyResponse> putResourcePolicy(PutResourcePolicyRequest putResourcePolicyRequest) Creates or updates an IAM policy for your rule group, firewall policy, or firewall. Use this to share these resources between accounts. This operation works in conjunction with the Amazon Web Services Resource Access Manager (RAM) service to manage resource sharing for Network Firewall.
For information about using sharing with Network Firewall resources, see Sharing Network Firewall resources in the Network Firewall Developer Guide.
Use this operation to create or update a resource policy for your Network Firewall rule group, firewall policy, or firewall. In the resource policy, you specify the accounts that you want to share the Network Firewall resource with and the operations that you want the accounts to be able to perform.
When you add an account in the resource policy, you then run the following Resource Access Manager (RAM) operations to access and accept the shared resource.
-
GetResourceShareInvitations - Returns the Amazon Resource Names (ARNs) of the resource share invitations.
-
AcceptResourceShareInvitation - Accepts the share invitation for a specified resource share.
For additional information about resource sharing using RAM, see Resource Access Manager User Guide.
- Parameters:
putResourcePolicyRequest
-- Returns:
- A Java Future containing the result of the PutResourcePolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidResourcePolicyException The policy statement failed validation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
-
putResourcePolicy
default CompletableFuture<PutResourcePolicyResponse> putResourcePolicy(Consumer<PutResourcePolicyRequest.Builder> putResourcePolicyRequest) Creates or updates an IAM policy for your rule group, firewall policy, or firewall. Use this to share these resources between accounts. This operation works in conjunction with the Amazon Web Services Resource Access Manager (RAM) service to manage resource sharing for Network Firewall.
For information about using sharing with Network Firewall resources, see Sharing Network Firewall resources in the Network Firewall Developer Guide.
Use this operation to create or update a resource policy for your Network Firewall rule group, firewall policy, or firewall. In the resource policy, you specify the accounts that you want to share the Network Firewall resource with and the operations that you want the accounts to be able to perform.
When you add an account in the resource policy, you then run the following Resource Access Manager (RAM) operations to access and accept the shared resource.
-
GetResourceShareInvitations - Returns the Amazon Resource Names (ARNs) of the resource share invitations.
-
AcceptResourceShareInvitation - Accepts the share invitation for a specified resource share.
For additional information about resource sharing using RAM, see Resource Access Manager User Guide.
This is a convenience which creates an instance of the
PutResourcePolicyRequest.Builder
avoiding the need to create one manually viaPutResourcePolicyRequest.builder()
- Parameters:
putResourcePolicyRequest
- AConsumer
that will call methods onPutResourcePolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the PutResourcePolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidResourcePolicyException The policy statement failed validation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
-
rejectNetworkFirewallTransitGatewayAttachment
default CompletableFuture<RejectNetworkFirewallTransitGatewayAttachmentResponse> rejectNetworkFirewallTransitGatewayAttachment(RejectNetworkFirewallTransitGatewayAttachmentRequest rejectNetworkFirewallTransitGatewayAttachmentRequest) Rejects a transit gateway attachment request for Network Firewall. When you reject the attachment request, Network Firewall cancels the creation of routing components between the transit gateway and firewall endpoints.
Only the firewall owner can reject the attachment. After rejection, no traffic will flow through the firewall endpoints for this attachment.
Use DescribeFirewall to monitor the rejection status. To accept the attachment instead of rejecting it, use AcceptNetworkFirewallTransitGatewayAttachment.
Once rejected, you cannot reverse this action. To establish connectivity, you must create a new transit gateway-attached firewall.
- Parameters:
rejectNetworkFirewallTransitGatewayAttachmentRequest
-- Returns:
- A Java Future containing the result of the RejectNetworkFirewallTransitGatewayAttachment operation
returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
rejectNetworkFirewallTransitGatewayAttachment
default CompletableFuture<RejectNetworkFirewallTransitGatewayAttachmentResponse> rejectNetworkFirewallTransitGatewayAttachment(Consumer<RejectNetworkFirewallTransitGatewayAttachmentRequest.Builder> rejectNetworkFirewallTransitGatewayAttachmentRequest) Rejects a transit gateway attachment request for Network Firewall. When you reject the attachment request, Network Firewall cancels the creation of routing components between the transit gateway and firewall endpoints.
Only the firewall owner can reject the attachment. After rejection, no traffic will flow through the firewall endpoints for this attachment.
Use DescribeFirewall to monitor the rejection status. To accept the attachment instead of rejecting it, use AcceptNetworkFirewallTransitGatewayAttachment.
Once rejected, you cannot reverse this action. To establish connectivity, you must create a new transit gateway-attached firewall.
This is a convenience which creates an instance of the
RejectNetworkFirewallTransitGatewayAttachmentRequest.Builder
avoiding the need to create one manually viaRejectNetworkFirewallTransitGatewayAttachmentRequest.builder()
- Parameters:
rejectNetworkFirewallTransitGatewayAttachmentRequest
- AConsumer
that will call methods onRejectNetworkFirewallTransitGatewayAttachmentRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the RejectNetworkFirewallTransitGatewayAttachment operation
returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
startAnalysisReport
default CompletableFuture<StartAnalysisReportResponse> startAnalysisReport(StartAnalysisReportRequest startAnalysisReportRequest) Generates a traffic analysis report for the timeframe and traffic type you specify.
For information on the contents of a traffic analysis report, see AnalysisReport.
- Parameters:
startAnalysisReportRequest
-- Returns:
- A Java Future containing the result of the StartAnalysisReport operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
startAnalysisReport
default CompletableFuture<StartAnalysisReportResponse> startAnalysisReport(Consumer<StartAnalysisReportRequest.Builder> startAnalysisReportRequest) Generates a traffic analysis report for the timeframe and traffic type you specify.
For information on the contents of a traffic analysis report, see AnalysisReport.
This is a convenience which creates an instance of the
StartAnalysisReportRequest.Builder
avoiding the need to create one manually viaStartAnalysisReportRequest.builder()
- Parameters:
startAnalysisReportRequest
- AConsumer
that will call methods onStartAnalysisReportRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StartAnalysisReport operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
startFlowCapture
default CompletableFuture<StartFlowCaptureResponse> startFlowCapture(StartFlowCaptureRequest startFlowCaptureRequest) Begins capturing the flows in a firewall, according to the filters you define. Captures are similar, but not identical to snapshots. Capture operations provide visibility into flows that are not closed and are tracked by a firewall's flow table. Unlike snapshots, captures are a time-boxed view.
A flow is network traffic that is monitored by a firewall, either by stateful or stateless rules. For traffic to be considered part of a flow, it must share Destination, DestinationPort, Direction, Protocol, Source, and SourcePort.
To avoid encountering operation limits, you should avoid starting captures with broad filters, like wide IP ranges. Instead, we recommend you define more specific criteria with
FlowFilters
, like narrow IP ranges, ports, or protocols.- Parameters:
startFlowCaptureRequest
-- Returns:
- A Java Future containing the result of the StartFlowCapture operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
startFlowCapture
default CompletableFuture<StartFlowCaptureResponse> startFlowCapture(Consumer<StartFlowCaptureRequest.Builder> startFlowCaptureRequest) Begins capturing the flows in a firewall, according to the filters you define. Captures are similar, but not identical to snapshots. Capture operations provide visibility into flows that are not closed and are tracked by a firewall's flow table. Unlike snapshots, captures are a time-boxed view.
A flow is network traffic that is monitored by a firewall, either by stateful or stateless rules. For traffic to be considered part of a flow, it must share Destination, DestinationPort, Direction, Protocol, Source, and SourcePort.
To avoid encountering operation limits, you should avoid starting captures with broad filters, like wide IP ranges. Instead, we recommend you define more specific criteria with
FlowFilters
, like narrow IP ranges, ports, or protocols.
This is a convenience which creates an instance of the
StartFlowCaptureRequest.Builder
avoiding the need to create one manually viaStartFlowCaptureRequest.builder()
- Parameters:
startFlowCaptureRequest
- AConsumer
that will call methods onStartFlowCaptureRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StartFlowCapture operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
startFlowFlush
default CompletableFuture<StartFlowFlushResponse> startFlowFlush(StartFlowFlushRequest startFlowFlushRequest) Begins the flushing of traffic from the firewall, according to the filters you define. When the operation starts, impacted flows are temporarily marked as timed out before the Suricata engine prunes, or flushes, the flows from the firewall table.
While the flush completes, impacted flows are processed as midstream traffic. This may result in a temporary increase in midstream traffic metrics. We recommend that you double check your stream exception policy before you perform a flush operation.
- Parameters:
startFlowFlushRequest
-- Returns:
- A Java Future containing the result of the StartFlowFlush operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
startFlowFlush
default CompletableFuture<StartFlowFlushResponse> startFlowFlush(Consumer<StartFlowFlushRequest.Builder> startFlowFlushRequest) Begins the flushing of traffic from the firewall, according to the filters you define. When the operation starts, impacted flows are temporarily marked as timed out before the Suricata engine prunes, or flushes, the flows from the firewall table.
While the flush completes, impacted flows are processed as midstream traffic. This may result in a temporary increase in midstream traffic metrics. We recommend that you double check your stream exception policy before you perform a flush operation.
This is a convenience which creates an instance of the
StartFlowFlushRequest.Builder
avoiding the need to create one manually viaStartFlowFlushRequest.builder()
- Parameters:
startFlowFlushRequest
- AConsumer
that will call methods onStartFlowFlushRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the StartFlowFlush operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
tagResource
Adds the specified tags to the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
You can tag the Amazon Web Services resources that you manage through Network Firewall: firewalls, firewall policies, and rule groups.
- Parameters:
tagResourceRequest
-- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds the specified tags to the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
You can tag the Amazon Web Services resources that you manage through Network Firewall: firewalls, firewall policies, and rule groups.
This is a convenience which creates an instance of the
TagResourceRequest.Builder
avoiding the need to create one manually viaTagResourceRequest.builder()
- Parameters:
tagResourceRequest
- AConsumer
that will call methods onTagResourceRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes the tags with the specified keys from the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
You can manage tags for the Amazon Web Services resources that you manage through Network Firewall: firewalls, firewall policies, and rule groups.
- Parameters:
untagResourceRequest
-- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes the tags with the specified keys from the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each Amazon Web Services resource, up to 50 tags for a resource.
You can manage tags for the Amazon Web Services resources that you manage through Network Firewall: firewalls, firewall policies, and rule groups.
This is a convenience which creates an instance of the
UntagResourceRequest.Builder
avoiding the need to create one manually viaUntagResourceRequest.builder()
- Parameters:
untagResourceRequest
- AConsumer
that will call methods onUntagResourceRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateAvailabilityZoneChangeProtection
default CompletableFuture<UpdateAvailabilityZoneChangeProtectionResponse> updateAvailabilityZoneChangeProtection(UpdateAvailabilityZoneChangeProtectionRequest updateAvailabilityZoneChangeProtectionRequest) Modifies the
AvailabilityZoneChangeProtection
setting for a transit gateway-attached firewall. When enabled, this setting prevents accidental changes to the firewall's Availability Zone configuration. This helps protect against disrupting traffic flow in production environments.When enabled, you must disable this protection before using AssociateAvailabilityZones or DisassociateAvailabilityZones to modify the firewall's Availability Zone configuration.
- Parameters:
updateAvailabilityZoneChangeProtectionRequest
-- Returns:
- A Java Future containing the result of the UpdateAvailabilityZoneChangeProtection operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateAvailabilityZoneChangeProtection
default CompletableFuture<UpdateAvailabilityZoneChangeProtectionResponse> updateAvailabilityZoneChangeProtection(Consumer<UpdateAvailabilityZoneChangeProtectionRequest.Builder> updateAvailabilityZoneChangeProtectionRequest) Modifies the
AvailabilityZoneChangeProtection
setting for a transit gateway-attached firewall. When enabled, this setting prevents accidental changes to the firewall's Availability Zone configuration. This helps protect against disrupting traffic flow in production environments.When enabled, you must disable this protection before using AssociateAvailabilityZones or DisassociateAvailabilityZones to modify the firewall's Availability Zone configuration.
This is a convenience which creates an instance of the
UpdateAvailabilityZoneChangeProtectionRequest.Builder
avoiding the need to create one manually viaUpdateAvailabilityZoneChangeProtectionRequest.builder()
- Parameters:
updateAvailabilityZoneChangeProtectionRequest
- AConsumer
that will call methods onUpdateAvailabilityZoneChangeProtectionRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateAvailabilityZoneChangeProtection operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallAnalysisSettings
default CompletableFuture<UpdateFirewallAnalysisSettingsResponse> updateFirewallAnalysisSettings(UpdateFirewallAnalysisSettingsRequest updateFirewallAnalysisSettingsRequest) Enables specific types of firewall analysis on a specific firewall you define.
- Parameters:
updateFirewallAnalysisSettingsRequest
-- Returns:
- A Java Future containing the result of the UpdateFirewallAnalysisSettings operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallAnalysisSettings
default CompletableFuture<UpdateFirewallAnalysisSettingsResponse> updateFirewallAnalysisSettings(Consumer<UpdateFirewallAnalysisSettingsRequest.Builder> updateFirewallAnalysisSettingsRequest) Enables specific types of firewall analysis on a specific firewall you define.
This is a convenience which creates an instance of the
UpdateFirewallAnalysisSettingsRequest.Builder
avoiding the need to create one manually viaUpdateFirewallAnalysisSettingsRequest.builder()
- Parameters:
updateFirewallAnalysisSettingsRequest
- AConsumer
that will call methods onUpdateFirewallAnalysisSettingsRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateFirewallAnalysisSettings operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallDeleteProtection
default CompletableFuture<UpdateFirewallDeleteProtectionResponse> updateFirewallDeleteProtection(UpdateFirewallDeleteProtectionRequest updateFirewallDeleteProtectionRequest) Modifies the flag,
DeleteProtection
, which indicates whether it is possible to delete the firewall. If the flag is set toTRUE
, the firewall is protected against deletion. This setting helps protect against accidentally deleting a firewall that's in use.- Parameters:
updateFirewallDeleteProtectionRequest
-- Returns:
- A Java Future containing the result of the UpdateFirewallDeleteProtection operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallDeleteProtection
default CompletableFuture<UpdateFirewallDeleteProtectionResponse> updateFirewallDeleteProtection(Consumer<UpdateFirewallDeleteProtectionRequest.Builder> updateFirewallDeleteProtectionRequest) Modifies the flag,
DeleteProtection
, which indicates whether it is possible to delete the firewall. If the flag is set toTRUE
, the firewall is protected against deletion. This setting helps protect against accidentally deleting a firewall that's in use.
This is a convenience which creates an instance of the
UpdateFirewallDeleteProtectionRequest.Builder
avoiding the need to create one manually viaUpdateFirewallDeleteProtectionRequest.builder()
- Parameters:
updateFirewallDeleteProtectionRequest
- AConsumer
that will call methods onUpdateFirewallDeleteProtectionRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateFirewallDeleteProtection operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallDescription
default CompletableFuture<UpdateFirewallDescriptionResponse> updateFirewallDescription(UpdateFirewallDescriptionRequest updateFirewallDescriptionRequest) Modifies the description for the specified firewall. Use the description to help you identify the firewall when you're working with it.
- Parameters:
updateFirewallDescriptionRequest
-- Returns:
- A Java Future containing the result of the UpdateFirewallDescription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallDescription
default CompletableFuture<UpdateFirewallDescriptionResponse> updateFirewallDescription(Consumer<UpdateFirewallDescriptionRequest.Builder> updateFirewallDescriptionRequest) Modifies the description for the specified firewall. Use the description to help you identify the firewall when you're working with it.
This is a convenience which creates an instance of the
UpdateFirewallDescriptionRequest.Builder
avoiding the need to create one manually viaUpdateFirewallDescriptionRequest.builder()
- Parameters:
updateFirewallDescriptionRequest
- AConsumer
that will call methods onUpdateFirewallDescriptionRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateFirewallDescription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallEncryptionConfiguration
default CompletableFuture<UpdateFirewallEncryptionConfigurationResponse> updateFirewallEncryptionConfiguration(UpdateFirewallEncryptionConfigurationRequest updateFirewallEncryptionConfigurationRequest) A complex type that contains settings for encryption of your firewall resources.
- Parameters:
updateFirewallEncryptionConfigurationRequest
-- Returns:
- A Java Future containing the result of the UpdateFirewallEncryptionConfiguration operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallEncryptionConfiguration
default CompletableFuture<UpdateFirewallEncryptionConfigurationResponse> updateFirewallEncryptionConfiguration(Consumer<UpdateFirewallEncryptionConfigurationRequest.Builder> updateFirewallEncryptionConfigurationRequest) A complex type that contains settings for encryption of your firewall resources.
This is a convenience which creates an instance of the
UpdateFirewallEncryptionConfigurationRequest.Builder
avoiding the need to create one manually viaUpdateFirewallEncryptionConfigurationRequest.builder()
- Parameters:
updateFirewallEncryptionConfigurationRequest
- AConsumer
that will call methods onUpdateFirewallEncryptionConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateFirewallEncryptionConfiguration operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallPolicy
default CompletableFuture<UpdateFirewallPolicyResponse> updateFirewallPolicy(UpdateFirewallPolicyRequest updateFirewallPolicyRequest) Updates the properties of the specified firewall policy.
- Parameters:
updateFirewallPolicyRequest
-- Returns:
- A Java Future containing the result of the UpdateFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallPolicy
default CompletableFuture<UpdateFirewallPolicyResponse> updateFirewallPolicy(Consumer<UpdateFirewallPolicyRequest.Builder> updateFirewallPolicyRequest) Updates the properties of the specified firewall policy.
This is a convenience which creates an instance of the
UpdateFirewallPolicyRequest.Builder
avoiding the need to create one manually viaUpdateFirewallPolicyRequest.builder()
- Parameters:
updateFirewallPolicyRequest
- AConsumer
that will call methods onUpdateFirewallPolicyRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateFirewallPolicy operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallPolicyChangeProtection
default CompletableFuture<UpdateFirewallPolicyChangeProtectionResponse> updateFirewallPolicyChangeProtection(UpdateFirewallPolicyChangeProtectionRequest updateFirewallPolicyChangeProtectionRequest) Modifies the flag,
ChangeProtection
, which indicates whether it is possible to change the firewall. If the flag is set toTRUE
, the firewall is protected from changes. This setting helps protect against accidentally changing a firewall that's in use.- Parameters:
updateFirewallPolicyChangeProtectionRequest
-- Returns:
- A Java Future containing the result of the UpdateFirewallPolicyChangeProtection operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateFirewallPolicyChangeProtection
default CompletableFuture<UpdateFirewallPolicyChangeProtectionResponse> updateFirewallPolicyChangeProtection(Consumer<UpdateFirewallPolicyChangeProtectionRequest.Builder> updateFirewallPolicyChangeProtectionRequest) Modifies the flag,
ChangeProtection
, which indicates whether it is possible to change the firewall. If the flag is set toTRUE
, the firewall is protected from changes. This setting helps protect against accidentally changing a firewall that's in use.
This is a convenience which creates an instance of the
UpdateFirewallPolicyChangeProtectionRequest.Builder
avoiding the need to create one manually viaUpdateFirewallPolicyChangeProtectionRequest.builder()
- Parameters:
updateFirewallPolicyChangeProtectionRequest
- AConsumer
that will call methods onUpdateFirewallPolicyChangeProtectionRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateFirewallPolicyChangeProtection operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateLoggingConfiguration
default CompletableFuture<UpdateLoggingConfigurationResponse> updateLoggingConfiguration(UpdateLoggingConfigurationRequest updateLoggingConfigurationRequest) Sets the logging configuration for the specified firewall.
To change the logging configuration, retrieve the LoggingConfiguration by calling DescribeLoggingConfiguration, then change it and provide the modified object to this update call. You must change the logging configuration one LogDestinationConfig at a time inside the retrieved LoggingConfiguration object.
You can perform only one of the following actions in any call to
UpdateLoggingConfiguration
:-
Create a new log destination object by adding a single
LogDestinationConfig
array element toLogDestinationConfigs
. -
Delete a log destination object by removing a single
LogDestinationConfig
array element fromLogDestinationConfigs
. -
Change the
LogDestination
setting in a singleLogDestinationConfig
array element.
You can't change the
LogDestinationType
orLogType
in aLogDestinationConfig
. To change these settings, delete the existingLogDestinationConfig
object and create a new one, using two separate calls to this update operation.- Parameters:
updateLoggingConfigurationRequest
-- Returns:
- A Java Future containing the result of the UpdateLoggingConfiguration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- LogDestinationPermissionException Unable to send logs to a configured logging destination.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
-
updateLoggingConfiguration
default CompletableFuture<UpdateLoggingConfigurationResponse> updateLoggingConfiguration(Consumer<UpdateLoggingConfigurationRequest.Builder> updateLoggingConfigurationRequest) Sets the logging configuration for the specified firewall.
To change the logging configuration, retrieve the LoggingConfiguration by calling DescribeLoggingConfiguration, then change it and provide the modified object to this update call. You must change the logging configuration one LogDestinationConfig at a time inside the retrieved LoggingConfiguration object.
You can perform only one of the following actions in any call to
UpdateLoggingConfiguration
:-
Create a new log destination object by adding a single
LogDestinationConfig
array element toLogDestinationConfigs
. -
Delete a log destination object by removing a single
LogDestinationConfig
array element fromLogDestinationConfigs
. -
Change the
LogDestination
setting in a singleLogDestinationConfig
array element.
You can't change the
LogDestinationType
orLogType
in aLogDestinationConfig
. To change these settings, delete the existingLogDestinationConfig
object and create a new one, using two separate calls to this update operation.
This is a convenience which creates an instance of the
UpdateLoggingConfigurationRequest.Builder
avoiding the need to create one manually viaUpdateLoggingConfigurationRequest.builder()
- Parameters:
updateLoggingConfigurationRequest
- AConsumer
that will call methods onUpdateLoggingConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateLoggingConfiguration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- LogDestinationPermissionException Unable to send logs to a configured logging destination.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
-
updateRuleGroup
default CompletableFuture<UpdateRuleGroupResponse> updateRuleGroup(UpdateRuleGroupRequest updateRuleGroupRequest) Updates the rule settings for the specified rule group. You use a rule group by reference in one or more firewall policies. When you modify a rule group, you modify all firewall policies that use the rule group.
To update a rule group, first call DescribeRuleGroup to retrieve the current RuleGroup object, update the object as needed, and then provide the updated object to this call.
- Parameters:
updateRuleGroupRequest
-- Returns:
- A Java Future containing the result of the UpdateRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateRuleGroup
default CompletableFuture<UpdateRuleGroupResponse> updateRuleGroup(Consumer<UpdateRuleGroupRequest.Builder> updateRuleGroupRequest) Updates the rule settings for the specified rule group. You use a rule group by reference in one or more firewall policies. When you modify a rule group, you modify all firewall policies that use the rule group.
To update a rule group, first call DescribeRuleGroup to retrieve the current RuleGroup object, update the object as needed, and then provide the updated object to this call.
This is a convenience which creates an instance of the
UpdateRuleGroupRequest.Builder
avoiding the need to create one manually viaUpdateRuleGroupRequest.builder()
- Parameters:
updateRuleGroupRequest
- AConsumer
that will call methods onUpdateRuleGroupRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateRuleGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateSubnetChangeProtection
default CompletableFuture<UpdateSubnetChangeProtectionResponse> updateSubnetChangeProtection(UpdateSubnetChangeProtectionRequest updateSubnetChangeProtectionRequest) - Parameters:
updateSubnetChangeProtectionRequest
-- Returns:
- A Java Future containing the result of the UpdateSubnetChangeProtection operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateSubnetChangeProtection
default CompletableFuture<UpdateSubnetChangeProtectionResponse> updateSubnetChangeProtection(Consumer<UpdateSubnetChangeProtectionRequest.Builder> updateSubnetChangeProtectionRequest)
This is a convenience which creates an instance of the
UpdateSubnetChangeProtectionRequest.Builder
avoiding the need to create one manually viaUpdateSubnetChangeProtectionRequest.builder()
- Parameters:
updateSubnetChangeProtectionRequest
- AConsumer
that will call methods onUpdateSubnetChangeProtectionRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateSubnetChangeProtection operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- ResourceOwnerCheckException Unable to change the resource because your account doesn't own it.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateTLSInspectionConfiguration
default CompletableFuture<UpdateTlsInspectionConfigurationResponse> updateTLSInspectionConfiguration(UpdateTlsInspectionConfigurationRequest updateTlsInspectionConfigurationRequest) Updates the TLS inspection configuration settings for the specified TLS inspection configuration. You use a TLS inspection configuration by referencing it in one or more firewall policies. When you modify a TLS inspection configuration, you modify all firewall policies that use the TLS inspection configuration.
To update a TLS inspection configuration, first call DescribeTLSInspectionConfiguration to retrieve the current TLSInspectionConfiguration object, update the object as needed, and then provide the updated object to this call.
- Parameters:
updateTlsInspectionConfigurationRequest
-- Returns:
- A Java Future containing the result of the UpdateTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
updateTLSInspectionConfiguration
default CompletableFuture<UpdateTlsInspectionConfigurationResponse> updateTLSInspectionConfiguration(Consumer<UpdateTlsInspectionConfigurationRequest.Builder> updateTlsInspectionConfigurationRequest) Updates the TLS inspection configuration settings for the specified TLS inspection configuration. You use a TLS inspection configuration by referencing it in one or more firewall policies. When you modify a TLS inspection configuration, you modify all firewall policies that use the TLS inspection configuration.
To update a TLS inspection configuration, first call DescribeTLSInspectionConfiguration to retrieve the current TLSInspectionConfiguration object, update the object as needed, and then provide the updated object to this call.
This is a convenience which creates an instance of the
UpdateTlsInspectionConfigurationRequest.Builder
avoiding the need to create one manually viaUpdateTlsInspectionConfigurationRequest.builder()
- Parameters:
updateTlsInspectionConfigurationRequest
- AConsumer
that will call methods onUpdateTlsInspectionConfigurationRequest.Builder
to create a request.- Returns:
- A Java Future containing the result of the UpdateTLSInspectionConfiguration operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
-
You specified an unsupported parameter name or value.
-
You tried to update a property with a value that isn't among the available types.
-
Your request references an ARN that is malformed, or corresponds to a resource that isn't valid in the context of the request.
-
- ResourceNotFoundException Unable to locate a resource using the parameters that you provided.
- ThrottlingException Unable to process the request due to throttling limitations.
- InternalServerErrorException Your request is valid, but Network Firewall couldn't perform the operation because of a system problem. Retry your request.
- InvalidTokenException The token you provided is stale or isn't valid for the operation.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- NetworkFirewallException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- InvalidRequestException The operation failed because of a problem with your request. Examples
include:
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-
create
Create aNetworkFirewallAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aNetworkFirewallAsyncClient
.
-