aws-sdk-networkfirewall 1.67.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 +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-networkfirewall/client.rb +476 -4
- data/lib/aws-sdk-networkfirewall/client_api.rb +182 -0
- data/lib/aws-sdk-networkfirewall/types.rb +719 -25
- data/lib/aws-sdk-networkfirewall.rb +2 -2
- data/sig/client.rbs +104 -4
- data/sig/types.rbs +107 -1
- metadata +1 -1
@@ -476,6 +476,135 @@ module Aws::NetworkFirewall
|
|
476
476
|
|
477
477
|
# @!group API Operations
|
478
478
|
|
479
|
+
# Accepts a transit gateway attachment request for Network Firewall.
|
480
|
+
# When you accept the attachment request, Network Firewall creates the
|
481
|
+
# necessary routing components to enable traffic flow between the
|
482
|
+
# transit gateway and firewall endpoints.
|
483
|
+
#
|
484
|
+
# You must accept a transit gateway attachment to complete the creation
|
485
|
+
# of a transit gateway-attached firewall, unless auto-accept is enabled
|
486
|
+
# on the transit gateway. After acceptance, use DescribeFirewall to
|
487
|
+
# verify the firewall status.
|
488
|
+
#
|
489
|
+
# To reject an attachment instead of accepting it, use
|
490
|
+
# RejectNetworkFirewallTransitGatewayAttachment.
|
491
|
+
#
|
492
|
+
# <note markdown="1"> It can take several minutes for the attachment acceptance to complete
|
493
|
+
# and the firewall to become available.
|
494
|
+
#
|
495
|
+
# </note>
|
496
|
+
#
|
497
|
+
# @option params [required, String] :transit_gateway_attachment_id
|
498
|
+
# Required. The unique identifier of the transit gateway attachment to
|
499
|
+
# accept. This ID is returned in the response when creating a transit
|
500
|
+
# gateway-attached firewall.
|
501
|
+
#
|
502
|
+
# @return [Types::AcceptNetworkFirewallTransitGatewayAttachmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
503
|
+
#
|
504
|
+
# * {Types::AcceptNetworkFirewallTransitGatewayAttachmentResponse#transit_gateway_attachment_id #transit_gateway_attachment_id} => String
|
505
|
+
# * {Types::AcceptNetworkFirewallTransitGatewayAttachmentResponse#transit_gateway_attachment_status #transit_gateway_attachment_status} => String
|
506
|
+
#
|
507
|
+
# @example Request syntax with placeholder values
|
508
|
+
#
|
509
|
+
# resp = client.accept_network_firewall_transit_gateway_attachment({
|
510
|
+
# transit_gateway_attachment_id: "TransitGatewayAttachmentId", # required
|
511
|
+
# })
|
512
|
+
#
|
513
|
+
# @example Response structure
|
514
|
+
#
|
515
|
+
# resp.transit_gateway_attachment_id #=> String
|
516
|
+
# resp.transit_gateway_attachment_status #=> String, one of "CREATING", "DELETING", "DELETED", "FAILED", "ERROR", "READY", "PENDING_ACCEPTANCE", "REJECTING", "REJECTED"
|
517
|
+
#
|
518
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AcceptNetworkFirewallTransitGatewayAttachment AWS API Documentation
|
519
|
+
#
|
520
|
+
# @overload accept_network_firewall_transit_gateway_attachment(params = {})
|
521
|
+
# @param [Hash] params ({})
|
522
|
+
def accept_network_firewall_transit_gateway_attachment(params = {}, options = {})
|
523
|
+
req = build_request(:accept_network_firewall_transit_gateway_attachment, params)
|
524
|
+
req.send_request(options)
|
525
|
+
end
|
526
|
+
|
527
|
+
# Associates the specified Availability Zones with a transit
|
528
|
+
# gateway-attached firewall. For each Availability Zone, Network
|
529
|
+
# Firewall creates a firewall endpoint to process traffic. You can
|
530
|
+
# specify one or more Availability Zones where you want to deploy the
|
531
|
+
# firewall.
|
532
|
+
#
|
533
|
+
# After adding Availability Zones, you must update your transit gateway
|
534
|
+
# route tables to direct traffic through the new firewall endpoints. Use
|
535
|
+
# DescribeFirewall to monitor the status of the new endpoints.
|
536
|
+
#
|
537
|
+
# @option params [String] :update_token
|
538
|
+
# An optional token that you can use for optimistic locking. Network
|
539
|
+
# Firewall returns a token to your requests that access the firewall.
|
540
|
+
# The token marks the state of the firewall resource at the time of the
|
541
|
+
# request.
|
542
|
+
#
|
543
|
+
# To make an unconditional change to the firewall, omit the token in
|
544
|
+
# your update request. Without the token, Network Firewall performs your
|
545
|
+
# updates regardless of whether the firewall has changed since you last
|
546
|
+
# retrieved it.
|
547
|
+
#
|
548
|
+
# To make a conditional change to the firewall, provide the token in
|
549
|
+
# your update request. Network Firewall uses the token to ensure that
|
550
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
551
|
+
# changed, the operation fails with an `InvalidTokenException`. If this
|
552
|
+
# happens, retrieve the firewall again to get a current copy of it with
|
553
|
+
# a new token. Reapply your changes as needed, then try the operation
|
554
|
+
# again using the new token.
|
555
|
+
#
|
556
|
+
# @option params [String] :firewall_arn
|
557
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
558
|
+
#
|
559
|
+
# You must specify the ARN or the name, and you can specify both.
|
560
|
+
#
|
561
|
+
# @option params [String] :firewall_name
|
562
|
+
# The descriptive name of the firewall. You can't change the name of a
|
563
|
+
# firewall after you create it.
|
564
|
+
#
|
565
|
+
# You must specify the ARN or the name, and you can specify both.
|
566
|
+
#
|
567
|
+
# @option params [required, Array<Types::AvailabilityZoneMapping>] :availability_zone_mappings
|
568
|
+
# Required. The Availability Zones where you want to create firewall
|
569
|
+
# endpoints. You must specify at least one Availability Zone.
|
570
|
+
#
|
571
|
+
# @return [Types::AssociateAvailabilityZonesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
572
|
+
#
|
573
|
+
# * {Types::AssociateAvailabilityZonesResponse#firewall_arn #firewall_arn} => String
|
574
|
+
# * {Types::AssociateAvailabilityZonesResponse#firewall_name #firewall_name} => String
|
575
|
+
# * {Types::AssociateAvailabilityZonesResponse#availability_zone_mappings #availability_zone_mappings} => Array<Types::AvailabilityZoneMapping>
|
576
|
+
# * {Types::AssociateAvailabilityZonesResponse#update_token #update_token} => String
|
577
|
+
#
|
578
|
+
# @example Request syntax with placeholder values
|
579
|
+
#
|
580
|
+
# resp = client.associate_availability_zones({
|
581
|
+
# update_token: "UpdateToken",
|
582
|
+
# firewall_arn: "ResourceArn",
|
583
|
+
# firewall_name: "ResourceName",
|
584
|
+
# availability_zone_mappings: [ # required
|
585
|
+
# {
|
586
|
+
# availability_zone: "AvailabilityZoneMappingString", # required
|
587
|
+
# },
|
588
|
+
# ],
|
589
|
+
# })
|
590
|
+
#
|
591
|
+
# @example Response structure
|
592
|
+
#
|
593
|
+
# resp.firewall_arn #=> String
|
594
|
+
# resp.firewall_name #=> String
|
595
|
+
# resp.availability_zone_mappings #=> Array
|
596
|
+
# resp.availability_zone_mappings[0].availability_zone #=> String
|
597
|
+
# resp.update_token #=> String
|
598
|
+
#
|
599
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/AssociateAvailabilityZones AWS API Documentation
|
600
|
+
#
|
601
|
+
# @overload associate_availability_zones(params = {})
|
602
|
+
# @param [Hash] params ({})
|
603
|
+
def associate_availability_zones(params = {}, options = {})
|
604
|
+
req = build_request(:associate_availability_zones, params)
|
605
|
+
req.send_request(options)
|
606
|
+
end
|
607
|
+
|
479
608
|
# Associates a FirewallPolicy to a Firewall.
|
480
609
|
#
|
481
610
|
# A firewall policy defines how to monitor and manage your VPC network
|
@@ -711,6 +840,46 @@ module Aws::NetworkFirewall
|
|
711
840
|
# An optional setting indicating the specific traffic analysis types to
|
712
841
|
# enable on the firewall.
|
713
842
|
#
|
843
|
+
# @option params [String] :transit_gateway_id
|
844
|
+
# Required when creating a transit gateway-attached firewall. The unique
|
845
|
+
# identifier of the transit gateway to attach to this firewall. You can
|
846
|
+
# provide either a transit gateway from your account or one that has
|
847
|
+
# been shared with you through Resource Access Manager.
|
848
|
+
#
|
849
|
+
# After creating the firewall, you cannot change the transit gateway
|
850
|
+
# association. To use a different transit gateway, you must create a new
|
851
|
+
# firewall.
|
852
|
+
#
|
853
|
+
# For information about creating firewalls, see CreateFirewall. For
|
854
|
+
# specific guidance about transit gateway-attached firewalls, see
|
855
|
+
# [Considerations for transit gateway-attached firewalls][1] in the
|
856
|
+
# *Network Firewall Developer Guide*.
|
857
|
+
#
|
858
|
+
#
|
859
|
+
#
|
860
|
+
# [1]: https://docs.aws.amazon.com/network-firewall/latest/developerguide/tgw-firewall-considerations.html
|
861
|
+
#
|
862
|
+
# @option params [Array<Types::AvailabilityZoneMapping>] :availability_zone_mappings
|
863
|
+
# Required. The Availability Zones where you want to create firewall
|
864
|
+
# endpoints for a transit gateway-attached firewall. You must specify at
|
865
|
+
# least one Availability Zone. Consider enabling the firewall in every
|
866
|
+
# Availability Zone where you have workloads to maintain Availability
|
867
|
+
# Zone independence.
|
868
|
+
#
|
869
|
+
# You can modify Availability Zones later using
|
870
|
+
# AssociateAvailabilityZones or DisassociateAvailabilityZones, but this
|
871
|
+
# may briefly disrupt traffic. The `AvailabilityZoneChangeProtection`
|
872
|
+
# setting controls whether you can make these modifications.
|
873
|
+
#
|
874
|
+
# @option params [Boolean] :availability_zone_change_protection
|
875
|
+
# Optional. A setting indicating whether the firewall is protected
|
876
|
+
# against changes to its Availability Zone configuration. When set to
|
877
|
+
# `TRUE`, you cannot add or remove Availability Zones without first
|
878
|
+
# disabling this protection using
|
879
|
+
# UpdateAvailabilityZoneChangeProtection.
|
880
|
+
#
|
881
|
+
# Default value: `FALSE`
|
882
|
+
#
|
714
883
|
# @return [Types::CreateFirewallResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
715
884
|
#
|
716
885
|
# * {Types::CreateFirewallResponse#firewall #firewall} => Types::Firewall
|
@@ -743,6 +912,13 @@ module Aws::NetworkFirewall
|
|
743
912
|
# type: "CUSTOMER_KMS", # required, accepts CUSTOMER_KMS, AWS_OWNED_KMS_KEY
|
744
913
|
# },
|
745
914
|
# enabled_analysis_types: ["TLS_SNI"], # accepts TLS_SNI, HTTP_HOST
|
915
|
+
# transit_gateway_id: "TransitGatewayId",
|
916
|
+
# availability_zone_mappings: [
|
917
|
+
# {
|
918
|
+
# availability_zone: "AvailabilityZoneMappingString", # required
|
919
|
+
# },
|
920
|
+
# ],
|
921
|
+
# availability_zone_change_protection: false,
|
746
922
|
# })
|
747
923
|
#
|
748
924
|
# @example Response structure
|
@@ -767,6 +943,11 @@ module Aws::NetworkFirewall
|
|
767
943
|
# resp.firewall.number_of_associations #=> Integer
|
768
944
|
# resp.firewall.enabled_analysis_types #=> Array
|
769
945
|
# resp.firewall.enabled_analysis_types[0] #=> String, one of "TLS_SNI", "HTTP_HOST"
|
946
|
+
# resp.firewall.transit_gateway_id #=> String
|
947
|
+
# resp.firewall.transit_gateway_owner_account_id #=> String
|
948
|
+
# resp.firewall.availability_zone_mappings #=> Array
|
949
|
+
# resp.firewall.availability_zone_mappings[0].availability_zone #=> String
|
950
|
+
# resp.firewall.availability_zone_change_protection #=> Boolean
|
770
951
|
# resp.firewall_status.status #=> String, one of "PROVISIONING", "DELETING", "READY"
|
771
952
|
# resp.firewall_status.configuration_sync_state_summary #=> String, one of "PENDING", "IN_SYNC", "CAPACITY_CONSTRAINED"
|
772
953
|
# resp.firewall_status.sync_states #=> Hash
|
@@ -781,6 +962,9 @@ module Aws::NetworkFirewall
|
|
781
962
|
# resp.firewall_status.capacity_usage_summary.cid_rs.utilized_cidr_count #=> Integer
|
782
963
|
# resp.firewall_status.capacity_usage_summary.cid_rs.ip_set_references #=> Hash
|
783
964
|
# resp.firewall_status.capacity_usage_summary.cid_rs.ip_set_references["IPSetArn"].resolved_cidr_count #=> Integer
|
965
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.attachment_id #=> String
|
966
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.transit_gateway_attachment_status #=> String, one of "CREATING", "DELETING", "DELETED", "FAILED", "ERROR", "READY", "PENDING_ACCEPTANCE", "REJECTING", "REJECTED"
|
967
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.status_message #=> String
|
784
968
|
#
|
785
969
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/CreateFirewall AWS API Documentation
|
786
970
|
#
|
@@ -1094,7 +1278,7 @@ module Aws::NetworkFirewall
|
|
1094
1278
|
# {
|
1095
1279
|
# action: "PASS", # required, accepts PASS, DROP, ALERT, REJECT
|
1096
1280
|
# header: { # required
|
1097
|
-
# protocol: "IP", # required, accepts IP, TCP, UDP, ICMP, HTTP, FTP, TLS, SMB, DNS, DCERPC, SSH, SMTP, IMAP, MSN, KRB5, IKEV2, TFTP, NTP, DHCP
|
1281
|
+
# protocol: "IP", # required, accepts IP, TCP, UDP, ICMP, HTTP, FTP, TLS, SMB, DNS, DCERPC, SSH, SMTP, IMAP, MSN, KRB5, IKEV2, TFTP, NTP, DHCP, HTTP2, QUIC
|
1098
1282
|
# source: "Source", # required
|
1099
1283
|
# source_port: "Port", # required
|
1100
1284
|
# direction: "FORWARD", # required, accepts FORWARD, ANY
|
@@ -1544,6 +1728,11 @@ module Aws::NetworkFirewall
|
|
1544
1728
|
# resp.firewall.number_of_associations #=> Integer
|
1545
1729
|
# resp.firewall.enabled_analysis_types #=> Array
|
1546
1730
|
# resp.firewall.enabled_analysis_types[0] #=> String, one of "TLS_SNI", "HTTP_HOST"
|
1731
|
+
# resp.firewall.transit_gateway_id #=> String
|
1732
|
+
# resp.firewall.transit_gateway_owner_account_id #=> String
|
1733
|
+
# resp.firewall.availability_zone_mappings #=> Array
|
1734
|
+
# resp.firewall.availability_zone_mappings[0].availability_zone #=> String
|
1735
|
+
# resp.firewall.availability_zone_change_protection #=> Boolean
|
1547
1736
|
# resp.firewall_status.status #=> String, one of "PROVISIONING", "DELETING", "READY"
|
1548
1737
|
# resp.firewall_status.configuration_sync_state_summary #=> String, one of "PENDING", "IN_SYNC", "CAPACITY_CONSTRAINED"
|
1549
1738
|
# resp.firewall_status.sync_states #=> Hash
|
@@ -1558,6 +1747,9 @@ module Aws::NetworkFirewall
|
|
1558
1747
|
# resp.firewall_status.capacity_usage_summary.cid_rs.utilized_cidr_count #=> Integer
|
1559
1748
|
# resp.firewall_status.capacity_usage_summary.cid_rs.ip_set_references #=> Hash
|
1560
1749
|
# resp.firewall_status.capacity_usage_summary.cid_rs.ip_set_references["IPSetArn"].resolved_cidr_count #=> Integer
|
1750
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.attachment_id #=> String
|
1751
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.transit_gateway_attachment_status #=> String, one of "CREATING", "DELETING", "DELETED", "FAILED", "ERROR", "READY", "PENDING_ACCEPTANCE", "REJECTING", "REJECTED"
|
1752
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.status_message #=> String
|
1561
1753
|
#
|
1562
1754
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DeleteFirewall AWS API Documentation
|
1563
1755
|
#
|
@@ -1618,6 +1810,45 @@ module Aws::NetworkFirewall
|
|
1618
1810
|
req.send_request(options)
|
1619
1811
|
end
|
1620
1812
|
|
1813
|
+
# Deletes a transit gateway attachment from a Network Firewall. Either
|
1814
|
+
# the firewall owner or the transit gateway owner can delete the
|
1815
|
+
# attachment.
|
1816
|
+
#
|
1817
|
+
# After you delete a transit gateway attachment, traffic will no longer
|
1818
|
+
# flow through the firewall endpoints.
|
1819
|
+
#
|
1820
|
+
# After you initiate the delete operation, use DescribeFirewall to
|
1821
|
+
# monitor the deletion status.
|
1822
|
+
#
|
1823
|
+
# @option params [required, String] :transit_gateway_attachment_id
|
1824
|
+
# Required. The unique identifier of the transit gateway attachment to
|
1825
|
+
# delete.
|
1826
|
+
#
|
1827
|
+
# @return [Types::DeleteNetworkFirewallTransitGatewayAttachmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1828
|
+
#
|
1829
|
+
# * {Types::DeleteNetworkFirewallTransitGatewayAttachmentResponse#transit_gateway_attachment_id #transit_gateway_attachment_id} => String
|
1830
|
+
# * {Types::DeleteNetworkFirewallTransitGatewayAttachmentResponse#transit_gateway_attachment_status #transit_gateway_attachment_status} => String
|
1831
|
+
#
|
1832
|
+
# @example Request syntax with placeholder values
|
1833
|
+
#
|
1834
|
+
# resp = client.delete_network_firewall_transit_gateway_attachment({
|
1835
|
+
# transit_gateway_attachment_id: "TransitGatewayAttachmentId", # required
|
1836
|
+
# })
|
1837
|
+
#
|
1838
|
+
# @example Response structure
|
1839
|
+
#
|
1840
|
+
# resp.transit_gateway_attachment_id #=> String
|
1841
|
+
# resp.transit_gateway_attachment_status #=> String, one of "CREATING", "DELETING", "DELETED", "FAILED", "ERROR", "READY", "PENDING_ACCEPTANCE", "REJECTING", "REJECTED"
|
1842
|
+
#
|
1843
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DeleteNetworkFirewallTransitGatewayAttachment AWS API Documentation
|
1844
|
+
#
|
1845
|
+
# @overload delete_network_firewall_transit_gateway_attachment(params = {})
|
1846
|
+
# @param [Hash] params ({})
|
1847
|
+
def delete_network_firewall_transit_gateway_attachment(params = {}, options = {})
|
1848
|
+
req = build_request(:delete_network_firewall_transit_gateway_attachment, params)
|
1849
|
+
req.send_request(options)
|
1850
|
+
end
|
1851
|
+
|
1621
1852
|
# Deletes a resource policy that you created in a PutResourcePolicy
|
1622
1853
|
# request.
|
1623
1854
|
#
|
@@ -1871,6 +2102,11 @@ module Aws::NetworkFirewall
|
|
1871
2102
|
# resp.firewall.number_of_associations #=> Integer
|
1872
2103
|
# resp.firewall.enabled_analysis_types #=> Array
|
1873
2104
|
# resp.firewall.enabled_analysis_types[0] #=> String, one of "TLS_SNI", "HTTP_HOST"
|
2105
|
+
# resp.firewall.transit_gateway_id #=> String
|
2106
|
+
# resp.firewall.transit_gateway_owner_account_id #=> String
|
2107
|
+
# resp.firewall.availability_zone_mappings #=> Array
|
2108
|
+
# resp.firewall.availability_zone_mappings[0].availability_zone #=> String
|
2109
|
+
# resp.firewall.availability_zone_change_protection #=> Boolean
|
1874
2110
|
# resp.firewall_status.status #=> String, one of "PROVISIONING", "DELETING", "READY"
|
1875
2111
|
# resp.firewall_status.configuration_sync_state_summary #=> String, one of "PENDING", "IN_SYNC", "CAPACITY_CONSTRAINED"
|
1876
2112
|
# resp.firewall_status.sync_states #=> Hash
|
@@ -1885,6 +2121,9 @@ module Aws::NetworkFirewall
|
|
1885
2121
|
# resp.firewall_status.capacity_usage_summary.cid_rs.utilized_cidr_count #=> Integer
|
1886
2122
|
# resp.firewall_status.capacity_usage_summary.cid_rs.ip_set_references #=> Hash
|
1887
2123
|
# resp.firewall_status.capacity_usage_summary.cid_rs.ip_set_references["IPSetArn"].resolved_cidr_count #=> Integer
|
2124
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.attachment_id #=> String
|
2125
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.transit_gateway_attachment_status #=> String, one of "CREATING", "DELETING", "DELETED", "FAILED", "ERROR", "READY", "PENDING_ACCEPTANCE", "REJECTING", "REJECTED"
|
2126
|
+
# resp.firewall_status.transit_gateway_attachment_sync_state.status_message #=> String
|
1888
2127
|
#
|
1889
2128
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeFirewall AWS API Documentation
|
1890
2129
|
#
|
@@ -1908,6 +2147,7 @@ module Aws::NetworkFirewall
|
|
1908
2147
|
# * {Types::DescribeFirewallMetadataResponse#description #description} => String
|
1909
2148
|
# * {Types::DescribeFirewallMetadataResponse#status #status} => String
|
1910
2149
|
# * {Types::DescribeFirewallMetadataResponse#supported_availability_zones #supported_availability_zones} => Hash<String,Types::AvailabilityZoneMetadata>
|
2150
|
+
# * {Types::DescribeFirewallMetadataResponse#transit_gateway_attachment_id #transit_gateway_attachment_id} => String
|
1911
2151
|
#
|
1912
2152
|
# @example Request syntax with placeholder values
|
1913
2153
|
#
|
@@ -1923,6 +2163,7 @@ module Aws::NetworkFirewall
|
|
1923
2163
|
# resp.status #=> String, one of "PROVISIONING", "DELETING", "READY"
|
1924
2164
|
# resp.supported_availability_zones #=> Hash
|
1925
2165
|
# resp.supported_availability_zones["AvailabilityZone"].ip_address_type #=> String, one of "DUALSTACK", "IPV4", "IPV6"
|
2166
|
+
# resp.transit_gateway_attachment_id #=> String
|
1926
2167
|
#
|
1927
2168
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeFirewallMetadata AWS API Documentation
|
1928
2169
|
#
|
@@ -2103,6 +2344,7 @@ module Aws::NetworkFirewall
|
|
2103
2344
|
#
|
2104
2345
|
# * {Types::DescribeLoggingConfigurationResponse#firewall_arn #firewall_arn} => String
|
2105
2346
|
# * {Types::DescribeLoggingConfigurationResponse#logging_configuration #logging_configuration} => Types::LoggingConfiguration
|
2347
|
+
# * {Types::DescribeLoggingConfigurationResponse#enable_monitoring_dashboard #enable_monitoring_dashboard} => Boolean
|
2106
2348
|
#
|
2107
2349
|
# @example Request syntax with placeholder values
|
2108
2350
|
#
|
@@ -2119,6 +2361,7 @@ module Aws::NetworkFirewall
|
|
2119
2361
|
# resp.logging_configuration.log_destination_configs[0].log_destination_type #=> String, one of "S3", "CloudWatchLogs", "KinesisDataFirehose"
|
2120
2362
|
# resp.logging_configuration.log_destination_configs[0].log_destination #=> Hash
|
2121
2363
|
# resp.logging_configuration.log_destination_configs[0].log_destination["HashMapKey"] #=> String
|
2364
|
+
# resp.enable_monitoring_dashboard #=> Boolean
|
2122
2365
|
#
|
2123
2366
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DescribeLoggingConfiguration AWS API Documentation
|
2124
2367
|
#
|
@@ -2221,7 +2464,7 @@ module Aws::NetworkFirewall
|
|
2221
2464
|
# resp.rule_group.rules_source.rules_source_list.generated_rules_type #=> String, one of "ALLOWLIST", "DENYLIST"
|
2222
2465
|
# resp.rule_group.rules_source.stateful_rules #=> Array
|
2223
2466
|
# resp.rule_group.rules_source.stateful_rules[0].action #=> String, one of "PASS", "DROP", "ALERT", "REJECT"
|
2224
|
-
# resp.rule_group.rules_source.stateful_rules[0].header.protocol #=> String, one of "IP", "TCP", "UDP", "ICMP", "HTTP", "FTP", "TLS", "SMB", "DNS", "DCERPC", "SSH", "SMTP", "IMAP", "MSN", "KRB5", "IKEV2", "TFTP", "NTP", "DHCP"
|
2467
|
+
# resp.rule_group.rules_source.stateful_rules[0].header.protocol #=> String, one of "IP", "TCP", "UDP", "ICMP", "HTTP", "FTP", "TLS", "SMB", "DNS", "DCERPC", "SSH", "SMTP", "IMAP", "MSN", "KRB5", "IKEV2", "TFTP", "NTP", "DHCP", "HTTP2", "QUIC"
|
2225
2468
|
# resp.rule_group.rules_source.stateful_rules[0].header.source #=> String
|
2226
2469
|
# resp.rule_group.rules_source.stateful_rules[0].header.source_port #=> String
|
2227
2470
|
# resp.rule_group.rules_source.stateful_rules[0].header.direction #=> String, one of "FORWARD", "ANY"
|
@@ -2478,6 +2721,91 @@ module Aws::NetworkFirewall
|
|
2478
2721
|
req.send_request(options)
|
2479
2722
|
end
|
2480
2723
|
|
2724
|
+
# Removes the specified Availability Zone associations from a transit
|
2725
|
+
# gateway-attached firewall. This removes the firewall endpoints from
|
2726
|
+
# these Availability Zones and stops traffic filtering in those zones.
|
2727
|
+
# Before removing an Availability Zone, ensure you've updated your
|
2728
|
+
# transit gateway route tables to redirect traffic appropriately.
|
2729
|
+
#
|
2730
|
+
# <note markdown="1"> If `AvailabilityZoneChangeProtection` is enabled, you must first
|
2731
|
+
# disable it using UpdateAvailabilityZoneChangeProtection.
|
2732
|
+
#
|
2733
|
+
# </note>
|
2734
|
+
#
|
2735
|
+
# To verify the status of your Availability Zone changes, use
|
2736
|
+
# DescribeFirewall.
|
2737
|
+
#
|
2738
|
+
# @option params [String] :update_token
|
2739
|
+
# An optional token that you can use for optimistic locking. Network
|
2740
|
+
# Firewall returns a token to your requests that access the firewall.
|
2741
|
+
# The token marks the state of the firewall resource at the time of the
|
2742
|
+
# request.
|
2743
|
+
#
|
2744
|
+
# To make an unconditional change to the firewall, omit the token in
|
2745
|
+
# your update request. Without the token, Network Firewall performs your
|
2746
|
+
# updates regardless of whether the firewall has changed since you last
|
2747
|
+
# retrieved it.
|
2748
|
+
#
|
2749
|
+
# To make a conditional change to the firewall, provide the token in
|
2750
|
+
# your update request. Network Firewall uses the token to ensure that
|
2751
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
2752
|
+
# changed, the operation fails with an `InvalidTokenException`. If this
|
2753
|
+
# happens, retrieve the firewall again to get a current copy of it with
|
2754
|
+
# a new token. Reapply your changes as needed, then try the operation
|
2755
|
+
# again using the new token.
|
2756
|
+
#
|
2757
|
+
# @option params [String] :firewall_arn
|
2758
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
2759
|
+
#
|
2760
|
+
# You must specify the ARN or the name, and you can specify both.
|
2761
|
+
#
|
2762
|
+
# @option params [String] :firewall_name
|
2763
|
+
# The descriptive name of the firewall. You can't change the name of a
|
2764
|
+
# firewall after you create it.
|
2765
|
+
#
|
2766
|
+
# You must specify the ARN or the name, and you can specify both.
|
2767
|
+
#
|
2768
|
+
# @option params [required, Array<Types::AvailabilityZoneMapping>] :availability_zone_mappings
|
2769
|
+
# Required. The Availability Zones to remove from the firewall's
|
2770
|
+
# configuration.
|
2771
|
+
#
|
2772
|
+
# @return [Types::DisassociateAvailabilityZonesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2773
|
+
#
|
2774
|
+
# * {Types::DisassociateAvailabilityZonesResponse#firewall_arn #firewall_arn} => String
|
2775
|
+
# * {Types::DisassociateAvailabilityZonesResponse#firewall_name #firewall_name} => String
|
2776
|
+
# * {Types::DisassociateAvailabilityZonesResponse#availability_zone_mappings #availability_zone_mappings} => Array<Types::AvailabilityZoneMapping>
|
2777
|
+
# * {Types::DisassociateAvailabilityZonesResponse#update_token #update_token} => String
|
2778
|
+
#
|
2779
|
+
# @example Request syntax with placeholder values
|
2780
|
+
#
|
2781
|
+
# resp = client.disassociate_availability_zones({
|
2782
|
+
# update_token: "UpdateToken",
|
2783
|
+
# firewall_arn: "ResourceArn",
|
2784
|
+
# firewall_name: "ResourceName",
|
2785
|
+
# availability_zone_mappings: [ # required
|
2786
|
+
# {
|
2787
|
+
# availability_zone: "AvailabilityZoneMappingString", # required
|
2788
|
+
# },
|
2789
|
+
# ],
|
2790
|
+
# })
|
2791
|
+
#
|
2792
|
+
# @example Response structure
|
2793
|
+
#
|
2794
|
+
# resp.firewall_arn #=> String
|
2795
|
+
# resp.firewall_name #=> String
|
2796
|
+
# resp.availability_zone_mappings #=> Array
|
2797
|
+
# resp.availability_zone_mappings[0].availability_zone #=> String
|
2798
|
+
# resp.update_token #=> String
|
2799
|
+
#
|
2800
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/DisassociateAvailabilityZones AWS API Documentation
|
2801
|
+
#
|
2802
|
+
# @overload disassociate_availability_zones(params = {})
|
2803
|
+
# @param [Hash] params ({})
|
2804
|
+
def disassociate_availability_zones(params = {}, options = {})
|
2805
|
+
req = build_request(:disassociate_availability_zones, params)
|
2806
|
+
req.send_request(options)
|
2807
|
+
end
|
2808
|
+
|
2481
2809
|
# Removes the specified subnet associations from the firewall. This
|
2482
2810
|
# removes the firewall endpoints from the subnets and removes any
|
2483
2811
|
# network filtering protections that the endpoints were providing.
|
@@ -2783,6 +3111,7 @@ module Aws::NetworkFirewall
|
|
2783
3111
|
# resp.firewalls #=> Array
|
2784
3112
|
# resp.firewalls[0].firewall_name #=> String
|
2785
3113
|
# resp.firewalls[0].firewall_arn #=> String
|
3114
|
+
# resp.firewalls[0].transit_gateway_attachment_id #=> String
|
2786
3115
|
#
|
2787
3116
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/ListFirewalls AWS API Documentation
|
2788
3117
|
#
|
@@ -3296,6 +3625,54 @@ module Aws::NetworkFirewall
|
|
3296
3625
|
req.send_request(options)
|
3297
3626
|
end
|
3298
3627
|
|
3628
|
+
# Rejects a transit gateway attachment request for Network Firewall.
|
3629
|
+
# When you reject the attachment request, Network Firewall cancels the
|
3630
|
+
# creation of routing components between the transit gateway and
|
3631
|
+
# firewall endpoints.
|
3632
|
+
#
|
3633
|
+
# Only the transit gateway owner can reject the attachment. After
|
3634
|
+
# rejection, no traffic will flow through the firewall endpoints for
|
3635
|
+
# this attachment.
|
3636
|
+
#
|
3637
|
+
# Use DescribeFirewall to monitor the rejection status. To accept the
|
3638
|
+
# attachment instead of rejecting it, use
|
3639
|
+
# AcceptNetworkFirewallTransitGatewayAttachment.
|
3640
|
+
#
|
3641
|
+
# <note markdown="1"> Once rejected, you cannot reverse this action. To establish
|
3642
|
+
# connectivity, you must create a new transit gateway-attached firewall.
|
3643
|
+
#
|
3644
|
+
# </note>
|
3645
|
+
#
|
3646
|
+
# @option params [required, String] :transit_gateway_attachment_id
|
3647
|
+
# Required. The unique identifier of the transit gateway attachment to
|
3648
|
+
# reject. This ID is returned in the response when creating a transit
|
3649
|
+
# gateway-attached firewall.
|
3650
|
+
#
|
3651
|
+
# @return [Types::RejectNetworkFirewallTransitGatewayAttachmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3652
|
+
#
|
3653
|
+
# * {Types::RejectNetworkFirewallTransitGatewayAttachmentResponse#transit_gateway_attachment_id #transit_gateway_attachment_id} => String
|
3654
|
+
# * {Types::RejectNetworkFirewallTransitGatewayAttachmentResponse#transit_gateway_attachment_status #transit_gateway_attachment_status} => String
|
3655
|
+
#
|
3656
|
+
# @example Request syntax with placeholder values
|
3657
|
+
#
|
3658
|
+
# resp = client.reject_network_firewall_transit_gateway_attachment({
|
3659
|
+
# transit_gateway_attachment_id: "TransitGatewayAttachmentId", # required
|
3660
|
+
# })
|
3661
|
+
#
|
3662
|
+
# @example Response structure
|
3663
|
+
#
|
3664
|
+
# resp.transit_gateway_attachment_id #=> String
|
3665
|
+
# resp.transit_gateway_attachment_status #=> String, one of "CREATING", "DELETING", "DELETED", "FAILED", "ERROR", "READY", "PENDING_ACCEPTANCE", "REJECTING", "REJECTED"
|
3666
|
+
#
|
3667
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/RejectNetworkFirewallTransitGatewayAttachment AWS API Documentation
|
3668
|
+
#
|
3669
|
+
# @overload reject_network_firewall_transit_gateway_attachment(params = {})
|
3670
|
+
# @param [Hash] params ({})
|
3671
|
+
def reject_network_firewall_transit_gateway_attachment(params = {}, options = {})
|
3672
|
+
req = build_request(:reject_network_firewall_transit_gateway_attachment, params)
|
3673
|
+
req.send_request(options)
|
3674
|
+
end
|
3675
|
+
|
3299
3676
|
# Generates a traffic analysis report for the timeframe and traffic type
|
3300
3677
|
# you specify.
|
3301
3678
|
#
|
@@ -3586,6 +3963,85 @@ module Aws::NetworkFirewall
|
|
3586
3963
|
req.send_request(options)
|
3587
3964
|
end
|
3588
3965
|
|
3966
|
+
# Modifies the `AvailabilityZoneChangeProtection` setting for a transit
|
3967
|
+
# gateway-attached firewall. When enabled, this setting prevents
|
3968
|
+
# accidental changes to the firewall's Availability Zone configuration.
|
3969
|
+
# This helps protect against disrupting traffic flow in production
|
3970
|
+
# environments.
|
3971
|
+
#
|
3972
|
+
# When enabled, you must disable this protection before using
|
3973
|
+
# AssociateAvailabilityZones or DisassociateAvailabilityZones to modify
|
3974
|
+
# the firewall's Availability Zone configuration.
|
3975
|
+
#
|
3976
|
+
# @option params [String] :update_token
|
3977
|
+
# An optional token that you can use for optimistic locking. Network
|
3978
|
+
# Firewall returns a token to your requests that access the firewall.
|
3979
|
+
# The token marks the state of the firewall resource at the time of the
|
3980
|
+
# request.
|
3981
|
+
#
|
3982
|
+
# To make an unconditional change to the firewall, omit the token in
|
3983
|
+
# your update request. Without the token, Network Firewall performs your
|
3984
|
+
# updates regardless of whether the firewall has changed since you last
|
3985
|
+
# retrieved it.
|
3986
|
+
#
|
3987
|
+
# To make a conditional change to the firewall, provide the token in
|
3988
|
+
# your update request. Network Firewall uses the token to ensure that
|
3989
|
+
# the firewall hasn't changed since you last retrieved it. If it has
|
3990
|
+
# changed, the operation fails with an `InvalidTokenException`. If this
|
3991
|
+
# happens, retrieve the firewall again to get a current copy of it with
|
3992
|
+
# a new token. Reapply your changes as needed, then try the operation
|
3993
|
+
# again using the new token.
|
3994
|
+
#
|
3995
|
+
# @option params [String] :firewall_arn
|
3996
|
+
# The Amazon Resource Name (ARN) of the firewall.
|
3997
|
+
#
|
3998
|
+
# You must specify the ARN or the name, and you can specify both.
|
3999
|
+
#
|
4000
|
+
# @option params [String] :firewall_name
|
4001
|
+
# The descriptive name of the firewall. You can't change the name of a
|
4002
|
+
# firewall after you create it.
|
4003
|
+
#
|
4004
|
+
# You must specify the ARN or the name, and you can specify both.
|
4005
|
+
#
|
4006
|
+
# @option params [required, Boolean] :availability_zone_change_protection
|
4007
|
+
# A setting indicating whether the firewall is protected against changes
|
4008
|
+
# to the subnet associations. Use this setting to protect against
|
4009
|
+
# accidentally modifying the subnet associations for a firewall that is
|
4010
|
+
# in use. When you create a firewall, the operation initializes this
|
4011
|
+
# setting to `TRUE`.
|
4012
|
+
#
|
4013
|
+
# @return [Types::UpdateAvailabilityZoneChangeProtectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4014
|
+
#
|
4015
|
+
# * {Types::UpdateAvailabilityZoneChangeProtectionResponse#update_token #update_token} => String
|
4016
|
+
# * {Types::UpdateAvailabilityZoneChangeProtectionResponse#firewall_arn #firewall_arn} => String
|
4017
|
+
# * {Types::UpdateAvailabilityZoneChangeProtectionResponse#firewall_name #firewall_name} => String
|
4018
|
+
# * {Types::UpdateAvailabilityZoneChangeProtectionResponse#availability_zone_change_protection #availability_zone_change_protection} => Boolean
|
4019
|
+
#
|
4020
|
+
# @example Request syntax with placeholder values
|
4021
|
+
#
|
4022
|
+
# resp = client.update_availability_zone_change_protection({
|
4023
|
+
# update_token: "UpdateToken",
|
4024
|
+
# firewall_arn: "ResourceArn",
|
4025
|
+
# firewall_name: "ResourceName",
|
4026
|
+
# availability_zone_change_protection: false, # required
|
4027
|
+
# })
|
4028
|
+
#
|
4029
|
+
# @example Response structure
|
4030
|
+
#
|
4031
|
+
# resp.update_token #=> String
|
4032
|
+
# resp.firewall_arn #=> String
|
4033
|
+
# resp.firewall_name #=> String
|
4034
|
+
# resp.availability_zone_change_protection #=> Boolean
|
4035
|
+
#
|
4036
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateAvailabilityZoneChangeProtection AWS API Documentation
|
4037
|
+
#
|
4038
|
+
# @overload update_availability_zone_change_protection(params = {})
|
4039
|
+
# @param [Hash] params ({})
|
4040
|
+
def update_availability_zone_change_protection(params = {}, options = {})
|
4041
|
+
req = build_request(:update_availability_zone_change_protection, params)
|
4042
|
+
req.send_request(options)
|
4043
|
+
end
|
4044
|
+
|
3589
4045
|
# Enables specific types of firewall analysis on a specific firewall you
|
3590
4046
|
# define.
|
3591
4047
|
#
|
@@ -4143,11 +4599,25 @@ module Aws::NetworkFirewall
|
|
4143
4599
|
# Defines how Network Firewall performs logging for a firewall. If you
|
4144
4600
|
# omit this setting, Network Firewall disables logging for the firewall.
|
4145
4601
|
#
|
4602
|
+
# @option params [Boolean] :enable_monitoring_dashboard
|
4603
|
+
# A boolean that lets you enable or disable the detailed firewall
|
4604
|
+
# monitoring dashboard on the firewall.
|
4605
|
+
#
|
4606
|
+
# The monitoring dashboard provides comprehensive visibility into your
|
4607
|
+
# firewall's flow logs and alert logs. After you enable detailed
|
4608
|
+
# monitoring, you can access these dashboards directly from the
|
4609
|
+
# **Monitoring** page of the Network Firewall console.
|
4610
|
+
#
|
4611
|
+
# Specify `TRUE` to enable the the detailed monitoring dashboard on the
|
4612
|
+
# firewall. Specify `FALSE` to disable the the detailed monitoring
|
4613
|
+
# dashboard on the firewall.
|
4614
|
+
#
|
4146
4615
|
# @return [Types::UpdateLoggingConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4147
4616
|
#
|
4148
4617
|
# * {Types::UpdateLoggingConfigurationResponse#firewall_arn #firewall_arn} => String
|
4149
4618
|
# * {Types::UpdateLoggingConfigurationResponse#firewall_name #firewall_name} => String
|
4150
4619
|
# * {Types::UpdateLoggingConfigurationResponse#logging_configuration #logging_configuration} => Types::LoggingConfiguration
|
4620
|
+
# * {Types::UpdateLoggingConfigurationResponse#enable_monitoring_dashboard #enable_monitoring_dashboard} => Boolean
|
4151
4621
|
#
|
4152
4622
|
# @example Request syntax with placeholder values
|
4153
4623
|
#
|
@@ -4165,6 +4635,7 @@ module Aws::NetworkFirewall
|
|
4165
4635
|
# },
|
4166
4636
|
# ],
|
4167
4637
|
# },
|
4638
|
+
# enable_monitoring_dashboard: false,
|
4168
4639
|
# })
|
4169
4640
|
#
|
4170
4641
|
# @example Response structure
|
@@ -4176,6 +4647,7 @@ module Aws::NetworkFirewall
|
|
4176
4647
|
# resp.logging_configuration.log_destination_configs[0].log_destination_type #=> String, one of "S3", "CloudWatchLogs", "KinesisDataFirehose"
|
4177
4648
|
# resp.logging_configuration.log_destination_configs[0].log_destination #=> Hash
|
4178
4649
|
# resp.logging_configuration.log_destination_configs[0].log_destination["HashMapKey"] #=> String
|
4650
|
+
# resp.enable_monitoring_dashboard #=> Boolean
|
4179
4651
|
#
|
4180
4652
|
# @see http://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12/UpdateLoggingConfiguration AWS API Documentation
|
4181
4653
|
#
|
@@ -4327,7 +4799,7 @@ module Aws::NetworkFirewall
|
|
4327
4799
|
# {
|
4328
4800
|
# action: "PASS", # required, accepts PASS, DROP, ALERT, REJECT
|
4329
4801
|
# header: { # required
|
4330
|
-
# protocol: "IP", # required, accepts IP, TCP, UDP, ICMP, HTTP, FTP, TLS, SMB, DNS, DCERPC, SSH, SMTP, IMAP, MSN, KRB5, IKEV2, TFTP, NTP, DHCP
|
4802
|
+
# protocol: "IP", # required, accepts IP, TCP, UDP, ICMP, HTTP, FTP, TLS, SMB, DNS, DCERPC, SSH, SMTP, IMAP, MSN, KRB5, IKEV2, TFTP, NTP, DHCP, HTTP2, QUIC
|
4331
4803
|
# source: "Source", # required
|
4332
4804
|
# source_port: "Port", # required
|
4333
4805
|
# direction: "FORWARD", # required, accepts FORWARD, ANY
|
@@ -4699,7 +5171,7 @@ module Aws::NetworkFirewall
|
|
4699
5171
|
tracer: tracer
|
4700
5172
|
)
|
4701
5173
|
context[:gem_name] = 'aws-sdk-networkfirewall'
|
4702
|
-
context[:gem_version] = '1.
|
5174
|
+
context[:gem_version] = '1.69.0'
|
4703
5175
|
Seahorse::Client::Request.new(handlers, context)
|
4704
5176
|
end
|
4705
5177
|
|