aws-sdk-networkfirewall 1.94.0 → 1.96.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -708,13 +708,20 @@ module Aws::NetworkFirewall
708
708
  # [1]: https://docs.aws.amazon.com/network-firewall/latest/developerguide/firewall-troubleshooting-endpoint-failures.html
709
709
  # @return [String]
710
710
  #
711
+ # @!attribute [rw] dns_name
712
+ # The DNS name that resolves to the firewall endpoint in the subnet.
713
+ # This is populated for proxy mode firewalls, where clients direct
714
+ # traffic to the firewall's proxy using this name.
715
+ # @return [String]
716
+ #
711
717
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/Attachment AWS API Documentation
712
718
  #
713
719
  class Attachment < Struct.new(
714
720
  :subnet_id,
715
721
  :endpoint_id,
716
722
  :status,
717
- :status_message)
723
+ :status_message,
724
+ :dns_name)
718
725
  SENSITIVE = []
719
726
  include Aws::Structure
720
727
  end
@@ -851,10 +858,9 @@ module Aws::NetworkFirewall
851
858
  include Aws::Structure
852
859
  end
853
860
 
854
- # High-level information about a container association, returned by the
855
- # ListContainerAssociations operation. You can use this information to
856
- # retrieve the full details of a container association using
857
- # DescribeContainerAssociation.
861
+ # The metadata for a container association returned by
862
+ # `ListContainerAssociations`. Contains the ARN and name that you use to
863
+ # identify the container association in other operations.
858
864
  #
859
865
  # @!attribute [rw] arn
860
866
  # The Amazon Resource Name (ARN) of the container association.
@@ -873,15 +879,15 @@ module Aws::NetworkFirewall
873
879
  include Aws::Structure
874
880
  end
875
881
 
876
- # A key-value pair that defines a container attribute filter for a
877
- # container monitoring configuration.
882
+ # A key-value filter pair used in container association monitoring
883
+ # configurations to narrow which containers are tracked.
878
884
  #
879
885
  # @!attribute [rw] key
880
- # The key of the container attribute to filter on.
886
+ # The attribute key to filter on.
881
887
  # @return [String]
882
888
  #
883
889
  # @!attribute [rw] value
884
- # The value of the container attribute to filter on.
890
+ # The attribute value to match.
885
891
  # @return [String]
886
892
  #
887
893
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/ContainerAttribute AWS API Documentation
@@ -893,18 +899,21 @@ module Aws::NetworkFirewall
893
899
  include Aws::Structure
894
900
  end
895
901
 
896
- # Defines a container cluster to monitor, along with optional attribute
897
- # filters that narrow the scope of monitored containers within the
898
- # cluster.
902
+ # Contains the monitoring configuration for a single cluster in a
903
+ # container association. Specifies the cluster ARN and optional
904
+ # attribute filters to narrow which containers are tracked.
899
905
  #
900
906
  # @!attribute [rw] cluster_arn
901
- # The Amazon Resource Name (ARN) of the container cluster to monitor.
907
+ # The ARN of the Amazon ECS or Amazon EKS cluster to monitor. The
908
+ # cluster must be in the same Region and account as the container
909
+ # association.
902
910
  # @return [String]
903
911
  #
904
912
  # @!attribute [rw] attribute_filters
905
- # A list of key-value pairs that filter which containers within the
906
- # cluster are monitored. Only containers that match the specified
907
- # attributes are included.
913
+ # Key-value pairs that filter which containers are tracked. For Amazon
914
+ # EKS, you can filter by namespace and Kubernetes labels. For Amazon
915
+ # ECS, you can filter by container instance attributes (EC2 launch
916
+ # type only).
908
917
  # @return [Array<Types::ContainerAttribute>]
909
918
  #
910
919
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/ContainerMonitoringConfiguration AWS API Documentation
@@ -926,14 +935,19 @@ module Aws::NetworkFirewall
926
935
  # @return [String]
927
936
  #
928
937
  # @!attribute [rw] type
929
- # The type of container orchestration platform for the clusters in
930
- # this association. Valid values are `ECS` and `EKS`. You can't
931
- # change the type after creation.
938
+ # The type of containers to monitor. You can't change the container
939
+ # type after creation. Valid values:
940
+ #
941
+ # * `ECS` - Amazon Elastic Container Service
942
+ #
943
+ # * `EKS` - Amazon Elastic Kubernetes Service
932
944
  # @return [String]
933
945
  #
934
946
  # @!attribute [rw] container_monitoring_configurations
935
- # The list of container monitoring configurations that define which
936
- # clusters and container attributes to monitor.
947
+ # The monitoring configurations for the container association. Each
948
+ # configuration specifies an Amazon ECS or Amazon EKS cluster to
949
+ # monitor and optional attribute filters to narrow which containers
950
+ # are tracked.
937
951
  # @return [Array<Types::ContainerMonitoringConfiguration>]
