@gammarers/aws-codesuite-state-change-detection-event-rules 2.1.22 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/API.md CHANGED
@@ -315,6 +315,319 @@ The name event rule.
315
315
  ---
316
316
 
317
317
 
318
+ ### CodePipelineStageExecutionStateChangeDetectionEventRule <a name="CodePipelineStageExecutionStateChangeDetectionEventRule" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule"></a>
319
+
320
+ #### Initializers <a name="Initializers" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer"></a>
321
+
322
+ ```typescript
323
+ import { CodePipelineStageExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules'
324
+
325
+ new CodePipelineStageExecutionStateChangeDetectionEventRule(scope: Construct, id: string, props: CodePipelineStageExecutionStateChangeDetectionEventRuleProps)
326
+ ```
327
+
328
+ | **Name** | **Type** | **Description** |
329
+ | --- | --- | --- |
330
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
331
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
332
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer.parameter.props">props</a></code> | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps">CodePipelineStageExecutionStateChangeDetectionEventRuleProps</a></code> | *No description.* |
333
+
334
+ ---
335
+
336
+ ##### `scope`<sup>Required</sup> <a name="scope" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer.parameter.scope"></a>
337
+
338
+ - *Type:* constructs.Construct
339
+
340
+ ---
341
+
342
+ ##### `id`<sup>Required</sup> <a name="id" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer.parameter.id"></a>
343
+
344
+ - *Type:* string
345
+
346
+ ---
347
+
348
+ ##### `props`<sup>Required</sup> <a name="props" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.Initializer.parameter.props"></a>
349
+
350
+ - *Type:* <a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps">CodePipelineStageExecutionStateChangeDetectionEventRuleProps</a>
351
+
352
+ ---
353
+
354
+ #### Methods <a name="Methods" id="Methods"></a>
355
+
356
+ | **Name** | **Description** |
357
+ | --- | --- |
358
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.toString">toString</a></code> | Returns a string representation of this construct. |
359
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.applyRemovalPolicy">applyRemovalPolicy</a></code> | Apply the given removal policy to this resource. |
360
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.addEventPattern">addEventPattern</a></code> | Adds an event pattern filter to this rule. |
361
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.addTarget">addTarget</a></code> | Adds a target to the rule. The abstract class RuleTarget can be extended to define new targets. |
362
+
363
+ ---
364
+
365
+ ##### `toString` <a name="toString" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.toString"></a>
366
+
367
+ ```typescript
368
+ public toString(): string
369
+ ```
370
+
371
+ Returns a string representation of this construct.
372
+
373
+ ##### `applyRemovalPolicy` <a name="applyRemovalPolicy" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.applyRemovalPolicy"></a>
374
+
375
+ ```typescript
376
+ public applyRemovalPolicy(policy: RemovalPolicy): void
377
+ ```
378
+
379
+ Apply the given removal policy to this resource.
380
+
381
+ The Removal Policy controls what happens to this resource when it stops
382
+ being managed by CloudFormation, either because you've removed it from the
383
+ CDK application or because you've made a change that requires the resource
384
+ to be replaced.
385
+
386
+ The resource can be deleted (`RemovalPolicy.DESTROY`), or left in your AWS
387
+ account for data recovery and cleanup later (`RemovalPolicy.RETAIN`).
388
+
389
+ ###### `policy`<sup>Required</sup> <a name="policy" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.applyRemovalPolicy.parameter.policy"></a>
390
+
391
+ - *Type:* aws-cdk-lib.RemovalPolicy
392
+
393
+ ---
394
+
395
+ ##### `addEventPattern` <a name="addEventPattern" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.addEventPattern"></a>
396
+
397
+ ```typescript
398
+ public addEventPattern(eventPattern?: EventPattern): void
399
+ ```
400
+
401
+ Adds an event pattern filter to this rule.
402
+
403
+ If a pattern was already specified,
404
+ these values are merged into the existing pattern.
405
+
406
+ For example, if the rule already contains the pattern:
407
+
408
+ {
409
+ "resources": [ "r1" ],
410
+ "detail": {
411
+ "hello": [ 1 ]
412
+ }
413
+ }
414
+
415
+ And `addEventPattern` is called with the pattern:
416
+
417
+ {
418
+ "resources": [ "r2" ],
419
+ "detail": {
420
+ "foo": [ "bar" ]
421
+ }
422
+ }
423
+
424
+ The resulting event pattern will be:
425
+
426
+ {
427
+ "resources": [ "r1", "r2" ],
428
+ "detail": {
429
+ "hello": [ 1 ],
430
+ "foo": [ "bar" ]
431
+ }
432
+ }
433
+
434
+ ###### `eventPattern`<sup>Optional</sup> <a name="eventPattern" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.addEventPattern.parameter.eventPattern"></a>
435
+
436
+ - *Type:* aws-cdk-lib.aws_events.EventPattern
437
+
438
+ ---
439
+
440
+ ##### `addTarget` <a name="addTarget" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.addTarget"></a>
441
+
442
+ ```typescript
443
+ public addTarget(target?: IRuleTarget): void
444
+ ```
445
+
446
+ Adds a target to the rule. The abstract class RuleTarget can be extended to define new targets.
447
+
448
+ No-op if target is undefined.
449
+
450
+ ###### `target`<sup>Optional</sup> <a name="target" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.addTarget.parameter.target"></a>
451
+
452
+ - *Type:* aws-cdk-lib.aws_events.IRuleTarget
453
+
454
+ ---
455
+
456
+ #### Static Functions <a name="Static Functions" id="Static Functions"></a>
457
+
458
+ | **Name** | **Description** |
459
+ | --- | --- |
460
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
461
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isOwnedResource">isOwnedResource</a></code> | Returns true if the construct was created by CDK, and false otherwise. |
462
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isResource">isResource</a></code> | Check whether the given construct is a Resource. |
463
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.fromEventRuleArn">fromEventRuleArn</a></code> | Import an existing EventBridge Rule provided an ARN. |
464
+
465
+ ---
466
+
467
+ ##### ~~`isConstruct`~~ <a name="isConstruct" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isConstruct"></a>
468
+
469
+ ```typescript
470
+ import { CodePipelineStageExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules'
471
+
472
+ CodePipelineStageExecutionStateChangeDetectionEventRule.isConstruct(x: any)
473
+ ```
474
+
475
+ Checks if `x` is a construct.
476
+
477
+ ###### `x`<sup>Required</sup> <a name="x" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isConstruct.parameter.x"></a>
478
+
479
+ - *Type:* any
480
+
481
+ Any object.
482
+
483
+ ---
484
+
485
+ ##### `isOwnedResource` <a name="isOwnedResource" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isOwnedResource"></a>
486
+
487
+ ```typescript
488
+ import { CodePipelineStageExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules'
489
+
490
+ CodePipelineStageExecutionStateChangeDetectionEventRule.isOwnedResource(construct: IConstruct)
491
+ ```
492
+
493
+ Returns true if the construct was created by CDK, and false otherwise.
494
+
495
+ ###### `construct`<sup>Required</sup> <a name="construct" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isOwnedResource.parameter.construct"></a>
496
+
497
+ - *Type:* constructs.IConstruct
498
+
499
+ ---
500
+
501
+ ##### `isResource` <a name="isResource" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isResource"></a>
502
+
503
+ ```typescript
504
+ import { CodePipelineStageExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules'
505
+
506
+ CodePipelineStageExecutionStateChangeDetectionEventRule.isResource(construct: IConstruct)
507
+ ```
508
+
509
+ Check whether the given construct is a Resource.
510
+
511
+ ###### `construct`<sup>Required</sup> <a name="construct" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.isResource.parameter.construct"></a>
512
+
513
+ - *Type:* constructs.IConstruct
514
+
515
+ ---
516
+
517
+ ##### `fromEventRuleArn` <a name="fromEventRuleArn" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.fromEventRuleArn"></a>
518
+
519
+ ```typescript
520
+ import { CodePipelineStageExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules'
521
+
522
+ CodePipelineStageExecutionStateChangeDetectionEventRule.fromEventRuleArn(scope: Construct, id: string, eventRuleArn: string)
523
+ ```
524
+
525
+ Import an existing EventBridge Rule provided an ARN.
526
+
527
+ ###### `scope`<sup>Required</sup> <a name="scope" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.fromEventRuleArn.parameter.scope"></a>
528
+
529
+ - *Type:* constructs.Construct
530
+
531
+ The parent creating construct (usually `this`).
532
+
533
+ ---
534
+
535
+ ###### `id`<sup>Required</sup> <a name="id" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.fromEventRuleArn.parameter.id"></a>
536
+
537
+ - *Type:* string
538
+
539
+ The construct's name.
540
+
541
+ ---
542
+
543
+ ###### `eventRuleArn`<sup>Required</sup> <a name="eventRuleArn" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.fromEventRuleArn.parameter.eventRuleArn"></a>
544
+
545
+ - *Type:* string
546
+
547
+ Event Rule ARN (i.e. arn:aws:events:<region>:<account-id>:rule/MyScheduledRule).
548
+
549
+ ---
550
+
551
+ #### Properties <a name="Properties" id="Properties"></a>
552
+
553
+ | **Name** | **Type** | **Description** |
554
+ | --- | --- | --- |
555
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
556
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.env">env</a></code> | <code>aws-cdk-lib.ResourceEnvironment</code> | The environment this resource belongs to. |
557
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.stack">stack</a></code> | <code>aws-cdk-lib.Stack</code> | The stack in which this resource is defined. |
558
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.ruleArn">ruleArn</a></code> | <code>string</code> | The value of the event rule Amazon Resource Name (ARN), such as arn:aws:events:us-east-2:123456789012:rule/example. |
559
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.ruleName">ruleName</a></code> | <code>string</code> | The name event rule. |
560
+
561
+ ---
562
+
563
+ ##### `node`<sup>Required</sup> <a name="node" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.node"></a>
564
+
565
+ ```typescript
566
+ public readonly node: Node;
567
+ ```
568
+
569
+ - *Type:* constructs.Node
570
+
571
+ The tree node.
572
+
573
+ ---
574
+
575
+ ##### `env`<sup>Required</sup> <a name="env" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.env"></a>
576
+
577
+ ```typescript
578
+ public readonly env: ResourceEnvironment;
579
+ ```
580
+
581
+ - *Type:* aws-cdk-lib.ResourceEnvironment
582
+
583
+ The environment this resource belongs to.
584
+
585
+ For resources that are created and managed by the CDK
586
+ (generally, those created by creating new class instances like Role, Bucket, etc.),
587
+ this is always the same as the environment of the stack they belong to;
588
+ however, for imported resources
589
+ (those obtained from static methods like fromRoleArn, fromBucketName, etc.),
590
+ that might be different than the stack they were imported into.
591
+
592
+ ---
593
+
594
+ ##### `stack`<sup>Required</sup> <a name="stack" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.stack"></a>
595
+
596
+ ```typescript
597
+ public readonly stack: Stack;
598
+ ```
599
+
600
+ - *Type:* aws-cdk-lib.Stack
601
+
602
+ The stack in which this resource is defined.
603
+
604
+ ---
605
+
606
+ ##### `ruleArn`<sup>Required</sup> <a name="ruleArn" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.ruleArn"></a>
607
+
608
+ ```typescript
609
+ public readonly ruleArn: string;
610
+ ```
611
+
612
+ - *Type:* string
613
+
614
+ The value of the event rule Amazon Resource Name (ARN), such as arn:aws:events:us-east-2:123456789012:rule/example.
615
+
616
+ ---
617
+
618
+ ##### `ruleName`<sup>Required</sup> <a name="ruleName" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRule.property.ruleName"></a>
619
+
620
+ ```typescript
621
+ public readonly ruleName: string;
622
+ ```
623
+
624
+ - *Type:* string
625
+
626
+ The name event rule.
627
+
628
+ ---
629
+
630
+
318
631
  ## Structs <a name="Structs" id="Structs"></a>
