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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-networkfirewall/client.rb +254 -52
- data/lib/aws-sdk-networkfirewall/client_api.rb +67 -0
- data/lib/aws-sdk-networkfirewall/types.rb +414 -75
- data/lib/aws-sdk-networkfirewall.rb +1 -1
- data/sig/client.rbs +47 -1
- data/sig/types.rbs +50 -0
- metadata +1 -1
|
@@ -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
|
-
#
|
|
855
|
-
# ListContainerAssociations
|
|
856
|
-
#
|
|
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
|
|
877
|
-
#
|
|
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
|
|
886
|
+
# The attribute key to filter on.
|
|
881
887
|
# @return [String]
|
|
882
888
|
#
|
|
883
889
|
# @!attribute [rw] value
|
|
884
|
-
# The value
|
|
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
|
-
#
|
|
897
|
-
#
|
|
898
|
-
#
|
|
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
|
|
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
|
-
#
|
|
906
|
-
#
|
|
907
|
-
# attributes
|
|
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
|
|
930
|
-
#
|
|
931
|
-
#
|
|
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
|
|
936
|
-
#
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
989
|
-
#
|
|
990
|
-
#
|
|
991
|
-
#
|
|
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
|
|
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.
|
|
1973
|
-
#
|
|
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.
|
|
1978
|
-
#
|
|
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.
|
|
2470
|
-
#
|
|
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.
|
|
2475
|
-
#
|
|
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
|
|
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
|
|
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
|
|
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
|
|
2519
|
-
#
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
8559
|
-
#
|
|
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.
|
|
8564
|
-
#
|
|
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
|
|
8573
|
-
#
|
|
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
|
|
8578
|
-
#
|
|
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
|
|
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.
|
|
8590
|
-
#
|
|
8591
|
-
#
|
|
8592
|
-
#
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|