938
952
  #
939
953
  # @!attribute [rw] tags
@@ -965,32 +979,38 @@ module Aws::NetworkFirewall
965
979
  # @return [String]
966
980
  #
967
981
  # @!attribute [rw] type
968
- # The type of container orchestration platform. Either `ECS` or `EKS`.
982
+ # The container type. Valid values:
983
+ #
984
+ # * `ECS` - Amazon Elastic Container Service
985
+ #
986
+ # * `EKS` - Amazon Elastic Kubernetes Service
969
987
  # @return [String]
970
988
  #
971
989
  # @!attribute [rw] container_monitoring_configurations
972
- # The container monitoring configurations for this container
973
- # association.
990
+ # The monitoring configurations for the container association.
974
991
  # @return [Array<Types::ContainerMonitoringConfiguration>]
975
992
  #
976
993
  # @!attribute [rw] status
977
- # The current status of the container association.
994
+ # The current status of the container association. For a new container
995
+ # association, the status is `CREATING`.
978
996
  # @return [String]
979
997
  #
980
998
  # @!attribute [rw] tags
981
- # The key:value pairs associated with the resource.
999
+ # The key:value pairs to associate with the resource.
982
1000
  # @return [Array<Types::Tag>]
983
1001
  #
984
1002
  # @!attribute [rw] update_token
985
1003
  # A token used for optimistic locking. Network Firewall returns a
986
1004
  # token to your requests that access the container association. The
987
1005
  # token marks the state of the container association resource at the
988
- # time of the request. To make an update to the container association,
989
- # provide the token in your request. Network Firewall uses the token
990
- # to ensure that the container association hasn't changed since you
991
- # last retrieved it. If it has changed, the operation fails with an
1006
+ # time of the request.
1007
+ #
1008
+ # To make changes to the container association, you provide the token
1009
+ # in your request. Network Firewall uses the token to ensure that the
1010
+ # container association hasn't changed since you last retrieved it.
1011
+ # If it has changed, the operation fails with an
992
1012
  # `InvalidTokenException`. If this happens, retrieve the container
993
- # association again to get a current copy of it with a new token.
1013
+ # association again to get a current copy of it with a current token.
994
1014
  # Reapply your changes as needed, then try the operation again using
995
1015
  # the new token.
996
1016
  # @return [String]
@@ -1199,6 +1219,45 @@ module Aws::NetworkFirewall
1199
1219
  # Default value: `FALSE`
1200
1220
  # @return [Boolean]
1201
1221
  #
1222
+ # @!attribute [rw] nat_gateway_mappings
1223
+ # The NAT gateways that the firewall uses to proxy traffic when
1224
+ # `NoSourcePreservation` is `TRUE`. Network Firewall attaches the
1225
+ # firewall to each NAT gateway that you specify, so that egress
1226
+ # traffic is proxied through the NAT gateway.
1227
+ # @return [Array<Types::NatGatewayMapping>]
1228
+ #
1229
+ # @!attribute [rw] proxy_settings
1230
+ # The listener configuration for a proxy mode firewall, used when
1231
+ # `NoSourcePreservation` is `TRUE`. This specifies the ports and
1232
+ # protocols on which the firewall's proxy listens for traffic.
1233
+ # @return [Types::ProxySettings]
1234
+ #
1235
+ # @!attribute [rw] no_source_preservation
1236
+ # Optional. Indicates whether the firewall operates in proxy mode, in
1237
+ # which the source IP address of the traffic is not preserved. When
1238
+ # set to `TRUE`, the firewall proxies traffic through a NAT gateway
1239
+ # and the traffic reaching the destination uses the NAT gateway's IP
1240
+ # address as the source.
1241
+ #
1242
+ # When you set this to `TRUE`, you must specify `NatGatewayMappings`
1243
+ # and `VpcEndpoint` instead of a top-level `VpcId` and
1244
+ # `SubnetMappings`.
1245
+ #
1246
+ # You can't change this setting after you create the firewall.
1247
+ #
1248
+ # Default value: `FALSE`
1249
+ # @return [Boolean]
1250
+ #
1251
+ # @!attribute [rw] vpc_endpoint
1252
+ # The VPC and subnets for the firewall endpoint, used when
1253
+ # `NoSourcePreservation` is `TRUE`. Network Firewall creates the
1254
+ # firewall endpoint in the subnets that you specify here.
1255
+ #
1256
+ # For proxy mode firewalls, provide the firewall's VPC and endpoint
1257
+ # subnets through this parameter instead of the top-level `VpcId` and
1258
+ # `SubnetMappings`.
1259
+ # @return [Types::VpcEndpoint]
1260
+ #
1202
1261
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/CreateFirewallRequest AWS API Documentation
1203
1262
  #
