blib/lib/Paws/NetworkFirewall.pm untested

filter: Statementstmt 0.0% 0 / 182 Branchbran 0.0% 0 / 16 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 0.0% 0 / 40 Podpod 0.0% 0 / 39 totaltotal 0.0% 0 / 277 CC 9 SCAR 15.0
CC
9
Cov
0%
ListAllFirewallPolicies
12.0
ListAllFirewalls
12.0
ListAllRuleGroups
12.0
CRAP 4.5
1 package Paws::NetworkFirewall;
2 use Moose;
3 sub service { 'network-firewall' }
4 sub signing_name { 'network-firewall' }
5 sub version { '2020-11-12' }
6 sub target_prefix { 'NetworkFirewall_20201112' }
7 sub json_version { "1.0" }
8 has max_attempts => (is => 'ro', isa => 'Int', default => 5);
9 has retry => (is => 'ro', isa => 'HashRef', default => sub {
10 { base => 'rand', type => 'exponential', growth_factor => 2 }
11 });
12 has retriables => (is => 'ro', isa => 'ArrayRef', default => sub { [
13 ] });
14  
15 with 'Paws::API::Caller', 'Paws::API::EndpointResolver', 'Paws::Net::V4Signature', 'Paws::Net::JsonCaller';
16  
17
18 sub AssociateFirewallPolicy {
19 my $self = shift;
20 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::AssociateFirewallPolicy', @_);
21 return $self->caller->do_call($self, $call_object);
22 }
23 sub AssociateSubnets {
24 my $self = shift;
25 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::AssociateSubnets', @_);
26 return $self->caller->do_call($self, $call_object);
27 }
28 sub CreateFirewall {
29 my $self = shift;
30 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::CreateFirewall', @_);
31 return $self->caller->do_call($self, $call_object);
32 }
33 sub CreateFirewallPolicy {
34 my $self = shift;
35 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::CreateFirewallPolicy', @_);
36 return $self->caller->do_call($self, $call_object);
37 }
38 sub CreateRuleGroup {
39 my $self = shift;
40 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::CreateRuleGroup', @_);
41 return $self->caller->do_call($self, $call_object);
42 }
43 sub DeleteFirewall {
44 my $self = shift;
45 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DeleteFirewall', @_);
46 return $self->caller->do_call($self, $call_object);
47 }
48 sub DeleteFirewallPolicy {
49 my $self = shift;
50 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DeleteFirewallPolicy', @_);
51 return $self->caller->do_call($self, $call_object);
52 }
53 sub DeleteResourcePolicy {
54 my $self = shift;
55 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DeleteResourcePolicy', @_);
56 return $self->caller->do_call($self, $call_object);
57 }
58 sub DeleteRuleGroup {
59 my $self = shift;
60 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DeleteRuleGroup', @_);
61 return $self->caller->do_call($self, $call_object);
62 }
63 sub DescribeFirewall {
64 my $self = shift;
65 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DescribeFirewall', @_);
66 return $self->caller->do_call($self, $call_object);
67 }
68 sub DescribeFirewallPolicy {
69 my $self = shift;
70 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DescribeFirewallPolicy', @_);
71 return $self->caller->do_call($self, $call_object);
72 }
73 sub DescribeLoggingConfiguration {
74 my $self = shift;
75 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DescribeLoggingConfiguration', @_);
76 return $self->caller->do_call($self, $call_object);
77 }
78 sub DescribeResourcePolicy {
79 my $self = shift;
80 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DescribeResourcePolicy', @_);
81 return $self->caller->do_call($self, $call_object);
82 }
83 sub DescribeRuleGroup {
84 my $self = shift;
85 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DescribeRuleGroup', @_);
86 return $self->caller->do_call($self, $call_object);
87 }
88 sub DisassociateSubnets {
89 my $self = shift;
90 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::DisassociateSubnets', @_);
91 return $self->caller->do_call($self, $call_object);
92 }
93 sub ListFirewallPolicies {
94 my $self = shift;
95 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::ListFirewallPolicies', @_);
96 return $self->caller->do_call($self, $call_object);
97 }
98 sub ListFirewalls {
99 my $self = shift;
100 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::ListFirewalls', @_);
101 return $self->caller->do_call($self, $call_object);
102 }
103 sub ListRuleGroups {
104 my $self = shift;
105 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::ListRuleGroups', @_);
106 return $self->caller->do_call($self, $call_object);
107 }
108 sub ListTagsForResource {
109 my $self = shift;
110 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::ListTagsForResource', @_);
111 return $self->caller->do_call($self, $call_object);
112 }
113 sub PutResourcePolicy {
114 my $self = shift;
115 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::PutResourcePolicy', @_);
116 return $self->caller->do_call($self, $call_object);
117 }
118 sub TagResource {
119 my $self = shift;
120 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::TagResource', @_);
121 return $self->caller->do_call($self, $call_object);
122 }
123 sub UntagResource {
124 my $self = shift;
125 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UntagResource', @_);
126 return $self->caller->do_call($self, $call_object);
127 }
128 sub UpdateFirewallDeleteProtection {
129 my $self = shift;
130 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateFirewallDeleteProtection', @_);
131 return $self->caller->do_call($self, $call_object);
132 }
133 sub UpdateFirewallDescription {
134 my $self = shift;
135 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateFirewallDescription', @_);
136 return $self->caller->do_call($self, $call_object);
137 }
138 sub UpdateFirewallPolicy {
139 my $self = shift;
140 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateFirewallPolicy', @_);
141 return $self->caller->do_call($self, $call_object);
142 }
143 sub UpdateFirewallPolicyChangeProtection {
144 my $self = shift;
145 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateFirewallPolicyChangeProtection', @_);
146 return $self->caller->do_call($self, $call_object);
147 }
148 sub UpdateLoggingConfiguration {
149 my $self = shift;
150 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateLoggingConfiguration', @_);
151 return $self->caller->do_call($self, $call_object);
152 }
153 sub UpdateRuleGroup {
154 my $self = shift;
155 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateRuleGroup', @_);
156 return $self->caller->do_call($self, $call_object);
157 }
158 sub UpdateSubnetChangeProtection {
159 my $self = shift;
160 my $call_object = $self->new_with_coercions('Paws::NetworkFirewall::UpdateSubnetChangeProtection', @_);
161 return $self->caller->do_call($self, $call_object);
162 }
163
164 sub ListAllFirewallPolicies {
165 my $self = shift;
166  
167 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
168 my $result = $self->ListFirewallPolicies(@_);
169 my $next_result = $result;
170  
171 if (not defined $callback) {
172 while ($next_result->NextToken) {
173 $next_result = $self->ListFirewallPolicies(@_, NextToken => $next_result->NextToken);
174 push @{ $result->FirewallPolicies }, @{ $next_result->FirewallPolicies };
175 }
176 return $result;
177 } else {
178 while ($result->NextToken) {
179 $callback->($_ => 'FirewallPolicies') foreach (@{ $result->FirewallPolicies });
180 $result = $self->ListFirewallPolicies(@_, NextToken => $result->NextToken);
181 }
182 $callback->($_ => 'FirewallPolicies') foreach (@{ $result->FirewallPolicies });
183 }
184  
185 return undef
186 }
187 sub ListAllFirewalls {
188 my $self = shift;
189  
190 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
191 my $result = $self->ListFirewalls(@_);
192 my $next_result = $result;
193  
194 if (not defined $callback) {
195 while ($next_result->NextToken) {
196 $next_result = $self->ListFirewalls(@_, NextToken => $next_result->NextToken);
197 push @{ $result->Firewalls }, @{ $next_result->Firewalls };
198 }
199 return $result;
200 } else {
201 while ($result->NextToken) {
202 $callback->($_ => 'Firewalls') foreach (@{ $result->Firewalls });
203 $result = $self->ListFirewalls(@_, NextToken => $result->NextToken);
204 }
205 $callback->($_ => 'Firewalls') foreach (@{ $result->Firewalls });
206 }
207  
208 return undef
209 }
210 sub ListAllRuleGroups {
211 my $self = shift;
212  
213 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
214 my $result = $self->ListRuleGroups(@_);
215 my $next_result = $result;
216  
217 if (not defined $callback) {
218 while ($next_result->NextToken) {
219 $next_result = $self->ListRuleGroups(@_, NextToken => $next_result->NextToken);
220 push @{ $result->RuleGroups }, @{ $next_result->RuleGroups };
221 }
222 return $result;
223 } else {
224 while ($result->NextToken) {
225 $callback->($_ => 'RuleGroups') foreach (@{ $result->RuleGroups });
226 $result = $self->ListRuleGroups(@_, NextToken => $result->NextToken);
227 }
228 $callback->($_ => 'RuleGroups') foreach (@{ $result->RuleGroups });
229 }
230  
231 return undef
232 }
233 sub ListAllTagsForResource {
234 my $self = shift;
235  
236 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
237 my $result = $self->ListTagsForResource(@_);
238 my $next_result = $result;
239  
240 if (not defined $callback) {
241 while ($next_result->NextToken) {
242 $next_result = $self->ListTagsForResource(@_, NextToken => $next_result->NextToken);
243 push @{ $result->Tags }, @{ $next_result->Tags };
244 }
245 return $result;
246 } else {
247 while ($result->NextToken) {
248 $callback->($_ => 'Tags') foreach (@{ $result->Tags });
249 $result = $self->ListTagsForResource(@_, NextToken => $result->NextToken);
250 }
251 $callback->($_ => 'Tags') foreach (@{ $result->Tags });
252 }
253  
254 return undef
255 }
256  
257  
258 sub operations { qw/AssociateFirewallPolicy AssociateSubnets CreateFirewall CreateFirewallPolicy CreateRuleGroup DeleteFirewall DeleteFirewallPolicy DeleteResourcePolicy DeleteRuleGroup DescribeFirewall DescribeFirewallPolicy DescribeLoggingConfiguration DescribeResourcePolicy DescribeRuleGroup DisassociateSubnets ListFirewallPolicies ListFirewalls ListRuleGroups ListTagsForResource PutResourcePolicy TagResource UntagResource UpdateFirewallDeleteProtection UpdateFirewallDescription UpdateFirewallPolicy UpdateFirewallPolicyChangeProtection UpdateLoggingConfiguration UpdateRuleGroup UpdateSubnetChangeProtection / }
259  
260 1;
261  
262 ### main pod documentation begin ###
263  
264 =head1 NAME
265  
266 Paws::NetworkFirewall - Perl Interface to AWS AWS Network Firewall
267  
268 =head1 SYNOPSIS
269  
270 use Paws;
271  
272 my $obj = Paws->service('NetworkFirewall');
273 my $res = $obj->Method(
274 Arg1 => $val1,
275 Arg2 => [ 'V1', 'V2' ],
276 # if Arg3 is an object, the HashRef will be used as arguments to the constructor
277 # of the arguments type
278 Arg3 => { Att1 => 'Val1' },
279 # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
280 # the constructor of the arguments type
281 Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
282 );
283  
284 =head1 DESCRIPTION
285  
286 This is the API Reference for AWS Network Firewall. This guide is for
287 developers who need detailed information about the Network Firewall API
288 actions, data types, and errors.
289  
290 =over
291  
292 =item *
293  
294 The REST API requires you to handle connection details, such as
295 calculating signatures, handling request retries, and error handling.
296 For general information about using the AWS REST APIs, see AWS APIs
297 (https://docs.aws.amazon.com/general/latest/gr/aws-apis.html).
298  
299 To access Network Firewall using the REST API endpoint:
300 C<https://network-firewall.E<lt>regionE<gt>.amazonaws.com>
301  
302 =item *
303  
304 Alternatively, you can use one of the AWS SDKs to access an API that's
305 tailored to the programming language or platform that you're using. For
306 more information, see AWS SDKs (http://aws.amazon.com/tools/#SDKs).
307  
308 =item *
309  
310 For descriptions of Network Firewall features, including and
311 step-by-step instructions on how to use them through the Network
312 Firewall console, see the Network Firewall Developer Guide
313 (https://docs.aws.amazon.com/network-firewall/latest/developerguide/).
314  
315 =back
316  
317 Network Firewall is a stateful, managed, network firewall and intrusion
318 detection and prevention service for Amazon Virtual Private Cloud
319 (Amazon VPC). With Network Firewall, you can filter traffic at the
320 perimeter of your VPC. This includes filtering traffic going to and
321 coming from an internet gateway, NAT gateway, or over VPN or AWS Direct
322 Connect. Network Firewall uses rules that are compatible with Suricata,
323 a free, open source intrusion detection system (IDS) engine. For
324 information about Suricata, see the Suricata website
325 (https://suricata-ids.org/).
326  
327 You can use Network Firewall to monitor and protect your VPC traffic in
328 a number of ways. The following are just a few examples:
329  
330 =over
331  
332 =item *
333  
334 Allow domains or IP addresses for known AWS service endpoints, such as
335 Amazon S3, and block all other forms of traffic.
336  
337 =item *
338  
339 Use custom lists of known bad domains to limit the types of domain
340 names that your applications can access.
341  
342 =item *
343  
344 Perform deep packet inspection on traffic entering or leaving your VPC.
345  
346 =item *
347  
348 Use stateful protocol detection to filter protocols like HTTPS,
349 regardless of the port used.
350  
351 =back
352  
353 To enable Network Firewall for your VPCs, you perform steps in both
354 Amazon VPC and in Network Firewall. For information about using Amazon
355 VPC, see Amazon VPC User Guide
356 (https://docs.aws.amazon.com/vpc/latest/userguide/).
357  
358 To start using Network Firewall, do the following:
359  
360 =over
361  
362 =item 1.
363  
364 (Optional) If you don't already have a VPC that you want to protect,
365 create it in Amazon VPC.
366  
367 =item 2.
368  
369 In Amazon VPC, in each Availability Zone where you want to have a
370 firewall endpoint, create a subnet for the sole use of Network
371 Firewall.
372  
373 =item 3.
374  
375 In Network Firewall, create stateless and stateful rule groups, to
376 define the components of the network traffic filtering behavior that
377 you want your firewall to have.
378  
379 =item 4.
380  
381 In Network Firewall, create a firewall policy that uses your rule
382 groups and specifies additional default traffic filtering behavior.
383  
384 =item 5.
385  
386 In Network Firewall, create a firewall and specify your new firewall
387 policy and VPC subnets. Network Firewall creates a firewall endpoint in
388 each subnet that you specify, with the behavior that's defined in the
389 firewall policy.
390  
391 =item 6.
392  
393 In Amazon VPC, use ingress routing enhancements to route traffic
394 through the new firewall endpoints.
395  
396 =back
397  
398  
399 For the AWS API documentation, see L<https://docs.aws.amazon.com/goto/WebAPI/network-firewall-2020-11-12>
400  
401  
402 =head1 METHODS
403  
404 =head2 AssociateFirewallPolicy
405  
406 =over
407  
408 =item FirewallPolicyArn => Str
409  
410 =item [FirewallArn => Str]
411  
412 =item [FirewallName => Str]
413  
414 =item [UpdateToken => Str]
415  
416  
417 =back
418  
419 Each argument is described in detail in: L<Paws::NetworkFirewall::AssociateFirewallPolicy>
420  
421 Returns: a L<Paws::NetworkFirewall::AssociateFirewallPolicyResponse> instance
422  
423 Associates a FirewallPolicy to a Firewall.
424  
425 A firewall policy defines how to monitor and manage your VPC network
426 traffic, using a collection of inspection rule groups and other
427 settings. Each firewall requires one firewall policy association, and
428 you can use the same firewall policy for multiple firewalls.
429  
430  
431 =head2 AssociateSubnets
432  
433 =over
434  
435 =item SubnetMappings => ArrayRef[L<Paws::NetworkFirewall::SubnetMapping>]
436  
437 =item [FirewallArn => Str]
438  
439 =item [FirewallName => Str]
440  
441 =item [UpdateToken => Str]
442  
443  
444 =back
445  
446 Each argument is described in detail in: L<Paws::NetworkFirewall::AssociateSubnets>
447  
448 Returns: a L<Paws::NetworkFirewall::AssociateSubnetsResponse> instance
449  
450 Associates the specified subnets in the Amazon VPC to the firewall. You
451 can specify one subnet for each of the Availability Zones that the VPC
452 spans.
453  
454 This request creates an AWS Network Firewall firewall endpoint in each
455 of the subnets. To enable the firewall's protections, you must also
456 modify the VPC's route tables for each subnet's Availability Zone, to
457 redirect the traffic that's coming into and going out of the zone
458 through the firewall endpoint.
459  
460  
461 =head2 CreateFirewall
462  
463 =over
464  
465 =item FirewallName => Str
466  
467 =item FirewallPolicyArn => Str
468  
469 =item SubnetMappings => ArrayRef[L<Paws::NetworkFirewall::SubnetMapping>]
470  
471 =item VpcId => Str
472  
473 =item [DeleteProtection => Bool]
474  
475 =item [Description => Str]
476  
477 =item [FirewallPolicyChangeProtection => Bool]
478  
479 =item [SubnetChangeProtection => Bool]
480  
481 =item [Tags => ArrayRef[L<Paws::NetworkFirewall::Tag>]]
482  
483  
484 =back
485  
486 Each argument is described in detail in: L<Paws::NetworkFirewall::CreateFirewall>
487  
488 Returns: a L<Paws::NetworkFirewall::CreateFirewallResponse> instance
489  
490 Creates an AWS Network Firewall Firewall and accompanying
491 FirewallStatus for a VPC.
492  
493 The firewall defines the configuration settings for an AWS Network
494 Firewall firewall. The settings that you can define at creation include
495 the firewall policy, the subnets in your VPC to use for the firewall
496 endpoints, and any tags that are attached to the firewall AWS resource.
497  
498 After you create a firewall, you can provide additional settings, like
499 the logging configuration.
500  
501 To update the settings for a firewall, you use the operations that
502 apply to the settings themselves, for example
503 UpdateLoggingConfiguration, AssociateSubnets, and
504 UpdateFirewallDeleteProtection.
505  
506 To manage a firewall's tags, use the standard AWS resource tagging
507 operations, ListTagsForResource, TagResource, and UntagResource.
508  
509 To retrieve information about firewalls, use ListFirewalls and
510 DescribeFirewall.
511  
512  
513 =head2 CreateFirewallPolicy
514  
515 =over
516  
517 =item FirewallPolicy => L<Paws::NetworkFirewall::FirewallPolicy>
518  
519 =item FirewallPolicyName => Str
520  
521 =item [Description => Str]
522  
523 =item [DryRun => Bool]
524  
525 =item [Tags => ArrayRef[L<Paws::NetworkFirewall::Tag>]]
526  
527  
528 =back
529  
530 Each argument is described in detail in: L<Paws::NetworkFirewall::CreateFirewallPolicy>
531  
532 Returns: a L<Paws::NetworkFirewall::CreateFirewallPolicyResponse> instance
533  
534 Creates the firewall policy for the firewall according to the
535 specifications.
536  
537 An AWS Network Firewall firewall policy defines the behavior of a
538 firewall, in a collection of stateless and stateful rule groups and
539 other settings. You can use one firewall policy for multiple firewalls.
540  
541  
542 =head2 CreateRuleGroup
543  
544 =over
545  
546 =item Capacity => Int
547  
548 =item RuleGroupName => Str
549  
550 =item Type => Str
551  
552 =item [Description => Str]
553  
554 =item [DryRun => Bool]
555  
556 =item [RuleGroup => L<Paws::NetworkFirewall::RuleGroup>]
557  
558 =item [Rules => Str]
559  
560 =item [Tags => ArrayRef[L<Paws::NetworkFirewall::Tag>]]
561  
562  
563 =back
564  
565 Each argument is described in detail in: L<Paws::NetworkFirewall::CreateRuleGroup>
566  
567 Returns: a L<Paws::NetworkFirewall::CreateRuleGroupResponse> instance
568  
569 Creates the specified stateless or stateful rule group, which includes
570 the rules for network traffic inspection, a capacity setting, and tags.
571  
572 You provide your rule group specification in your request using either
573 C<RuleGroup> or C<Rules>.
574  
575  
576 =head2 DeleteFirewall
577  
578 =over
579  
580 =item [FirewallArn => Str]
581  
582 =item [FirewallName => Str]
583  
584  
585 =back
586  
587 Each argument is described in detail in: L<Paws::NetworkFirewall::DeleteFirewall>
588  
589 Returns: a L<Paws::NetworkFirewall::DeleteFirewallResponse> instance
590  
591 Deletes the specified Firewall and its FirewallStatus. This operation
592 requires the firewall's C<DeleteProtection> flag to be C<FALSE>. You
593 can't revert this operation.
594  
595 You can check whether a firewall is in use by reviewing the route
596 tables for the Availability Zones where you have firewall subnet
597 mappings. Retrieve the subnet mappings by calling DescribeFirewall. You
598 define and update the route tables through Amazon VPC. As needed,
599 update the route tables for the zones to remove the firewall endpoints.
600 When the route tables no longer use the firewall endpoints, you can
601 remove the firewall safely.
602  
603 To delete a firewall, remove the delete protection if you need to using
604 UpdateFirewallDeleteProtection, then delete the firewall by calling
605 DeleteFirewall.
606  
607  
608 =head2 DeleteFirewallPolicy
609  
610 =over
611  
612 =item [FirewallPolicyArn => Str]
613  
614 =item [FirewallPolicyName => Str]
615  
616  
617 =back
618  
619 Each argument is described in detail in: L<Paws::NetworkFirewall::DeleteFirewallPolicy>
620  
621 Returns: a L<Paws::NetworkFirewall::DeleteFirewallPolicyResponse> instance
622  
623 Deletes the specified FirewallPolicy.
624  
625  
626 =head2 DeleteResourcePolicy
627  
628 =over
629  
630 =item ResourceArn => Str
631  
632  
633 =back
634  
635 Each argument is described in detail in: L<Paws::NetworkFirewall::DeleteResourcePolicy>
636  
637 Returns: a L<Paws::NetworkFirewall::DeleteResourcePolicyResponse> instance
638  
639 Deletes a resource policy that you created in a PutResourcePolicy
640 request.
641  
642  
643 =head2 DeleteRuleGroup
644  
645 =over
646  
647 =item [RuleGroupArn => Str]
648  
649 =item [RuleGroupName => Str]
650  
651 =item [Type => Str]
652  
653  
654 =back
655  
656 Each argument is described in detail in: L<Paws::NetworkFirewall::DeleteRuleGroup>
657  
658 Returns: a L<Paws::NetworkFirewall::DeleteRuleGroupResponse> instance
659  
660 Deletes the specified RuleGroup.
661  
662  
663 =head2 DescribeFirewall
664  
665 =over
666  
667 =item [FirewallArn => Str]
668  
669 =item [FirewallName => Str]
670  
671  
672 =back
673  
674 Each argument is described in detail in: L<Paws::NetworkFirewall::DescribeFirewall>
675  
676 Returns: a L<Paws::NetworkFirewall::DescribeFirewallResponse> instance
677  
678 Returns the data objects for the specified firewall.
679  
680  
681 =head2 DescribeFirewallPolicy
682  
683 =over
684  
685 =item [FirewallPolicyArn => Str]
686  
687 =item [FirewallPolicyName => Str]
688  
689  
690 =back
691  
692 Each argument is described in detail in: L<Paws::NetworkFirewall::DescribeFirewallPolicy>
693  
694 Returns: a L<Paws::NetworkFirewall::DescribeFirewallPolicyResponse> instance
695  
696 Returns the data objects for the specified firewall policy.
697  
698  
699 =head2 DescribeLoggingConfiguration
700  
701 =over
702  
703 =item [FirewallArn => Str]
704  
705 =item [FirewallName => Str]
706  
707  
708 =back
709  
710 Each argument is described in detail in: L<Paws::NetworkFirewall::DescribeLoggingConfiguration>
711  
712 Returns: a L<Paws::NetworkFirewall::DescribeLoggingConfigurationResponse> instance
713  
714 Returns the logging configuration for the specified firewall.
715  
716  
717 =head2 DescribeResourcePolicy
718  
719 =over
720  
721 =item ResourceArn => Str
722  
723  
724 =back
725  
726 Each argument is described in detail in: L<Paws::NetworkFirewall::DescribeResourcePolicy>
727  
728 Returns: a L<Paws::NetworkFirewall::DescribeResourcePolicyResponse> instance
729  
730 Retrieves a resource policy that you created in a PutResourcePolicy
731 request.
732  
733  
734 =head2 DescribeRuleGroup
735  
736 =over
737  
738 =item [RuleGroupArn => Str]
739  
740 =item [RuleGroupName => Str]
741  
742 =item [Type => Str]
743  
744  
745 =back
746  
747 Each argument is described in detail in: L<Paws::NetworkFirewall::DescribeRuleGroup>
748  
749 Returns: a L<Paws::NetworkFirewall::DescribeRuleGroupResponse> instance
750  
751 Returns the data objects for the specified rule group.
752  
753  
754 =head2 DisassociateSubnets
755  
756 =over
757  
758 =item SubnetIds => ArrayRef[Str|Undef]
759  
760 =item [FirewallArn => Str]
761  
762 =item [FirewallName => Str]
763  
764 =item [UpdateToken => Str]
765  
766  
767 =back
768  
769 Each argument is described in detail in: L<Paws::NetworkFirewall::DisassociateSubnets>
770  
771 Returns: a L<Paws::NetworkFirewall::DisassociateSubnetsResponse> instance
772  
773 Removes the specified subnet associations from the firewall. This
774 removes the firewall endpoints from the subnets and removes any network
775 filtering protections that the endpoints were providing.
776  
777  
778 =head2 ListFirewallPolicies
779  
780 =over
781  
782 =item [MaxResults => Int]
783  
784 =item [NextToken => Str]
785  
786  
787 =back
788  
789 Each argument is described in detail in: L<Paws::NetworkFirewall::ListFirewallPolicies>
790  
791 Returns: a L<Paws::NetworkFirewall::ListFirewallPoliciesResponse> instance
792  
793 Retrieves the metadata for the firewall policies that you have defined.
794 Depending on your setting for max results and the number of firewall
795 policies, a single call might not return the full list.
796  
797  
798 =head2 ListFirewalls
799  
800 =over
801  
802 =item [MaxResults => Int]
803  
804 =item [NextToken => Str]
805  
806 =item [VpcIds => ArrayRef[Str|Undef]]
807  
808  
809 =back
810  
811 Each argument is described in detail in: L<Paws::NetworkFirewall::ListFirewalls>
812  
813 Returns: a L<Paws::NetworkFirewall::ListFirewallsResponse> instance
814  
815 Retrieves the metadata for the firewalls that you have defined. If you
816 provide VPC identifiers in your request, this returns only the
817 firewalls for those VPCs.
818  
819 Depending on your setting for max results and the number of firewalls,
820 a single call might not return the full list.
821  
822  
823 =head2 ListRuleGroups
824  
825 =over
826  
827 =item [MaxResults => Int]
828  
829 =item [NextToken => Str]
830  
831  
832 =back
833  
834 Each argument is described in detail in: L<Paws::NetworkFirewall::ListRuleGroups>
835  
836 Returns: a L<Paws::NetworkFirewall::ListRuleGroupsResponse> instance
837  
838 Retrieves the metadata for the rule groups that you have defined.
839 Depending on your setting for max results and the number of rule
840 groups, a single call might not return the full list.
841  
842  
843 =head2 ListTagsForResource
844  
845 =over
846  
847 =item ResourceArn => Str
848  
849 =item [MaxResults => Int]
850  
851 =item [NextToken => Str]
852  
853  
854 =back
855  
856 Each argument is described in detail in: L<Paws::NetworkFirewall::ListTagsForResource>
857  
858 Returns: a L<Paws::NetworkFirewall::ListTagsForResourceResponse> instance
859  
860 Retrieves the tags associated with the specified resource. Tags are
861 key:value pairs that you can use to categorize and manage your
862 resources, for purposes like billing. For example, you might set the
863 tag key to "customer" and the value to the customer name or ID. You can
864 specify one or more tags to add to each AWS resource, up to 50 tags for
865 a resource.
866  
867 You can tag the AWS resources that you manage through AWS Network
868 Firewall: firewalls, firewall policies, and rule groups.
869  
870  
871 =head2 PutResourcePolicy
872  
873 =over
874  
875 =item Policy => Str
876  
877 =item ResourceArn => Str
878  
879  
880 =back
881  
882 Each argument is described in detail in: L<Paws::NetworkFirewall::PutResourcePolicy>
883  
884 Returns: a L<Paws::NetworkFirewall::PutResourcePolicyResponse> instance
885  
886 Creates or updates an AWS Identity and Access Management policy for
887 your rule group or firewall policy. Use this to share rule groups and
888 firewall policies between accounts. This operation works in conjunction
889 with the AWS Resource Access Manager (RAM) service to manage resource
890 sharing for Network Firewall.
891  
892 Use this operation to create or update a resource policy for your rule
893 group or firewall policy. In the policy, you specify the accounts that
894 you want to share the resource with and the operations that you want
895 the accounts to be able to perform.
896  
897 When you add an account in the resource policy, you then run the
898 following Resource Access Manager (RAM) operations to access and accept
899 the shared rule group or firewall policy.
900  
901 =over
902  
903 =item *
904  
905 GetResourceShareInvitations
906 (https://docs.aws.amazon.com/ram/latest/APIReference/API_GetResourceShareInvitations.html)
907 - Returns the Amazon Resource Names (ARNs) of the resource share
908 invitations.
909  
910 =item *
911  
912 AcceptResourceShareInvitation
913 (https://docs.aws.amazon.com/ram/latest/APIReference/API_AcceptResourceShareInvitation.html)
914 - Accepts the share invitation for a specified resource share.
915  
916 =back
917  
918 For additional information about resource sharing using RAM, see AWS
919 Resource Access Manager User Guide
920 (https://docs.aws.amazon.com/ram/latest/userguide/what-is.html).
921  
922  
923 =head2 TagResource
924  
925 =over
926  
927 =item ResourceArn => Str
928  
929 =item Tags => ArrayRef[L<Paws::NetworkFirewall::Tag>]
930  
931  
932 =back
933  
934 Each argument is described in detail in: L<Paws::NetworkFirewall::TagResource>
935  
936 Returns: a L<Paws::NetworkFirewall::TagResourceResponse> instance
937  
938 Adds the specified tags to the specified resource. Tags are key:value
939 pairs that you can use to categorize and manage your resources, for
940 purposes like billing. For example, you might set the tag key to
941 "customer" and the value to the customer name or ID. You can specify
942 one or more tags to add to each AWS resource, up to 50 tags for a
943 resource.
944  
945 You can tag the AWS resources that you manage through AWS Network
946 Firewall: firewalls, firewall policies, and rule groups.
947  
948  
949 =head2 UntagResource
950  
951 =over
952  
953 =item ResourceArn => Str
954  
955 =item TagKeys => ArrayRef[Str|Undef]
956  
957  
958 =back
959  
960 Each argument is described in detail in: L<Paws::NetworkFirewall::UntagResource>
961  
962 Returns: a L<Paws::NetworkFirewall::UntagResourceResponse> instance
963  
964 Removes the tags with the specified keys from the specified resource.
965 Tags are key:value pairs that you can use to categorize and manage your
966 resources, for purposes like billing. For example, you might set the
967 tag key to "customer" and the value to the customer name or ID. You can
968 specify one or more tags to add to each AWS resource, up to 50 tags for
969 a resource.
970  
971 You can manage tags for the AWS resources that you manage through AWS
972 Network Firewall: firewalls, firewall policies, and rule groups.
973  
974  
975 =head2 UpdateFirewallDeleteProtection
976  
977 =over
978  
979 =item DeleteProtection => Bool
980  
981 =item [FirewallArn => Str]
982  
983 =item [FirewallName => Str]
984  
985 =item [UpdateToken => Str]
986  
987  
988 =back
989  
990 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateFirewallDeleteProtection>
991  
992 Returns: a L<Paws::NetworkFirewall::UpdateFirewallDeleteProtectionResponse> instance
993  
994 Modifies the flag, C<DeleteProtection>, which indicates whether it is
995 possible to delete the firewall. If the flag is set to C<TRUE>, the
996 firewall is protected against deletion. This setting helps protect
997 against accidentally deleting a firewall that's in use.
998  
999  
1000 =head2 UpdateFirewallDescription
1001  
1002 =over
1003  
1004 =item [Description => Str]
1005  
1006 =item [FirewallArn => Str]
1007  
1008 =item [FirewallName => Str]
1009  
1010 =item [UpdateToken => Str]
1011  
1012  
1013 =back
1014  
1015 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateFirewallDescription>
1016  
1017 Returns: a L<Paws::NetworkFirewall::UpdateFirewallDescriptionResponse> instance
1018  
1019 Modifies the description for the specified firewall. Use the
1020 description to help you identify the firewall when you're working with
1021 it.
1022  
1023  
1024 =head2 UpdateFirewallPolicy
1025  
1026 =over
1027  
1028 =item FirewallPolicy => L<Paws::NetworkFirewall::FirewallPolicy>
1029  
1030 =item UpdateToken => Str
1031  
1032 =item [Description => Str]
1033  
1034 =item [DryRun => Bool]
1035  
1036 =item [FirewallPolicyArn => Str]
1037  
1038 =item [FirewallPolicyName => Str]
1039  
1040  
1041 =back
1042  
1043 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateFirewallPolicy>
1044  
1045 Returns: a L<Paws::NetworkFirewall::UpdateFirewallPolicyResponse> instance
1046  
1047 Updates the properties of the specified firewall policy.
1048  
1049  
1050 =head2 UpdateFirewallPolicyChangeProtection
1051  
1052 =over
1053  
1054 =item FirewallPolicyChangeProtection => Bool
1055  
1056 =item [FirewallArn => Str]
1057  
1058 =item [FirewallName => Str]
1059  
1060 =item [UpdateToken => Str]
1061  
1062  
1063 =back
1064  
1065 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateFirewallPolicyChangeProtection>
1066  
1067 Returns: a L<Paws::NetworkFirewall::UpdateFirewallPolicyChangeProtectionResponse> instance
1068  
1069  
1070  
1071  
1072 =head2 UpdateLoggingConfiguration
1073  
1074 =over
1075  
1076 =item [FirewallArn => Str]
1077  
1078 =item [FirewallName => Str]
1079  
1080 =item [LoggingConfiguration => L<Paws::NetworkFirewall::LoggingConfiguration>]
1081  
1082  
1083 =back
1084  
1085 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateLoggingConfiguration>
1086  
1087 Returns: a L<Paws::NetworkFirewall::UpdateLoggingConfigurationResponse> instance
1088  
1089 Sets the logging configuration for the specified firewall.
1090  
1091 To change the logging configuration, retrieve the LoggingConfiguration
1092 by calling DescribeLoggingConfiguration, then change it and provide the
1093 modified object to this update call. You must change the logging
1094 configuration one LogDestinationConfig at a time inside the retrieved
1095 LoggingConfiguration object.
1096  
1097 You can perform only one of the following actions in any call to
1098 C<UpdateLoggingConfiguration>:
1099  
1100 =over
1101  
1102 =item *
1103  
1104 Create a new log destination object by adding a single
1105 C<LogDestinationConfig> array element to C<LogDestinationConfigs>.
1106  
1107 =item *
1108  
1109 Delete a log destination object by removing a single
1110 C<LogDestinationConfig> array element from C<LogDestinationConfigs>.
1111  
1112 =item *
1113  
1114 Change the C<LogDestination> setting in a single
1115 C<LogDestinationConfig> array element.
1116  
1117 =back
1118  
1119 You can't change the C<LogDestinationType> or C<LogType> in a
1120 C<LogDestinationConfig>. To change these settings, delete the existing
1121 C<LogDestinationConfig> object and create a new one, using two separate
1122 calls to this update operation.
1123  
1124  
1125 =head2 UpdateRuleGroup
1126  
1127 =over
1128  
1129 =item UpdateToken => Str
1130  
1131 =item [Description => Str]
1132  
1133 =item [DryRun => Bool]
1134  
1135 =item [RuleGroup => L<Paws::NetworkFirewall::RuleGroup>]
1136  
1137 =item [RuleGroupArn => Str]
1138  
1139 =item [RuleGroupName => Str]
1140  
1141 =item [Rules => Str]
1142  
1143 =item [Type => Str]
1144  
1145  
1146 =back
1147  
1148 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateRuleGroup>
1149  
1150 Returns: a L<Paws::NetworkFirewall::UpdateRuleGroupResponse> instance
1151  
1152 Updates the rule settings for the specified rule group. You use a rule
1153 group by reference in one or more firewall policies. When you modify a
1154 rule group, you modify all firewall policies that use the rule group.
1155  
1156 To update a rule group, first call DescribeRuleGroup to retrieve the
1157 current RuleGroup object, update the object as needed, and then provide
1158 the updated object to this call.
1159  
1160  
1161 =head2 UpdateSubnetChangeProtection
1162  
1163 =over
1164  
1165 =item SubnetChangeProtection => Bool
1166  
1167 =item [FirewallArn => Str]
1168  
1169 =item [FirewallName => Str]
1170  
1171 =item [UpdateToken => Str]
1172  
1173  
1174 =back
1175  
1176 Each argument is described in detail in: L<Paws::NetworkFirewall::UpdateSubnetChangeProtection>
1177  
1178 Returns: a L<Paws::NetworkFirewall::UpdateSubnetChangeProtectionResponse> instance
1179  
1180  
1181  
1182  
1183  
1184  
1185 =head1 PAGINATORS
1186  
1187 Paginator methods are helpers that repetively call methods that return partial results
1188  
1189 =head2 ListAllFirewallPolicies(sub { },[MaxResults => Int, NextToken => Str])
1190  
1191 =head2 ListAllFirewallPolicies([MaxResults => Int, NextToken => Str])
1192  
1193  
1194 If passed a sub as first parameter, it will call the sub for each element found in :
1195  
1196 - FirewallPolicies, passing the object as the first parameter, and the string 'FirewallPolicies' as the second parameter
1197  
1198 If not, it will return a a L<Paws::NetworkFirewall::ListFirewallPoliciesResponse> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1199  
1200  
1201 =head2 ListAllFirewalls(sub { },[MaxResults => Int, NextToken => Str, VpcIds => ArrayRef[Str|Undef]])
1202  
1203 =head2 ListAllFirewalls([MaxResults => Int, NextToken => Str, VpcIds => ArrayRef[Str|Undef]])
1204  
1205  
1206 If passed a sub as first parameter, it will call the sub for each element found in :
1207  
1208 - Firewalls, passing the object as the first parameter, and the string 'Firewalls' as the second parameter
1209  
1210 If not, it will return a a L<Paws::NetworkFirewall::ListFirewallsResponse> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1211  
1212  
1213 =head2 ListAllRuleGroups(sub { },[MaxResults => Int, NextToken => Str])
1214  
1215 =head2 ListAllRuleGroups([MaxResults => Int, NextToken => Str])
1216  
1217  
1218 If passed a sub as first parameter, it will call the sub for each element found in :
1219  
1220 - RuleGroups, passing the object as the first parameter, and the string 'RuleGroups' as the second parameter
1221  
1222 If not, it will return a a L<Paws::NetworkFirewall::ListRuleGroupsResponse> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1223  
1224  
1225 =head2 ListAllTagsForResource(sub { },ResourceArn => Str, [MaxResults => Int, NextToken => Str])
1226  
1227 =head2 ListAllTagsForResource(ResourceArn => Str, [MaxResults => Int, NextToken => Str])
1228  
1229  
1230 If passed a sub as first parameter, it will call the sub for each element found in :
1231  
1232 - Tags, passing the object as the first parameter, and the string 'Tags' as the second parameter
1233  
1234 If not, it will return a a L<Paws::NetworkFirewall::ListTagsForResourceResponse> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1235  
1236  
1237  
1238  
1239  
1240 =head1 SEE ALSO
1241  
1242 This service class forms part of L<Paws>
1243  
1244 =head1 BUGS and CONTRIBUTIONS
1245  
1246 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
1247  
1248 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
1249  
1250 =cut
1251