319
632
 
320
633
  ### CodePipelineExecutionStateChangeDetectionEventRuleProps <a name="CodePipelineExecutionStateChangeDetectionEventRuleProps" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineExecutionStateChangeDetectionEventRuleProps"></a>
@@ -475,6 +788,164 @@ public readonly targetStates: CodePipelineExecutionState[];
475
788
 
476
789
  ---
477
790
 
791
+ ### CodePipelineStageExecutionStateChangeDetectionEventRuleProps <a name="CodePipelineStageExecutionStateChangeDetectionEventRuleProps" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps"></a>
792
+
793
+ #### Initializer <a name="Initializer" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.Initializer"></a>
794
+
795
+ ```typescript
796
+ import { CodePipelineStageExecutionStateChangeDetectionEventRuleProps } from '@gammarers/aws-codesuite-state-change-detection-event-rules'
797
+
798
+ const codePipelineStageExecutionStateChangeDetectionEventRuleProps: CodePipelineStageExecutionStateChangeDetectionEventRuleProps = { ... }
799
+ ```
800
+
801
+ #### Properties <a name="Properties" id="Properties"></a>
802
+
803
+ | **Name** | **Type** | **Description** |
804
+ | --- | --- | --- |
805
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.crossStackScope">crossStackScope</a></code> | <code>constructs.Construct</code> | The scope to use if the source of the rule and its target are in different Stacks (but in the same account & region). |
806
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.description">description</a></code> | <code>string</code> | A description of the rule's purpose. |
807
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.eventPattern">eventPattern</a></code> | <code>aws-cdk-lib.aws_events.EventPattern</code> | Additional restrictions for the event to route to the specified target. |
808
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.ruleName">ruleName</a></code> | <code>string</code> | A name for the rule. |
809
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.enabled">enabled</a></code> | <code>boolean</code> | Indicates whether the rule is enabled. |
810
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.eventBus">eventBus</a></code> | <code>aws-cdk-lib.aws_events.IEventBus</code> | The event bus to associate with this rule. |
811
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.schedule">schedule</a></code> | <code>aws-cdk-lib.aws_events.Schedule</code> | The schedule or rate (frequency) that determines when EventBridge runs the rule. |
812
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.targets">targets</a></code> | <code>aws-cdk-lib.aws_events.IRuleTarget[]</code> | Targets to invoke when this rule matches an event. |
813
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.targetStates">targetStates</a></code> | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState">CodePipelineStageExecutionState</a>[]</code> | *No description.* |
814
+
815
+ ---
816
+
817
+ ##### `crossStackScope`<sup>Optional</sup> <a name="crossStackScope" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.crossStackScope"></a>
818
+
819
+ ```typescript
820
+ public readonly crossStackScope: Construct;
821
+ ```
822
+
823
+ - *Type:* constructs.Construct
824
+ - *Default:* none (the main scope will be used, even for cross-stack Events)
825
+
826
+ The scope to use if the source of the rule and its target are in different Stacks (but in the same account & region).
827
+
828
+ This helps dealing with cycles that often arise in these situations.
829
+
830
+ ---
831
+
832
+ ##### `description`<sup>Optional</sup> <a name="description" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.description"></a>
833
+
834
+ ```typescript
835
+ public readonly description: string;
836
+ ```
837
+
838
+ - *Type:* string
839
+ - *Default:* No description
840
+
841
+ A description of the rule's purpose.
842
+
843
+ ---
844
+
845
+ ##### `eventPattern`<sup>Optional</sup> <a name="eventPattern" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.eventPattern"></a>
846
+
847
+ ```typescript
848
+ public readonly eventPattern: EventPattern;
849
+ ```
850
+
851
+ - *Type:* aws-cdk-lib.aws_events.EventPattern
852
+ - *Default:* No additional filtering based on an event pattern.
853
+
854
+ Additional restrictions for the event to route to the specified target.
855
+
856
+ The method that generates the rule probably imposes some type of event
857
+ filtering. The filtering implied by what you pass here is added
858
+ on top of that filtering.
859
+
860
+ > [https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html)
861
+
862
+ ---
863
+
864
+ ##### `ruleName`<sup>Optional</sup> <a name="ruleName" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.ruleName"></a>
865
+
866
+ ```typescript
867
+ public readonly ruleName: string;
868
+ ```
869
+
870
+ - *Type:* string
871
+ - *Default:* AWS CloudFormation generates a unique physical ID.
872
+
873
+ A name for the rule.
874
+
875
+ ---
876
+
877
+ ##### `enabled`<sup>Optional</sup> <a name="enabled" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.enabled"></a>
878
+
879
+ ```typescript
880
+ public readonly enabled: boolean;
881
+ ```
882
+
883
+ - *Type:* boolean
884
+ - *Default:* true
885
+
886
+ Indicates whether the rule is enabled.
887
+
888
+ ---
889
+
890
+ ##### `eventBus`<sup>Optional</sup> <a name="eventBus" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.eventBus"></a>
891
+
892
+ ```typescript
893
+ public readonly eventBus: IEventBus;
894
+ ```
895
+
896
+ - *Type:* aws-cdk-lib.aws_events.IEventBus
897
+ - *Default:* The default event bus.
898
+
899
+ The event bus to associate with this rule.
900
+
901
+ ---
902
+
903
+ ##### `schedule`<sup>Optional</sup> <a name="schedule" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.schedule"></a>
904
+
905
+ ```typescript
906
+ public readonly schedule: Schedule;
907
+ ```
908
+
909
+ - *Type:* aws-cdk-lib.aws_events.Schedule
910
+ - *Default:* None.
911
+
912
+ The schedule or rate (frequency) that determines when EventBridge runs the rule.
913
+
914
+ You must specify this property, the `eventPattern` property, or both.
915
+
916
+ For more information, see Schedule Expression Syntax for
917
+ Rules in the Amazon EventBridge User Guide.
918
+
919
+ > [https://docs.aws.amazon.com/eventbridge/latest/userguide/scheduled-events.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/scheduled-events.html)
920
+
921
+ ---
922
+
923
+ ##### `targets`<sup>Optional</sup> <a name="targets" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.targets"></a>
924
+
925
+ ```typescript
926
+ public readonly targets: IRuleTarget[];
927
+ ```
928
+
929
+ - *Type:* aws-cdk-lib.aws_events.IRuleTarget[]
930
+ - *Default:* No targets.
931
+
932
+ Targets to invoke when this rule matches an event.
933
+
934
+ Input will be the full matched event. If you wish to specify custom
935
+ target input, use `addTarget(target[, inputOptions])`.
936
+
937
+ ---
938
+
939
+ ##### `targetStates`<sup>Optional</sup> <a name="targetStates" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionStateChangeDetectionEventRuleProps.property.targetStates"></a>
940
+
941
+ ```typescript
942
+ public readonly targetStates: CodePipelineStageExecutionState[];
943
+ ```
944
+
945
+ - *Type:* <a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState">CodePipelineStageExecutionState</a>[]
946
+
947
+ ---
948
+
478
949
 
479
950
 
480
951
  ## Enums <a name="Enums" id="Enums"></a>
@@ -535,3 +1006,54 @@ public readonly targetStates: CodePipelineExecutionState[];
535
1006
 
536
1007
  ---
537
1008
 
1009
+
1010
+ ### CodePipelineStageExecutionState <a name="CodePipelineStageExecutionState" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState"></a>
1011
+
1012
+ #### Members <a name="Members" id="Members"></a>
1013
+
1014
+ | **Name** | **Description** |
1015
+ | --- | --- |
1016
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.CANCELED">CANCELED</a></code> | *No description.* |
1017
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.FAILED">FAILED</a></code> | *No description.* |
1018
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.RESUMED">RESUMED</a></code> | *No description.* |
1019
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.STARTED">STARTED</a></code> | *No description.* |
1020
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.STOPPED">STOPPED</a></code> | *No description.* |
1021
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.STOPPING">STOPPING</a></code> | *No description.* |
1022
+ | <code><a href="#@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.SUCCEEDED">SUCCEEDED</a></code> | *No description.* |
1023
+
1024
+ ---
1025
+
1026
+ ##### `CANCELED` <a name="CANCELED" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.CANCELED"></a>
1027
+
1028
+ ---
1029
+
1030
+
1031
+ ##### `FAILED` <a name="FAILED" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.FAILED"></a>
1032
+
1033
+ ---
1034
+
1035
+
1036
+ ##### `RESUMED` <a name="RESUMED" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.RESUMED"></a>
1037
+
1038
+ ---
1039
+
1040
+
1041
+ ##### `STARTED` <a name="STARTED" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.STARTED"></a>
1042
+
1043
+ ---
1044
+
1045
+
1046
+ ##### `STOPPED` <a name="STOPPED" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.STOPPED"></a>
1047
+
1048
+ ---
1049
+
1050
+
1051
+ ##### `STOPPING` <a name="STOPPING" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.STOPPING"></a>
1052
+
1053
+ ---
1054
+
1055
+
1056
+ ##### `SUCCEEDED` <a name="SUCCEEDED" id="@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineStageExecutionState.SUCCEEDED"></a>
1057
+
1058
+ ---
1059
+
package/README.md CHANGED
@@ -36,6 +36,8 @@ bun add @gammarers/aws-codesuite-state-change-detection-event-rules
36
36
 
37
37
  ## Example
38
38
 
39
+ ### CodePipeline Pipeline Execution State Change Detection Event Rule Handling
40
+
39
41
  ```typescript
40
42
  import { CodePipelineExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules';
41
43
 
@@ -52,6 +54,24 @@ const rule = new CodePipelineExecutionStateChangeDetectionEventRule(stack, 'Code
52
54
 
53
55
  ```
54
56
 
57
+ ### CodePipeline Stage Execution State Chagen Detection Event Rule Handling
58
+
59
+ ```ts
60
+ import { CodePipelineStageExecutionStateChangeDetectionEventRule } from '@gammarers/aws-codesuite-state-change-detection-event-rules';
61
+
62
+ const fn = new lambda.Function(this, 'MyFunc', {
63
+ runtime: lambda.Runtime.NODEJS_LATEST,
64
+ handler: 'index.handler',
65
+ code: lambda.Code.fromInline(`exports.handler = handler.toString()`),
66
+ });
67
+
68
+ const rule = new CodePipelineStageExecutionStateChangeDetectionEventRule(stack, 'CodePipelineStageExecutionStateChangeDetectionEventRule', {
69
+ targets: new targets.LambdaFunction(fn),
70
+ });
71
+
72
+ ```
73
+
74
+
55
75
  ## License
56
76
 
57
77
  This project is licensed under the Apache-2.0 License.
@@ -51,5 +51,5 @@ class CodePipelineExecutionStateChangeDetectionEventRule extends events.Rule {
51
51
  }
52
52
  exports.CodePipelineExecutionStateChangeDetectionEventRule = CodePipelineExecutionStateChangeDetectionEventRule;
53
53
  _a = JSII_RTTI_SYMBOL_1;
54
- CodePipelineExecutionStateChangeDetectionEventRule[_a] = { fqn: "@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineExecutionStateChangeDetectionEventRule", version: "2.1.22" };
54
+ CodePipelineExecutionStateChangeDetectionEventRule[_a] = { fqn: "@gammarers/aws-codesuite-state-change-detection-event-rules.CodePipelineExecutionStateChangeDetectionEventRule", version: "2.2.1" };
55
55
  //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29kZXBpcGVsaW5lLWV4ZWN1dGlvbi1zdGF0ZS1jaGFuZ2UtZGV0ZWN0aW9uLWV2ZW50LXJ1bGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29kZXBpcGVsaW5lLWV4ZWN1dGlvbi1zdGF0ZS1jaGFuZ2UtZGV0ZWN0aW9uLWV2ZW50LXJ1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQSw4REFBb0Y7QUFDcEYsaURBQWlEO0FBR2pEOzs7OztHQUtHO0FBRUgsSUFBWSwwQkFTWDtBQVRELFdBQVksMEJBQTBCO0lBQ3BDLG1EQUFxQixDQUFBO0lBQ3JCLCtDQUFpQixDQUFBO0lBQ2pCLGlEQUFtQixDQUFBO0lBQ25CLGlEQUFtQixDQUFBO0lBQ25CLGlEQUFtQixDQUFBO0lBQ25CLG1EQUFxQixDQUFBO0lBQ3JCLHFEQUF1QixDQUFBO0lBQ3ZCLHVEQUF5QixDQUFBO0FBQzNCLENBQUMsRUFUVywwQkFBMEIsMENBQTFCLDBCQUEwQixRQVNyQztBQU1ELE1BQWEsa0RBQW1ELFNBQVEsTUFBTSxDQUFDLElBQUk7SUFDakYsWUFBWSxLQUFnQixFQUFFLEVBQVUsRUFBRSxLQUE4RDtRQUN0RyxLQUFLLENBQUMsS0FBSyxFQUFFLEVBQUUsRUFBRTtZQUNmLEdBQUcsS0FBSztZQUNSLFlBQVksRUFBRSxDQUFDLEdBQXdCLEVBQUU7Z0JBQ3ZDLElBQUksS0FBSyxDQUFDLFlBQVksRUFBRSxDQUFDO29CQUN2QixNQUFNLElBQUksd0RBQXVDLENBQUMsY0FBYyxDQUFDLENBQUM7Z0JBQ3BFLENBQUM7Z0JBQ0QsT0FBTztvQkFDTCxNQUFNLEVBQUUsQ0FBQyxrQkFBa0IsQ0FBQztvQkFDNUIsVUFBVSxFQUFFLENBQUMsOENBQThDLENBQUM7b0JBQzVELHFCQUFxQjtvQkFDckIsd0NBQXdDO29CQUN4QyxjQUFjO29CQUNkLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRTt3QkFDWixJQUFJLEtBQUssQ0FBQyxZQUFZLEVBQUUsQ0FBQzs0QkFDdkIsT0FBTztnQ0FDTCxLQUFLLEVBQUUsS0FBSyxDQUFDLFlBQVk7NkJBQzFCLENBQUM7d0JBQ0osQ0FBQzt3QkFDRCxPQUFPLFNBQVMsQ0FBQztvQkFDbkIsQ0FBQyxDQUFDLEVBQUU7aUJBQ0wsQ0FBQztZQUNKLENBQUMsQ0FBQyxFQUFFO1NBQ0wsQ0FBQyxDQUFDO0lBQ0wsQ0FBQzs7QUF6QkgsZ0hBMEJDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgSW52YWxpZEludGVybmFsRGVmaW5pdGlvblBhcmFtZXRlckVycm9yIH0gZnJvbSAnQGdhbW1hcmVycy9hd3MtY2RrLWVycm9ycyc7XG5pbXBvcnQgKiBhcyBldmVudHMgZnJvbSAnYXdzLWNkay1saWIvYXdzLWV2ZW50cyc7XG5pbXBvcnQgeyBDb25zdHJ1Y3QgfSBmcm9tICdjb25zdHJ1Y3RzJztcblxuLyoqXG4gKiBAVE9ETzogTm90IHlldCBzdXBwb3J0ZWQgT21pdFxuICogaHR0cHM6Ly9naXRodWIuY29tL2F3cy9qc2lpL2lzc3Vlcy80NDY4XG4gKiB0eXBlIG9taXRLZXlzID0gJ2V2ZW50UGF0dGVybic7XG4gKiBleHBvcnQgaW50ZXJmYWNlIENvZGVQaXBlbGluZVN0YXRlQ2hhbmdlRGV0ZWN0aW9uRXZlbnRSdWxlUHJvcHMgZXh0ZW5kcyBPbWl0PGV2ZW50cy5SdWxlUHJvcHMsICdldmVudFBhdHRlcm4nPiB7fVxuICovXG5cbmV4cG9ydCBlbnVtIENvZGVQaXBlbGluZUV4ZWN1dGlvblN0YXRlIHtcbiAgQ0FOQ0VMRUQgPSAnQ0FOQ0VMRUQnLFxuICBGQUlMRUQgPSAnRkFJTEVEJyxcbiAgUkVTVU1FRCA9ICdSRVNVTUVEJyxcbiAgU1RBUlRFRCA9ICdTVEFSVEVEJyxcbiAgU1RPUFBFRCA9ICdTVE9QUEVEJyxcbiAgU1RPUFBJTkcgPSAnU1RPUFBJTkcnLFxuICBTVUNDRUVERUQgPSAnU1VDQ0VFREVEJyxcbiAgU1VQRVJTRURFRCA9ICdTVVBFUlNFREVEJyxcbn1cblxuZXhwb3J0IGludGVyZmFjZSBDb2RlUGlwZWxpbmVFeGVjdXRpb25TdGF0ZUNoYW5nZURldGVjdGlvbkV2ZW50UnVsZVByb3BzIGV4dGVuZHMgZXZlbnRzLlJ1bGVQcm9wcyB7XG4gIHJlYWRvbmx5IHRhcmdldFN0YXRlcz86IENvZGVQaXBlbGluZUV4ZWN1dGlvblN0YXRlW107XG59XG5cbmV4cG9ydCBjbGFzcyBDb2RlUGlwZWxpbmVFeGVjdXRpb25TdGF0ZUNoYW5nZURldGVjdGlvbkV2ZW50UnVsZSBleHRlbmRzIGV2ZW50cy5SdWxlIHtcbiAgY29uc3RydWN0b3Ioc2NvcGU6IENvbnN0cnVjdCwgaWQ6IHN0cmluZywgcHJvcHM6IENvZGVQaXBlbGluZUV4ZWN1dGlvblN0YXRlQ2hhbmdlRGV0ZWN0aW9uRXZlbnRSdWxlUHJvcHMpIHtcbiAgICBzdXBlcihzY29wZSwgaWQsIHtcbiAgICAgIC4uLnByb3BzLFxuICAgICAgZXZlbnRQYXR0ZXJuOiAoKCk6IGV2ZW50cy5FdmVudFBhdHRlcm4gPT4ge1xuICAgICAgICBpZiAocHJvcHMuZXZlbnRQYXR0ZXJuKSB7XG4gICAgICAgICAgdGhyb3cgbmV3IEludmFsaWRJbnRlcm5hbERlZmluaXRpb25QYXJhbWV0ZXJFcnJvcignZXZlbnRQYXR0ZXJuJyk7XG4gICAgICAgIH1cbiAgICAgICAgcmV0dXJuIHtcbiAgICAgICAgICBzb3VyY2U6IFsnYXdzLmNvZGVwaXBlbGluZSddLFxuICAgICAgICAgIGRldGFpbFR5cGU6IFsnQ29kZVBpcGVsaW5lIFBpcGVsaW5lIEV4ZWN1dGlvbiBTdGF0ZSBDaGFuZ2UnXSxcbiAgICAgICAgICAvLyAgICAgICAgICBkZXRhaWw6IHtcbiAgICAgICAgICAvLyAgICAgICAgICAgIHN0YXRlOiBwcm9wcy50YXJnZXRTdGF0ZXMsXG4gICAgICAgICAgLy8gICAgICAgICAgfSxcbiAgICAgICAgICBkZXRhaWw6ICgoKSA9PiB7XG4gICAgICAgICAgICBpZiAocHJvcHMudGFyZ2V0U3RhdGVzKSB7XG4gICAgICAgICAgICAgIHJldHVybiB7XG4gICAgICAgICAgICAgICAgc3RhdGU6IHByb3BzLnRhcmdldFN0YXRlcyxcbiAgICAgICAgICAgICAgfTtcbiAgICAgICAgICAgIH1cbiAgICAgICAgICAgIHJldHVybiB1bmRlZmluZWQ7XG4gICAgICAgICAgfSkoKSxcbiAgICAgICAgfTtcbiAgICAgIH0pKCksXG4gICAgfSk7XG4gIH1cbn0iXX0=
@@ -0,0 +1,23 @@
1
+ import * as events from 'aws-cdk-lib/aws-events';
2
+ import { Construct } from 'constructs';
3
+ /**
4
+ * @TODO: Not yet supported Omit
5
+ * https://github.com/aws/jsii/issues/4468
6
+ * type omitKeys = 'eventPattern';
7
+ * export interface CodePipelineStateChangeDetectionEventRuleProps extends Omit<events.RuleProps, 'eventPattern'> {}
8
+ */
9
+ export declare enum CodePipelineStageExecutionState {
10
+ CANCELED = "CANCELED",
11
+ FAILED = "FAILED",
12
+ RESUMED = "RESUMED",
13
+ STARTED = "STARTED",
14
+ STOPPED = "STOPPED",
15
+ STOPPING = "STOPPING",
16
+ SUCCEEDED = "SUCCEEDED"
17
+ }
18
+ export interface CodePipelineStageExecutionStateChangeDetectionEventRuleProps extends events.RuleProps {
19
+ readonly targetStates?: CodePipelineStageExecutionState[];
20
+ }
21
+ export declare class CodePipelineStageExecutionStateChangeDetectionEventRule extends events.Rule {
22
+ constructor(scope: Construct, id: string, props: CodePipelineStageExecutionStateChangeDetectionEventRuleProps);
23
+ }