1204
1263
  class CreateFirewallRequest < Struct.new(
@@ -1215,7 +1274,11 @@ module Aws::NetworkFirewall
1215
1274
  :enabled_analysis_types,
1216
1275
  :transit_gateway_id,
1217
1276
  :availability_zone_mappings,
1218
- :availability_zone_change_protection)
1277
+ :availability_zone_change_protection,
1278
+ :nat_gateway_mappings,
1279
+ :proxy_settings,
1280
+ :no_source_preservation,
1281
+ :vpc_endpoint)
1219
1282
  SENSITIVE = []
1220
1283
  include Aws::Structure
1221
1284
  end
@@ -1969,13 +2032,15 @@ module Aws::NetworkFirewall
1969
2032
  end
1970
2033
 
1971
2034
  # @!attribute [rw] container_association_name
1972
- # The descriptive name of the container association. You must specify
1973
- # the ARN or the name, and you can specify both.
2035
+ # The descriptive name of the container association.
2036
+ #
2037
+ # You must specify the ARN or the name, and you can specify both.
1974
2038
  # @return [String]
1975
2039
  #
1976
2040
  # @!attribute [rw] container_association_arn
1977
- # The Amazon Resource Name (ARN) of the container association. You
1978
- # must specify the ARN or the name, and you can specify both.
2041
+ # The Amazon Resource Name (ARN) of the container association.
2042
+ #
2043
+ # You must specify the ARN or the name, and you can specify both.
1979
2044
  # @return [String]
1980
2045
  #
1981
2046
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DeleteContainerAssociationRequest AWS API Documentation
@@ -1996,7 +2061,8 @@ module Aws::NetworkFirewall
1996
2061
  # @return [String]
1997
2062
  #
1998
2063
  # @!attribute [rw] status
1999
- # The current status of the container association.
2064
+ # The current status of the container association. After deletion is
2065
+ # initiated, the status is `DELETING`.
2000
2066
  # @return [String]
2001
2067
  #
2002
2068
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DeleteContainerAssociationResponse AWS API Documentation
@@ -2466,13 +2532,15 @@ module Aws::NetworkFirewall
2466
2532
  end
2467
2533
 
2468
2534
  # @!attribute [rw] container_association_name
2469
- # The descriptive name of the container association. You must specify
2470
- # the ARN or the name, and you can specify both.
2535
+ # The descriptive name of the container association.
2536
+ #
2537
+ # You must specify the ARN or the name, and you can specify both.
2471
2538
  # @return [String]
2472
2539
  #
2473
2540
  # @!attribute [rw] container_association_arn
2474
- # The Amazon Resource Name (ARN) of the container association. You
2475
- # must specify the ARN or the name, and you can specify both.
2541
+ # The Amazon Resource Name (ARN) of the container association.
2542
+ #
2543
+ # You must specify the ARN or the name, and you can specify both.
2476
2544
  # @return [String]
2477
2545
  #
2478
2546
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeContainerAssociationRequest AWS API Documentation
@@ -2497,12 +2565,15 @@ module Aws::NetworkFirewall
2497
2565
  # @return [String]
2498
2566
  #
2499
2567
  # @!attribute [rw] type
2500
- # The type of container orchestration platform. Either `ECS` or `EKS`.
2568
+ # The container type. Valid values:
2569
+ #
2570
+ # * `ECS` - Amazon Elastic Container Service
2571
+ #
2572
+ # * `EKS` - Amazon Elastic Kubernetes Service
2501
2573
  # @return [String]
2502
2574
  #
2503
2575
  # @!attribute [rw] container_monitoring_configurations
2504
- # The container monitoring configurations for this container
2505
- # association.
2576
+ # The monitoring configurations for the container association.
2506
2577
  # @return [Array<Types::ContainerMonitoringConfiguration>]
2507
2578
  #
2508
2579
  # @!attribute [rw] status
@@ -2510,17 +2581,16 @@ module Aws::NetworkFirewall
2510
2581
  # @return [String]
2511
2582
  #
2512
2583
  # @!attribute [rw] resolved_cidr_count
2513
- # The number of CIDR blocks that have been resolved from the monitored
2514
- # containers for this container association.
2584
+ # The number of CIDR blocks resolved from the monitored containers.
2515
2585
  # @return [Integer]
2516
2586
  #
2517
2587
  # @!attribute [rw] last_updated_time
2518
- # The last time that the container association was updated or resolved
2519
- # new container IP addresses.
2588
+ # The most recent time that Network Firewall updated the container
2589
+ # association.
2520
2590
  # @return [Time]
