aws-sdk-networkfirewall 1.68.0 → 1.69.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 +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-networkfirewall/client.rb +458 -4
- data/lib/aws-sdk-networkfirewall/client_api.rb +178 -0
- data/lib/aws-sdk-networkfirewall/types.rb +681 -22
- data/lib/aws-sdk-networkfirewall.rb +2 -2
- data/sig/client.rbs +100 -3
- data/sig/types.rbs +104 -1
- metadata +1 -1
@@ -37,6 +37,59 @@ module Aws::NetworkFirewall
|
|
37
37
|
include Aws::Structure
|
38
38
|
end
|
39
39
|
|
40
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
41
|
+
# Required. The unique identifier of the transit gateway attachment to
|
42
|
+
# accept. This ID is returned in the response when creating a transit
|
43
|
+
# gateway-attached firewall.
|
44
|
+
# @return [String]
|
45
|
+
#
|
46
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AcceptNetworkFirewallTransitGatewayAttachmentRequest AWS API Documentation
|
47
|
+
#
|
48
|
+
class AcceptNetworkFirewallTransitGatewayAttachmentRequest < Struct.new(
|
49
|
+
:transit_gateway_attachment_id)
|
50
|
+
SENSITIVE = []
|
51
|
+
include Aws::Structure
|
52
|
+
end
|
53
|
+
|
54
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
55
|
+
# The unique identifier of the transit gateway attachment that was
|
56
|
+
# accepted.
|
57
|
+
# @return [String]
|
58
|
+
#
|
59
|
+
# @!attribute [rw] transit_gateway_attachment_status
|
60
|
+
# The current status of the transit gateway attachment. Valid values
|
61
|
+
# are:
|
62
|
+
#
|
63
|
+
# * `CREATING` - The attachment is being created
|
64
|
+
#
|
65
|
+
# * `DELETING` - The attachment is being deleted
|
66
|
+
#
|
67
|
+
# * `DELETED` - The attachment has been deleted
|
68
|
+
#
|
69
|
+
# * `FAILED` - The attachment creation has failed and cannot be
|
70
|
+
# recovered
|
71
|
+
#
|
72
|
+
# * `ERROR` - The attachment is in an error state that might be
|
73
|
+
# recoverable
|
74
|
+
#
|
75
|
+
# * `READY` - The attachment is active and processing traffic
|
76
|
+
#
|
77
|
+
# * `PENDING_ACCEPTANCE` - The attachment is waiting to be accepted
|
78
|
+
#
|
79
|
+
# * `REJECTING` - The attachment is in the process of being rejected
|
80
|
+
#
|
81
|
+
# * `REJECTED` - The attachment has been rejected
|
82
|
+
# @return [String]
|
83
|
+
#
|
84
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AcceptNetworkFirewallTransitGatewayAttachmentResponse AWS API Documentation
|
85
|
+
#
|
86
|
+
class AcceptNetworkFirewallTransitGatewayAttachmentResponse < Struct.new(
|
87
|
+
:transit_gateway_attachment_id,
|
88
|
+
:transit_gateway_attachment_status)
|
89
|
+
SENSITIVE = []
|
90
|
+
include Aws::Structure
|
91
|
+
end
|
92
|
+
|
40
93
|
# A custom action to use in stateless rule actions settings. This is
|
41
94
|
# used in CustomAction.
|
42
95
|
#
|
@@ -253,6 +306,101 @@ module Aws::NetworkFirewall
|
|
253
306
|
include Aws::Structure
|
254
307
|
end
|
255
308
|
|
309
|
+
# @!attribute [rw] update_token
|
310
|
+
# An optional token that you can use for optimistic locking. Network
|
311
|
+
# Firewall returns a token to your requests that access the firewall.
|
312
|
+
# The token marks the state of the firewall resource at the time of
|
313
|
+
# the request.
|
314
|
+
#
|
315
|
+
# To make an unconditional change to the firewall, omit the token in
|
316
|
+
# your update request. Without the token, Network Firewall performs
|
317
|
+
# your updates regardless of whether the firewall has changed since
|
318
|
+
# you last retrieved it.
|
319
|
+
#
|
320
|
+
# To make a conditional change to the firewall, provide the token in
|
321
|
+
# your update request. Network Firewall uses the token to ensure that
|
322
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
323
|
+
# changed, the operation fails with an `InvalidTokenException`. If
|
324
|
+
# this happens, retrieve the firewall again to get a current copy of
|
325
|
+
# it with a new token. Reapply your changes as needed, then try the
|
326
|
+
# operation again using the new token.
|
327
|
+
# @return [String]
|
328
|
+
#
|
329
|
+
# @!attribute [rw] firewall_arn
|
330
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
331
|
+
#
|
332
|
+
# You must specify the ARN or the name, and you can specify both.
|
333
|
+
# @return [String]
|
334
|
+
#
|
335
|
+
# @!attribute [rw] firewall_name
|
336
|
+
# The descriptive name of the firewall. You can't change the name of
|
337
|
+
# a firewall after you create it.
|
338
|
+
#
|
339
|
+
# You must specify the ARN or the name, and you can specify both.
|
340
|
+
# @return [String]
|
341
|
+
#
|
342
|
+
# @!attribute [rw] availability_zone_mappings
|
343
|
+
# Required. The Availability Zones where you want to create firewall
|
344
|
+
# endpoints. You must specify at least one Availability Zone.
|
345
|
+
# @return [Array<Types::AvailabilityZoneMapping>]
|
346
|
+
#
|
347
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AssociateAvailabilityZonesRequest AWS API Documentation
|
348
|
+
#
|
349
|
+
class AssociateAvailabilityZonesRequest < Struct.new(
|
350
|
+
:update_token,
|
351
|
+
:firewall_arn,
|
352
|
+
:firewall_name,
|
353
|
+
:availability_zone_mappings)
|
354
|
+
SENSITIVE = []
|
355
|
+
include Aws::Structure
|
356
|
+
end
|
357
|
+
|
358
|
+
# @!attribute [rw] firewall_arn
|
359
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
360
|
+
# @return [String]
|
361
|
+
#
|
362
|
+
# @!attribute [rw] firewall_name
|
363
|
+
# The descriptive name of the firewall. You can't change the name of
|
364
|
+
# a firewall after you create it.
|
365
|
+
# @return [String]
|
366
|
+
#
|
367
|
+
# @!attribute [rw] availability_zone_mappings
|
368
|
+
# The Availability Zones where Network Firewall created firewall
|
369
|
+
# endpoints. Each mapping specifies an Availability Zone where the
|
370
|
+
# firewall processes traffic.
|
371
|
+
# @return [Array<Types::AvailabilityZoneMapping>]
|
372
|
+
#
|
373
|
+
# @!attribute [rw] update_token
|
374
|
+
# An optional token that you can use for optimistic locking. Network
|
375
|
+
# Firewall returns a token to your requests that access the firewall.
|
376
|
+
# The token marks the state of the firewall resource at the time of
|
377
|
+
# the request.
|
378
|
+
#
|
379
|
+
# To make an unconditional change to the firewall, omit the token in
|
380
|
+
# your update request. Without the token, Network Firewall performs
|
381
|
+
# your updates regardless of whether the firewall has changed since
|
382
|
+
# you last retrieved it.
|
383
|
+
#
|
384
|
+
# To make a conditional change to the firewall, provide the token in
|
385
|
+
# your update request. Network Firewall uses the token to ensure that
|
386
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
387
|
+
# changed, the operation fails with an `InvalidTokenException`. If
|
388
|
+
# this happens, retrieve the firewall again to get a current copy of
|
389
|
+
# it with a new token. Reapply your changes as needed, then try the
|
390
|
+
# operation again using the new token.
|
391
|
+
# @return [String]
|
392
|
+
#
|
393
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AssociateAvailabilityZonesResponse AWS API Documentation
|
394
|
+
#
|
395
|
+
class AssociateAvailabilityZonesResponse < Struct.new(
|
396
|
+
:firewall_arn,
|
397
|
+
:firewall_name,
|
398
|
+
:availability_zone_mappings,
|
399
|
+
:update_token)
|
400
|
+
SENSITIVE = []
|
401
|
+
include Aws::Structure
|
402
|
+
end
|
403
|
+
|
256
404
|
# @!attribute [rw] update_token
|
257
405
|
# An optional token that you can use for optimistic locking. Network
|
258
406
|
# Firewall returns a token to your requests that access the firewall.
|
@@ -499,6 +647,29 @@ module Aws::NetworkFirewall
|
|
499
647
|
include Aws::Structure
|
500
648
|
end
|
501
649
|
|
650
|
+
# Defines the mapping between an Availability Zone and a firewall
|
651
|
+
# endpoint for a transit gateway-attached firewall. Each mapping
|
652
|
+
# represents where the firewall can process traffic. You use these
|
653
|
+
# mappings when calling CreateFirewall, AssociateAvailabilityZones, and
|
654
|
+
# DisassociateAvailabilityZones.
|
655
|
+
#
|
656
|
+
# To retrieve the current Availability Zone mappings for a firewall, use
|
657
|
+
# DescribeFirewall.
|
658
|
+
#
|
659
|
+
# @!attribute [rw] availability_zone
|
660
|
+
# The ID of the Availability Zone where the firewall endpoint is
|
661
|
+
# located. For example, `us-east-2a`. The Availability Zone must be in
|
662
|
+
# the same Region as the transit gateway.
|
663
|
+
# @return [String]
|
664
|
+
#
|
665
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AvailabilityZoneMapping AWS API Documentation
|
666
|
+
#
|
667
|
+
class AvailabilityZoneMapping < Struct.new(
|
668
|
+
:availability_zone)
|
669
|
+
SENSITIVE = []
|
670
|
+
include Aws::Structure
|
671
|
+
end
|
672
|
+
|
502
673
|
# High-level information about an Availability Zone where the firewall
|
503
674
|
# has an endpoint defined.
|
504
675
|
#
|
@@ -753,6 +924,50 @@ module Aws::NetworkFirewall
|
|
753
924
|
# to enable on the firewall.
|
754
925
|
# @return [Array<String>]
|
755
926
|
#
|
927
|
+
# @!attribute [rw] transit_gateway_id
|
928
|
+
# Required when creating a transit gateway-attached firewall. The
|
929
|
+
# unique identifier of the transit gateway to attach to this firewall.
|
930
|
+
# You can provide either a transit gateway from your account or one
|
931
|
+
# that has been shared with you through Resource Access Manager.
|
932
|
+
#
|
933
|
+
# After creating the firewall, you cannot change the transit gateway
|
934
|
+
# association. To use a different transit gateway, you must create a
|
935
|
+
# new firewall.
|
936
|
+
#
|
937
|
+
# For information about creating firewalls, see CreateFirewall. For
|
938
|
+
# specific guidance about transit gateway-attached firewalls, see
|
939
|
+
# [Considerations for transit gateway-attached firewalls][1] in the
|
940
|
+
# *Network Firewall Developer Guide*.
|
941
|
+
#
|
942
|
+
#
|
943
|
+
#
|
944
|
+
# [1]: https://docs.aws.amazon.com/network-firewall/latest/developerguide/tgw-firewall-considerations.html
|
945
|
+
# @return [String]
|
946
|
+
#
|
947
|
+
# @!attribute [rw] availability_zone_mappings
|
948
|
+
# Required. The Availability Zones where you want to create firewall
|
949
|
+
# endpoints for a transit gateway-attached firewall. You must specify
|
950
|
+
# at least one Availability Zone. Consider enabling the firewall in
|
951
|
+
# every Availability Zone where you have workloads to maintain
|
952
|
+
# Availability Zone independence.
|
953
|
+
#
|
954
|
+
# You can modify Availability Zones later using
|
955
|
+
# AssociateAvailabilityZones or DisassociateAvailabilityZones, but
|
956
|
+
# this may briefly disrupt traffic. The
|
957
|
+
# `AvailabilityZoneChangeProtection` setting controls whether you can
|
958
|
+
# make these modifications.
|
959
|
+
# @return [Array<Types::AvailabilityZoneMapping>]
|
960
|
+
#
|
961
|
+
# @!attribute [rw] availability_zone_change_protection
|
962
|
+
# Optional. A setting indicating whether the firewall is protected
|
963
|
+
# against changes to its Availability Zone configuration. When set to
|
964
|
+
# `TRUE`, you cannot add or remove Availability Zones without first
|
965
|
+
# disabling this protection using
|
966
|
+
# UpdateAvailabilityZoneChangeProtection.
|
967
|
+
#
|
968
|
+
# Default value: `FALSE`
|
969
|
+
# @return [Boolean]
|
970
|
+
#
|
756
971
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/CreateFirewallRequest AWS API Documentation
|
757
972
|
#
|
758
973
|
class CreateFirewallRequest < Struct.new(
|
@@ -766,7 +981,10 @@ module Aws::NetworkFirewall
|
|
766
981
|
:description,
|
767
982
|
:tags,
|
768
983
|
:encryption_configuration,
|
769
|
-
:enabled_analysis_types
|
984
|
+
:enabled_analysis_types,
|
985
|
+
:transit_gateway_id,
|
986
|
+
:availability_zone_mappings,
|
987
|
+
:availability_zone_change_protection)
|
770
988
|
SENSITIVE = []
|
771
989
|
include Aws::Structure
|
772
990
|
end
|
@@ -1268,6 +1486,59 @@ module Aws::NetworkFirewall
|
|
1268
1486
|
include Aws::Structure
|
1269
1487
|
end
|
1270
1488
|
|
1489
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
1490
|
+
# Required. The unique identifier of the transit gateway attachment to
|
1491
|
+
# delete.
|
1492
|
+
# @return [String]
|
1493
|
+
#
|
1494
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DeleteNetworkFirewallTransitGatewayAttachmentRequest AWS API Documentation
|
1495
|
+
#
|
1496
|
+
class DeleteNetworkFirewallTransitGatewayAttachmentRequest < Struct.new(
|
1497
|
+
:transit_gateway_attachment_id)
|
1498
|
+
SENSITIVE = []
|
1499
|
+
include Aws::Structure
|
1500
|
+
end
|
1501
|
+
|
1502
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
1503
|
+
# The ID of the transit gateway attachment that was deleted.
|
1504
|
+
# @return [String]
|
1505
|
+
#
|
1506
|
+
# @!attribute [rw] transit_gateway_attachment_status
|
1507
|
+
# The current status of the transit gateway attachment deletion
|
1508
|
+
# process.
|
1509
|
+
#
|
1510
|
+
# Valid values are:
|
1511
|
+
#
|
1512
|
+
# * `CREATING` - The attachment is being created
|
1513
|
+
#
|
1514
|
+
# * `DELETING` - The attachment is being deleted
|
1515
|
+
#
|
1516
|
+
# * `DELETED` - The attachment has been deleted
|
1517
|
+
#
|
1518
|
+
# * `FAILED` - The attachment creation has failed and cannot be
|
1519
|
+
# recovered
|
1520
|
+
#
|
1521
|
+
# * `ERROR` - The attachment is in an error state that might be
|
1522
|
+
# recoverable
|
1523
|
+
#
|
1524
|
+
# * `READY` - The attachment is active and processing traffic
|
1525
|
+
#
|
1526
|
+
# * `PENDING_ACCEPTANCE` - The attachment is waiting to be accepted
|
1527
|
+
#
|
1528
|
+
# * `REJECTING` - The attachment is in the process of being rejected
|
1529
|
+
#
|
1530
|
+
# * `REJECTED` - The attachment has been rejected
|
1531
|
+
# @return [String]
|
1532
|
+
#
|
1533
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DeleteNetworkFirewallTransitGatewayAttachmentResponse AWS API Documentation
|
1534
|
+
#
|
1535
|
+
class DeleteNetworkFirewallTransitGatewayAttachmentResponse < Struct.new(
|
1536
|
+
:transit_gateway_attachment_id,
|
1537
|
+
:transit_gateway_attachment_status)
|
1538
|
+
SENSITIVE = []
|
1539
|
+
include Aws::Structure
|
1540
|
+
end
|
1541
|
+
|
1271
1542
|
# @!attribute [rw] resource_arn
|
1272
1543
|
# The Amazon Resource Name (ARN) of the rule group or firewall policy
|
1273
1544
|
# whose resource policy you want to delete.
|
@@ -1444,6 +1715,12 @@ module Aws::NetworkFirewall
|
|
1444
1715
|
# defined.
|
1445
1716
|
# @return [Hash<String,Types::AvailabilityZoneMetadata>]
|
1446
1717
|
#
|
1718
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
1719
|
+
# The unique identifier of the transit gateway attachment associated
|
1720
|
+
# with this firewall. This field is only present for transit
|
1721
|
+
# gateway-attached firewalls.
|
1722
|
+
# @return [String]
|
1723
|
+
#
|
1447
1724
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeFirewallMetadataResponse AWS API Documentation
|
1448
1725
|
#
|
1449
1726
|
class DescribeFirewallMetadataResponse < Struct.new(
|
@@ -1451,7 +1728,8 @@ module Aws::NetworkFirewall
|
|
1451
1728
|
:firewall_policy_arn,
|
1452
1729
|
:description,
|
1453
1730
|
:status,
|
1454
|
-
:supported_availability_zones
|
1731
|
+
:supported_availability_zones,
|
1732
|
+
:transit_gateway_attachment_id)
|
1455
1733
|
SENSITIVE = []
|
1456
1734
|
include Aws::Structure
|
1457
1735
|
end
|
@@ -1851,7 +2129,7 @@ module Aws::NetworkFirewall
|
|
1851
2129
|
# @return [Types::StatefulRuleOptions]
|
1852
2130
|
#
|
1853
2131
|
# @!attribute [rw] last_modified_time
|
1854
|
-
#
|
2132
|
+
# A timestamp indicating when the rule group was last modified.
|
1855
2133
|
# @return [Time]
|
1856
2134
|
#
|
1857
2135
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeRuleGroupMetadataResponse AWS API Documentation
|
@@ -2099,6 +2377,100 @@ module Aws::NetworkFirewall
|
|
2099
2377
|
include Aws::Structure
|
2100
2378
|
end
|
2101
2379
|
|
2380
|
+
# @!attribute [rw] update_token
|
2381
|
+
# An optional token that you can use for optimistic locking. Network
|
2382
|
+
# Firewall returns a token to your requests that access the firewall.
|
2383
|
+
# The token marks the state of the firewall resource at the time of
|
2384
|
+
# the request.
|
2385
|
+
#
|
2386
|
+
# To make an unconditional change to the firewall, omit the token in
|
2387
|
+
# your update request. Without the token, Network Firewall performs
|
2388
|
+
# your updates regardless of whether the firewall has changed since
|
2389
|
+
# you last retrieved it.
|
2390
|
+
#
|
2391
|
+
# To make a conditional change to the firewall, provide the token in
|
2392
|
+
# your update request. Network Firewall uses the token to ensure that
|
2393
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
2394
|
+
# changed, the operation fails with an `InvalidTokenException`. If
|
2395
|
+
# this happens, retrieve the firewall again to get a current copy of
|
2396
|
+
# it with a new token. Reapply your changes as needed, then try the
|
2397
|
+
# operation again using the new token.
|
2398
|
+
# @return [String]
|
2399
|
+
#
|
2400
|
+
# @!attribute [rw] firewall_arn
|
2401
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
2402
|
+
#
|
2403
|
+
# You must specify the ARN or the name, and you can specify both.
|
2404
|
+
# @return [String]
|
2405
|
+
#
|
2406
|
+
# @!attribute [rw] firewall_name
|
2407
|
+
# The descriptive name of the firewall. You can't change the name of
|
2408
|
+
# a firewall after you create it.
|
2409
|
+
#
|
2410
|
+
# You must specify the ARN or the name, and you can specify both.
|
2411
|
+
# @return [String]
|
2412
|
+
#
|
2413
|
+
# @!attribute [rw] availability_zone_mappings
|
2414
|
+
# Required. The Availability Zones to remove from the firewall's
|
2415
|
+
# configuration.
|
2416
|
+
# @return [Array<Types::AvailabilityZoneMapping>]
|
2417
|
+
#
|
2418
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DisassociateAvailabilityZonesRequest AWS API Documentation
|
2419
|
+
#
|
2420
|
+
class DisassociateAvailabilityZonesRequest < Struct.new(
|
2421
|
+
:update_token,
|
2422
|
+
:firewall_arn,
|
2423
|
+
:firewall_name,
|
2424
|
+
:availability_zone_mappings)
|
2425
|
+
SENSITIVE = []
|
2426
|
+
include Aws::Structure
|
2427
|
+
end
|
2428
|
+
|
2429
|
+
# @!attribute [rw] firewall_arn
|
2430
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
2431
|
+
# @return [String]
|
2432
|
+
#
|
2433
|
+
# @!attribute [rw] firewall_name
|
2434
|
+
# The descriptive name of the firewall. You can't change the name of
|
2435
|
+
# a firewall after you create it.
|
2436
|
+
# @return [String]
|
2437
|
+
#
|
2438
|
+
# @!attribute [rw] availability_zone_mappings
|
2439
|
+
# The remaining Availability Zones where the firewall has endpoints
|
2440
|
+
# after the disassociation.
|
2441
|
+
# @return [Array<Types::AvailabilityZoneMapping>]
|
2442
|
+
#
|
2443
|
+
# @!attribute [rw] update_token
|
2444
|
+
# An optional token that you can use for optimistic locking. Network
|
2445
|
+
# Firewall returns a token to your requests that access the firewall.
|
2446
|
+
# The token marks the state of the firewall resource at the time of
|
2447
|
+
# the request.
|
2448
|
+
#
|
2449
|
+
# To make an unconditional change to the firewall, omit the token in
|
2450
|
+
# your update request. Without the token, Network Firewall performs
|
2451
|
+
# your updates regardless of whether the firewall has changed since
|
2452
|
+
# you last retrieved it.
|
2453
|
+
#
|
2454
|
+
# To make a conditional change to the firewall, provide the token in
|
2455
|
+
# your update request. Network Firewall uses the token to ensure that
|
2456
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
2457
|
+
# changed, the operation fails with an `InvalidTokenException`. If
|
2458
|
+
# this happens, retrieve the firewall again to get a current copy of
|
2459
|
+
# it with a new token. Reapply your changes as needed, then try the
|
2460
|
+
# operation again using the new token.
|
2461
|
+
# @return [String]
|
2462
|
+
#
|
2463
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DisassociateAvailabilityZonesResponse AWS API Documentation
|
2464
|
+
#
|
2465
|
+
class DisassociateAvailabilityZonesResponse < Struct.new(
|
2466
|
+
:firewall_arn,
|
2467
|
+
:firewall_name,
|
2468
|
+
:availability_zone_mappings,
|
2469
|
+
:update_token)
|
2470
|
+
SENSITIVE = []
|
2471
|
+
include Aws::Structure
|
2472
|
+
end
|
2473
|
+
|
2102
2474
|
# @!attribute [rw] update_token
|
2103
2475
|
# An optional token that you can use for optimistic locking. Network
|
2104
2476
|
# Firewall returns a token to your requests that access the firewall.
|
@@ -2340,6 +2712,31 @@ module Aws::NetworkFirewall
|
|
2340
2712
|
# to enable on the firewall.
|
2341
2713
|
# @return [Array<String>]
|
2342
2714
|
#
|
2715
|
+
# @!attribute [rw] transit_gateway_id
|
2716
|
+
# The unique identifier of the transit gateway associated with this
|
2717
|
+
# firewall. This field is only present for transit gateway-attached
|
2718
|
+
# firewalls.
|
2719
|
+
# @return [String]
|
2720
|
+
#
|
2721
|
+
# @!attribute [rw] transit_gateway_owner_account_id
|
2722
|
+
# The Amazon Web Services account ID that owns the transit gateway.
|
2723
|
+
# This may be different from the firewall owner's account ID when
|
2724
|
+
# using a shared transit gateway.
|
2725
|
+
# @return [String]
|
2726
|
+
#
|
2727
|
+
# @!attribute [rw] availability_zone_mappings
|
2728
|
+
# The Availability Zones where the firewall endpoints are created for
|
2729
|
+
# a transit gateway-attached firewall. Each mapping specifies an
|
2730
|
+
# Availability Zone where the firewall processes traffic.
|
2731
|
+
# @return [Array<Types::AvailabilityZoneMapping>]
|
2732
|
+
#
|
2733
|
+
# @!attribute [rw] availability_zone_change_protection
|
2734
|
+
# A setting indicating whether the firewall is protected against
|
2735
|
+
# changes to its Availability Zone configuration. When set to `TRUE`,
|
2736
|
+
# you must first disable this protection before adding or removing
|
2737
|
+
# Availability Zones.
|
2738
|
+
# @return [Boolean]
|
2739
|
+
#
|
2343
2740
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/Firewall AWS API Documentation
|
2344
2741
|
#
|
2345
2742
|
class Firewall < Struct.new(
|
@@ -2356,7 +2753,11 @@ module Aws::NetworkFirewall
|
|
2356
2753
|
:tags,
|
2357
2754
|
:encryption_configuration,
|
2358
2755
|
:number_of_associations,
|
2359
|
-
:enabled_analysis_types
|
2756
|
+
:enabled_analysis_types,
|
2757
|
+
:transit_gateway_id,
|
2758
|
+
:transit_gateway_owner_account_id,
|
2759
|
+
:availability_zone_mappings,
|
2760
|
+
:availability_zone_change_protection)
|
2360
2761
|
SENSITIVE = []
|
2361
2762
|
include Aws::Structure
|
2362
2763
|
end
|
@@ -2374,11 +2775,18 @@ module Aws::NetworkFirewall
|
|
2374
2775
|
# The Amazon Resource Name (ARN) of the firewall.
|
2375
2776
|
# @return [String]
|
2376
2777
|
#
|
2778
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
2779
|
+
# The unique identifier of the transit gateway attachment associated
|
2780
|
+
# with this firewall. This field is only present for transit
|
2781
|
+
# gateway-attached firewalls.
|
2782
|
+
# @return [String]
|
2783
|
+
#
|
2377
2784
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/FirewallMetadata AWS API Documentation
|
2378
2785
|
#
|
2379
2786
|
class FirewallMetadata < Struct.new(
|
2380
2787
|
:firewall_name,
|
2381
|
-
:firewall_arn
|
2788
|
+
:firewall_arn,
|
2789
|
+
:transit_gateway_attachment_id)
|
2382
2790
|
SENSITIVE = []
|
2383
2791
|
include Aws::Structure
|
2384
2792
|
end
|
@@ -2651,13 +3059,21 @@ module Aws::NetworkFirewall
|
|
2651
3059
|
# all of the reference sets in a firewall.
|
2652
3060
|
# @return [Types::CapacityUsageSummary]
|
2653
3061
|
#
|
3062
|
+
# @!attribute [rw] transit_gateway_attachment_sync_state
|
3063
|
+
# The synchronization state of the transit gateway attachment. This
|
3064
|
+
# indicates whether the firewall's transit gateway configuration is
|
3065
|
+
# properly synchronized and operational. Use this to verify that your
|
3066
|
+
# transit gateway configuration changes have been applied.
|
3067
|
+
# @return [Types::TransitGatewayAttachmentSyncState]
|
3068
|
+
#
|
2654
3069
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/FirewallStatus AWS API Documentation
|
2655
3070
|
#
|
2656
3071
|
class FirewallStatus < Struct.new(
|
2657
3072
|
:status,
|
2658
3073
|
:configuration_sync_state_summary,
|
2659
3074
|
:sync_states,
|
2660
|
-
:capacity_usage_summary
|
3075
|
+
:capacity_usage_summary,
|
3076
|
+
:transit_gateway_attachment_sync_state)
|
2661
3077
|
SENSITIVE = []
|
2662
3078
|
include Aws::Structure
|
2663
3079
|
end
|
@@ -4176,6 +4592,67 @@ module Aws::NetworkFirewall
|
|
4176
4592
|
include Aws::Structure
|
4177
4593
|
end
|
4178
4594
|
|
4595
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
4596
|
+
# Required. The unique identifier of the transit gateway attachment to
|
4597
|
+
# reject. This ID is returned in the response when creating a transit
|
4598
|
+
# gateway-attached firewall.
|
4599
|
+
# @return [String]
|
4600
|
+
#
|
4601
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/RejectNetworkFirewallTransitGatewayAttachmentRequest AWS API Documentation
|
4602
|
+
#
|
4603
|
+
class RejectNetworkFirewallTransitGatewayAttachmentRequest < Struct.new(
|
4604
|
+
:transit_gateway_attachment_id)
|
4605
|
+
SENSITIVE = []
|
4606
|
+
include Aws::Structure
|
4607
|
+
end
|
4608
|
+
|
4609
|
+
# @!attribute [rw] transit_gateway_attachment_id
|
4610
|
+
# The unique identifier of the transit gateway attachment that was
|
4611
|
+
# rejected.
|
4612
|
+
# @return [String]
|
4613
|
+
#
|
4614
|
+
# @!attribute [rw] transit_gateway_attachment_status
|
4615
|
+
# The current status of the transit gateway attachment. Valid values
|
4616
|
+
# are:
|
4617
|
+
#
|
4618
|
+
# * `CREATING` - The attachment is being created
|
4619
|
+
#
|
4620
|
+
# * `DELETING` - The attachment is being deleted
|
4621
|
+
#
|
4622
|
+
# * `DELETED` - The attachment has been deleted
|
4623
|
+
#
|
4624
|
+
# * `FAILED` - The attachment creation has failed and cannot be
|
4625
|
+
# recovered
|
4626
|
+
#
|
4627
|
+
# * `ERROR` - The attachment is in an error state that might be
|
4628
|
+
# recoverable
|
4629
|
+
#
|
4630
|
+
# * `READY` - The attachment is active and processing traffic
|
4631
|
+
#
|
4632
|
+
# * `PENDING_ACCEPTANCE` - The attachment is waiting to be accepted
|
4633
|
+
#
|
4634
|
+
# * `REJECTING` - The attachment is in the process of being rejected
|
4635
|
+
#
|
4636
|
+
# * `REJECTED` - The attachment has been rejected
|
4637
|
+
#
|
4638
|
+
# For information about troubleshooting endpoint failures, see
|
4639
|
+
# [Troubleshooting firewall endpoint failures][1] in the *Network
|
4640
|
+
# Firewall Developer Guide*.
|
4641
|
+
#
|
4642
|
+
#
|
4643
|
+
#
|
4644
|
+
# [1]: https://docs.aws.amazon.com/network-firewall/latest/developerguide/firewall-troubleshooting-endpoint-failures.html
|
4645
|
+
# @return [String]
|
4646
|
+
#
|
4647
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/RejectNetworkFirewallTransitGatewayAttachmentResponse AWS API Documentation
|
4648
|
+
#
|
4649
|
+
class RejectNetworkFirewallTransitGatewayAttachmentResponse < Struct.new(
|
4650
|
+
:transit_gateway_attachment_id,
|
4651
|
+
:transit_gateway_attachment_status)
|
4652
|
+
SENSITIVE = []
|
4653
|
+
include Aws::Structure
|
4654
|
+
end
|
4655
|
+
|
4179
4656
|
# Unable to locate a resource using the parameters that you provided.
|
4180
4657
|
#
|
4181
4658
|
# @!attribute [rw] message
|
@@ -4407,7 +4884,7 @@ module Aws::NetworkFirewall
|
|
4407
4884
|
# @return [Types::SourceMetadata]
|
4408
4885
|
#
|
4409
4886
|
# @!attribute [rw] sns_topic
|
4410
|
-
# The Amazon
|
4887
|
+
# The Amazon Resource Name (ARN) of the Amazon Simple Notification
|
4411
4888
|
# Service SNS topic that's used to record changes to the managed rule
|
4412
4889
|
# group. You can subscribe to the SNS topic to receive notifications
|
4413
4890
|
# when the managed rule group is modified, such as for new versions
|
@@ -4491,7 +4968,8 @@ module Aws::NetworkFirewall
|
|
4491
4968
|
end
|
4492
4969
|
|
4493
4970
|
# Settings that are available for use in the rules in the RuleGroup
|
4494
|
-
# where this is defined.
|
4971
|
+
# where this is defined. See CreateRuleGroup or UpdateRuleGroup for
|
4972
|
+
# usage.
|
4495
4973
|
#
|
4496
4974
|
# @!attribute [rw] ip_sets
|
4497
4975
|
# A list of IP addresses and address ranges, in CIDR notation.
|
@@ -4682,9 +5160,8 @@ module Aws::NetworkFirewall
|
|
4682
5160
|
# Authority.
|
4683
5161
|
#
|
4684
5162
|
# For more information about configuring certificates for outbound
|
4685
|
-
# inspection, see [Using SSL/TLS certificates with
|
4686
|
-
#
|
4687
|
-
# Guide*.
|
5163
|
+
# inspection, see [Using SSL/TLS certificates with TLS inspection
|
5164
|
+
# configurations][1] in the *Network Firewall Developer Guide*.
|
4688
5165
|
#
|
4689
5166
|
# For information about working with certificates in ACM, see
|
4690
5167
|
# [Importing certificates][2] in the *Certificate Manager User Guide*.
|
@@ -5001,17 +5478,18 @@ module Aws::NetworkFirewall
|
|
5001
5478
|
#
|
5002
5479
|
# @!attribute [rw] rule_order
|
5003
5480
|
# Indicates how to manage the order of stateful rule evaluation for
|
5004
|
-
# the policy. `STRICT_ORDER` is the
|
5005
|
-
#
|
5006
|
-
#
|
5007
|
-
#
|
5008
|
-
# `STRICT_ORDER` to have the stateful
|
5009
|
-
# evaluation order of your rules. The
|
5010
|
-
# order is `PASS`, followed by `DROP`,
|
5011
|
-
# Stateful rules are provided to the
|
5012
|
-
# compatible strings, and Suricata evaluates
|
5013
|
-
# settings. For more information, see [Evaluation
|
5014
|
-
# rules][1] in the *Network Firewall Developer
|
5481
|
+
# the policy. `STRICT_ORDER` is the recommended option, but
|
5482
|
+
# `DEFAULT_ACTION_ORDER` is the default option. With `STRICT_ORDER`,
|
5483
|
+
# provide your rules in the order that you want them to be evaluated.
|
5484
|
+
# You can then choose one or more default actions for packets that
|
5485
|
+
# don't match any rules. Choose `STRICT_ORDER` to have the stateful
|
5486
|
+
# rules engine determine the evaluation order of your rules. The
|
5487
|
+
# default action for this rule order is `PASS`, followed by `DROP`,
|
5488
|
+
# `REJECT`, and `ALERT` actions. Stateful rules are provided to the
|
5489
|
+
# rule engine as Suricata compatible strings, and Suricata evaluates
|
5490
|
+
# them based on your settings. For more information, see [Evaluation
|
5491
|
+
# order for stateful rules][1] in the *Network Firewall Developer
|
5492
|
+
# Guide*.
|
5015
5493
|
#
|
5016
5494
|
#
|
5017
5495
|
#
|
@@ -5612,6 +6090,87 @@ module Aws::NetworkFirewall
|
|
5612
6090
|
include Aws::Structure
|
5613
6091
|
end
|
5614
6092
|
|
6093
|
+
# Contains information about the synchronization state of a transit
|
6094
|
+
# gateway attachment, including its current status and any error
|
6095
|
+
# messages. Network Firewall uses this to track the state of your
|
6096
|
+
# transit gateway configuration changes.
|
6097
|
+
#
|
6098
|
+
# @!attribute [rw] attachment_id
|
6099
|
+
# The unique identifier of the transit gateway attachment.
|
6100
|
+
# @return [String]
|
6101
|
+
#
|
6102
|
+
# @!attribute [rw] transit_gateway_attachment_status
|
6103
|
+
# The current status of the transit gateway attachment.
|
6104
|
+
#
|
6105
|
+
# Valid values are:
|
6106
|
+
#
|
6107
|
+
# * `CREATING` - The attachment is being created
|
6108
|
+
#
|
6109
|
+
# * `DELETING` - The attachment is being deleted
|
6110
|
+
#
|
6111
|
+
# * `DELETED` - The attachment has been deleted
|
6112
|
+
#
|
6113
|
+
# * `FAILED` - The attachment creation has failed and cannot be
|
6114
|
+
# recovered
|
6115
|
+
#
|
6116
|
+
# * `ERROR` - The attachment is in an error state that might be
|
6117
|
+
# recoverable
|
6118
|
+
#
|
6119
|
+
# * `READY` - The attachment is active and processing traffic
|
6120
|
+
#
|
6121
|
+
# * `PENDING_ACCEPTANCE` - The attachment is waiting to be accepted
|
6122
|
+
#
|
6123
|
+
# * `REJECTING` - The attachment is in the process of being rejected
|
6124
|
+
#
|
6125
|
+
# * `REJECTED` - The attachment has been rejected
|
6126
|
+
# @return [String]
|
6127
|
+
#
|
6128
|
+
# @!attribute [rw] status_message
|
6129
|
+
# A message providing additional information about the current status,
|
6130
|
+
# particularly useful when the transit gateway attachment is in a
|
6131
|
+
# non-`READY` state.
|
6132
|
+
#
|
6133
|
+
# Valid values are:
|
6134
|
+
#
|
6135
|
+
# * `CREATING` - The attachment is being created
|
6136
|
+
#
|
6137
|
+
# * `DELETING` - The attachment is being deleted
|
6138
|
+
#
|
6139
|
+
# * `DELETED` - The attachment has been deleted
|
6140
|
+
#
|
6141
|
+
# * `FAILED` - The attachment creation has failed and cannot be
|
6142
|
+
# recovered
|
6143
|
+
#
|
6144
|
+
# * `ERROR` - The attachment is in an error state that might be
|
6145
|
+
# recoverable
|
6146
|
+
#
|
6147
|
+
# * `READY` - The attachment is active and processing traffic
|
6148
|
+
#
|
6149
|
+
# * `PENDING_ACCEPTANCE` - The attachment is waiting to be accepted
|
6150
|
+
#
|
6151
|
+
# * `REJECTING` - The attachment is in the process of being rejected
|
6152
|
+
#
|
6153
|
+
# * `REJECTED` - The attachment has been rejected
|
6154
|
+
#
|
6155
|
+
# For information about troubleshooting endpoint failures, see
|
6156
|
+
# [Troubleshooting firewall endpoint failures][1] in the *Network
|
6157
|
+
# Firewall Developer Guide*.
|
6158
|
+
#
|
6159
|
+
#
|
6160
|
+
#
|
6161
|
+
# [1]: https://docs.aws.amazon.com/network-firewall/latest/developerguide/firewall-troubleshooting-endpoint-failures.html
|
6162
|
+
# @return [String]
|
6163
|
+
#
|
6164
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/TransitGatewayAttachmentSyncState AWS API Documentation
|
6165
|
+
#
|
6166
|
+
class TransitGatewayAttachmentSyncState < Struct.new(
|
6167
|
+
:attachment_id,
|
6168
|
+
:transit_gateway_attachment_status,
|
6169
|
+
:status_message)
|
6170
|
+
SENSITIVE = []
|
6171
|
+
include Aws::Structure
|
6172
|
+
end
|
6173
|
+
|
5615
6174
|
# A unique source IP address that connected to a domain.
|
5616
6175
|
#
|
5617
6176
|
# @!attribute [rw] count
|
@@ -5659,6 +6218,106 @@ module Aws::NetworkFirewall
|
|
5659
6218
|
#
|
5660
6219
|
class UntagResourceResponse < Aws::EmptyStructure; end
|
5661
6220
|
|
6221
|
+
# @!attribute [rw] update_token
|
6222
|
+
# An optional token that you can use for optimistic locking. Network
|
6223
|
+
# Firewall returns a token to your requests that access the firewall.
|
6224
|
+
# The token marks the state of the firewall resource at the time of
|
6225
|
+
# the request.
|
6226
|
+
#
|
6227
|
+
# To make an unconditional change to the firewall, omit the token in
|
6228
|
+
# your update request. Without the token, Network Firewall performs
|
6229
|
+
# your updates regardless of whether the firewall has changed since
|
6230
|
+
# you last retrieved it.
|
6231
|
+
#
|
6232
|
+
# To make a conditional change to the firewall, provide the token in
|
6233
|
+
# your update request. Network Firewall uses the token to ensure that
|
6234
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
6235
|
+
# changed, the operation fails with an `InvalidTokenException`. If
|
6236
|
+
# this happens, retrieve the firewall again to get a current copy of
|
6237
|
+
# it with a new token. Reapply your changes as needed, then try the
|
6238
|
+
# operation again using the new token.
|
6239
|
+
# @return [String]
|
6240
|
+
#
|
6241
|
+
# @!attribute [rw] firewall_arn
|
6242
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
6243
|
+
#
|
6244
|
+
# You must specify the ARN or the name, and you can specify both.
|
6245
|
+
# @return [String]
|
6246
|
+
#
|
6247
|
+
# @!attribute [rw] firewall_name
|
6248
|
+
# The descriptive name of the firewall. You can't change the name of
|
6249
|
+
# a firewall after you create it.
|
6250
|
+
#
|
6251
|
+
# You must specify the ARN or the name, and you can specify both.
|
6252
|
+
# @return [String]
|
6253
|
+
#
|
6254
|
+
# @!attribute [rw] availability_zone_change_protection
|
6255
|
+
# A setting indicating whether the firewall is protected against
|
6256
|
+
# changes to the subnet associations. Use this setting to protect
|
6257
|
+
# against accidentally modifying the subnet associations for a
|
6258
|
+
# firewall that is in use. When you create a firewall, the operation
|
6259
|
+
# initializes this setting to `TRUE`.
|
6260
|
+
# @return [Boolean]
|
6261
|
+
#
|
6262
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateAvailabilityZoneChangeProtectionRequest AWS API Documentation
|
6263
|
+
#
|
6264
|
+
class UpdateAvailabilityZoneChangeProtectionRequest < Struct.new(
|
6265
|
+
:update_token,
|
6266
|
+
:firewall_arn,
|
6267
|
+
:firewall_name,
|
6268
|
+
:availability_zone_change_protection)
|
6269
|
+
SENSITIVE = []
|
6270
|
+
include Aws::Structure
|
6271
|
+
end
|
6272
|
+
|
6273
|
+
# @!attribute [rw] update_token
|
6274
|
+
# An optional token that you can use for optimistic locking. Network
|
6275
|
+
# Firewall returns a token to your requests that access the firewall.
|
6276
|
+
# The token marks the state of the firewall resource at the time of
|
6277
|
+
# the request.
|
6278
|
+
#
|
6279
|
+
# To make an unconditional change to the firewall, omit the token in
|
6280
|
+
# your update request. Without the token, Network Firewall performs
|
6281
|
+
# your updates regardless of whether the firewall has changed since
|
6282
|
+
# you last retrieved it.
|
6283
|
+
#
|
6284
|
+
# To make a conditional change to the firewall, provide the token in
|
6285
|
+
# your update request. Network Firewall uses the token to ensure that
|
6286
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
6287
|
+
# changed, the operation fails with an `InvalidTokenException`. If
|
6288
|
+
# this happens, retrieve the firewall again to get a current copy of
|
6289
|
+
# it with a new token. Reapply your changes as needed, then try the
|
6290
|
+
# operation again using the new token.
|
6291
|
+
# @return [String]
|
6292
|
+
#
|
6293
|
+
# @!attribute [rw] firewall_arn
|
6294
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
6295
|
+
# @return [String]
|
6296
|
+
#
|
6297
|
+
# @!attribute [rw] firewall_name
|
6298
|
+
# The descriptive name of the firewall. You can't change the name of
|
6299
|
+
# a firewall after you create it.
|
6300
|
+
# @return [String]
|
6301
|
+
#
|
6302
|
+
# @!attribute [rw] availability_zone_change_protection
|
6303
|
+
# A setting indicating whether the firewall is protected against
|
6304
|
+
# changes to the subnet associations. Use this setting to protect
|
6305
|
+
# against accidentally modifying the subnet associations for a
|
6306
|
+
# firewall that is in use. When you create a firewall, the operation
|
6307
|
+
# initializes this setting to `TRUE`.
|
6308
|
+
# @return [Boolean]
|
6309
|
+
#
|
6310
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateAvailabilityZoneChangeProtectionResponse AWS API Documentation
|
6311
|
+
#
|
6312
|
+
class UpdateAvailabilityZoneChangeProtectionResponse < Struct.new(
|
6313
|
+
:update_token,
|
6314
|
+
:firewall_arn,
|
6315
|
+
:firewall_name,
|
6316
|
+
:availability_zone_change_protection)
|
6317
|
+
SENSITIVE = []
|
6318
|
+
include Aws::Structure
|
6319
|
+
end
|
6320
|
+
|
5662
6321
|
# @!attribute [rw] enabled_analysis_types
|
5663
6322
|
# An optional setting indicating the specific traffic analysis types
|
5664
6323
|
# to enable on the firewall.
|