blib/lib/Paws/CloudWatchEvents.pm untested

filter: Statementstmt 0.0% 0 / 228 Branchbran 0.0% 0 / 12 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 0.0% 0 / 61 Podpod 0.0% 0 / 60 totaltotal 0.0% 0 / 361 CC 7 SCAR 12.1
CC
7
Cov
0%
ListAllRuleNamesByTarget
12.0
ListAllRules
12.0
ListAllTargetsByRule
12.0
CRAP 3.3
1 package Paws::CloudWatchEvents;
2 use Moose;
3 sub service { 'events' }
4 sub signing_name { 'events' }
5 sub version { '2015-10-07' }
6 sub target_prefix { 'AWSEvents' }
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 ActivateEventSource {
19 my $self = shift;
20 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ActivateEventSource', @_);
21 return $self->caller->do_call($self, $call_object);
22 }
23 sub CancelReplay {
24 my $self = shift;
25 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::CancelReplay', @_);
26 return $self->caller->do_call($self, $call_object);
27 }
28 sub CreateApiDestination {
29 my $self = shift;
30 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::CreateApiDestination', @_);
31 return $self->caller->do_call($self, $call_object);
32 }
33 sub CreateArchive {
34 my $self = shift;
35 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::CreateArchive', @_);
36 return $self->caller->do_call($self, $call_object);
37 }
38 sub CreateConnection {
39 my $self = shift;
40 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::CreateConnection', @_);
41 return $self->caller->do_call($self, $call_object);
42 }
43 sub CreateEventBus {
44 my $self = shift;
45 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::CreateEventBus', @_);
46 return $self->caller->do_call($self, $call_object);
47 }
48 sub CreatePartnerEventSource {
49 my $self = shift;
50 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::CreatePartnerEventSource', @_);
51 return $self->caller->do_call($self, $call_object);
52 }
53 sub DeactivateEventSource {
54 my $self = shift;
55 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeactivateEventSource', @_);
56 return $self->caller->do_call($self, $call_object);
57 }
58 sub DeauthorizeConnection {
59 my $self = shift;
60 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeauthorizeConnection', @_);
61 return $self->caller->do_call($self, $call_object);
62 }
63 sub DeleteApiDestination {
64 my $self = shift;
65 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeleteApiDestination', @_);
66 return $self->caller->do_call($self, $call_object);
67 }
68 sub DeleteArchive {
69 my $self = shift;
70 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeleteArchive', @_);
71 return $self->caller->do_call($self, $call_object);
72 }
73 sub DeleteConnection {
74 my $self = shift;
75 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeleteConnection', @_);
76 return $self->caller->do_call($self, $call_object);
77 }
78 sub DeleteEventBus {
79 my $self = shift;
80 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeleteEventBus', @_);
81 return $self->caller->do_call($self, $call_object);
82 }
83 sub DeletePartnerEventSource {
84 my $self = shift;
85 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeletePartnerEventSource', @_);
86 return $self->caller->do_call($self, $call_object);
87 }
88 sub DeleteRule {
89 my $self = shift;
90 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DeleteRule', @_);
91 return $self->caller->do_call($self, $call_object);
92 }
93 sub DescribeApiDestination {
94 my $self = shift;
95 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeApiDestination', @_);
96 return $self->caller->do_call($self, $call_object);
97 }
98 sub DescribeArchive {
99 my $self = shift;
100 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeArchive', @_);
101 return $self->caller->do_call($self, $call_object);
102 }
103 sub DescribeConnection {
104 my $self = shift;
105 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeConnection', @_);
106 return $self->caller->do_call($self, $call_object);
107 }
108 sub DescribeEventBus {
109 my $self = shift;
110 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeEventBus', @_);
111 return $self->caller->do_call($self, $call_object);
112 }
113 sub DescribeEventSource {
114 my $self = shift;
115 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeEventSource', @_);
116 return $self->caller->do_call($self, $call_object);
117 }
118 sub DescribePartnerEventSource {
119 my $self = shift;
120 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribePartnerEventSource', @_);
121 return $self->caller->do_call($self, $call_object);
122 }
123 sub DescribeReplay {
124 my $self = shift;
125 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeReplay', @_);
126 return $self->caller->do_call($self, $call_object);
127 }
128 sub DescribeRule {
129 my $self = shift;
130 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DescribeRule', @_);
131 return $self->caller->do_call($self, $call_object);
132 }
133 sub DisableRule {
134 my $self = shift;
135 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::DisableRule', @_);
136 return $self->caller->do_call($self, $call_object);
137 }
138 sub EnableRule {
139 my $self = shift;
140 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::EnableRule', @_);
141 return $self->caller->do_call($self, $call_object);
142 }
143 sub ListApiDestinations {
144 my $self = shift;
145 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListApiDestinations', @_);
146 return $self->caller->do_call($self, $call_object);
147 }
148 sub ListArchives {
149 my $self = shift;
150 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListArchives', @_);
151 return $self->caller->do_call($self, $call_object);
152 }
153 sub ListConnections {
154 my $self = shift;
155 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListConnections', @_);
156 return $self->caller->do_call($self, $call_object);
157 }
158 sub ListEventBuses {
159 my $self = shift;
160 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListEventBuses', @_);
161 return $self->caller->do_call($self, $call_object);
162 }
163 sub ListEventSources {
164 my $self = shift;
165 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListEventSources', @_);
166 return $self->caller->do_call($self, $call_object);
167 }
168 sub ListPartnerEventSourceAccounts {
169 my $self = shift;
170 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListPartnerEventSourceAccounts', @_);
171 return $self->caller->do_call($self, $call_object);
172 }
173 sub ListPartnerEventSources {
174 my $self = shift;
175 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListPartnerEventSources', @_);
176 return $self->caller->do_call($self, $call_object);
177 }
178 sub ListReplays {
179 my $self = shift;
180 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListReplays', @_);
181 return $self->caller->do_call($self, $call_object);
182 }
183 sub ListRuleNamesByTarget {
184 my $self = shift;
185 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListRuleNamesByTarget', @_);
186 return $self->caller->do_call($self, $call_object);
187 }
188 sub ListRules {
189 my $self = shift;
190 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListRules', @_);
191 return $self->caller->do_call($self, $call_object);
192 }
193 sub ListTagsForResource {
194 my $self = shift;
195 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListTagsForResource', @_);
196 return $self->caller->do_call($self, $call_object);
197 }
198 sub ListTargetsByRule {
199 my $self = shift;
200 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::ListTargetsByRule', @_);
201 return $self->caller->do_call($self, $call_object);
202 }
203 sub PutEvents {
204 my $self = shift;
205 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::PutEvents', @_);
206 return $self->caller->do_call($self, $call_object);
207 }
208 sub PutPartnerEvents {
209 my $self = shift;
210 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::PutPartnerEvents', @_);
211 return $self->caller->do_call($self, $call_object);
212 }
213 sub PutPermission {
214 my $self = shift;
215 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::PutPermission', @_);
216 return $self->caller->do_call($self, $call_object);
217 }
218 sub PutRule {
219 my $self = shift;
220 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::PutRule', @_);
221 return $self->caller->do_call($self, $call_object);
222 }
223 sub PutTargets {
224 my $self = shift;
225 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::PutTargets', @_);
226 return $self->caller->do_call($self, $call_object);
227 }
228 sub RemovePermission {
229 my $self = shift;
230 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::RemovePermission', @_);
231 return $self->caller->do_call($self, $call_object);
232 }
233 sub RemoveTargets {
234 my $self = shift;
235 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::RemoveTargets', @_);
236 return $self->caller->do_call($self, $call_object);
237 }
238 sub StartReplay {
239 my $self = shift;
240 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::StartReplay', @_);
241 return $self->caller->do_call($self, $call_object);
242 }
243 sub TagResource {
244 my $self = shift;
245 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::TagResource', @_);
246 return $self->caller->do_call($self, $call_object);
247 }
248 sub TestEventPattern {
249 my $self = shift;
250 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::TestEventPattern', @_);
251 return $self->caller->do_call($self, $call_object);
252 }
253 sub UntagResource {
254 my $self = shift;
255 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::UntagResource', @_);
256 return $self->caller->do_call($self, $call_object);
257 }
258 sub UpdateApiDestination {
259 my $self = shift;
260 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::UpdateApiDestination', @_);
261 return $self->caller->do_call($self, $call_object);
262 }
263 sub UpdateArchive {
264 my $self = shift;
265 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::UpdateArchive', @_);
266 return $self->caller->do_call($self, $call_object);
267 }
268 sub UpdateConnection {
269 my $self = shift;
270 my $call_object = $self->new_with_coercions('Paws::CloudWatchEvents::UpdateConnection', @_);
271 return $self->caller->do_call($self, $call_object);
272 }
273
274 sub ListAllRuleNamesByTarget {
275 my $self = shift;
276  
277 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
278 my $result = $self->ListRuleNamesByTarget(@_);
279 my $next_result = $result;
280  
281 if (not defined $callback) {
282 while ($next_result->NextToken) {
283 $next_result = $self->ListRuleNamesByTarget(@_, NextToken => $next_result->NextToken);
284 push @{ $result->RuleNames }, @{ $next_result->RuleNames };
285 }
286 return $result;
287 } else {
288 while ($result->NextToken) {
289 $callback->($_ => 'RuleNames') foreach (@{ $result->RuleNames });
290 $result = $self->ListRuleNamesByTarget(@_, NextToken => $result->NextToken);
291 }
292 $callback->($_ => 'RuleNames') foreach (@{ $result->RuleNames });
293 }
294  
295 return undef
296 }
297 sub ListAllRules {
298 my $self = shift;
299  
300 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
301 my $result = $self->ListRules(@_);
302 my $next_result = $result;
303  
304 if (not defined $callback) {
305 while ($next_result->NextToken) {
306 $next_result = $self->ListRules(@_, NextToken => $next_result->NextToken);
307 push @{ $result->Rules }, @{ $next_result->Rules };
308 }
309 return $result;
310 } else {
311 while ($result->NextToken) {
312 $callback->($_ => 'Rules') foreach (@{ $result->Rules });
313 $result = $self->ListRules(@_, NextToken => $result->NextToken);
314 }
315 $callback->($_ => 'Rules') foreach (@{ $result->Rules });
316 }
317  
318 return undef
319 }
320 sub ListAllTargetsByRule {
321 my $self = shift;
322  
323 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
324 my $result = $self->ListTargetsByRule(@_);
325 my $next_result = $result;
326  
327 if (not defined $callback) {
328 while ($next_result->NextToken) {
329 $next_result = $self->ListTargetsByRule(@_, NextToken => $next_result->NextToken);
330 push @{ $result->Targets }, @{ $next_result->Targets };
331 }
332 return $result;
333 } else {
334 while ($result->NextToken) {
335 $callback->($_ => 'Targets') foreach (@{ $result->Targets });
336 $result = $self->ListTargetsByRule(@_, NextToken => $result->NextToken);
337 }
338 $callback->($_ => 'Targets') foreach (@{ $result->Targets });
339 }
340  
341 return undef
342 }
343  
344  
345 sub operations { qw/ActivateEventSource CancelReplay CreateApiDestination CreateArchive CreateConnection CreateEventBus CreatePartnerEventSource DeactivateEventSource DeauthorizeConnection DeleteApiDestination DeleteArchive DeleteConnection DeleteEventBus DeletePartnerEventSource DeleteRule DescribeApiDestination DescribeArchive DescribeConnection DescribeEventBus DescribeEventSource DescribePartnerEventSource DescribeReplay DescribeRule DisableRule EnableRule ListApiDestinations ListArchives ListConnections ListEventBuses ListEventSources ListPartnerEventSourceAccounts ListPartnerEventSources ListReplays ListRuleNamesByTarget ListRules ListTagsForResource ListTargetsByRule PutEvents PutPartnerEvents PutPermission PutRule PutTargets RemovePermission RemoveTargets StartReplay TagResource TestEventPattern UntagResource UpdateApiDestination UpdateArchive UpdateConnection / }
346  
347 1;
348  
349 ### main pod documentation begin ###
350  
351 =head1 NAME
352  
353 Paws::CloudWatchEvents - Perl Interface to AWS Amazon EventBridge
354  
355 =head1 SYNOPSIS
356  
357 use Paws;
358  
359 my $obj = Paws->service('CloudWatchEvents');
360 my $res = $obj->Method(
361 Arg1 => $val1,
362 Arg2 => [ 'V1', 'V2' ],
363 # if Arg3 is an object, the HashRef will be used as arguments to the constructor
364 # of the arguments type
365 Arg3 => { Att1 => 'Val1' },
366 # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
367 # the constructor of the arguments type
368 Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
369 );
370  
371 =head1 DESCRIPTION
372  
373 Amazon EventBridge helps you to respond to state changes in your AWS
374 resources. When your resources change state, they automatically send
375 events into an event stream. You can create rules that match selected
376 events in the stream and route them to targets to take action. You can
377 also use rules to take action on a predetermined schedule. For example,
378 you can configure rules to:
379  
380 =over
381  
382 =item *
383  
384 Automatically invoke an AWS Lambda function to update DNS entries when
385 an event notifies you that Amazon EC2 instance enters the running
386 state.
387  
388 =item *
389  
390 Direct specific API records from AWS CloudTrail to an Amazon Kinesis
391 data stream for detailed analysis of potential security or availability
392 risks.
393  
394 =item *
395  
396 Periodically invoke a built-in target to create a snapshot of an Amazon
397 EBS volume.
398  
399 =back
400  
401 For more information about the features of Amazon EventBridge, see the
402 Amazon EventBridge User Guide
403 (https://docs.aws.amazon.com/eventbridge/latest/userguide).
404  
405 For the AWS API documentation, see L<https://docs.aws.amazon.com/cloudwatch/>
406  
407  
408 =head1 METHODS
409  
410 =head2 ActivateEventSource
411  
412 =over
413  
414 =item Name => Str
415  
416  
417 =back
418  
419 Each argument is described in detail in: L<Paws::CloudWatchEvents::ActivateEventSource>
420  
421 Returns: nothing
422  
423 Activates a partner event source that has been deactivated. Once
424 activated, your matching event bus will start receiving events from the
425 event source.
426  
427  
428 =head2 CancelReplay
429  
430 =over
431  
432 =item ReplayName => Str
433  
434  
435 =back
436  
437 Each argument is described in detail in: L<Paws::CloudWatchEvents::CancelReplay>
438  
439 Returns: a L<Paws::CloudWatchEvents::CancelReplayResponse> instance
440  
441 Cancels the specified replay.
442  
443  
444 =head2 CreateApiDestination
445  
446 =over
447  
448 =item ConnectionArn => Str
449  
450 =item HttpMethod => Str
451  
452 =item InvocationEndpoint => Str
453  
454 =item Name => Str
455  
456 =item [Description => Str]
457  
458 =item [InvocationRateLimitPerSecond => Int]
459  
460  
461 =back
462  
463 Each argument is described in detail in: L<Paws::CloudWatchEvents::CreateApiDestination>
464  
465 Returns: a L<Paws::CloudWatchEvents::CreateApiDestinationResponse> instance
466  
467 Creates an API destination, which is an HTTP invocation endpoint
468 configured as a target for events.
469  
470  
471 =head2 CreateArchive
472  
473 =over
474  
475 =item ArchiveName => Str
476  
477 =item EventSourceArn => Str
478  
479 =item [Description => Str]
480  
481 =item [EventPattern => Str]
482  
483 =item [RetentionDays => Int]
484  
485  
486 =back
487  
488 Each argument is described in detail in: L<Paws::CloudWatchEvents::CreateArchive>
489  
490 Returns: a L<Paws::CloudWatchEvents::CreateArchiveResponse> instance
491  
492 Creates an archive of events with the specified settings. When you
493 create an archive, incoming events might not immediately start being
494 sent to the archive. Allow a short period of time for changes to take
495 effect. If you do not specify a pattern to filter events sent to the
496 archive, all events are sent to the archive except replayed events.
497 Replayed events are not sent to an archive.
498  
499  
500 =head2 CreateConnection
501  
502 =over
503  
504 =item AuthorizationType => Str
505  
506 =item AuthParameters => L<Paws::CloudWatchEvents::CreateConnectionAuthRequestParameters>
507  
508 =item Name => Str
509  
510 =item [Description => Str]
511  
512  
513 =back
514  
515 Each argument is described in detail in: L<Paws::CloudWatchEvents::CreateConnection>
516  
517 Returns: a L<Paws::CloudWatchEvents::CreateConnectionResponse> instance
518  
519 Creates a connection. A connection defines the authorization type and
520 credentials to use for authorization with an API destination HTTP
521 endpoint.
522  
523  
524 =head2 CreateEventBus
525  
526 =over
527  
528 =item Name => Str
529  
530 =item [EventSourceName => Str]
531  
532 =item [Tags => ArrayRef[L<Paws::CloudWatchEvents::Tag>]]
533  
534  
535 =back
536  
537 Each argument is described in detail in: L<Paws::CloudWatchEvents::CreateEventBus>
538  
539 Returns: a L<Paws::CloudWatchEvents::CreateEventBusResponse> instance
540  
541 Creates a new event bus within your account. This can be a custom event
542 bus which you can use to receive events from your custom applications
543 and services, or it can be a partner event bus which can be matched to
544 a partner event source.
545  
546  
547 =head2 CreatePartnerEventSource
548  
549 =over
550  
551 =item Account => Str
552  
553 =item Name => Str
554  
555  
556 =back
557  
558 Each argument is described in detail in: L<Paws::CloudWatchEvents::CreatePartnerEventSource>
559  
560 Returns: a L<Paws::CloudWatchEvents::CreatePartnerEventSourceResponse> instance
561  
562 Called by an SaaS partner to create a partner event source. This
563 operation is not used by AWS customers.
564  
565 Each partner event source can be used by one AWS account to create a
566 matching partner event bus in that AWS account. A SaaS partner must
567 create one partner event source for each AWS account that wants to
568 receive those event types.
569  
570 A partner event source creates events based on resources within the
571 SaaS partner's service or application.
572  
573 An AWS account that creates a partner event bus that matches the
574 partner event source can use that event bus to receive events from the
575 partner, and then process them using AWS Events rules and targets.
576  
577 Partner event source names follow this format:
578  
579 C<I<partner_name>/I<event_namespace>/I<event_name>>
580  
581 I<partner_name> is determined during partner registration and
582 identifies the partner to AWS customers. I<event_namespace> is
583 determined by the partner and is a way for the partner to categorize
584 their events. I<event_name> is determined by the partner, and should
585 uniquely identify an event-generating resource within the partner
586 system. The combination of I<event_namespace> and I<event_name> should
587 help AWS customers decide whether to create an event bus to receive
588 these events.
589  
590  
591 =head2 DeactivateEventSource
592  
593 =over
594  
595 =item Name => Str
596  
597  
598 =back
599  
600 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeactivateEventSource>
601  
602 Returns: nothing
603  
604 You can use this operation to temporarily stop receiving events from
605 the specified partner event source. The matching event bus is not
606 deleted.
607  
608 When you deactivate a partner event source, the source goes into
609 PENDING state. If it remains in PENDING state for more than two weeks,
610 it is deleted.
611  
612 To activate a deactivated partner event source, use
613 ActivateEventSource.
614  
615  
616 =head2 DeauthorizeConnection
617  
618 =over
619  
620 =item Name => Str
621  
622  
623 =back
624  
625 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeauthorizeConnection>
626  
627 Returns: a L<Paws::CloudWatchEvents::DeauthorizeConnectionResponse> instance
628  
629 Removes all authorization parameters from the connection. This lets you
630 remove the secret from the connection so you can reuse it without
631 having to create a new connection.
632  
633  
634 =head2 DeleteApiDestination
635  
636 =over
637  
638 =item Name => Str
639  
640  
641 =back
642  
643 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeleteApiDestination>
644  
645 Returns: a L<Paws::CloudWatchEvents::DeleteApiDestinationResponse> instance
646  
647 Deletes the specified API destination.
648  
649  
650 =head2 DeleteArchive
651  
652 =over
653  
654 =item ArchiveName => Str
655  
656  
657 =back
658  
659 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeleteArchive>
660  
661 Returns: a L<Paws::CloudWatchEvents::DeleteArchiveResponse> instance
662  
663 Deletes the specified archive.
664  
665  
666 =head2 DeleteConnection
667  
668 =over
669  
670 =item Name => Str
671  
672  
673 =back
674  
675 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeleteConnection>
676  
677 Returns: a L<Paws::CloudWatchEvents::DeleteConnectionResponse> instance
678  
679 Deletes a connection.
680  
681  
682 =head2 DeleteEventBus
683  
684 =over
685  
686 =item Name => Str
687  
688  
689 =back
690  
691 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeleteEventBus>
692  
693 Returns: nothing
694  
695 Deletes the specified custom event bus or partner event bus. All rules
696 associated with this event bus need to be deleted. You can't delete
697 your account's default event bus.
698  
699  
700 =head2 DeletePartnerEventSource
701  
702 =over
703  
704 =item Account => Str
705  
706 =item Name => Str
707  
708  
709 =back
710  
711 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeletePartnerEventSource>
712  
713 Returns: nothing
714  
715 This operation is used by SaaS partners to delete a partner event
716 source. This operation is not used by AWS customers.
717  
718 When you delete an event source, the status of the corresponding
719 partner event bus in the AWS customer account becomes DELETED.
720  
721  
722 =head2 DeleteRule
723  
724 =over
725  
726 =item Name => Str
727  
728 =item [EventBusName => Str]
729  
730 =item [Force => Bool]
731  
732  
733 =back
734  
735 Each argument is described in detail in: L<Paws::CloudWatchEvents::DeleteRule>
736  
737 Returns: nothing
738  
739 Deletes the specified rule.
740  
741 Before you can delete the rule, you must remove all targets, using
742 RemoveTargets.
743  
744 When you delete a rule, incoming events might continue to match to the
745 deleted rule. Allow a short period of time for changes to take effect.
746  
747 If you call delete rule multiple times for the same rule, all calls
748 will succeed. When you call delete rule for a non-existent custom
749 eventbus, C<ResourceNotFoundException> is returned.
750  
751 Managed rules are rules created and managed by another AWS service on
752 your behalf. These rules are created by those other AWS services to
753 support functionality in those services. You can delete these rules
754 using the C<Force> option, but you should do so only if you are sure
755 the other service is not still using that rule.
756  
757  
758 =head2 DescribeApiDestination
759  
760 =over
761  
762 =item Name => Str
763  
764  
765 =back
766  
767 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeApiDestination>
768  
769 Returns: a L<Paws::CloudWatchEvents::DescribeApiDestinationResponse> instance
770  
771 Retrieves details about an API destination.
772  
773  
774 =head2 DescribeArchive
775  
776 =over
777  
778 =item ArchiveName => Str
779  
780  
781 =back
782  
783 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeArchive>
784  
785 Returns: a L<Paws::CloudWatchEvents::DescribeArchiveResponse> instance
786  
787 Retrieves details about an archive.
788  
789  
790 =head2 DescribeConnection
791  
792 =over
793  
794 =item Name => Str
795  
796  
797 =back
798  
799 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeConnection>
800  
801 Returns: a L<Paws::CloudWatchEvents::DescribeConnectionResponse> instance
802  
803 Retrieves details about a connection.
804  
805  
806 =head2 DescribeEventBus
807  
808 =over
809  
810 =item [Name => Str]
811  
812  
813 =back
814  
815 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeEventBus>
816  
817 Returns: a L<Paws::CloudWatchEvents::DescribeEventBusResponse> instance
818  
819 Displays details about an event bus in your account. This can include
820 the external AWS accounts that are permitted to write events to your
821 default event bus, and the associated policy. For custom event buses
822 and partner event buses, it displays the name, ARN, policy, state, and
823 creation time.
824  
825 To enable your account to receive events from other accounts on its
826 default event bus, use PutPermission.
827  
828 For more information about partner event buses, see CreateEventBus.
829  
830  
831 =head2 DescribeEventSource
832  
833 =over
834  
835 =item Name => Str
836  
837  
838 =back
839  
840 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeEventSource>
841  
842 Returns: a L<Paws::CloudWatchEvents::DescribeEventSourceResponse> instance
843  
844 This operation lists details about a partner event source that is
845 shared with your account.
846  
847  
848 =head2 DescribePartnerEventSource
849  
850 =over
851  
852 =item Name => Str
853  
854  
855 =back
856  
857 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribePartnerEventSource>
858  
859 Returns: a L<Paws::CloudWatchEvents::DescribePartnerEventSourceResponse> instance
860  
861 An SaaS partner can use this operation to list details about a partner
862 event source that they have created. AWS customers do not use this
863 operation. Instead, AWS customers can use DescribeEventSource to see
864 details about a partner event source that is shared with them.
865  
866  
867 =head2 DescribeReplay
868  
869 =over
870  
871 =item ReplayName => Str
872  
873  
874 =back
875  
876 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeReplay>
877  
878 Returns: a L<Paws::CloudWatchEvents::DescribeReplayResponse> instance
879  
880 Retrieves details about a replay. Use C<DescribeReplay> to determine
881 the progress of a running replay. A replay processes events to replay
882 based on the time in the event, and replays them using 1 minute
883 intervals. If you use C<StartReplay> and specify an C<EventStartTime>
884 and an C<EventEndTime> that covers a 20 minute time range, the events
885 are replayed from the first minute of that 20 minute range first. Then
886 the events from the second minute are replayed. You can use
887 C<DescribeReplay> to determine the progress of a replay. The value
888 returned for C<EventLastReplayedTime> indicates the time within the
889 specified time range associated with the last event replayed.
890  
891  
892 =head2 DescribeRule
893  
894 =over
895  
896 =item Name => Str
897  
898 =item [EventBusName => Str]
899  
900  
901 =back
902  
903 Each argument is described in detail in: L<Paws::CloudWatchEvents::DescribeRule>
904  
905 Returns: a L<Paws::CloudWatchEvents::DescribeRuleResponse> instance
906  
907 Describes the specified rule.
908  
909 DescribeRule does not list the targets of a rule. To see the targets
910 associated with a rule, use ListTargetsByRule.
911  
912  
913 =head2 DisableRule
914  
915 =over
916  
917 =item Name => Str
918  
919 =item [EventBusName => Str]
920  
921  
922 =back
923  
924 Each argument is described in detail in: L<Paws::CloudWatchEvents::DisableRule>
925  
926 Returns: nothing
927  
928 Disables the specified rule. A disabled rule won't match any events,
929 and won't self-trigger if it has a schedule expression.
930  
931 When you disable a rule, incoming events might continue to match to the
932 disabled rule. Allow a short period of time for changes to take effect.
933  
934  
935 =head2 EnableRule
936  
937 =over
938  
939 =item Name => Str
940  
941 =item [EventBusName => Str]
942  
943  
944 =back
945  
946 Each argument is described in detail in: L<Paws::CloudWatchEvents::EnableRule>
947  
948 Returns: nothing
949  
950 Enables the specified rule. If the rule does not exist, the operation
951 fails.
952  
953 When you enable a rule, incoming events might not immediately start
954 matching to a newly enabled rule. Allow a short period of time for
955 changes to take effect.
956  
957  
958 =head2 ListApiDestinations
959  
960 =over
961  
962 =item [ConnectionArn => Str]
963  
964 =item [Limit => Int]
965  
966 =item [NamePrefix => Str]
967  
968 =item [NextToken => Str]
969  
970  
971 =back
972  
973 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListApiDestinations>
974  
975 Returns: a L<Paws::CloudWatchEvents::ListApiDestinationsResponse> instance
976  
977 Retrieves a list of API destination in the account in the current
978 Region.
979  
980  
981 =head2 ListArchives
982  
983 =over
984  
985 =item [EventSourceArn => Str]
986  
987 =item [Limit => Int]
988  
989 =item [NamePrefix => Str]
990  
991 =item [NextToken => Str]
992  
993 =item [State => Str]
994  
995  
996 =back
997  
998 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListArchives>
999  
1000 Returns: a L<Paws::CloudWatchEvents::ListArchivesResponse> instance
1001  
1002 Lists your archives. You can either list all the archives or you can
1003 provide a prefix to match to the archive names. Filter parameters are
1004 exclusive.
1005  
1006  
1007 =head2 ListConnections
1008  
1009 =over
1010  
1011 =item [ConnectionState => Str]
1012  
1013 =item [Limit => Int]
1014  
1015 =item [NamePrefix => Str]
1016  
1017 =item [NextToken => Str]
1018  
1019  
1020 =back
1021  
1022 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListConnections>
1023  
1024 Returns: a L<Paws::CloudWatchEvents::ListConnectionsResponse> instance
1025  
1026 Retrieves a list of connections from the account.
1027  
1028  
1029 =head2 ListEventBuses
1030  
1031 =over
1032  
1033 =item [Limit => Int]
1034  
1035 =item [NamePrefix => Str]
1036  
1037 =item [NextToken => Str]
1038  
1039  
1040 =back
1041  
1042 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListEventBuses>
1043  
1044 Returns: a L<Paws::CloudWatchEvents::ListEventBusesResponse> instance
1045  
1046 Lists all the event buses in your account, including the default event
1047 bus, custom event buses, and partner event buses.
1048  
1049  
1050 =head2 ListEventSources
1051  
1052 =over
1053  
1054 =item [Limit => Int]
1055  
1056 =item [NamePrefix => Str]
1057  
1058 =item [NextToken => Str]
1059  
1060  
1061 =back
1062  
1063 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListEventSources>
1064  
1065 Returns: a L<Paws::CloudWatchEvents::ListEventSourcesResponse> instance
1066  
1067 You can use this to see all the partner event sources that have been
1068 shared with your AWS account. For more information about partner event
1069 sources, see CreateEventBus.
1070  
1071  
1072 =head2 ListPartnerEventSourceAccounts
1073  
1074 =over
1075  
1076 =item EventSourceName => Str
1077  
1078 =item [Limit => Int]
1079  
1080 =item [NextToken => Str]
1081  
1082  
1083 =back
1084  
1085 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListPartnerEventSourceAccounts>
1086  
1087 Returns: a L<Paws::CloudWatchEvents::ListPartnerEventSourceAccountsResponse> instance
1088  
1089 An SaaS partner can use this operation to display the AWS account ID
1090 that a particular partner event source name is associated with. This
1091 operation is not used by AWS customers.
1092  
1093  
1094 =head2 ListPartnerEventSources
1095  
1096 =over
1097  
1098 =item NamePrefix => Str
1099  
1100 =item [Limit => Int]
1101  
1102 =item [NextToken => Str]
1103  
1104  
1105 =back
1106  
1107 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListPartnerEventSources>
1108  
1109 Returns: a L<Paws::CloudWatchEvents::ListPartnerEventSourcesResponse> instance
1110  
1111 An SaaS partner can use this operation to list all the partner event
1112 source names that they have created. This operation is not used by AWS
1113 customers.
1114  
1115  
1116 =head2 ListReplays
1117  
1118 =over
1119  
1120 =item [EventSourceArn => Str]
1121  
1122 =item [Limit => Int]
1123  
1124 =item [NamePrefix => Str]
1125  
1126 =item [NextToken => Str]
1127  
1128 =item [State => Str]
1129  
1130  
1131 =back
1132  
1133 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListReplays>
1134  
1135 Returns: a L<Paws::CloudWatchEvents::ListReplaysResponse> instance
1136  
1137 Lists your replays. You can either list all the replays or you can
1138 provide a prefix to match to the replay names. Filter parameters are
1139 exclusive.
1140  
1141  
1142 =head2 ListRuleNamesByTarget
1143  
1144 =over
1145  
1146 =item TargetArn => Str
1147  
1148 =item [EventBusName => Str]
1149  
1150 =item [Limit => Int]
1151  
1152 =item [NextToken => Str]
1153  
1154  
1155 =back
1156  
1157 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListRuleNamesByTarget>
1158  
1159 Returns: a L<Paws::CloudWatchEvents::ListRuleNamesByTargetResponse> instance
1160  
1161 Lists the rules for the specified target. You can see which of the
1162 rules in Amazon EventBridge can invoke a specific target in your
1163 account.
1164  
1165  
1166 =head2 ListRules
1167  
1168 =over
1169  
1170 =item [EventBusName => Str]
1171  
1172 =item [Limit => Int]
1173  
1174 =item [NamePrefix => Str]
1175  
1176 =item [NextToken => Str]
1177  
1178  
1179 =back
1180  
1181 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListRules>
1182  
1183 Returns: a L<Paws::CloudWatchEvents::ListRulesResponse> instance
1184  
1185 Lists your Amazon EventBridge rules. You can either list all the rules
1186 or you can provide a prefix to match to the rule names.
1187  
1188 ListRules does not list the targets of a rule. To see the targets
1189 associated with a rule, use ListTargetsByRule.
1190  
1191  
1192 =head2 ListTagsForResource
1193  
1194 =over
1195  
1196 =item ResourceARN => Str
1197  
1198  
1199 =back
1200  
1201 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListTagsForResource>
1202  
1203 Returns: a L<Paws::CloudWatchEvents::ListTagsForResourceResponse> instance
1204  
1205 Displays the tags associated with an EventBridge resource. In
1206 EventBridge, rules and event buses can be tagged.
1207  
1208  
1209 =head2 ListTargetsByRule
1210  
1211 =over
1212  
1213 =item Rule => Str
1214  
1215 =item [EventBusName => Str]
1216  
1217 =item [Limit => Int]
1218  
1219 =item [NextToken => Str]
1220  
1221  
1222 =back
1223  
1224 Each argument is described in detail in: L<Paws::CloudWatchEvents::ListTargetsByRule>
1225  
1226 Returns: a L<Paws::CloudWatchEvents::ListTargetsByRuleResponse> instance
1227  
1228 Lists the targets assigned to the specified rule.
1229  
1230  
1231 =head2 PutEvents
1232  
1233 =over
1234  
1235 =item Entries => ArrayRef[L<Paws::CloudWatchEvents::PutEventsRequestEntry>]
1236  
1237  
1238 =back
1239  
1240 Each argument is described in detail in: L<Paws::CloudWatchEvents::PutEvents>
1241  
1242 Returns: a L<Paws::CloudWatchEvents::PutEventsResponse> instance
1243  
1244 Sends custom events to Amazon EventBridge so that they can be matched
1245 to rules.
1246  
1247  
1248 =head2 PutPartnerEvents
1249  
1250 =over
1251  
1252 =item Entries => ArrayRef[L<Paws::CloudWatchEvents::PutPartnerEventsRequestEntry>]
1253  
1254  
1255 =back
1256  
1257 Each argument is described in detail in: L<Paws::CloudWatchEvents::PutPartnerEvents>
1258  
1259 Returns: a L<Paws::CloudWatchEvents::PutPartnerEventsResponse> instance
1260  
1261 This is used by SaaS partners to write events to a customer's partner
1262 event bus. AWS customers do not use this operation.
1263  
1264  
1265 =head2 PutPermission
1266  
1267 =over
1268  
1269 =item [Action => Str]
1270  
1271 =item [Condition => L<Paws::CloudWatchEvents::Condition>]
1272  
1273 =item [EventBusName => Str]
1274  
1275 =item [Policy => Str]
1276  
1277 =item [Principal => Str]
1278  
1279 =item [StatementId => Str]
1280  
1281  
1282 =back
1283  
1284 Each argument is described in detail in: L<Paws::CloudWatchEvents::PutPermission>
1285  
1286 Returns: nothing
1287  
1288 Running C<PutPermission> permits the specified AWS account or AWS
1289 organization to put events to the specified I<event bus>. Amazon
1290 EventBridge (CloudWatch Events) rules in your account are triggered by
1291 these events arriving to an event bus in your account.
1292  
1293 For another account to send events to your account, that external
1294 account must have an EventBridge rule with your account's event bus as
1295 a target.
1296  
1297 To enable multiple AWS accounts to put events to your event bus, run
1298 C<PutPermission> once for each of these accounts. Or, if all the
1299 accounts are members of the same AWS organization, you can run
1300 C<PutPermission> once specifying C<Principal> as "*" and specifying the
1301 AWS organization ID in C<Condition>, to grant permissions to all
1302 accounts in that organization.
1303  
1304 If you grant permissions using an organization, then accounts in that
1305 organization must specify a C<RoleArn> with proper permissions when
1306 they use C<PutTarget> to add your account's event bus as a target. For
1307 more information, see Sending and Receiving Events Between AWS Accounts
1308 (https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html)
1309 in the I<Amazon EventBridge User Guide>.
1310  
1311 The permission policy on the default event bus cannot exceed 10 KB in
1312 size.
1313  
1314  
1315 =head2 PutRule
1316  
1317 =over
1318  
1319 =item Name => Str
1320  
1321 =item [Description => Str]
1322  
1323 =item [EventBusName => Str]
1324  
1325 =item [EventPattern => Str]
1326  
1327 =item [RoleArn => Str]
1328  
1329 =item [ScheduleExpression => Str]
1330  
1331 =item [State => Str]
1332  
1333 =item [Tags => ArrayRef[L<Paws::CloudWatchEvents::Tag>]]
1334  
1335  
1336 =back
1337  
1338 Each argument is described in detail in: L<Paws::CloudWatchEvents::PutRule>
1339  
1340 Returns: a L<Paws::CloudWatchEvents::PutRuleResponse> instance
1341  
1342 Creates or updates the specified rule. Rules are enabled by default, or
1343 based on value of the state. You can disable a rule using DisableRule.
1344  
1345 A single rule watches for events from a single event bus. Events
1346 generated by AWS services go to your account's default event bus.
1347 Events generated by SaaS partner services or applications go to the
1348 matching partner event bus. If you have custom applications or
1349 services, you can specify whether their events go to your default event
1350 bus or a custom event bus that you have created. For more information,
1351 see CreateEventBus.
1352  
1353 If you are updating an existing rule, the rule is replaced with what
1354 you specify in this C<PutRule> command. If you omit arguments in
1355 C<PutRule>, the old values for those arguments are not kept. Instead,
1356 they are replaced with null values.
1357  
1358 When you create or update a rule, incoming events might not immediately
1359 start matching to new or updated rules. Allow a short period of time
1360 for changes to take effect.
1361  
1362 A rule must contain at least an EventPattern or ScheduleExpression.
1363 Rules with EventPatterns are triggered when a matching event is
1364 observed. Rules with ScheduleExpressions self-trigger based on the
1365 given schedule. A rule can have both an EventPattern and a
1366 ScheduleExpression, in which case the rule triggers on matching events
1367 as well as on a schedule.
1368  
1369 When you initially create a rule, you can optionally assign one or more
1370 tags to the rule. Tags can help you organize and categorize your
1371 resources. You can also use them to scope user permissions, by granting
1372 a user permission to access or change only rules with certain tag
1373 values. To use the C<PutRule> operation and assign tags, you must have
1374 both the C<events:PutRule> and C<events:TagResource> permissions.
1375  
1376 If you are updating an existing rule, any tags you specify in the
1377 C<PutRule> operation are ignored. To update the tags of an existing
1378 rule, use TagResource and UntagResource.
1379  
1380 Most services in AWS treat : or / as the same character in Amazon
1381 Resource Names (ARNs). However, EventBridge uses an exact match in
1382 event patterns and rules. Be sure to use the correct ARN characters
1383 when creating event patterns so that they match the ARN syntax in the
1384 event you want to match.
1385  
1386 In EventBridge, it is possible to create rules that lead to infinite
1387 loops, where a rule is fired repeatedly. For example, a rule might
1388 detect that ACLs have changed on an S3 bucket, and trigger software to
1389 change them to the desired state. If the rule is not written carefully,
1390 the subsequent change to the ACLs fires the rule again, creating an
1391 infinite loop.
1392  
1393 To prevent this, write the rules so that the triggered actions do not
1394 re-fire the same rule. For example, your rule could fire only if ACLs
1395 are found to be in a bad state, instead of after any change.
1396  
1397 An infinite loop can quickly cause higher than expected charges. We
1398 recommend that you use budgeting, which alerts you when charges exceed
1399 your specified limit. For more information, see Managing Your Costs
1400 with Budgets
1401 (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html).
1402  
1403  
1404 =head2 PutTargets
1405  
1406 =over
1407  
1408 =item Rule => Str
1409  
1410 =item Targets => ArrayRef[L<Paws::CloudWatchEvents::Target>]
1411  
1412 =item [EventBusName => Str]
1413  
1414  
1415 =back
1416  
1417 Each argument is described in detail in: L<Paws::CloudWatchEvents::PutTargets>
1418  
1419 Returns: a L<Paws::CloudWatchEvents::PutTargetsResponse> instance
1420  
1421 Adds the specified targets to the specified rule, or updates the
1422 targets if they are already associated with the rule.
1423  
1424 Targets are the resources that are invoked when a rule is triggered.
1425  
1426 You can configure the following as targets for Events:
1427  
1428 =over
1429  
1430 =item *
1431  
1432 API destination
1433 (https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html)
1434  
1435 =item *
1436  
1437 Amazon API Gateway REST API endpoints
1438  
1439 =item *
1440  
1441 API Gateway
1442  
1443 =item *
1444  
1445 AWS Batch job queue
1446  
1447 =item *
1448  
1449 CloudWatch Logs group
1450  
1451 =item *
1452  
1453 CodeBuild project
1454  
1455 =item *
1456  
1457 CodePineline
1458  
1459 =item *
1460  
1461 Amazon EC2 C<CreateSnapshot> API call
1462  
1463 =item *
1464  
1465 Amazon EC2 C<RebootInstances> API call
1466  
1467 =item *
1468  
1469 Amazon EC2 C<StopInstances> API call
1470  
1471 =item *
1472  
1473 Amazon EC2 C<TerminateInstances> API call
1474  
1475 =item *
1476  
1477 Amazon ECS tasks
1478  
1479 =item *
1480  
1481 Event bus in a different AWS account or Region.
1482  
1483 You can use an event bus in the US East (N. Virginia) us-east-1, US
1484 West (Oregon) us-west-2, or Europe (Ireland) eu-west-1 Regions as a
1485 target for a rule.
1486  
1487 =item *
1488  
1489 Firehose delivery stream (Kinesis Data Firehose)
1490  
1491 =item *
1492  
1493 Inspector assessment template (Amazon Inspector)
1494  
1495 =item *
1496  
1497 Kinesis stream (Kinesis Data Stream)
1498  
1499 =item *
1500  
1501 AWS Lambda function
1502  
1503 =item *
1504  
1505 Redshift clusters (Data API statement execution)
1506  
1507 =item *
1508  
1509 Amazon SNS topic
1510  
1511 =item *
1512  
1513 Amazon SQS queues (includes FIFO queues
1514  
1515 =item *
1516  
1517 SSM Automation
1518  
1519 =item *
1520  
1521 SSM OpsItem
1522  
1523 =item *
1524  
1525 SSM Run Command
1526  
1527 =item *
1528  
1529 Step Functions state machines
1530  
1531 =back
1532  
1533 Creating rules with built-in targets is supported only in the AWS
1534 Management Console. The built-in targets are C<EC2 CreateSnapshot API
1535 call>, C<EC2 RebootInstances API call>, C<EC2 StopInstances API call>,
1536 and C<EC2 TerminateInstances API call>.
1537  
1538 For some target types, C<PutTargets> provides target-specific
1539 parameters. If the target is a Kinesis data stream, you can optionally
1540 specify which shard the event goes to by using the C<KinesisParameters>
1541 argument. To invoke a command on multiple EC2 instances with one rule,
1542 you can use the C<RunCommandParameters> field.
1543  
1544 To be able to make API calls against the resources that you own, Amazon
1545 EventBridge (CloudWatch Events) needs the appropriate permissions. For
1546 AWS Lambda and Amazon SNS resources, EventBridge relies on
1547 resource-based policies. For EC2 instances, Kinesis data streams, AWS
1548 Step Functions state machines and API Gateway REST APIs, EventBridge
1549 relies on IAM roles that you specify in the C<RoleARN> argument in
1550 C<PutTargets>. For more information, see Authentication and Access
1551 Control
1552 (https://docs.aws.amazon.com/eventbridge/latest/userguide/auth-and-access-control-eventbridge.html)
1553 in the I<Amazon EventBridge User Guide>.
1554  
1555 If another AWS account is in the same region and has granted you
1556 permission (using C<PutPermission>), you can send events to that
1557 account. Set that account's event bus as a target of the rules in your
1558 account. To send the matched events to the other account, specify that
1559 account's event bus as the C<Arn> value when you run C<PutTargets>. If
1560 your account sends events to another account, your account is charged
1561 for each sent event. Each event sent to another account is charged as a
1562 custom event. The account receiving the event is not charged. For more
1563 information, see Amazon EventBridge (CloudWatch Events) Pricing
1564 (https://aws.amazon.com/eventbridge/pricing/).
1565  
1566 C<Input>, C<InputPath>, and C<InputTransformer> are not available with
1567 C<PutTarget> if the target is an event bus of a different AWS account.
1568  
1569 If you are setting the event bus of another account as the target, and
1570 that account granted permission to your account through an organization
1571 instead of directly by the account ID, then you must specify a
1572 C<RoleArn> with proper permissions in the C<Target> structure. For more
1573 information, see Sending and Receiving Events Between AWS Accounts
1574 (https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html)
1575 in the I<Amazon EventBridge User Guide>.
1576  
1577 For more information about enabling cross-account events, see
1578 PutPermission.
1579  
1580 B<Input>, B<InputPath>, and B<InputTransformer> are mutually exclusive
1581 and optional parameters of a target. When a rule is triggered due to a
1582 matched event:
1583  
1584 =over
1585  
1586 =item *
1587  
1588 If none of the following arguments are specified for a target, then the
1589 entire event is passed to the target in JSON format (unless the target
1590 is Amazon EC2 Run Command or Amazon ECS task, in which case nothing
1591 from the event is passed to the target).
1592  
1593 =item *
1594  
1595 If B<Input> is specified in the form of valid JSON, then the matched
1596 event is overridden with this constant.
1597  
1598 =item *
1599  
1600 If B<InputPath> is specified in the form of JSONPath (for example,
1601 C<$.detail>), then only the part of the event specified in the path is
1602 passed to the target (for example, only the detail part of the event is
1603 passed).
1604  
1605 =item *
1606  
1607 If B<InputTransformer> is specified, then one or more specified
1608 JSONPaths are extracted from the event and used as values in a template
1609 that you specify as the input to the target.
1610  
1611 =back
1612  
1613 When you specify C<InputPath> or C<InputTransformer>, you must use JSON
1614 dot notation, not bracket notation.
1615  
1616 When you add targets to a rule and the associated rule triggers soon
1617 after, new or updated targets might not be immediately invoked. Allow a
1618 short period of time for changes to take effect.
1619  
1620 This action can partially fail if too many requests are made at the
1621 same time. If that happens, C<FailedEntryCount> is non-zero in the
1622 response and each entry in C<FailedEntries> provides the ID of the
1623 failed target and the error code.
1624  
1625  
1626 =head2 RemovePermission
1627  
1628 =over
1629  
1630 =item [EventBusName => Str]
1631  
1632 =item [RemoveAllPermissions => Bool]
1633  
1634 =item [StatementId => Str]
1635  
1636  
1637 =back
1638  
1639 Each argument is described in detail in: L<Paws::CloudWatchEvents::RemovePermission>
1640  
1641 Returns: nothing
1642  
1643 Revokes the permission of another AWS account to be able to put events
1644 to the specified event bus. Specify the account to revoke by the
1645 C<StatementId> value that you associated with the account when you
1646 granted it permission with C<PutPermission>. You can find the
1647 C<StatementId> by using DescribeEventBus.
1648  
1649  
1650 =head2 RemoveTargets
1651  
1652 =over
1653  
1654 =item Ids => ArrayRef[Str|Undef]
1655  
1656 =item Rule => Str
1657  
1658 =item [EventBusName => Str]
1659  
1660 =item [Force => Bool]
1661  
1662  
1663 =back
1664  
1665 Each argument is described in detail in: L<Paws::CloudWatchEvents::RemoveTargets>
1666  
1667 Returns: a L<Paws::CloudWatchEvents::RemoveTargetsResponse> instance
1668  
1669 Removes the specified targets from the specified rule. When the rule is
1670 triggered, those targets are no longer be invoked.
1671  
1672 When you remove a target, when the associated rule triggers, removed
1673 targets might continue to be invoked. Allow a short period of time for
1674 changes to take effect.
1675  
1676 This action can partially fail if too many requests are made at the
1677 same time. If that happens, C<FailedEntryCount> is non-zero in the
1678 response and each entry in C<FailedEntries> provides the ID of the
1679 failed target and the error code.
1680  
1681  
1682 =head2 StartReplay
1683  
1684 =over
1685  
1686 =item Destination => L<Paws::CloudWatchEvents::ReplayDestination>
1687  
1688 =item EventEndTime => Str
1689  
1690 =item EventSourceArn => Str
1691  
1692 =item EventStartTime => Str
1693  
1694 =item ReplayName => Str
1695  
1696 =item [Description => Str]
1697  
1698  
1699 =back
1700  
1701 Each argument is described in detail in: L<Paws::CloudWatchEvents::StartReplay>
1702  
1703 Returns: a L<Paws::CloudWatchEvents::StartReplayResponse> instance
1704  
1705 Starts the specified replay. Events are not necessarily replayed in the
1706 exact same order that they were added to the archive. A replay
1707 processes events to replay based on the time in the event, and replays
1708 them using 1 minute intervals. If you specify an C<EventStartTime> and
1709 an C<EventEndTime> that covers a 20 minute time range, the events are
1710 replayed from the first minute of that 20 minute range first. Then the
1711 events from the second minute are replayed. You can use
1712 C<DescribeReplay> to determine the progress of a replay. The value
1713 returned for C<EventLastReplayedTime> indicates the time within the
1714 specified time range associated with the last event replayed.
1715  
1716  
1717 =head2 TagResource
1718  
1719 =over
1720  
1721 =item ResourceARN => Str
1722  
1723 =item Tags => ArrayRef[L<Paws::CloudWatchEvents::Tag>]
1724  
1725  
1726 =back
1727  
1728 Each argument is described in detail in: L<Paws::CloudWatchEvents::TagResource>
1729  
1730 Returns: a L<Paws::CloudWatchEvents::TagResourceResponse> instance
1731  
1732 Assigns one or more tags (key-value pairs) to the specified EventBridge
1733 resource. Tags can help you organize and categorize your resources. You
1734 can also use them to scope user permissions by granting a user
1735 permission to access or change only resources with certain tag values.
1736 In EventBridge, rules and event buses can be tagged.
1737  
1738 Tags don't have any semantic meaning to AWS and are interpreted
1739 strictly as strings of characters.
1740  
1741 You can use the C<TagResource> action with a resource that already has
1742 tags. If you specify a new tag key, this tag is appended to the list of
1743 tags associated with the resource. If you specify a tag key that is
1744 already associated with the resource, the new tag value that you
1745 specify replaces the previous value for that tag.
1746  
1747 You can associate as many as 50 tags with a resource.
1748  
1749  
1750 =head2 TestEventPattern
1751  
1752 =over
1753  
1754 =item Event => Str
1755  
1756 =item EventPattern => Str
1757  
1758  
1759 =back
1760  
1761 Each argument is described in detail in: L<Paws::CloudWatchEvents::TestEventPattern>
1762  
1763 Returns: a L<Paws::CloudWatchEvents::TestEventPatternResponse> instance
1764  
1765 Tests whether the specified event pattern matches the provided event.
1766  
1767 Most services in AWS treat : or / as the same character in Amazon
1768 Resource Names (ARNs). However, EventBridge uses an exact match in
1769 event patterns and rules. Be sure to use the correct ARN characters
1770 when creating event patterns so that they match the ARN syntax in the
1771 event you want to match.
1772  
1773  
1774 =head2 UntagResource
1775  
1776 =over
1777  
1778 =item ResourceARN => Str
1779  
1780 =item TagKeys => ArrayRef[Str|Undef]
1781  
1782  
1783 =back
1784  
1785 Each argument is described in detail in: L<Paws::CloudWatchEvents::UntagResource>
1786  
1787 Returns: a L<Paws::CloudWatchEvents::UntagResourceResponse> instance
1788  
1789 Removes one or more tags from the specified EventBridge resource. In
1790 Amazon EventBridge (CloudWatch Events), rules and event buses can be
1791 tagged.
1792  
1793  
1794 =head2 UpdateApiDestination
1795  
1796 =over
1797  
1798 =item Name => Str
1799  
1800 =item [ConnectionArn => Str]
1801  
1802 =item [Description => Str]
1803  
1804 =item [HttpMethod => Str]
1805  
1806 =item [InvocationEndpoint => Str]
1807  
1808 =item [InvocationRateLimitPerSecond => Int]
1809  
1810  
1811 =back
1812  
1813 Each argument is described in detail in: L<Paws::CloudWatchEvents::UpdateApiDestination>
1814  
1815 Returns: a L<Paws::CloudWatchEvents::UpdateApiDestinationResponse> instance
1816  
1817 Updates an API destination.
1818  
1819  
1820 =head2 UpdateArchive
1821  
1822 =over
1823  
1824 =item ArchiveName => Str
1825  
1826 =item [Description => Str]
1827  
1828 =item [EventPattern => Str]
1829  
1830 =item [RetentionDays => Int]
1831  
1832  
1833 =back
1834  
1835 Each argument is described in detail in: L<Paws::CloudWatchEvents::UpdateArchive>
1836  
1837 Returns: a L<Paws::CloudWatchEvents::UpdateArchiveResponse> instance
1838  
1839 Updates the specified archive.
1840  
1841  
1842 =head2 UpdateConnection
1843  
1844 =over
1845  
1846 =item Name => Str
1847  
1848 =item [AuthorizationType => Str]
1849  
1850 =item [AuthParameters => L<Paws::CloudWatchEvents::UpdateConnectionAuthRequestParameters>]
1851  
1852 =item [Description => Str]
1853  
1854  
1855 =back
1856  
1857 Each argument is described in detail in: L<Paws::CloudWatchEvents::UpdateConnection>
1858  
1859 Returns: a L<Paws::CloudWatchEvents::UpdateConnectionResponse> instance
1860  
1861 Updates settings for a connection.
1862  
1863  
1864  
1865  
1866 =head1 PAGINATORS
1867  
1868 Paginator methods are helpers that repetively call methods that return partial results
1869  
1870 =head2 ListAllRuleNamesByTarget(sub { },TargetArn => Str, [EventBusName => Str, Limit => Int, NextToken => Str])
1871  
1872 =head2 ListAllRuleNamesByTarget(TargetArn => Str, [EventBusName => Str, Limit => Int, NextToken => Str])
1873  
1874  
1875 If passed a sub as first parameter, it will call the sub for each element found in :
1876  
1877 - RuleNames, passing the object as the first parameter, and the string 'RuleNames' as the second parameter
1878  
1879 If not, it will return a a L<Paws::CloudWatchEvents::ListRuleNamesByTargetResponse> 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.
1880  
1881  
1882 =head2 ListAllRules(sub { },[EventBusName => Str, Limit => Int, NamePrefix => Str, NextToken => Str])
1883  
1884 =head2 ListAllRules([EventBusName => Str, Limit => Int, NamePrefix => Str, NextToken => Str])
1885  
1886  
1887 If passed a sub as first parameter, it will call the sub for each element found in :
1888  
1889 - Rules, passing the object as the first parameter, and the string 'Rules' as the second parameter
1890  
1891 If not, it will return a a L<Paws::CloudWatchEvents::ListRulesResponse> 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.
1892  
1893  
1894 =head2 ListAllTargetsByRule(sub { },Rule => Str, [EventBusName => Str, Limit => Int, NextToken => Str])
1895  
1896 =head2 ListAllTargetsByRule(Rule => Str, [EventBusName => Str, Limit => Int, NextToken => Str])
1897  
1898  
1899 If passed a sub as first parameter, it will call the sub for each element found in :
1900  
1901 - Targets, passing the object as the first parameter, and the string 'Targets' as the second parameter
1902  
1903 If not, it will return a a L<Paws::CloudWatchEvents::ListTargetsByRuleResponse> 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.
1904  
1905  
1906  
1907  
1908  
1909 =head1 SEE ALSO
1910  
1911 This service class forms part of L<Paws>
1912  
1913 =head1 BUGS and CONTRIBUTIONS
1914  
1915 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
1916  
1917 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
1918  
1919 =cut
1920