2521
2591
  #
2522
2592
  # @!attribute [rw] tags
2523
- # The key:value pairs associated with the resource.
2593
+ # The key:value pairs to associate with the resource.
2524
2594
  # @return [Array<Types::Tag>]
2525
2595
  #
2526
2596
  # @!attribute [rw] update_token
@@ -2528,6 +2598,15 @@ module Aws::NetworkFirewall
2528
2598
  # token to your requests that access the container association. The
2529
2599
  # token marks the state of the container association resource at the
2530
2600
  # time of the request.
2601
+ #
2602
+ # To make changes to the container association, you provide the token
2603
+ # in your request. Network Firewall uses the token to ensure that the
2604
+ # container association hasn't changed since you last retrieved it.
2605
+ # If it has changed, the operation fails with an
2606
+ # `InvalidTokenException`. If this happens, retrieve the container
2607
+ # association again to get a current copy of it with a current token.
2608
+ # Reapply your changes as needed, then try the operation again using
2609
+ # the new token.
2531
2610
  # @return [String]
2532
2611
  #
2533
2612
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeContainerAssociationResponse AWS API Documentation
@@ -4070,6 +4149,30 @@ module Aws::NetworkFirewall
4070
4149
  # Availability Zones.
4071
4150
  # @return [Boolean]
4072
4151
  #
4152
+ # @!attribute [rw] nat_gateway_mappings
4153
+ # The NAT gateways that the firewall uses to proxy traffic. This is
4154
+ # set for proxy mode firewalls, where `NoSourcePreservation` is
4155
+ # `TRUE`.
4156
+ # @return [Array<Types::NatGatewayMapping>]
4157
+ #
4158
+ # @!attribute [rw] proxy_settings
4159
+ # The listener configuration for the firewall's proxy. This is set
4160
+ # for proxy mode firewalls, where `NoSourcePreservation` is `TRUE`.
4161
+ # @return [Types::ProxySettings]
4162
+ #
4163
+ # @!attribute [rw] no_source_preservation
4164
+ # Indicates whether the firewall operates in proxy mode, in which the
4165
+ # source IP address of the traffic is not preserved. When this value
4166
+ # is `TRUE`, the firewall proxies traffic through a NAT gateway and
4167
+ # uses the NAT gateway's IP address as the source for traffic
4168
+ # reaching the destination.
4169
+ # @return [Boolean]
4170
+ #
4171
+ # @!attribute [rw] vpc_endpoint
4172
+ # The VPC and subnets for the firewall endpoint. This is set for proxy
4173
+ # mode firewalls, where `NoSourcePreservation` is `TRUE`.
4174
+ # @return [Types::VpcEndpoint]
4175
+ #
4073
4176
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/Firewall AWS API Documentation
4074
4177
  #
4075
4178
  class Firewall < Struct.new(
@@ -4090,7 +4193,11 @@ module Aws::NetworkFirewall
4090
4193
  :transit_gateway_id,
4091
4194
  :transit_gateway_owner_account_id,
4092
4195
  :availability_zone_mappings,
4093
- :availability_zone_change_protection)
4196
+ :availability_zone_change_protection,
4197
+ :nat_gateway_mappings,
4198
+ :proxy_settings,
4199
+ :no_source_preservation,
4200
+ :vpc_endpoint)
4094
4201
  SENSITIVE = []
4095
4202
  include Aws::Structure
4096
4203
  end
@@ -4198,6 +4305,14 @@ module Aws::NetworkFirewall
4198
4305
  #
4199
4306
  # * aws:alert\_established
4200
4307
  #
4308
+ # * aws:drop\_established\_app\_layer
4309
+ #
4310
+ # * aws:alert\_established\_app\_layer
4311
+ #
4312
+ # * aws:drop\_established\_app\_layer\_to\_server
4313
+ #
4314
+ # * aws:alert\_established\_app\_layer\_to\_server
4315
+ #
4201
4316
  # For more information, see [Strict evaluation order][1] in the
4202
4317
  # *Network Firewall Developer Guide*.
4203
4318
  #
@@ -5100,7 +5215,8 @@ module Aws::NetworkFirewall
5100
5215
  end
5101
5216
 
5102
5217
  # @!attribute [rw] container_associations
5103
- # The container association metadata objects.
5218
+ # The container association metadata objects for the account and
5219
+ # Region.
5104
5220
  # @return [Array<Types::ContainerAssociationSummary>]
5105
5221
  #
5106
5222
  # @!attribute [rw] next_token
@@ -6006,6 +6122,57 @@ module Aws::NetworkFirewall
6006
6122
  include Aws::Structure
6007
6123
  end
6008
6124
 
