blib/lib/Paws/Shield.pm untested

filter: Statementstmt 0.0% 0 / 154 Branchbran 0.0% 0 / 8 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 0.0% 0 / 42 Podpod 0.0% 0 / 41 totaltotal 0.0% 0 / 245 CC 5 SCAR 12.0
CC
5
Cov
0%
ListAllAttacks
12.0
ListAllProtections
12.0
service
2.0
CRAP 3.3
1 package Paws::Shield;
2 use Moose;
3 sub service { 'shield' }
4 sub signing_name { 'shield' }
5 sub version { '2016-06-02' }
6 sub target_prefix { 'AWSShield_20160616' }
7 sub json_version { "1.1" }
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 AssociateDRTLogBucket {
19 my $self = shift;
20 my $call_object = $self->new_with_coercions('Paws::Shield::AssociateDRTLogBucket', @_);
21 return $self->caller->do_call($self, $call_object);
22 }
23 sub AssociateDRTRole {
24 my $self = shift;
25 my $call_object = $self->new_with_coercions('Paws::Shield::AssociateDRTRole', @_);
26 return $self->caller->do_call($self, $call_object);
27 }
28 sub AssociateHealthCheck {
29 my $self = shift;
30 my $call_object = $self->new_with_coercions('Paws::Shield::AssociateHealthCheck', @_);
31 return $self->caller->do_call($self, $call_object);
32 }
33 sub AssociateProactiveEngagementDetails {
34 my $self = shift;
35 my $call_object = $self->new_with_coercions('Paws::Shield::AssociateProactiveEngagementDetails', @_);
36 return $self->caller->do_call($self, $call_object);
37 }
38 sub CreateProtection {
39 my $self = shift;
40 my $call_object = $self->new_with_coercions('Paws::Shield::CreateProtection', @_);
41 return $self->caller->do_call($self, $call_object);
42 }
43 sub CreateProtectionGroup {
44 my $self = shift;
45 my $call_object = $self->new_with_coercions('Paws::Shield::CreateProtectionGroup', @_);
46 return $self->caller->do_call($self, $call_object);
47 }
48 sub CreateSubscription {
49 my $self = shift;
50 my $call_object = $self->new_with_coercions('Paws::Shield::CreateSubscription', @_);
51 return $self->caller->do_call($self, $call_object);
52 }
53 sub DeleteProtection {
54 my $self = shift;
55 my $call_object = $self->new_with_coercions('Paws::Shield::DeleteProtection', @_);
56 return $self->caller->do_call($self, $call_object);
57 }
58 sub DeleteProtectionGroup {
59 my $self = shift;
60 my $call_object = $self->new_with_coercions('Paws::Shield::DeleteProtectionGroup', @_);
61 return $self->caller->do_call($self, $call_object);
62 }
63 sub DeleteSubscription {
64 my $self = shift;
65 my $call_object = $self->new_with_coercions('Paws::Shield::DeleteSubscription', @_);
66 return $self->caller->do_call($self, $call_object);
67 }
68 sub DescribeAttack {
69 my $self = shift;
70 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeAttack', @_);
71 return $self->caller->do_call($self, $call_object);
72 }
73 sub DescribeAttackStatistics {
74 my $self = shift;
75 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeAttackStatistics', @_);
76 return $self->caller->do_call($self, $call_object);
77 }
78 sub DescribeDRTAccess {
79 my $self = shift;
80 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeDRTAccess', @_);
81 return $self->caller->do_call($self, $call_object);
82 }
83 sub DescribeEmergencyContactSettings {
84 my $self = shift;
85 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeEmergencyContactSettings', @_);
86 return $self->caller->do_call($self, $call_object);
87 }
88 sub DescribeProtection {
89 my $self = shift;
90 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeProtection', @_);
91 return $self->caller->do_call($self, $call_object);
92 }
93 sub DescribeProtectionGroup {
94 my $self = shift;
95 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeProtectionGroup', @_);
96 return $self->caller->do_call($self, $call_object);
97 }
98 sub DescribeSubscription {
99 my $self = shift;
100 my $call_object = $self->new_with_coercions('Paws::Shield::DescribeSubscription', @_);
101 return $self->caller->do_call($self, $call_object);
102 }
103 sub DisableProactiveEngagement {
104 my $self = shift;
105 my $call_object = $self->new_with_coercions('Paws::Shield::DisableProactiveEngagement', @_);
106 return $self->caller->do_call($self, $call_object);
107 }
108 sub DisassociateDRTLogBucket {
109 my $self = shift;
110 my $call_object = $self->new_with_coercions('Paws::Shield::DisassociateDRTLogBucket', @_);
111 return $self->caller->do_call($self, $call_object);
112 }
113 sub DisassociateDRTRole {
114 my $self = shift;
115 my $call_object = $self->new_with_coercions('Paws::Shield::DisassociateDRTRole', @_);
116 return $self->caller->do_call($self, $call_object);
117 }
118 sub DisassociateHealthCheck {
119 my $self = shift;
120 my $call_object = $self->new_with_coercions('Paws::Shield::DisassociateHealthCheck', @_);
121 return $self->caller->do_call($self, $call_object);
122 }
123 sub EnableProactiveEngagement {
124 my $self = shift;
125 my $call_object = $self->new_with_coercions('Paws::Shield::EnableProactiveEngagement', @_);
126 return $self->caller->do_call($self, $call_object);
127 }
128 sub GetSubscriptionState {
129 my $self = shift;
130 my $call_object = $self->new_with_coercions('Paws::Shield::GetSubscriptionState', @_);
131 return $self->caller->do_call($self, $call_object);
132 }
133 sub ListAttacks {
134 my $self = shift;
135 my $call_object = $self->new_with_coercions('Paws::Shield::ListAttacks', @_);
136 return $self->caller->do_call($self, $call_object);
137 }
138 sub ListProtectionGroups {
139 my $self = shift;
140 my $call_object = $self->new_with_coercions('Paws::Shield::ListProtectionGroups', @_);
141 return $self->caller->do_call($self, $call_object);
142 }
143 sub ListProtections {
144 my $self = shift;
145 my $call_object = $self->new_with_coercions('Paws::Shield::ListProtections', @_);
146 return $self->caller->do_call($self, $call_object);
147 }
148 sub ListResourcesInProtectionGroup {
149 my $self = shift;
150 my $call_object = $self->new_with_coercions('Paws::Shield::ListResourcesInProtectionGroup', @_);
151 return $self->caller->do_call($self, $call_object);
152 }
153 sub ListTagsForResource {
154 my $self = shift;
155 my $call_object = $self->new_with_coercions('Paws::Shield::ListTagsForResource', @_);
156 return $self->caller->do_call($self, $call_object);
157 }
158 sub TagResource {
159 my $self = shift;
160 my $call_object = $self->new_with_coercions('Paws::Shield::TagResource', @_);
161 return $self->caller->do_call($self, $call_object);
162 }
163 sub UntagResource {
164 my $self = shift;
165 my $call_object = $self->new_with_coercions('Paws::Shield::UntagResource', @_);
166 return $self->caller->do_call($self, $call_object);
167 }
168 sub UpdateEmergencyContactSettings {
169 my $self = shift;
170 my $call_object = $self->new_with_coercions('Paws::Shield::UpdateEmergencyContactSettings', @_);
171 return $self->caller->do_call($self, $call_object);
172 }
173 sub UpdateProtectionGroup {
174 my $self = shift;
175 my $call_object = $self->new_with_coercions('Paws::Shield::UpdateProtectionGroup', @_);
176 return $self->caller->do_call($self, $call_object);
177 }
178 sub UpdateSubscription {
179 my $self = shift;
180 my $call_object = $self->new_with_coercions('Paws::Shield::UpdateSubscription', @_);
181 return $self->caller->do_call($self, $call_object);
182 }
183
184 sub ListAllAttacks {
185 my $self = shift;
186  
187 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
188 my $result = $self->ListAttacks(@_);
189 my $next_result = $result;
190  
191 if (not defined $callback) {
192 while ($next_result->NextToken) {
193 $next_result = $self->ListAttacks(@_, NextToken => $next_result->NextToken);
194 push @{ $result->AttackSummaries }, @{ $next_result->AttackSummaries };
195 }
196 return $result;
197 } else {
198 while ($result->NextToken) {
199 $callback->($_ => 'AttackSummaries') foreach (@{ $result->AttackSummaries });
200 $result = $self->ListAttacks(@_, NextToken => $result->NextToken);
201 }
202 $callback->($_ => 'AttackSummaries') foreach (@{ $result->AttackSummaries });
203 }
204  
205 return undef
206 }
207 sub ListAllProtections {
208 my $self = shift;
209  
210 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
211 my $result = $self->ListProtections(@_);
212 my $next_result = $result;
213  
214 if (not defined $callback) {
215 while ($next_result->NextToken) {
216 $next_result = $self->ListProtections(@_, NextToken => $next_result->NextToken);
217 push @{ $result->Protections }, @{ $next_result->Protections };
218 }
219 return $result;
220 } else {
221 while ($result->NextToken) {
222 $callback->($_ => 'Protections') foreach (@{ $result->Protections });
223 $result = $self->ListProtections(@_, NextToken => $result->NextToken);
224 }
225 $callback->($_ => 'Protections') foreach (@{ $result->Protections });
226 }
227  
228 return undef
229 }
230  
231  
232 sub operations { qw/AssociateDRTLogBucket AssociateDRTRole AssociateHealthCheck AssociateProactiveEngagementDetails CreateProtection CreateProtectionGroup CreateSubscription DeleteProtection DeleteProtectionGroup DeleteSubscription DescribeAttack DescribeAttackStatistics DescribeDRTAccess DescribeEmergencyContactSettings DescribeProtection DescribeProtectionGroup DescribeSubscription DisableProactiveEngagement DisassociateDRTLogBucket DisassociateDRTRole DisassociateHealthCheck EnableProactiveEngagement GetSubscriptionState ListAttacks ListProtectionGroups ListProtections ListResourcesInProtectionGroup ListTagsForResource TagResource UntagResource UpdateEmergencyContactSettings UpdateProtectionGroup UpdateSubscription / }
233  
234 1;
235  
236 ### main pod documentation begin ###
237  
238 =head1 NAME
239  
240 Paws::Shield - Perl Interface to AWS AWS Shield
241  
242 =head1 SYNOPSIS
243  
244 use Paws;
245  
246 my $obj = Paws->service('Shield');
247 my $res = $obj->Method(
248 Arg1 => $val1,
249 Arg2 => [ 'V1', 'V2' ],
250 # if Arg3 is an object, the HashRef will be used as arguments to the constructor
251 # of the arguments type
252 Arg3 => { Att1 => 'Val1' },
253 # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
254 # the constructor of the arguments type
255 Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
256 );
257  
258 =head1 DESCRIPTION
259  
260 AWS Shield Advanced
261  
262 This is the I<AWS Shield Advanced API Reference>. This guide is for
263 developers who need detailed information about the AWS Shield Advanced
264 API actions, data types, and errors. For detailed information about AWS
265 WAF and AWS Shield Advanced features and an overview of how to use the
266 AWS WAF and AWS Shield Advanced APIs, see the AWS WAF and AWS Shield
267 Developer Guide
268 (https://docs.aws.amazon.com/waf/latest/developerguide/).
269  
270 For the AWS API documentation, see L<https://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02>
271  
272  
273 =head1 METHODS
274  
275 =head2 AssociateDRTLogBucket
276  
277 =over
278  
279 =item LogBucket => Str
280  
281  
282 =back
283  
284 Each argument is described in detail in: L<Paws::Shield::AssociateDRTLogBucket>
285  
286 Returns: a L<Paws::Shield::AssociateDRTLogBucketResponse> instance
287  
288 Authorizes the DDoS Response Team (DRT) to access the specified Amazon
289 S3 bucket containing your AWS WAF logs. You can associate up to 10
290 Amazon S3 buckets with your subscription.
291  
292 To use the services of the DRT and make an C<AssociateDRTLogBucket>
293 request, you must be subscribed to the Business Support plan
294 (https://aws.amazon.com/premiumsupport/business-support/) or the
295 Enterprise Support plan
296 (https://aws.amazon.com/premiumsupport/enterprise-support/).
297  
298  
299 =head2 AssociateDRTRole
300  
301 =over
302  
303 =item RoleArn => Str
304  
305  
306 =back
307  
308 Each argument is described in detail in: L<Paws::Shield::AssociateDRTRole>
309  
310 Returns: a L<Paws::Shield::AssociateDRTRoleResponse> instance
311  
312 Authorizes the DDoS Response Team (DRT), using the specified role, to
313 access your AWS account to assist with DDoS attack mitigation during
314 potential attacks. This enables the DRT to inspect your AWS WAF
315 configuration and create or update AWS WAF rules and web ACLs.
316  
317 You can associate only one C<RoleArn> with your subscription. If you
318 submit an C<AssociateDRTRole> request for an account that already has
319 an associated role, the new C<RoleArn> will replace the existing
320 C<RoleArn>.
321  
322 Prior to making the C<AssociateDRTRole> request, you must attach the
323 AWSShieldDRTAccessPolicy
324 (https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/service-role/AWSShieldDRTAccessPolicy)
325 managed policy to the role you will specify in the request. For more
326 information see Attaching and Detaching IAM Policies. The role must
327 also trust the service principal C< drt.shield.amazonaws.com>. For more
328 information, see IAM JSON Policy Elements: Principal
329 (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html).
330  
331 The DRT will have access only to your AWS WAF and Shield resources. By
332 submitting this request, you authorize the DRT to inspect your AWS WAF
333 and Shield configuration and create and update AWS WAF rules and web
334 ACLs on your behalf. The DRT takes these actions only if explicitly
335 authorized by you.
336  
337 You must have the C<iam:PassRole> permission to make an
338 C<AssociateDRTRole> request. For more information, see Granting a User
339 Permissions to Pass a Role to an AWS Service
340 (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html).
341  
342 To use the services of the DRT and make an C<AssociateDRTRole> request,
343 you must be subscribed to the Business Support plan
344 (https://aws.amazon.com/premiumsupport/business-support/) or the
345 Enterprise Support plan
346 (https://aws.amazon.com/premiumsupport/enterprise-support/).
347  
348  
349 =head2 AssociateHealthCheck
350  
351 =over
352  
353 =item HealthCheckArn => Str
354  
355 =item ProtectionId => Str
356  
357  
358 =back
359  
360 Each argument is described in detail in: L<Paws::Shield::AssociateHealthCheck>
361  
362 Returns: a L<Paws::Shield::AssociateHealthCheckResponse> instance
363  
364 Adds health-based detection to the Shield Advanced protection for a
365 resource. Shield Advanced health-based detection uses the health of
366 your AWS resource to improve responsiveness and accuracy in attack
367 detection and mitigation.
368  
369 You define the health check in Route 53 and then associate it with your
370 Shield Advanced protection. For more information, see Shield Advanced
371 Health-Based Detection
372 (https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html#ddos-advanced-health-check-option)
373 in the AWS WAF and AWS Shield Developer Guide
374 (https://docs.aws.amazon.com/waf/latest/developerguide/).
375  
376  
377 =head2 AssociateProactiveEngagementDetails
378  
379 =over
380  
381 =item EmergencyContactList => ArrayRef[L<Paws::Shield::EmergencyContact>]
382  
383  
384 =back
385  
386 Each argument is described in detail in: L<Paws::Shield::AssociateProactiveEngagementDetails>
387  
388 Returns: a L<Paws::Shield::AssociateProactiveEngagementDetailsResponse> instance
389  
390 Initializes proactive engagement and sets the list of contacts for the
391 DDoS Response Team (DRT) to use. You must provide at least one phone
392 number in the emergency contact list.
393  
394 After you have initialized proactive engagement using this call, to
395 disable or enable proactive engagement, use the calls
396 C<DisableProactiveEngagement> and C<EnableProactiveEngagement>.
397  
398 This call defines the list of email addresses and phone numbers that
399 the DDoS Response Team (DRT) can use to contact you for escalations to
400 the DRT and to initiate proactive customer support.
401  
402 The contacts that you provide in the request replace any contacts that
403 were already defined. If you already have contacts defined and want to
404 use them, retrieve the list using C<DescribeEmergencyContactSettings>
405 and then provide it to this call.
406  
407  
408 =head2 CreateProtection
409  
410 =over
411  
412 =item Name => Str
413  
414 =item ResourceArn => Str
415  
416 =item [Tags => ArrayRef[L<Paws::Shield::Tag>]]
417  
418  
419 =back
420  
421 Each argument is described in detail in: L<Paws::Shield::CreateProtection>
422  
423 Returns: a L<Paws::Shield::CreateProtectionResponse> instance
424  
425 Enables AWS Shield Advanced for a specific AWS resource. The resource
426 can be an Amazon CloudFront distribution, Elastic Load Balancing load
427 balancer, AWS Global Accelerator accelerator, Elastic IP Address, or an
428 Amazon Route 53 hosted zone.
429  
430 You can add protection to only a single resource with each
431 CreateProtection request. If you want to add protection to multiple
432 resources at once, use the AWS WAF console
433 (https://console.aws.amazon.com/waf/). For more information see Getting
434 Started with AWS Shield Advanced
435 (https://docs.aws.amazon.com/waf/latest/developerguide/getting-started-ddos.html)
436 and Add AWS Shield Advanced Protection to more AWS Resources
437 (https://docs.aws.amazon.com/waf/latest/developerguide/configure-new-protection.html).
438  
439  
440 =head2 CreateProtectionGroup
441  
442 =over
443  
444 =item Aggregation => Str
445  
446 =item Pattern => Str
447  
448 =item ProtectionGroupId => Str
449  
450 =item [Members => ArrayRef[Str|Undef]]
451  
452 =item [ResourceType => Str]
453  
454 =item [Tags => ArrayRef[L<Paws::Shield::Tag>]]
455  
456  
457 =back
458  
459 Each argument is described in detail in: L<Paws::Shield::CreateProtectionGroup>
460  
461 Returns: a L<Paws::Shield::CreateProtectionGroupResponse> instance
462  
463 Creates a grouping of protected resources so they can be handled as a
464 collective. This resource grouping improves the accuracy of detection
465 and reduces false positives.
466  
467  
468 =head2 CreateSubscription
469  
470  
471  
472  
473  
474  
475 Each argument is described in detail in: L<Paws::Shield::CreateSubscription>
476  
477 Returns: a L<Paws::Shield::CreateSubscriptionResponse> instance
478  
479 Activates AWS Shield Advanced for an account.
480  
481 When you initally create a subscription, your subscription is set to be
482 automatically renewed at the end of the existing subscription period.
483 You can change this by submitting an C<UpdateSubscription> request.
484  
485  
486 =head2 DeleteProtection
487  
488 =over
489  
490 =item ProtectionId => Str
491  
492  
493 =back
494  
495 Each argument is described in detail in: L<Paws::Shield::DeleteProtection>
496  
497 Returns: a L<Paws::Shield::DeleteProtectionResponse> instance
498  
499 Deletes an AWS Shield Advanced Protection.
500  
501  
502 =head2 DeleteProtectionGroup
503  
504 =over
505  
506 =item ProtectionGroupId => Str
507  
508  
509 =back
510  
511 Each argument is described in detail in: L<Paws::Shield::DeleteProtectionGroup>
512  
513 Returns: a L<Paws::Shield::DeleteProtectionGroupResponse> instance
514  
515 Removes the specified protection group.
516  
517  
518 =head2 DeleteSubscription
519  
520  
521  
522  
523  
524  
525 Each argument is described in detail in: L<Paws::Shield::DeleteSubscription>
526  
527 Returns: a L<Paws::Shield::DeleteSubscriptionResponse> instance
528  
529 Removes AWS Shield Advanced from an account. AWS Shield Advanced
530 requires a 1-year subscription commitment. You cannot delete a
531 subscription prior to the completion of that commitment.
532  
533  
534 =head2 DescribeAttack
535  
536 =over
537  
538 =item AttackId => Str
539  
540  
541 =back
542  
543 Each argument is described in detail in: L<Paws::Shield::DescribeAttack>
544  
545 Returns: a L<Paws::Shield::DescribeAttackResponse> instance
546  
547 Describes the details of a DDoS attack.
548  
549  
550 =head2 DescribeAttackStatistics
551  
552  
553  
554  
555  
556  
557 Each argument is described in detail in: L<Paws::Shield::DescribeAttackStatistics>
558  
559 Returns: a L<Paws::Shield::DescribeAttackStatisticsResponse> instance
560  
561 Provides information about the number and type of attacks AWS Shield
562 has detected in the last year for all resources that belong to your
563 account, regardless of whether you've defined Shield protections for
564 them. This operation is available to Shield customers as well as to
565 Shield Advanced customers.
566  
567 The operation returns data for the time range of midnight UTC, one year
568 ago, to midnight UTC, today. For example, if the current time is
569 C<2020-10-26 15:39:32 PDT>, equal to C<2020-10-26 22:39:32 UTC>, then
570 the time range for the attack data returned is from C<2019-10-26
571 00:00:00 UTC> to C<2020-10-26 00:00:00 UTC>.
572  
573 The time range indicates the period covered by the attack statistics
574 data items.
575  
576  
577 =head2 DescribeDRTAccess
578  
579  
580  
581  
582  
583  
584 Each argument is described in detail in: L<Paws::Shield::DescribeDRTAccess>
585  
586 Returns: a L<Paws::Shield::DescribeDRTAccessResponse> instance
587  
588 Returns the current role and list of Amazon S3 log buckets used by the
589 DDoS Response Team (DRT) to access your AWS account while assisting
590 with attack mitigation.
591  
592  
593 =head2 DescribeEmergencyContactSettings
594  
595  
596  
597  
598  
599  
600 Each argument is described in detail in: L<Paws::Shield::DescribeEmergencyContactSettings>
601  
602 Returns: a L<Paws::Shield::DescribeEmergencyContactSettingsResponse> instance
603  
604 A list of email addresses and phone numbers that the DDoS Response Team
605 (DRT) can use to contact you if you have proactive engagement enabled,
606 for escalations to the DRT and to initiate proactive customer support.
607  
608  
609 =head2 DescribeProtection
610  
611 =over
612  
613 =item [ProtectionId => Str]
614  
615 =item [ResourceArn => Str]
616  
617  
618 =back
619  
620 Each argument is described in detail in: L<Paws::Shield::DescribeProtection>
621  
622 Returns: a L<Paws::Shield::DescribeProtectionResponse> instance
623  
624 Lists the details of a Protection object.
625  
626  
627 =head2 DescribeProtectionGroup
628  
629 =over
630  
631 =item ProtectionGroupId => Str
632  
633  
634 =back
635  
636 Each argument is described in detail in: L<Paws::Shield::DescribeProtectionGroup>
637  
638 Returns: a L<Paws::Shield::DescribeProtectionGroupResponse> instance
639  
640 Returns the specification for the specified protection group.
641  
642  
643 =head2 DescribeSubscription
644  
645  
646  
647  
648  
649  
650 Each argument is described in detail in: L<Paws::Shield::DescribeSubscription>
651  
652 Returns: a L<Paws::Shield::DescribeSubscriptionResponse> instance
653  
654 Provides details about the AWS Shield Advanced subscription for an
655 account.
656  
657  
658 =head2 DisableProactiveEngagement
659  
660  
661  
662  
663  
664  
665 Each argument is described in detail in: L<Paws::Shield::DisableProactiveEngagement>
666  
667 Returns: a L<Paws::Shield::DisableProactiveEngagementResponse> instance
668  
669 Removes authorization from the DDoS Response Team (DRT) to notify
670 contacts about escalations to the DRT and to initiate proactive
671 customer support.
672  
673  
674 =head2 DisassociateDRTLogBucket
675  
676 =over
677  
678 =item LogBucket => Str
679  
680  
681 =back
682  
683 Each argument is described in detail in: L<Paws::Shield::DisassociateDRTLogBucket>
684  
685 Returns: a L<Paws::Shield::DisassociateDRTLogBucketResponse> instance
686  
687 Removes the DDoS Response Team's (DRT) access to the specified Amazon
688 S3 bucket containing your AWS WAF logs.
689  
690 To make a C<DisassociateDRTLogBucket> request, you must be subscribed
691 to the Business Support plan
692 (https://aws.amazon.com/premiumsupport/business-support/) or the
693 Enterprise Support plan
694 (https://aws.amazon.com/premiumsupport/enterprise-support/). However,
695 if you are not subscribed to one of these support plans, but had been
696 previously and had granted the DRT access to your account, you can
697 submit a C<DisassociateDRTLogBucket> request to remove this access.
698  
699  
700 =head2 DisassociateDRTRole
701  
702  
703  
704  
705  
706  
707 Each argument is described in detail in: L<Paws::Shield::DisassociateDRTRole>
708  
709 Returns: a L<Paws::Shield::DisassociateDRTRoleResponse> instance
710  
711 Removes the DDoS Response Team's (DRT) access to your AWS account.
712  
713 To make a C<DisassociateDRTRole> request, you must be subscribed to the
714 Business Support plan
715 (https://aws.amazon.com/premiumsupport/business-support/) or the
716 Enterprise Support plan
717 (https://aws.amazon.com/premiumsupport/enterprise-support/). However,
718 if you are not subscribed to one of these support plans, but had been
719 previously and had granted the DRT access to your account, you can
720 submit a C<DisassociateDRTRole> request to remove this access.
721  
722  
723 =head2 DisassociateHealthCheck
724  
725 =over
726  
727 =item HealthCheckArn => Str
728  
729 =item ProtectionId => Str
730  
731  
732 =back
733  
734 Each argument is described in detail in: L<Paws::Shield::DisassociateHealthCheck>
735  
736 Returns: a L<Paws::Shield::DisassociateHealthCheckResponse> instance
737  
738 Removes health-based detection from the Shield Advanced protection for
739 a resource. Shield Advanced health-based detection uses the health of
740 your AWS resource to improve responsiveness and accuracy in attack
741 detection and mitigation.
742  
743 You define the health check in Route 53 and then associate or
744 disassociate it with your Shield Advanced protection. For more
745 information, see Shield Advanced Health-Based Detection
746 (https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html#ddos-advanced-health-check-option)
747 in the AWS WAF and AWS Shield Developer Guide
748 (https://docs.aws.amazon.com/waf/latest/developerguide/).
749  
750  
751 =head2 EnableProactiveEngagement
752  
753  
754  
755  
756  
757  
758 Each argument is described in detail in: L<Paws::Shield::EnableProactiveEngagement>
759  
760 Returns: a L<Paws::Shield::EnableProactiveEngagementResponse> instance
761  
762 Authorizes the DDoS Response Team (DRT) to use email and phone to
763 notify contacts about escalations to the DRT and to initiate proactive
764 customer support.
765  
766  
767 =head2 GetSubscriptionState
768  
769  
770  
771  
772  
773  
774 Each argument is described in detail in: L<Paws::Shield::GetSubscriptionState>
775  
776 Returns: a L<Paws::Shield::GetSubscriptionStateResponse> instance
777  
778 Returns the C<SubscriptionState>, either C<Active> or C<Inactive>.
779  
780  
781 =head2 ListAttacks
782  
783 =over
784  
785 =item [EndTime => L<Paws::Shield::TimeRange>]
786  
787 =item [MaxResults => Int]
788  
789 =item [NextToken => Str]
790  
791 =item [ResourceArns => ArrayRef[Str|Undef]]
792  
793 =item [StartTime => L<Paws::Shield::TimeRange>]
794  
795  
796 =back
797  
798 Each argument is described in detail in: L<Paws::Shield::ListAttacks>
799  
800 Returns: a L<Paws::Shield::ListAttacksResponse> instance
801  
802 Returns all ongoing DDoS attacks or all DDoS attacks during a specified
803 time period.
804  
805  
806 =head2 ListProtectionGroups
807  
808 =over
809  
810 =item [MaxResults => Int]
811  
812 =item [NextToken => Str]
813  
814  
815 =back
816  
817 Each argument is described in detail in: L<Paws::Shield::ListProtectionGroups>
818  
819 Returns: a L<Paws::Shield::ListProtectionGroupsResponse> instance
820  
821 Retrieves the ProtectionGroup objects for the account.
822  
823  
824 =head2 ListProtections
825  
826 =over
827  
828 =item [MaxResults => Int]
829  
830 =item [NextToken => Str]
831  
832  
833 =back
834  
835 Each argument is described in detail in: L<Paws::Shield::ListProtections>
836  
837 Returns: a L<Paws::Shield::ListProtectionsResponse> instance
838  
839 Lists all Protection objects for the account.
840  
841  
842 =head2 ListResourcesInProtectionGroup
843  
844 =over
845  
846 =item ProtectionGroupId => Str
847  
848 =item [MaxResults => Int]
849  
850 =item [NextToken => Str]
851  
852  
853 =back
854  
855 Each argument is described in detail in: L<Paws::Shield::ListResourcesInProtectionGroup>
856  
857 Returns: a L<Paws::Shield::ListResourcesInProtectionGroupResponse> instance
858  
859 Retrieves the resources that are included in the protection group.
860  
861  
862 =head2 ListTagsForResource
863  
864 =over
865  
866 =item ResourceARN => Str
867  
868  
869 =back
870  
871 Each argument is described in detail in: L<Paws::Shield::ListTagsForResource>
872  
873 Returns: a L<Paws::Shield::ListTagsForResourceResponse> instance
874  
875 Gets information about AWS tags for a specified Amazon Resource Name
876 (ARN) in AWS Shield.
877  
878  
879 =head2 TagResource
880  
881 =over
882  
883 =item ResourceARN => Str
884  
885 =item Tags => ArrayRef[L<Paws::Shield::Tag>]
886  
887  
888 =back
889  
890 Each argument is described in detail in: L<Paws::Shield::TagResource>
891  
892 Returns: a L<Paws::Shield::TagResourceResponse> instance
893  
894 Adds or updates tags for a resource in AWS Shield.
895  
896  
897 =head2 UntagResource
898  
899 =over
900  
901 =item ResourceARN => Str
902  
903 =item TagKeys => ArrayRef[Str|Undef]
904  
905  
906 =back
907  
908 Each argument is described in detail in: L<Paws::Shield::UntagResource>
909  
910 Returns: a L<Paws::Shield::UntagResourceResponse> instance
911  
912 Removes tags from a resource in AWS Shield.
913  
914  
915 =head2 UpdateEmergencyContactSettings
916  
917 =over
918  
919 =item [EmergencyContactList => ArrayRef[L<Paws::Shield::EmergencyContact>]]
920  
921  
922 =back
923  
924 Each argument is described in detail in: L<Paws::Shield::UpdateEmergencyContactSettings>
925  
926 Returns: a L<Paws::Shield::UpdateEmergencyContactSettingsResponse> instance
927  
928 Updates the details of the list of email addresses and phone numbers
929 that the DDoS Response Team (DRT) can use to contact you if you have
930 proactive engagement enabled, for escalations to the DRT and to
931 initiate proactive customer support.
932  
933  
934 =head2 UpdateProtectionGroup
935  
936 =over
937  
938 =item Aggregation => Str
939  
940 =item Pattern => Str
941  
942 =item ProtectionGroupId => Str
943  
944 =item [Members => ArrayRef[Str|Undef]]
945  
946 =item [ResourceType => Str]
947  
948  
949 =back
950  
951 Each argument is described in detail in: L<Paws::Shield::UpdateProtectionGroup>
952  
953 Returns: a L<Paws::Shield::UpdateProtectionGroupResponse> instance
954  
955 Updates an existing protection group. A protection group is a grouping
956 of protected resources so they can be handled as a collective. This
957 resource grouping improves the accuracy of detection and reduces false
958 positives.
959  
960  
961 =head2 UpdateSubscription
962  
963 =over
964  
965 =item [AutoRenew => Str]
966  
967  
968 =back
969  
970 Each argument is described in detail in: L<Paws::Shield::UpdateSubscription>
971  
972 Returns: a L<Paws::Shield::UpdateSubscriptionResponse> instance
973  
974 Updates the details of an existing subscription. Only enter values for
975 parameters you want to change. Empty parameters are not updated.
976  
977  
978  
979  
980 =head1 PAGINATORS
981  
982 Paginator methods are helpers that repetively call methods that return partial results
983  
984 =head2 ListAllAttacks(sub { },[EndTime => L<Paws::Shield::TimeRange>, MaxResults => Int, NextToken => Str, ResourceArns => ArrayRef[Str|Undef], StartTime => L<Paws::Shield::TimeRange>])
985  
986 =head2 ListAllAttacks([EndTime => L<Paws::Shield::TimeRange>, MaxResults => Int, NextToken => Str, ResourceArns => ArrayRef[Str|Undef], StartTime => L<Paws::Shield::TimeRange>])
987  
988  
989 If passed a sub as first parameter, it will call the sub for each element found in :
990  
991 - AttackSummaries, passing the object as the first parameter, and the string 'AttackSummaries' as the second parameter
992  
993 If not, it will return a a L<Paws::Shield::ListAttacksResponse> 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.
994  
995  
996 =head2 ListAllProtections(sub { },[MaxResults => Int, NextToken => Str])
997  
998 =head2 ListAllProtections([MaxResults => Int, NextToken => Str])
999  
1000  
1001 If passed a sub as first parameter, it will call the sub for each element found in :
1002  
1003 - Protections, passing the object as the first parameter, and the string 'Protections' as the second parameter
1004  
1005 If not, it will return a a L<Paws::Shield::ListProtectionsResponse> 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.
1006  
1007  
1008  
1009  
1010  
1011 =head1 SEE ALSO
1012  
1013 This service class forms part of L<Paws>
1014  
1015 =head1 BUGS and CONTRIBUTIONS
1016  
1017 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
1018  
1019 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
1020  
1021 =cut
1022