blib/lib/Paws/CloudTrail.pm

filter: Statementstmt 11.9% 17 / 142 Branchbran 0.0% 0 / 32 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 19.3% 6 / 31 Podpod 78.5% 22 / 28 totaltotal 19.3% 45 / 233 CC 25 SCAR 33.8
CC
25
Cov
10%
ListAllPublicKeys
56.0
ListAllTags
56.0
ListAllTrails
56.0
CRAP 29.4
« blib/lib/Paws/Batch.pm ↑ Summary blib/lib/Paws/AutoScaling.pm »
1 package Paws::CloudTrail;
2 1 ▶ use Moose;
Subroutine BEGIN: called CC=1 SCAR=0.0
3 2 ▶ sub service { 'cloudtrail' }
Subroutine service: called CC=1 SCAR=0.0
Pod undocumented
4 0 ▶ sub signing_name { 'cloudtrail' }
Subroutine signing_name: not called CC=1 SCAR=6.9
Pod undocumented
5 0 ▶ sub version { '2013-11-01' }
Subroutine version: not called CC=1 SCAR=6.9
Pod undocumented
6 0 ▶ sub target_prefix { 'com.amazonaws.cloudtrail.v20131101.CloudTrail_20131101' }
Subroutine target_prefix: not called CC=1 SCAR=6.9
Pod undocumented
7 0 ▶ sub json_version { "1.1" }
Subroutine json_version: not called CC=1 SCAR=6.9
Pod undocumented
8 1 has max_attempts => (is => 'ro', isa => 'Int', default => 5);
9 2 ▶ has retry => (is => 'ro', isa => 'HashRef', default => sub {
Subroutine __ANON__: called CC=1 SCAR=0.0
10 2 { base => 'rand', type => 'exponential', growth_factor => 2 }
11 1 });
12 2 ▶ has retriables => (is => 'ro', isa => 'ArrayRef', default => sub { [
Subroutine __ANON__: called CC=1 SCAR=0.0
13 2 ] });
14  
15 1 with 'Paws::API::Caller', 'Paws::API::EndpointResolver', 'Paws::Net::V4Signature', 'Paws::Net::JsonCaller';
16  
17
18 0 ▶ sub AddTags {
Subroutine AddTags: not called CC=1 SCAR=6.9
Pod documented
19 0 my $self = shift;
20 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::AddTags', @_);
21 0 return $self->caller->do_call($self, $call_object);
22 }
23 0 ▶ sub CreateTrail {
Subroutine CreateTrail: not called CC=1 SCAR=6.9
Pod documented
24 0 my $self = shift;
25 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::CreateTrail', @_);
26 0 return $self->caller->do_call($self, $call_object);
27 }
28 0 ▶ sub DeleteTrail {
Subroutine DeleteTrail: not called CC=1 SCAR=6.9
Pod documented
29 0 my $self = shift;
30 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::DeleteTrail', @_);
31 0 return $self->caller->do_call($self, $call_object);
32 }
33 0 ▶ sub DescribeTrails {
Subroutine DescribeTrails: not called CC=1 SCAR=6.9
Pod documented
34 0 my $self = shift;
35 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::DescribeTrails', @_);
36 0 return $self->caller->do_call($self, $call_object);
37 }
38 0 ▶ sub GetEventSelectors {
Subroutine GetEventSelectors: not called CC=1 SCAR=6.9
Pod documented
39 0 my $self = shift;
40 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::GetEventSelectors', @_);
41 0 return $self->caller->do_call($self, $call_object);
42 }
43 0 ▶ sub GetInsightSelectors {
Subroutine GetInsightSelectors: not called CC=1 SCAR=6.9
Pod documented
44 0 my $self = shift;
45 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::GetInsightSelectors', @_);
46 0 return $self->caller->do_call($self, $call_object);
47 }
48 0 ▶ sub GetTrail {
Subroutine GetTrail: not called CC=1 SCAR=6.9
Pod documented
49 0 my $self = shift;
50 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::GetTrail', @_);
51 0 return $self->caller->do_call($self, $call_object);
52 }
53 1 ▶ sub GetTrailStatus {
Subroutine GetTrailStatus: called CC=1 SCAR=0.0
Pod documented
54 1 my $self = shift;
55 1 my $call_object = $self->new_with_coercions('Paws::CloudTrail::GetTrailStatus', @_);
56 1 return $self->caller->do_call($self, $call_object);
57 }
58 0 ▶ sub ListPublicKeys {
Subroutine ListPublicKeys: not called CC=1 SCAR=6.9
Pod documented
59 0 my $self = shift;
60 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::ListPublicKeys', @_);
61 0 return $self->caller->do_call($self, $call_object);
62 }
63 0 ▶ sub ListTags {
Subroutine ListTags: not called CC=1 SCAR=6.9
Pod documented
64 0 my $self = shift;
65 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::ListTags', @_);
66 0 return $self->caller->do_call($self, $call_object);
67 }
68 0 ▶ sub ListTrails {
Subroutine ListTrails: not called CC=1 SCAR=6.9
Pod documented
69 0 my $self = shift;
70 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::ListTrails', @_);
71 0 return $self->caller->do_call($self, $call_object);
72 }
73 1 ▶ sub LookupEvents {
Subroutine LookupEvents: called CC=1 SCAR=0.0
Pod documented
74 1 my $self = shift;
75 1 my $call_object = $self->new_with_coercions('Paws::CloudTrail::LookupEvents', @_);
76 1 return $self->caller->do_call($self, $call_object);
77 }
78 0 ▶ sub PutEventSelectors {
Subroutine PutEventSelectors: not called CC=1 SCAR=6.9
Pod documented
79 0 my $self = shift;
80 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::PutEventSelectors', @_);
81 0 return $self->caller->do_call($self, $call_object);
82 }
83 0 ▶ sub PutInsightSelectors {
Subroutine PutInsightSelectors: not called CC=1 SCAR=6.9
Pod documented
84 0 my $self = shift;
85 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::PutInsightSelectors', @_);
86 0 return $self->caller->do_call($self, $call_object);
87 }
88 0 ▶ sub RemoveTags {
Subroutine RemoveTags: not called CC=1 SCAR=6.9
Pod documented
89 0 my $self = shift;
90 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::RemoveTags', @_);
91 0 return $self->caller->do_call($self, $call_object);
92 }
93 0 ▶ sub StartLogging {
Subroutine StartLogging: not called CC=1 SCAR=6.9
Pod documented
94 0 my $self = shift;
95 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::StartLogging', @_);
96 0 return $self->caller->do_call($self, $call_object);
97 }
98 0 ▶ sub StopLogging {
Subroutine StopLogging: not called CC=1 SCAR=6.9
Pod documented
99 0 my $self = shift;
100 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::StopLogging', @_);
101 0 return $self->caller->do_call($self, $call_object);
102 }
103 0 ▶ sub UpdateTrail {
Subroutine UpdateTrail: not called CC=1 SCAR=6.9
Pod documented
104 0 my $self = shift;
105 0 my $call_object = $self->new_with_coercions('Paws::CloudTrail::UpdateTrail', @_);
106 0 return $self->caller->do_call($self, $call_object);
107 }
108
109 0 ▶ sub ListAllPublicKeys {
Subroutine ListAllPublicKeys: not called CC=7 SCAR=40.3
Pod documented
110 0 my $self = shift;
111  
112 0 ▶ my $callback = shift @_ if (ref($_[0]) eq 'CODE');
Branch: 1 branch
BranchTrueFalseTotal
if ref $_[0] eq "CODE" 0 0 0
113 0 my $result = $self->ListPublicKeys(@_);
114 0 my $next_result = $result;
115  
116 0 ▶ if (not defined $callback) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $callback) { } 0 0 0
117 0 ▶ while ($next_result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($next_result->NextToken) 0 0 0
118 0 $next_result = $self->ListPublicKeys(@_, NextToken => $next_result->NextToken);
119 0 push @{ $result->PublicKeyList }, @{ $next_result->PublicKeyList };
120 }
121 0 return $result;
122 } else {
123 0 ▶ while ($result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($result->NextToken) 0 0 0
124 0 $callback->($_ => 'PublicKeyList') foreach (@{ $result->PublicKeyList });
125 0 $result = $self->ListPublicKeys(@_, NextToken => $result->NextToken);
126 }
127 0 $callback->($_ => 'PublicKeyList') foreach (@{ $result->PublicKeyList });
128 }
129  
130 return undef
131 0 }
132 0 ▶ sub ListAllTags {
Subroutine ListAllTags: not called CC=7 SCAR=40.3
Pod documented
133 0 my $self = shift;
134  
135 0 ▶ my $callback = shift @_ if (ref($_[0]) eq 'CODE');
Branch: 1 branch
BranchTrueFalseTotal
if ref $_[0] eq "CODE" 0 0 0
136 0 my $result = $self->ListTags(@_);
137 0 my $next_result = $result;
138  
139 0 ▶ if (not defined $callback) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $callback) { } 0 0 0
140 0 ▶ while ($next_result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($next_result->NextToken) 0 0 0
141 0 $next_result = $self->ListTags(@_, NextToken => $next_result->NextToken);
142 0 push @{ $result->ResourceTagList }, @{ $next_result->ResourceTagList };
143 }
144 0 return $result;
145 } else {
146 0 ▶ while ($result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($result->NextToken) 0 0 0
147 0 $callback->($_ => 'ResourceTagList') foreach (@{ $result->ResourceTagList });
148 0 $result = $self->ListTags(@_, NextToken => $result->NextToken);
149 }
150 0 $callback->($_ => 'ResourceTagList') foreach (@{ $result->ResourceTagList });
151 }
152  
153 return undef
154 0 }
155 0 ▶ sub ListAllTrails {
Subroutine ListAllTrails: not called CC=7 SCAR=40.3
Pod documented
156 0 my $self = shift;
157  
158 0 ▶ my $callback = shift @_ if (ref($_[0]) eq 'CODE');
Branch: 1 branch
BranchTrueFalseTotal
if ref $_[0] eq "CODE" 0 0 0
159 0 my $result = $self->ListTrails(@_);
160 0 my $next_result = $result;
161  
162 0 ▶ if (not defined $callback) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $callback) { } 0 0 0
163 0 ▶ while ($next_result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($next_result->NextToken) 0 0 0
164 0 $next_result = $self->ListTrails(@_, NextToken => $next_result->NextToken);
165 0 push @{ $result->Trails }, @{ $next_result->Trails };
166 }
167 0 return $result;
168 } else {
169 0 ▶ while ($result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($result->NextToken) 0 0 0
170 0 $callback->($_ => 'Trails') foreach (@{ $result->Trails });
171 0 $result = $self->ListTrails(@_, NextToken => $result->NextToken);
172 }
173 0 $callback->($_ => 'Trails') foreach (@{ $result->Trails });
174 }
175  
176 return undef
177 0 }
178 0 ▶ sub LookupAllEvents {
Subroutine LookupAllEvents: not called CC=7 SCAR=40.3
Pod documented
179 0 my $self = shift;
180  
181 0 ▶ my $callback = shift @_ if (ref($_[0]) eq 'CODE');
Branch: 1 branch
BranchTrueFalseTotal
if ref $_[0] eq "CODE" 0 0 0
182 0 my $result = $self->LookupEvents(@_);
183 0 my $next_result = $result;
184  
185 0 ▶ if (not defined $callback) {
Branch: 1 branch
BranchTrueFalseTotal
if (not defined $callback) { } 0 0 0
186 0 ▶ while ($next_result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($next_result->NextToken) 0 0 0
187 0 $next_result = $self->LookupEvents(@_, NextToken => $next_result->NextToken);
188 0 push @{ $result->Events }, @{ $next_result->Events };
189 }
190 0 return $result;
191 } else {
192 0 ▶ while ($result->NextToken) {
Branch: 1 branch
BranchTrueFalseTotal
if ($result->NextToken) 0 0 0
193 0 $callback->($_ => 'Events') foreach (@{ $result->Events });
194 0 $result = $self->LookupEvents(@_, NextToken => $result->NextToken);
195 }
196 0 $callback->($_ => 'Events') foreach (@{ $result->Events });
197 }
198  
199 return undef
200 0 }
201  
202  
203 0 ▶ sub operations { qw/AddTags CreateTrail DeleteTrail DescribeTrails GetEventSelectors GetInsightSelectors GetTrail GetTrailStatus ListPublicKeys ListTags ListTrails LookupEvents PutEventSelectors PutInsightSelectors RemoveTags StartLogging StopLogging UpdateTrail / }
Subroutine operations: not called CC=1 SCAR=6.9
Pod undocumented
204  
205 1 1;
206  
207 ### main pod documentation begin ###
208  
209 =head1 NAME
210  
211 Paws::CloudTrail - Perl Interface to AWS AWS CloudTrail
212  
213 =head1 SYNOPSIS
214  
215 use Paws;
216  
217 my $obj = Paws->service('CloudTrail');
218 my $res = $obj->Method(
219 Arg1 => $val1,
220 Arg2 => [ 'V1', 'V2' ],
221 # if Arg3 is an object, the HashRef will be used as arguments to the constructor
222 # of the arguments type
223 Arg3 => { Att1 => 'Val1' },
224 # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
225 # the constructor of the arguments type
226 Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
227 );
228  
229 =head1 DESCRIPTION
230  
231 AWS CloudTrail
232  
233 This is the CloudTrail API Reference. It provides descriptions of
234 actions, data types, common parameters, and common errors for
235 CloudTrail.
236  
237 CloudTrail is a web service that records AWS API calls for your AWS
238 account and delivers log files to an Amazon S3 bucket. The recorded
239 information includes the identity of the user, the start time of the
240 AWS API call, the source IP address, the request parameters, and the
241 response elements returned by the service.
242  
243 As an alternative to the API, you can use one of the AWS SDKs, which
244 consist of libraries and sample code for various programming languages
245 and platforms (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide
246 a convenient way to create programmatic access to AWSCloudTrail. For
247 example, the SDKs take care of cryptographically signing requests,
248 managing errors, and retrying requests automatically. For information
249 about the AWS SDKs, including how to download and install them, see the
250 Tools for Amazon Web Services page (http://aws.amazon.com/tools/).
251  
252 See the AWS CloudTrail User Guide
253 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)
254 for information about the data that is included with each AWS API call
255 listed in the log files.
256  
257 For the AWS API documentation, see L<https://docs.aws.amazon.com/goto/WebAPI/cloudtrail-2013-11-01>
258  
259  
260 =head1 METHODS
261  
262 =head2 AddTags
263  
264 =over
265  
266 =item ResourceId => Str
267  
268 =item [TagsList => ArrayRef[L<Paws::CloudTrail::Tag>]]
269  
270  
271 =back
272  
273 Each argument is described in detail in: L<Paws::CloudTrail::AddTags>
274  
275 Returns: a L<Paws::CloudTrail::AddTagsResponse> instance
276  
277 Adds one or more tags to a trail, up to a limit of 50. Overwrites an
278 existing tag's value when a new value is specified for an existing tag
279 key. Tag key names must be unique for a trail; you cannot have two keys
280 with the same name but different values. If you specify a key without a
281 value, the tag will be created with the specified key and a value of
282 null. You can tag a trail that applies to all AWS Regions only from the
283 Region in which the trail was created (also known as its home region).
284  
285  
286 =head2 CreateTrail
287  
288 =over
289  
290 =item Name => Str
291  
292 =item S3BucketName => Str
293  
294 =item [CloudWatchLogsLogGroupArn => Str]
295  
296 =item [CloudWatchLogsRoleArn => Str]
297  
298 =item [EnableLogFileValidation => Bool]
299  
300 =item [IncludeGlobalServiceEvents => Bool]
301  
302 =item [IsMultiRegionTrail => Bool]
303  
304 =item [IsOrganizationTrail => Bool]
305  
306 =item [KmsKeyId => Str]
307  
308 =item [S3KeyPrefix => Str]
309  
310 =item [SnsTopicName => Str]
311  
312 =item [TagsList => ArrayRef[L<Paws::CloudTrail::Tag>]]
313  
314  
315 =back
316  
317 Each argument is described in detail in: L<Paws::CloudTrail::CreateTrail>
318  
319 Returns: a L<Paws::CloudTrail::CreateTrailResponse> instance
320  
321 Creates a trail that specifies the settings for delivery of log data to
322 an Amazon S3 bucket.
323  
324  
325 =head2 DeleteTrail
326  
327 =over
328  
329 =item Name => Str
330  
331  
332 =back
333  
334 Each argument is described in detail in: L<Paws::CloudTrail::DeleteTrail>
335  
336 Returns: a L<Paws::CloudTrail::DeleteTrailResponse> instance
337  
338 Deletes a trail. This operation must be called from the region in which
339 the trail was created. C<DeleteTrail> cannot be called on the shadow
340 trails (replicated trails in other regions) of a trail that is enabled
341 in all regions.
342  
343  
344 =head2 DescribeTrails
345  
346 =over
347  
348 =item [IncludeShadowTrails => Bool]
349  
350 =item [TrailNameList => ArrayRef[Str|Undef]]
351  
352  
353 =back
354  
355 Each argument is described in detail in: L<Paws::CloudTrail::DescribeTrails>
356  
357 Returns: a L<Paws::CloudTrail::DescribeTrailsResponse> instance
358  
359 Retrieves settings for one or more trails associated with the current
360 region for your account.
361  
362  
363 =head2 GetEventSelectors
364  
365 =over
366  
367 =item TrailName => Str
368  
369  
370 =back
371  
372 Each argument is described in detail in: L<Paws::CloudTrail::GetEventSelectors>
373  
374 Returns: a L<Paws::CloudTrail::GetEventSelectorsResponse> instance
375  
376 Describes the settings for the event selectors that you configured for
377 your trail. The information returned for your event selectors includes
378 the following:
379  
380 =over
381  
382 =item *
383  
384 If your event selector includes read-only events, write-only events, or
385 all events. This applies to both management events and data events.
386  
387 =item *
388  
389 If your event selector includes management events.
390  
391 =item *
392  
393 If your event selector includes data events, the resources on which you
394 are logging data events.
395  
396 =back
397  
398 For more information, see Logging Data and Management Events for Trails
399 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html)
400 in the I<AWS CloudTrail User Guide>.
401  
402  
403 =head2 GetInsightSelectors
404  
405 =over
406  
407 =item TrailName => Str
408  
409  
410 =back
411  
412 Each argument is described in detail in: L<Paws::CloudTrail::GetInsightSelectors>
413  
414 Returns: a L<Paws::CloudTrail::GetInsightSelectorsResponse> instance
415  
416 Describes the settings for the Insights event selectors that you
417 configured for your trail. C<GetInsightSelectors> shows if CloudTrail
418 Insights event logging is enabled on the trail, and if it is, which
419 insight types are enabled. If you run C<GetInsightSelectors> on a trail
420 that does not have Insights events enabled, the operation throws the
421 exception C<InsightNotEnabledException>
422  
423 For more information, see Logging CloudTrail Insights Events for Trails
424 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html)
425 in the I<AWS CloudTrail User Guide>.
426  
427  
428 =head2 GetTrail
429  
430 =over
431  
432 =item Name => Str
433  
434  
435 =back
436  
437 Each argument is described in detail in: L<Paws::CloudTrail::GetTrail>
438  
439 Returns: a L<Paws::CloudTrail::GetTrailResponse> instance
440  
441 Returns settings information for a specified trail.
442  
443  
444 =head2 GetTrailStatus
445  
446 =over
447  
448 =item Name => Str
449  
450  
451 =back
452  
453 Each argument is described in detail in: L<Paws::CloudTrail::GetTrailStatus>
454  
455 Returns: a L<Paws::CloudTrail::GetTrailStatusResponse> instance
456  
457 Returns a JSON-formatted list of information about the specified trail.
458 Fields include information on delivery errors, Amazon SNS and Amazon S3
459 errors, and start and stop logging times for each trail. This operation
460 returns trail status from a single region. To return trail status from
461 all regions, you must call the operation on each region.
462  
463  
464 =head2 ListPublicKeys
465  
466 =over
467  
468 =item [EndTime => Str]
469  
470 =item [NextToken => Str]
471  
472 =item [StartTime => Str]
473  
474  
475 =back
476  
477 Each argument is described in detail in: L<Paws::CloudTrail::ListPublicKeys>
478  
479 Returns: a L<Paws::CloudTrail::ListPublicKeysResponse> instance
480  
481 Returns all public keys whose private keys were used to sign the digest
482 files within the specified time range. The public key is needed to
483 validate digest files that were signed with its corresponding private
484 key.
485  
486 CloudTrail uses different private/public key pairs per region. Each
487 digest file is signed with a private key unique to its region.
488 Therefore, when you validate a digest file from a particular region,
489 you must look in the same region for its corresponding public key.
490  
491  
492 =head2 ListTags
493  
494 =over
495  
496 =item ResourceIdList => ArrayRef[Str|Undef]
497  
498 =item [NextToken => Str]
499  
500  
501 =back
502  
503 Each argument is described in detail in: L<Paws::CloudTrail::ListTags>
504  
505 Returns: a L<Paws::CloudTrail::ListTagsResponse> instance
506  
507 Lists the tags for the trail in the current region.
508  
509  
510 =head2 ListTrails
511  
512 =over
513  
514 =item [NextToken => Str]
515  
516  
517 =back
518  
519 Each argument is described in detail in: L<Paws::CloudTrail::ListTrails>
520  
521 Returns: a L<Paws::CloudTrail::ListTrailsResponse> instance
522  
523 Lists trails that are in the current account.
524  
525  
526 =head2 LookupEvents
527  
528 =over
529  
530 =item [EndTime => Str]
531  
532 =item [EventCategory => Str]
533  
534 =item [LookupAttributes => ArrayRef[L<Paws::CloudTrail::LookupAttribute>]]
535  
536 =item [MaxResults => Int]
537  
538 =item [NextToken => Str]
539  
540 =item [StartTime => Str]
541  
542  
543 =back
544  
545 Each argument is described in detail in: L<Paws::CloudTrail::LookupEvents>
546  
547 Returns: a L<Paws::CloudTrail::LookupEventsResponse> instance
548  
549 Looks up management events
550 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-management-events)
551 or CloudTrail Insights events
552 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-insights-events)
553 that are captured by CloudTrail. You can look up events that occurred
554 in a region within the last 90 days. Lookup supports the following
555 attributes for management events:
556  
557 =over
558  
559 =item *
560  
561 AWS access key
562  
563 =item *
564  
565 Event ID
566  
567 =item *
568  
569 Event name
570  
571 =item *
572  
573 Event source
574  
575 =item *
576  
577 Read only
578  
579 =item *
580  
581 Resource name
582  
583 =item *
584  
585 Resource type
586  
587 =item *
588  
589 User name
590  
591 =back
592  
593 Lookup supports the following attributes for Insights events:
594  
595 =over
596  
597 =item *
598  
599 Event ID
600  
601 =item *
602  
603 Event name
604  
605 =item *
606  
607 Event source
608  
609 =back
610  
611 All attributes are optional. The default number of results returned is
612 50, with a maximum of 50 possible. The response includes a token that
613 you can use to get the next page of results.
614  
615 The rate of lookup requests is limited to two per second, per account,
616 per region. If this limit is exceeded, a throttling error occurs.
617  
618  
619 =head2 PutEventSelectors
620  
621 =over
622  
623 =item TrailName => Str
624  
625 =item [AdvancedEventSelectors => ArrayRef[L<Paws::CloudTrail::AdvancedEventSelector>]]
626  
627 =item [EventSelectors => ArrayRef[L<Paws::CloudTrail::EventSelector>]]
628  
629  
630 =back
631  
632 Each argument is described in detail in: L<Paws::CloudTrail::PutEventSelectors>
633  
634 Returns: a L<Paws::CloudTrail::PutEventSelectorsResponse> instance
635  
636 Configures an event selector or advanced event selectors for your
637 trail. Use event selectors or advanced event selectors to specify
638 management and data event settings for your trail. By default, trails
639 created without specific event selectors are configured to log all read
640 and write management events, and no data events.
641  
642 When an event occurs in your account, CloudTrail evaluates the event
643 selectors or advanced event selectors in all trails. For each trail, if
644 the event matches any event selector, the trail processes and logs the
645 event. If the event doesn't match any event selector, the trail doesn't
646 log the event.
647  
648 Example
649  
650 =over
651  
652 =item 1.
653  
654 You create an event selector for a trail and specify that you want
655 write-only events.
656  
657 =item 2.
658  
659 The EC2 C<GetConsoleOutput> and C<RunInstances> API operations occur in
660 your account.
661  
662 =item 3.
663  
664 CloudTrail evaluates whether the events match your event selectors.
665  
666 =item 4.
667  
668 The C<RunInstances> is a write-only event and it matches your event
669 selector. The trail logs the event.
670  
671 =item 5.
672  
673 The C<GetConsoleOutput> is a read-only event that doesn't match your
674 event selector. The trail doesn't log the event.
675  
676 =back
677  
678 The C<PutEventSelectors> operation must be called from the region in
679 which the trail was created; otherwise, an
680 C<InvalidHomeRegionException> exception is thrown.
681  
682 You can configure up to five event selectors for each trail. For more
683 information, see Logging data and management events for trails
684 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html)
685 and Quotas in AWS CloudTrail
686 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html)
687 in the I<AWS CloudTrail User Guide>.
688  
689 You can add advanced event selectors, and conditions for your advanced
690 event selectors, up to a maximum of 500 values for all conditions and
691 selectors on a trail. You can use either C<AdvancedEventSelectors> or
692 C<EventSelectors>, but not both. If you apply C<AdvancedEventSelectors>
693 to a trail, any existing C<EventSelectors> are overwritten. For more
694 information about advanced event selectors, see Logging data events for
695 trails
696 (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)
697 in the I<AWS CloudTrail User Guide>.
698  
699  
700 =head2 PutInsightSelectors
701  
702 =over
703  
704 =item InsightSelectors => ArrayRef[L<Paws::CloudTrail::InsightSelector>]
705  
706 =item TrailName => Str
707  
708  
709 =back
710  
711 Each argument is described in detail in: L<Paws::CloudTrail::PutInsightSelectors>
712  
713 Returns: a L<Paws::CloudTrail::PutInsightSelectorsResponse> instance
714  
715 Lets you enable Insights event logging by specifying the Insights
716 selectors that you want to enable on an existing trail. You also use
717 C<PutInsightSelectors> to turn off Insights event logging, by passing
718 an empty list of insight types. In this release, only
719 C<ApiCallRateInsight> is supported as an Insights selector.
720  
721  
722 =head2 RemoveTags
723  
724 =over
725  
726 =item ResourceId => Str
727  
728 =item [TagsList => ArrayRef[L<Paws::CloudTrail::Tag>]]
729  
730  
731 =back
732  
733 Each argument is described in detail in: L<Paws::CloudTrail::RemoveTags>
734  
735 Returns: a L<Paws::CloudTrail::RemoveTagsResponse> instance
736  
737 Removes the specified tags from a trail.
738  
739  
740 =head2 StartLogging
741  
742 =over
743  
744 =item Name => Str
745  
746  
747 =back
748  
749 Each argument is described in detail in: L<Paws::CloudTrail::StartLogging>
750  
751 Returns: a L<Paws::CloudTrail::StartLoggingResponse> instance
752  
753 Starts the recording of AWS API calls and log file delivery for a
754 trail. For a trail that is enabled in all regions, this operation must
755 be called from the region in which the trail was created. This
756 operation cannot be called on the shadow trails (replicated trails in
757 other regions) of a trail that is enabled in all regions.
758  
759  
760 =head2 StopLogging
761  
762 =over
763  
764 =item Name => Str
765  
766  
767 =back
768  
769 Each argument is described in detail in: L<Paws::CloudTrail::StopLogging>
770  
771 Returns: a L<Paws::CloudTrail::StopLoggingResponse> instance
772  
773 Suspends the recording of AWS API calls and log file delivery for the
774 specified trail. Under most circumstances, there is no need to use this
775 action. You can update a trail without stopping it first. This action
776 is the only way to stop recording. For a trail enabled in all regions,
777 this operation must be called from the region in which the trail was
778 created, or an C<InvalidHomeRegionException> will occur. This operation
779 cannot be called on the shadow trails (replicated trails in other
780 regions) of a trail enabled in all regions.
781  
782  
783 =head2 UpdateTrail
784  
785 =over
786  
787 =item Name => Str
788  
789 =item [CloudWatchLogsLogGroupArn => Str]
790  
791 =item [CloudWatchLogsRoleArn => Str]
792  
793 =item [EnableLogFileValidation => Bool]
794  
795 =item [IncludeGlobalServiceEvents => Bool]
796  
797 =item [IsMultiRegionTrail => Bool]
798  
799 =item [IsOrganizationTrail => Bool]
800  
801 =item [KmsKeyId => Str]
802  
803 =item [S3BucketName => Str]
804  
805 =item [S3KeyPrefix => Str]
806  
807 =item [SnsTopicName => Str]
808  
809  
810 =back
811  
812 Each argument is described in detail in: L<Paws::CloudTrail::UpdateTrail>
813  
814 Returns: a L<Paws::CloudTrail::UpdateTrailResponse> instance
815  
816 Updates the settings that specify delivery of log files. Changes to a
817 trail do not require stopping the CloudTrail service. Use this action
818 to designate an existing bucket for log delivery. If the existing
819 bucket has previously been a target for CloudTrail log files, an IAM
820 policy exists for the bucket. C<UpdateTrail> must be called from the
821 region in which the trail was created; otherwise, an
822 C<InvalidHomeRegionException> is thrown.
823  
824  
825  
826  
827 =head1 PAGINATORS
828  
829 Paginator methods are helpers that repetively call methods that return partial results
830  
831 =head2 ListAllPublicKeys(sub { },[EndTime => Str, NextToken => Str, StartTime => Str])
832  
833 =head2 ListAllPublicKeys([EndTime => Str, NextToken => Str, StartTime => Str])
834  
835  
836 If passed a sub as first parameter, it will call the sub for each element found in :
837  
838 - PublicKeyList, passing the object as the first parameter, and the string 'PublicKeyList' as the second parameter
839  
840 If not, it will return a a L<Paws::CloudTrail::ListPublicKeysResponse> 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.
841  
842  
843 =head2 ListAllTags(sub { },ResourceIdList => ArrayRef[Str|Undef], [NextToken => Str])
844  
845 =head2 ListAllTags(ResourceIdList => ArrayRef[Str|Undef], [NextToken => Str])
846  
847  
848 If passed a sub as first parameter, it will call the sub for each element found in :
849  
850 - ResourceTagList, passing the object as the first parameter, and the string 'ResourceTagList' as the second parameter
851  
852 If not, it will return a a L<Paws::CloudTrail::ListTagsResponse> 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.
853  
854  
855 =head2 ListAllTrails(sub { },[NextToken => Str])
856  
857 =head2 ListAllTrails([NextToken => Str])
858  
859  
860 If passed a sub as first parameter, it will call the sub for each element found in :
861  
862 - Trails, passing the object as the first parameter, and the string 'Trails' as the second parameter
863  
864 If not, it will return a a L<Paws::CloudTrail::ListTrailsResponse> 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.
865  
866  
867 =head2 LookupAllEvents(sub { },[EndTime => Str, EventCategory => Str, LookupAttributes => ArrayRef[L<Paws::CloudTrail::LookupAttribute>], MaxResults => Int, NextToken => Str, StartTime => Str])
868  
869 =head2 LookupAllEvents([EndTime => Str, EventCategory => Str, LookupAttributes => ArrayRef[L<Paws::CloudTrail::LookupAttribute>], MaxResults => Int, NextToken => Str, StartTime => Str])
870  
871  
872 If passed a sub as first parameter, it will call the sub for each element found in :
873  
874 - Events, passing the object as the first parameter, and the string 'Events' as the second parameter
875  
876 If not, it will return a a L<Paws::CloudTrail::LookupEventsResponse> 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.
877  
878  
879  
880  
881  
882 =head1 SEE ALSO
883  
884 This service class forms part of L<Paws>
885  
886 =head1 BUGS and CONTRIBUTIONS
887  
888 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
889  
890 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
891  
892 =cut
893  
« blib/lib/Paws/Batch.pm ↑ Summary blib/lib/Paws/AutoScaling.pm »