6125
+ # The definition and status of the attachment between a proxy mode
6126
+ # firewall and a NAT gateway that proxies its traffic.
6127
+ #
6128
+ # @!attribute [rw] nat_gateway_id
6129
+ # A unique identifier for the NAT gateway to use with proxy resources.
6130
+ # @return [String]
6131
+ #
6132
+ # @!attribute [rw] status
6133
+ # The current status of the NAT gateway attachment.
6134
+ #
6135
+ # When this value is `READY`, the attachment is available to proxy
6136
+ # traffic. Otherwise, this value reflects its state, for example
6137
+ # `CREATING` or `DELETING`.
6138
+ # @return [String]
6139
+ #
6140
+ # @!attribute [rw] status_message
6141
+ # If Network Firewall encounters an issue with the NAT gateway
6142
+ # attachment, it populates this with an explanation of the problem.
6143
+ # @return [String]
6144
+ #
6145
+ # @!attribute [rw] dns_name
6146
+ # The DNS name that resolves to the firewall's proxy for traffic sent
6147
+ # through this NAT gateway attachment.
6148
+ # @return [String]
6149
+ #
6150
+ # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/NatGatewayAttachment AWS API Documentation
6151
+ #
6152
+ class NatGatewayAttachment < Struct.new(
6153
+ :nat_gateway_id,
6154
+ :status,
6155
+ :status_message,
6156
+ :dns_name)
6157
+ SENSITIVE = []
6158
+ include Aws::Structure
6159
+ end
6160
+
6161
+ # A NAT gateway that a proxy mode firewall uses to proxy traffic. This
6162
+ # is used in CreateFirewall when `NoSourcePreservation` is `TRUE`.
6163
+ #
6164
+ # @!attribute [rw] nat_gateway_id
6165
+ # A unique identifier for the NAT gateway to use with proxy resources.
6166
+ # @return [String]
6167
+ #
6168
+ # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/NatGatewayMapping AWS API Documentation
6169
+ #
6170
+ class NatGatewayMapping < Struct.new(
6171
+ :nat_gateway_id)
6172
+ SENSITIVE = []
6173
+ include Aws::Structure
6174
+ end
6175
+
6009
6176
  # Provides configuration status for a single policy or rule group that
6010
6177
  # is used for a firewall endpoint. Network Firewall provides each
6011
6178
  # endpoint with the rules that are configured in the firewall policy.
@@ -6576,6 +6743,22 @@ module Aws::NetworkFirewall
6576
6743
  include Aws::Structure
6577
6744
  end
6578
6745
 
6746
+ # The listener configuration for a proxy mode firewall. This specifies
6747
+ # the ports and protocols on which the firewall's proxy listens for
6748
+ # traffic.
6749
+ #
6750
+ # @!attribute [rw] listener_properties
6751
+ # Listener properties for HTTP and HTTPS traffic.
6752
+ # @return [Array<Types::ListenerProperty>]
6753
+ #
6754
+ # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/ProxySettings AWS API Documentation
6755
+ #
6756
+ class ProxySettings < Struct.new(
6757
+ :listener_properties)
6758
+ SENSITIVE = []
6759
+ include Aws::Structure
6760
+ end
6761
+
6579
6762
  # Stateless inspection criteria that publishes the specified metrics to
6580
6763
  # Amazon CloudWatch for the matching packet. This setting defines a
6581
6764
  # CloudWatch dimension value to be published.
@@ -7027,7 +7210,7 @@ module Aws::NetworkFirewall
7027
7210
  #
7028
7211
  #
7029
7212
  #
7030
- # [1]: https://suricata.readthedocs.io/en/suricata-7.0.3/rules/intro.html#rule-options
7213
+ # [1]: https://suricata.readthedocs.io/en/suricata-7.0.8/rules/intro.html#rule-options
7031
7214
  # @return [String]
7032
7215
  #
7033
7216
  # @!attribute [rw] settings
@@ -7038,7 +7221,7 @@ module Aws::NetworkFirewall
7038
7221
  #
7039
7222
  #
7040
7223
  #
7041
- # [1]: https://suricata.readthedocs.io/en/suricata-7.0.3/rules/intro.html#rule-options
7224
+ # [1]: https://suricata.readthedocs.io/en/suricata-7.0.8/rules/intro.html#rule-options
7042
7225
  # @return [Array<String>]
7043
7226
  #
7044
7227
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/RuleOption AWS API Documentation
@@ -7136,7 +7319,7 @@ module Aws::NetworkFirewall
7136
7319
  #
7137
7320
  #
7138
7321
  #
