@aws-sdk/client-codestar-notifications 3.379.1 → 3.382.0

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.
@@ -71,6 +71,7 @@ export type NotificationRuleStatus = (typeof NotificationRuleStatus)[keyof typeo
71
71
  */
72
72
  export interface Target {
73
73
  /**
74
+ * @public
74
75
  * <p>The target type. Can be an Chatbot topic or Chatbot client.</p>
75
76
  * <ul>
76
77
  * <li>
@@ -83,6 +84,7 @@ export interface Target {
83
84
  */
84
85
  TargetType?: string;
85
86
  /**
87
+ * @public
86
88
  * <p>The Amazon Resource Name (ARN) of the Chatbot topic or Chatbot client.</p>
87
89
  */
88
90
  TargetAddress?: string;
@@ -92,31 +94,37 @@ export interface Target {
92
94
  */
93
95
  export interface CreateNotificationRuleRequest {
94
96
  /**
97
+ * @public
95
98
  * <p>The name for the notification rule. Notification rule names must be unique in your Amazon Web Services account.</p>
96
99
  */
97
100
  Name: string | undefined;
98
101
  /**
102
+ * @public
99
103
  * <p>A list of event types associated with this notification rule. For a list of allowed
100
104
  * events, see <a>EventTypeSummary</a>.</p>
101
105
  */
102
106
  EventTypeIds: string[] | undefined;
103
107
  /**
108
+ * @public
104
109
  * <p>The Amazon Resource Name (ARN) of the resource to associate with the notification rule. Supported resources include pipelines in CodePipeline,
105
110
  * repositories in CodeCommit, and build projects in CodeBuild.</p>
106
111
  */
107
112
  Resource: string | undefined;
108
113
  /**
114
+ * @public
109
115
  * <p>A list of Amazon Resource Names (ARNs) of Amazon Simple Notification Service topics and Chatbot clients to associate with the
110
116
  * notification rule.</p>
111
117
  */
112
118
  Targets: Target[] | undefined;
113
119
  /**
120
+ * @public
114
121
  * <p>The level of detail to include in the notifications for this resource. <code>BASIC</code> will include only the
115
122
  * contents of the event as it would appear in Amazon CloudWatch. <code>FULL</code> will include any supplemental information
116
123
  * provided by AWS CodeStar Notifications and/or the service for the resource for which the notification is created.</p>
117
124
  */
118
125
  DetailType: DetailType | string | undefined;
119
126
  /**
127
+ * @public
120
128
  * <p>A unique, client-generated idempotency token that, when provided in a request, ensures
121
129
  * the request cannot be repeated with a changed parameter. If a request with the same
122
130
  * parameters is received and a token is included, the request returns information about
@@ -128,10 +136,12 @@ export interface CreateNotificationRuleRequest {
128
136
  */
129
137
  ClientRequestToken?: string;
130
138
  /**
139
+ * @public
131
140
  * <p>A list of tags to apply to this notification rule. Key names cannot start with "<code>aws</code>". </p>
132
141
  */
133
142
  Tags?: Record<string, string>;
134
143
  /**
144
+ * @public
135
145
  * <p>The status of the notification rule. The default value is <code>ENABLED</code>. If the status is
136
146
  * set to <code>DISABLED</code>, notifications aren't sent for the notification rule.</p>
137
147
  */
@@ -142,6 +152,7 @@ export interface CreateNotificationRuleRequest {
142
152
  */
143
153
  export interface CreateNotificationRuleResult {
144
154
  /**
155
+ * @public
145
156
  * <p>The Amazon Resource Name (ARN) of the notification rule.</p>
146
157
  */
147
158
  Arn?: string;
@@ -193,6 +204,7 @@ export declare class ValidationException extends __BaseException {
193
204
  */
194
205
  export interface DeleteNotificationRuleRequest {
195
206
  /**
207
+ * @public
196
208
  * <p>The Amazon Resource Name (ARN) of the notification rule you want to delete.</p>
197
209
  */
198
210
  Arn: string | undefined;
@@ -202,6 +214,7 @@ export interface DeleteNotificationRuleRequest {
202
214
  */
203
215
  export interface DeleteNotificationRuleResult {
204
216
  /**
217
+ * @public
205
218
  * <p>The Amazon Resource Name (ARN) of the deleted notification rule.</p>
206
219
  */
207
220
  Arn?: string;
@@ -211,10 +224,12 @@ export interface DeleteNotificationRuleResult {
211
224
  */
212
225
  export interface DeleteTargetRequest {
213
226
  /**
227
+ * @public
214
228
  * <p>The Amazon Resource Name (ARN) of the Chatbot topic or Chatbot client to delete.</p>
215
229
  */
216
230
  TargetAddress: string | undefined;
217
231
  /**
232
+ * @public
218
233
  * <p>A Boolean value that can be used to delete all associations with this Chatbot topic. The
219
234
  * default value is FALSE. If set to TRUE, all associations between that target and every
220
235
  * notification rule in your Amazon Web Services account are deleted.</p>
@@ -231,6 +246,7 @@ export interface DeleteTargetResult {
231
246
  */
232
247
  export interface DescribeNotificationRuleRequest {
233
248
  /**
249
+ * @public
234
250
  * <p>The Amazon Resource Name (ARN) of the notification rule.</p>
235
251
  */
236
252
  Arn: string | undefined;
@@ -241,20 +257,24 @@ export interface DescribeNotificationRuleRequest {
241
257
  */
242
258
  export interface EventTypeSummary {
243
259
  /**
260
+ * @public
244
261
  * <p>The system-generated ID of the event. For a complete list of event types and IDs, see
245
262
  * <a href="https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#concepts-api">Notification concepts</a>
246
263
  * in the <i>Developer Tools Console User Guide</i>.</p>
247
264
  */
248
265
  EventTypeId?: string;
249
266
  /**
267
+ * @public
250
268
  * <p>The name of the service for which the event applies.</p>
251
269
  */
252
270
  ServiceName?: string;
253
271
  /**
272
+ * @public
254
273
  * <p>The name of the event.</p>
255
274
  */
256
275
  EventTypeName?: string;
257
276
  /**
277
+ * @public
258
278
  * <p>The resource type of the event.</p>
259
279
  */
260
280
  ResourceType?: string;
@@ -280,10 +300,12 @@ export type TargetStatus = (typeof TargetStatus)[keyof typeof TargetStatus];
280
300
  */
281
301
  export interface TargetSummary {
282
302
  /**
303
+ * @public
283
304
  * <p>The Amazon Resource Name (ARN) of the Chatbot topic or Chatbot client.</p>
284
305
  */
285
306
  TargetAddress?: string;
286
307
  /**
308
+ * @public
287
309
  * <p>The type of the target (for example, <code>SNS</code>).</p>
288
310
  * <ul>
289
311
  * <li>
@@ -296,6 +318,7 @@ export interface TargetSummary {
296
318
  */
297
319
  TargetType?: string;
298
320
  /**
321
+ * @public
299
322
  * <p>The status of the target.</p>
300
323
  */
301
324
  TargetStatus?: TargetStatus | string;
@@ -305,51 +328,62 @@ export interface TargetSummary {
305
328
  */
306
329
  export interface DescribeNotificationRuleResult {
307
330
  /**
331
+ * @public
308
332
  * <p>The Amazon Resource Name (ARN) of the notification rule.</p>
309
333
  */
310
334
  Arn: string | undefined;
311
335
  /**
336
+ * @public
312
337
  * <p>The name of the notification rule.</p>
313
338
  */
314
339
  Name?: string;
315
340
  /**
341
+ * @public
316
342
  * <p>A list of the event types associated with the notification rule.</p>
317
343
  */
318
344
  EventTypes?: EventTypeSummary[];
319
345
  /**
346
+ * @public
320
347
  * <p>The Amazon Resource Name (ARN) of the resource associated with the notification
321
348
  * rule.</p>
322
349
  */
323
350
  Resource?: string;
324
351
  /**
352
+ * @public
325
353
  * <p>A list of the Chatbot topics and Chatbot clients associated with the notification rule.</p>
326
354
  */
327
355
  Targets?: TargetSummary[];
328
356
  /**
357
+ * @public
329
358
  * <p>The level of detail included in the notifications for this resource. BASIC will include only the
330
359
  * contents of the event as it would appear in Amazon CloudWatch. FULL will include any supplemental information
331
360
  * provided by AWS CodeStar Notifications and/or the service for the resource for which the notification is created.</p>
332
361
  */
333
362
  DetailType?: DetailType | string;
334
363
  /**
364
+ * @public
335
365
  * <p>The name or email alias of the person who created the notification rule.</p>
336
366
  */
337
367
  CreatedBy?: string;
338
368
  /**
369
+ * @public
339
370
  * <p>The status of the notification rule. Valid statuses are on (sending notifications) or off
340
371
  * (not sending notifications).</p>
341
372
  */
342
373
  Status?: NotificationRuleStatus | string;
343
374
  /**
375
+ * @public
344
376
  * <p>The date and time the notification rule was created, in timestamp format.</p>
345
377
  */
346
378
  CreatedTimestamp?: Date;
347
379
  /**
380
+ * @public
348
381
  * <p>The date and time the notification rule was most recently updated, in timestamp
349
382
  * format.</p>
350
383
  */
351
384
  LastModifiedTimestamp?: Date;
352
385
  /**
386
+ * @public
353
387
  * <p>The tags associated with the notification rule.</p>
354
388
  */
355
389
  Tags?: Record<string, string>;
@@ -399,10 +433,12 @@ export type ListEventTypesFilterName = (typeof ListEventTypesFilterName)[keyof t
399
433
  */
400
434
  export interface ListEventTypesFilter {
401
435
  /**
436
+ * @public
402
437
  * <p>The system-generated name of the filter type you want to filter by.</p>
403
438
  */
404
439
  Name: ListEventTypesFilterName | string | undefined;
405
440
  /**
441
+ * @public
406
442
  * <p>The name of the resource type (for example, pipeline) or service name (for example,
407
443
  * CodePipeline) that you want to filter by.</p>
408
444
  */
@@ -413,15 +449,18 @@ export interface ListEventTypesFilter {
413
449
  */
414
450
  export interface ListEventTypesRequest {
415
451
  /**
452
+ * @public
416
453
  * <p>The filters to use to return information by service or resource type.</p>
417
454
  */
418
455
  Filters?: ListEventTypesFilter[];
419
456
  /**
457
+ * @public
420
458
  * <p>An enumeration token that, when provided in a request, returns the next batch of the
421
459
  * results.</p>
422
460
  */
423
461
  NextToken?: string;
424
462
  /**
463
+ * @public
425
464
  * <p>A non-negative integer used to limit the number of returned results. The default number is 50. The maximum number of
426
465
  * results that can be returned is 100.</p>
427
466
  */
@@ -432,11 +471,13 @@ export interface ListEventTypesRequest {
432
471
  */
433
472
  export interface ListEventTypesResult {
434
473
  /**
474
+ * @public
435
475
  * <p>Information about each event, including service name, resource type, event ID, and event
436
476
  * name.</p>
437
477
  */
438
478
  EventTypes?: EventTypeSummary[];
439
479
  /**
480
+ * @public
440
481
  * <p>An enumeration token that can be used in a request to return the next batch of the results.</p>
441
482
  */
442
483
  NextToken?: string;
@@ -462,10 +503,12 @@ export type ListNotificationRulesFilterName = (typeof ListNotificationRulesFilte
462
503
  */
463
504
  export interface ListNotificationRulesFilter {
464
505
  /**
506
+ * @public
465
507
  * <p>The name of the attribute you want to use to filter the returned notification rules.</p>
466
508
  */
467
509
  Name: ListNotificationRulesFilterName | string | undefined;
468
510
  /**
511
+ * @public
469
512
  * <p>The value of the attribute you want to use to filter the returned notification rules. For example, if you specify filtering by <i>RESOURCE</i>
470
513
  * in Name, you might specify the ARN of a pipeline in CodePipeline for the value.</p>
471
514
  */
@@ -476,6 +519,7 @@ export interface ListNotificationRulesFilter {
476
519
  */
477
520
  export interface ListNotificationRulesRequest {
478
521
  /**
522
+ * @public
479
523
  * <p>The filters to use to return information by service or resource type. For valid values,
480
524
  * see <a>ListNotificationRulesFilter</a>.</p>
481
525
  * <note>
@@ -484,11 +528,13 @@ export interface ListNotificationRulesRequest {
484
528
  */
485
529
  Filters?: ListNotificationRulesFilter[];
486
530
  /**
531
+ * @public
487
532
  * <p>An enumeration token that, when provided in a request, returns the next batch of the
488
533
  * results.</p>
489
534
  */
490
535
  NextToken?: string;
491
536
  /**
537
+ * @public
492
538
  * <p>A non-negative integer used to limit the number of returned results. The maximum number of
493
539
  * results that can be returned is 100.</p>
494
540
  */
@@ -500,10 +546,12 @@ export interface ListNotificationRulesRequest {
500
546
  */
501
547
  export interface NotificationRuleSummary {
502
548
  /**
549
+ * @public
503
550
  * <p>The unique ID of the notification rule.</p>
504
551
  */
505
552
  Id?: string;
506
553
  /**
554
+ * @public
507
555
  * <p>The Amazon Resource Name (ARN) of the notification rule.</p>
508
556
  */
509
557
  Arn?: string;
@@ -513,10 +561,12 @@ export interface NotificationRuleSummary {
513
561
  */
514
562
  export interface ListNotificationRulesResult {
515
563
  /**
564
+ * @public
516
565
  * <p>An enumeration token that can be used in a request to return the next batch of the results.</p>
517
566
  */
518
567
  NextToken?: string;
519
568
  /**
569
+ * @public
520
570
  * <p>The list of notification rules for the Amazon Web Services account, by Amazon Resource Name (ARN) and ID. </p>
521
571
  */
522
572
  NotificationRules?: NotificationRuleSummary[];
@@ -526,6 +576,7 @@ export interface ListNotificationRulesResult {
526
576
  */
527
577
  export interface ListTagsForResourceRequest {
528
578
  /**
579
+ * @public
529
580
  * <p>The Amazon Resource Name (ARN) for the notification rule.</p>
530
581
  */
531
582
  Arn: string | undefined;
@@ -535,6 +586,7 @@ export interface ListTagsForResourceRequest {
535
586
  */
536
587
  export interface ListTagsForResourceResult {
537
588
  /**
589
+ * @public
538
590
  * <p>The tags associated with the notification rule.</p>
539
591
  */
540
592
  Tags?: Record<string, string>;
@@ -562,10 +614,12 @@ export type ListTargetsFilterName = (typeof ListTargetsFilterName)[keyof typeof
562
614
  */
563
615
  export interface ListTargetsFilter {
564
616
  /**
617
+ * @public
565
618
  * <p>The name of the attribute you want to use to filter the returned targets.</p>
566
619
  */
567
620
  Name: ListTargetsFilterName | string | undefined;
568
621
  /**
622
+ * @public
569
623
  * <p>The value of the attribute you want to use to filter the returned targets. For example,
570
624
  * if you specify <code>SNS</code> for the Target type, you could specify an Amazon
571
625
  * Resource Name (ARN) for a topic as the value.</p>
@@ -577,6 +631,7 @@ export interface ListTargetsFilter {
577
631
  */
578
632
  export interface ListTargetsRequest {
579
633
  /**
634
+ * @public
580
635
  * <p>The filters to use to return information by service or resource type. Valid filters
581
636
  * include target type, target address, and target status.</p>
582
637
  * <note>
@@ -585,11 +640,13 @@ export interface ListTargetsRequest {
585
640
  */
586
641
  Filters?: ListTargetsFilter[];
587
642
  /**
643
+ * @public
588
644
  * <p>An enumeration token that, when provided in a request, returns the next batch of the
589
645
  * results.</p>
590
646
  */
591
647
  NextToken?: string;
592
648
  /**
649
+ * @public
593
650
  * <p>A non-negative integer used to limit the number of returned results. The maximum number of
594
651
  * results that can be returned is 100.</p>
595
652
  */
@@ -600,10 +657,12 @@ export interface ListTargetsRequest {
600
657
  */
601
658
  export interface ListTargetsResult {
602
659
  /**
660
+ * @public
603
661
  * <p>The list of notification rule targets. </p>
604
662
  */
605
663
  Targets?: TargetSummary[];
606
664
  /**
665
+ * @public
607
666
  * <p>An enumeration token that can be used in a request to return the next batch of
608
667
  * results.</p>
609
668
  */
@@ -614,14 +673,17 @@ export interface ListTargetsResult {
614
673
  */
615
674
  export interface SubscribeRequest {
616
675
  /**
676
+ * @public
617
677
  * <p>The Amazon Resource Name (ARN) of the notification rule for which you want to create the association.</p>
618
678
  */
619
679
  Arn: string | undefined;
620
680
  /**
681
+ * @public
621
682
  * <p>Information about the Chatbot topics or Chatbot clients associated with a notification rule.</p>
622
683
  */
623
684
  Target: Target | undefined;
624
685
  /**
686
+ * @public
625
687
  * <p>An enumeration token that, when provided in a request, returns the next batch of the
626
688
  * results.</p>
627
689
  */
@@ -632,6 +694,7 @@ export interface SubscribeRequest {
632
694
  */
633
695
  export interface SubscribeResult {
634
696
  /**
697
+ * @public
635
698
  * <p>The Amazon Resource Name (ARN) of the notification rule for which you have created assocations.</p>
636
699
  */
637
700
  Arn?: string;
@@ -641,10 +704,12 @@ export interface SubscribeResult {
641
704
  */
642
705
  export interface TagResourceRequest {
643
706
  /**
707
+ * @public
644
708
  * <p>The Amazon Resource Name (ARN) of the notification rule to tag.</p>
645
709
  */
646
710
  Arn: string | undefined;
647
711
  /**
712
+ * @public
648
713
  * <p>The list of tags to associate with the resource. Tag key names cannot start with "<code>aws</code>".</p>
649
714
  */
650
715
  Tags: Record<string, string> | undefined;
@@ -654,6 +719,7 @@ export interface TagResourceRequest {
654
719
  */
655
720
  export interface TagResourceResult {
656
721
  /**
722
+ * @public
657
723
  * <p>The list of tags associated with the resource.</p>
658
724
  */
659
725
  Tags?: Record<string, string>;
@@ -663,10 +729,12 @@ export interface TagResourceResult {
663
729
  */
664
730
  export interface UnsubscribeRequest {
665
731
  /**
732
+ * @public
666
733
  * <p>The Amazon Resource Name (ARN) of the notification rule.</p>
667
734
  */
668
735
  Arn: string | undefined;
669
736
  /**
737
+ * @public
670
738
  * <p>The ARN of the Chatbot topic to unsubscribe from the notification rule.</p>
671
739
  */
672
740
  TargetAddress: string | undefined;
@@ -676,6 +744,7 @@ export interface UnsubscribeRequest {
676
744
  */
677
745
  export interface UnsubscribeResult {
678
746
  /**
747
+ * @public
679
748
  * <p>The Amazon Resource Name (ARN) of the the notification rule from which you have removed a subscription.</p>
680
749
  */
681
750
  Arn: string | undefined;
@@ -685,11 +754,13 @@ export interface UnsubscribeResult {
685
754
  */
686
755
  export interface UntagResourceRequest {
687
756
  /**
757
+ * @public
688
758
  * <p>The Amazon Resource Name (ARN) of the notification rule from which to remove the
689
759
  * tags.</p>
690
760
  */
691
761
  Arn: string | undefined;
692
762
  /**
763
+ * @public
693
764
  * <p>The key names of the tags to remove.</p>
694
765
  */
695
766
  TagKeys: string[] | undefined;
@@ -704,30 +775,36 @@ export interface UntagResourceResult {
704
775
  */
705
776
  export interface UpdateNotificationRuleRequest {
706
777
  /**
778
+ * @public
707
779
  * <p>The Amazon Resource Name (ARN) of the notification rule.</p>
708
780
  */
709
781
  Arn: string | undefined;
710
782
  /**
783
+ * @public
711
784
  * <p>The name of the notification rule.</p>
712
785
  */
713
786
  Name?: string;
714
787
  /**
788
+ * @public
715
789
  * <p>The status of the notification rule. Valid statuses include enabled (sending notifications) or
716
790
  * disabled (not sending notifications).</p>
717
791
  */
718
792
  Status?: NotificationRuleStatus | string;
719
793
  /**
794
+ * @public
720
795
  * <p>A list of event types associated with this notification rule. For a complete list of event types and IDs, see
721
796
  * <a href="https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#concepts-api">Notification concepts</a>
722
797
  * in the <i>Developer Tools Console User Guide</i>.</p>
723
798
  */
724
799
  EventTypeIds?: string[];
725
800
  /**
801
+ * @public
726
802
  * <p>The address and type of the targets to receive notifications from this notification
727
803
  * rule.</p>
728
804
  */
729
805
  Targets?: Target[];
730
806
  /**
807
+ * @public
731
808
  * <p>The level of detail to include in the notifications for this resource. BASIC will include only the
732
809
  * contents of the event as it would appear in Amazon CloudWatch. FULL will include any supplemental information
733
810
  * provided by AWS CodeStar Notifications and/or the service for the resource for which the notification is created.</p>
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-codestar-notifications",
3
3
  "description": "AWS SDK for JavaScript Codestar Notifications Client for Node.js, Browser and React Native",
4
- "version": "3.379.1",
4
+ "version": "3.382.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,15 +21,15 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.379.1",
25
- "@aws-sdk/credential-provider-node": "3.379.1",
24
+ "@aws-sdk/client-sts": "3.382.0",
25
+ "@aws-sdk/credential-provider-node": "3.382.0",
26
26
  "@aws-sdk/middleware-host-header": "3.379.1",
27
27
  "@aws-sdk/middleware-logger": "3.378.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.378.0",
29
29
  "@aws-sdk/middleware-signing": "3.379.1",
30
- "@aws-sdk/middleware-user-agent": "3.379.1",
30
+ "@aws-sdk/middleware-user-agent": "3.382.0",
31
31
  "@aws-sdk/types": "3.378.0",
32
- "@aws-sdk/util-endpoints": "3.378.0",
32
+ "@aws-sdk/util-endpoints": "3.382.0",
33
33
  "@aws-sdk/util-user-agent-browser": "3.378.0",
34
34
  "@aws-sdk/util-user-agent-node": "3.378.0",
35
35
  "@smithy/config-resolver": "^2.0.1",