7139
- # [1]: https://suricata.readthedocs.io/en/suricata-7.0.3/rules/intro.html
7322
+ # [1]: https://suricata.readthedocs.io/en/suricata-7.0.8/rules/intro.html
7140
7323
  # @return [Array<Types::StatefulRule>]
7141
7324
  #
7142
7325
  # @!attribute [rw] stateless_rules_and_custom_actions
@@ -7599,6 +7782,11 @@ module Aws::NetworkFirewall
7599
7782
  # Configuration settings for the handling of the stateful rule groups in
7600
7783
  # a firewall policy.
7601
7784
  #
7785
+ # Updating any setting in `StatefulEngineOptions` may require a restart
7786
+ # of the stateful engine in order to apply the changes. When this
7787
+ # occurs, existing connections will be treated according to your stream
7788
+ # exception policy configuration.
7789
+ #
7602
7790
  # @!attribute [rw] rule_order
7603
7791
  # Indicates how to manage the order of stateful rule evaluation for
7604
7792
  # the policy. `STRICT_ORDER` is the recommended option, but
@@ -7670,7 +7858,7 @@ module Aws::NetworkFirewall
7670
7858
  #
7671
7859
  #
7672
7860
  #
7673
- # [1]: https://suricata.readthedocs.io/en/suricata-7.0.3/rules/intro.html
7861
+ # [1]: https://suricata.readthedocs.io/en/suricata-7.0.8/rules/intro.html
7674
7862
  #
7675
7863
  # @!attribute [rw] action
7676
7864
  # Defines what Network Firewall should do with the packets in a
@@ -8009,11 +8197,18 @@ module Aws::NetworkFirewall
8009
8197
  # traffic.
8010
8198
  # @return [Hash<String,Types::PerObjectStatus>]
8011
8199
  #
8200
+ # @!attribute [rw] nat_gateway_attachments
8201
+ # The status of the NAT gateway attachments for a proxy mode firewall
8202
+ # in the Availability Zone. This reflects the attachment of the
8203
+ # firewall to each NAT gateway that proxies its traffic.
8204
+ # @return [Array<Types::NatGatewayAttachment>]
8205
+ #
8012
8206
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/SyncState AWS API Documentation
8013
8207
  #
8014
8208
  class SyncState < Struct.new(
8015
8209
  :attachment,
8016
- :config)
8210
+ :config,
8211
+ :nat_gateway_attachments)
8017
8212
  SENSITIVE = []
8018
8213
  include Aws::Structure
8019
8214
  end
@@ -8555,43 +8750,54 @@ module Aws::NetworkFirewall
8555
8750
  end
8556
8751
 
8557
8752
  # @!attribute [rw] container_association_name
8558
- # The descriptive name of the container association. You must specify
8559
- # the ARN or the name, and you can specify both.
8753
+ # The descriptive name of the container association.
8754
+ #
8755
+ # You must specify the ARN or the name, and you can specify both.
8560
8756
  # @return [String]
8561
8757
  #
8562
8758
  # @!attribute [rw] container_association_arn
8563
- # The Amazon Resource Name (ARN) of the container association. You
8564
- # must specify the ARN or the name, and you can specify both.
8759
+ # The Amazon Resource Name (ARN) of the container association.
8760
+ #
8761
+ # You must specify the ARN or the name, and you can specify both.
8565
8762
  # @return [String]
8566
8763
  #
8567
8764
  # @!attribute [rw] description
8568
- # A description of the container association.
8765
+ # A description of the container association. When omitted, the
8766
+ # existing description remains unchanged. To clear the description,
8767
+ # pass an empty string.
8569
8768
  # @return [String]
8570
8769
  #
8571
8770
  # @!attribute [rw] type
8572
- # The type of container orchestration platform. This must match the
8573
- # type specified when the container association was created.
8771
+ # The container type. This value must match the existing type and
8772
+ # can't be changed. Valid values:
8773
+ #
8774
+ # * `ECS` - Amazon Elastic Container Service
8775
+ #
8776
+ # * `EKS` - Amazon Elastic Kubernetes Service
8574
8777
  # @return [String]
8575
8778
  #
8576
8779
  # @!attribute [rw] container_monitoring_configurations
8577
- # The updated list of container monitoring configurations that define
8578
- # which clusters and container attributes to monitor.
8780
+ # The updated monitoring configurations for the container association.
8781
+ # Each configuration specifies an Amazon ECS or Amazon EKS cluster to
8782
+ # monitor and optional attribute filters.
8579
8783
  # @return [Array<Types::ContainerMonitoringConfiguration>]
8580
8784
  #
8581
8785
  # @!attribute [rw] tags
8582
- # The key:value pairs associated with the resource.
8786
+ # The key:value pairs to associate with the resource.
8583
8787
  # @return [Array<Types::Tag>]
8584
8788
  #
8585
8789
  # @!attribute [rw] update_token
8586
8790
  # A token used for optimistic locking. Network Firewall returns a
8587
8791
  # token to your requests that access the container association. The
8588
8792
  # token marks the state of the container association resource at the
8589
- # time of the request. To make an update to the container association,
8590
- # provide the token in your request. Network Firewall uses the token
8591
- # to ensure that the container association hasn't changed since you
8592
- # last retrieved it. If it has changed, the operation fails with an
8793
+ # time of the request.
8794
+ #
8795
+ # To make changes to the container association, you provide the token
8796
+ # in your request. Network Firewall uses the token to ensure that the
8797
+ # container association hasn't changed since you last retrieved it.
8798
+ # If it has changed, the operation fails with an
8593
8799
  # `InvalidTokenException`. If this happens, retrieve the container
8594
- # association again to get a current copy of it with a new token.
8800
+ # association again to get a current copy of it with a current token.
8595
8801
  # Reapply your changes as needed, then try the operation again using
8596
8802
  # the new token.
8597
8803
  # @return [String]
@@ -8623,12 +8829,15 @@ module Aws::NetworkFirewall
8623
8829
  # @return [String]
8624
8830
  #
8625
8831
  # @!attribute [rw] type
8626
- # The type of container orchestration platform. Either `ECS` or `EKS`.
8832
+ # The container type. Valid values:
8833
+ #
8834
+ # * `ECS` - Amazon Elastic Container Service
8835
+ #
8836
+ # * `EKS` - Amazon Elastic Kubernetes Service
8627
8837
  # @return [String]
8628
8838
  #
8629
8839
  # @!attribute [rw] container_monitoring_configurations
8630
- # The container monitoring configurations for this container
8631
- # association.
8840
+ # The monitoring configurations for the container association.
8632
8841
  # @return [Array<Types::ContainerMonitoringConfiguration>]
8633
8842
  #
8634
8843
  # @!attribute [rw] status
@@ -8636,7 +8845,7 @@ module Aws::NetworkFirewall
8636
8845
  # @return [String]
8637
8846
  #
8638
8847
  # @!attribute [rw] tags
8639
- # The key:value pairs associated with the resource.
8848
+ # The key:value pairs to associate with the resource.
8640
8849
  # @return [Array<Types::Tag>]
8641
8850
  #
8642
8851
  # @!attribute [rw] update_token
@@ -8644,6 +8853,15 @@ module Aws::NetworkFirewall
8644
8853
  # token to your requests that access the container association. The
8645
8854
  # token marks the state of the container association resource at the
8646
8855
  # time of the request.
8856
+ #
8857
+ # To make changes to the container association, you provide the token
8858
+ # in your request. Network Firewall uses the token to ensure that the
8859
+ # container association hasn't changed since you last retrieved it.
8860
+ # If it has changed, the operation fails with an
8861
+ # `InvalidTokenException`. If this happens, retrieve the container
8862
+ # association again to get a current copy of it with a current token.
8863
+ # Reapply your changes as needed, then try the operation again using
8864
+ # the new token.
8647
8865
  # @return [String]
8648
8866
  #
8649
8867
  # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateContainerAssociationResponse AWS API Documentation
@@ -9771,6 +9989,100 @@ module Aws::NetworkFirewall
9771
9989
  include Aws::Structure
9772
9990
  end
9773
9991
 
9992
+ # @!attribute [rw] firewall_arn
9993
+ # The Amazon Resource Name (ARN) of the firewall.
9994
+ #
9995
+ # You must specify the ARN or the name, and you can specify both.
9996
+ # @return [String]
9997
+ #
9998
+ # @!attribute [rw] firewall_name
9999
+ # The descriptive name of the firewall. You can't change the name of
10000
+ # a firewall after you create it.
10001
+ #
10002
+ # You must specify the ARN or the name, and you can specify both.
10003
+ # @return [String]
10004
+ #
10005
+ # @!attribute [rw] update_token
10006
+ # An optional token that you can use for optimistic locking. Network
10007
+ # Firewall returns a token to your requests that access the firewall.
10008
+ # The token marks the state of the firewall resource at the time of
10009
+ # the request.
10010
+ #
10011
+ # To make an unconditional change to the firewall, omit the token in
10012
+ # your update request. Without the token, Network Firewall performs
10013
+ # your updates regardless of whether the firewall has changed since
10014
+ # you last retrieved it.
10015
+ #
10016
+ # To make a conditional change to the firewall, provide the token in
10017
+ # your update request. Network Firewall uses the token to ensure that
10018
+ # the firewall hasn't changed since you last retrieved it. If it has
10019
+ # changed, the operation fails with an `InvalidTokenException`. If
10020
+ # this happens, retrieve the firewall again to get a current copy of
10021
+ # it with a new token. Reapply your changes as needed, then try the
10022
+ # operation again using the new token.
10023
+ # @return [String]
10024
+ #
10025
+ # @!attribute [rw] proxy_settings
10026
+ # The proxy listener configuration to set on the firewall. This
10027
+ # specifies the ports and protocols on which the firewall's proxy
10028
+ # listens for traffic.
10029
+ # @return [Types::ProxySettings]
10030
+ #
10031
+ # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateProxySettingsRequest AWS API Documentation
10032
+ #
10033
+ class UpdateProxySettingsRequest < Struct.new(
10034
+ :firewall_arn,
10035
+ :firewall_name,
10036
+ :update_token,
10037
+ :proxy_settings)
10038
+ SENSITIVE = []
10039
+ include Aws::Structure
10040
+ end
10041
+
10042
+ # @!attribute [rw] firewall_arn
10043
+ # The Amazon Resource Name (ARN) of the firewall.
10044
+ # @return [String]
10045
+ #
10046
+ # @!attribute [rw] firewall_name
10047
+ # The descriptive name of the firewall. You can't change the name of
10048
+ # a firewall after you create it.
10049
+ # @return [String]
10050
+ #
10051
+ # @!attribute [rw] update_token
10052
+ # An optional token that you can use for optimistic locking. Network
10053
+ # Firewall returns a token to your requests that access the firewall.
10054
+ # The token marks the state of the firewall resource at the time of
10055
+ # the request.
10056
+ #
10057
+ # To make an unconditional change to the firewall, omit the token in
10058
+ # your update request. Without the token, Network Firewall performs
10059
+ # your updates regardless of whether the firewall has changed since
10060
+ # you last retrieved it.
10061
+ #
10062
+ # To make a conditional change to the firewall, provide the token in
10063
+ # your update request. Network Firewall uses the token to ensure that
10064
+ # the firewall hasn't changed since you last retrieved it. If it has
10065
+ # changed, the operation fails with an `InvalidTokenException`. If
10066
+ # this happens, retrieve the firewall again to get a current copy of
10067
+ # it with a new token. Reapply your changes as needed, then try the
10068
+ # operation again using the new token.
10069
+ # @return [String]
10070
+ #
10071
+ # @!attribute [rw] proxy_settings
10072
+ # The updated proxy listener configuration on the firewall.
10073
+ # @return [Types::ProxySettings]
10074
+ #
10075
+ # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateProxySettingsResponse AWS API Documentation
10076
+ #
10077
+ class UpdateProxySettingsResponse < Struct.new(
10078
+ :firewall_arn,
10079
+ :firewall_name,
10080
+ :update_token,
10081
+ :proxy_settings)
10082
+ SENSITIVE = []
10083
+ include Aws::Structure
10084
+ end
10085
+
9774
10086
  # @!attribute [rw] update_token
9775
10087
  # A token used for optimistic locking. Network Firewall returns a
9776
10088
  # token to your requests that access the rule group. The token marks
@@ -10132,6 +10444,33 @@ module Aws::NetworkFirewall
10132
10444
  include Aws::Structure
10133
10445
  end
10134
10446
 
10447
+ # The VPC and subnets for a proxy mode firewall endpoint. This is used
10448
+ # in CreateFirewall when `NoSourcePreservation` is `TRUE`, to specify
10449
+ # where Network Firewall creates the firewall endpoint.
10450
+ #
10451
+ # This differs from VpcEndpointAssociation, which defines additional
10452
+ # secondary endpoints for a firewall in other VPCs.
10453
+ #
10454
+ # @!attribute [rw] vpc_id
10455
+ # The unique identifier of the VPC where Network Firewall creates the
10456
+ # proxy mode firewall endpoint.
10457
+ # @return [String]
10458
+ #
10459
+ # @!attribute [rw] subnet_mappings
10460
+ # The subnets in which Network Firewall creates the firewall endpoint
10461
+ # for a proxy mode firewall. Each subnet must belong to a different
10462
+ # Availability Zone in the VPC.
10463
+ # @return [Array<Types::SubnetMapping>]
10464
+ #
10465
+ # @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/VpcEndpoint AWS API Documentation
10466
+ #
10467
+ class VpcEndpoint < Struct.new(
10468
+ :vpc_id,
10469
+ :subnet_mappings)
10470
+ SENSITIVE = []
10471
+ include Aws::Structure
10472
+ end
10473
+
10135
10474
  # A VPC endpoint association defines a single subnet to use for a
10136
10475
  # firewall endpoint for a `Firewall`. You can define VPC endpoint
10137
10476
  # associations only in the Availability Zones that already have a subnet