@aws-sdk/client-kinesis 3.1121.0 → 3.1122.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.
Files changed (71) hide show
  1. package/README.md +35 -0
  2. package/dist-cjs/index.js +834 -310
  3. package/dist-es/Kinesis.js +14 -0
  4. package/dist-es/commandBuilder.js +7 -3
  5. package/dist-es/commands/CreateChannelCommand.js +4 -0
  6. package/dist-es/commands/DeleteChannelCommand.js +4 -0
  7. package/dist-es/commands/DeleteResourcePolicyCommand.js +2 -2
  8. package/dist-es/commands/DeregisterStreamConsumerCommand.js +2 -2
  9. package/dist-es/commands/DescribeChannelCommand.js +4 -0
  10. package/dist-es/commands/DescribeStreamConsumerCommand.js +2 -2
  11. package/dist-es/commands/GetRecordsCommand.js +2 -2
  12. package/dist-es/commands/GetResourcePolicyCommand.js +2 -2
  13. package/dist-es/commands/GetShardIteratorCommand.js +2 -2
  14. package/dist-es/commands/ListChannelsCommand.js +4 -0
  15. package/dist-es/commands/ListTagsForResourceCommand.js +2 -2
  16. package/dist-es/commands/PutRecordCommand.js +2 -2
  17. package/dist-es/commands/PutRecordsCommand.js +2 -2
  18. package/dist-es/commands/PutResourcePolicyCommand.js +2 -2
  19. package/dist-es/commands/SubscribeToShardCommand.js +2 -2
  20. package/dist-es/commands/TagResourceCommand.js +2 -2
  21. package/dist-es/commands/UntagResourceCommand.js +2 -2
  22. package/dist-es/commands/UpdateChannelCommand.js +4 -0
  23. package/dist-es/commands/index.js +5 -0
  24. package/dist-es/endpoint/bdd.js +275 -211
  25. package/dist-es/endpoint/endpointResolver.js +1 -0
  26. package/dist-es/models/enums.js +38 -0
  27. package/dist-es/models/errors.js +44 -44
  28. package/dist-es/pagination/ListChannelsPaginator.js +4 -0
  29. package/dist-es/pagination/index.js +1 -0
  30. package/dist-es/schemas/schemas_0.js +312 -38
  31. package/dist-es/waiters/index.js +1 -0
  32. package/dist-es/waiters/waitForChannelActive.js +67 -0
  33. package/dist-types/Kinesis.d.ts +49 -0
  34. package/dist-types/KinesisClient.d.ts +7 -2
  35. package/dist-types/commandBuilder.d.ts +4 -0
  36. package/dist-types/commands/CreateChannelCommand.d.ts +456 -0
  37. package/dist-types/commands/DeleteChannelCommand.d.ts +105 -0
  38. package/dist-types/commands/DescribeChannelCommand.d.ts +219 -0
  39. package/dist-types/commands/DescribeLimitsCommand.d.ts +2 -0
  40. package/dist-types/commands/DescribeStreamSummaryCommand.d.ts +1 -0
  41. package/dist-types/commands/ListChannelsCommand.d.ts +181 -0
  42. package/dist-types/commands/UpdateChannelCommand.d.ts +246 -0
  43. package/dist-types/commands/index.d.ts +5 -0
  44. package/dist-types/endpoint/EndpointParameters.d.ts +1 -0
  45. package/dist-types/models/enums.d.ts +102 -0
  46. package/dist-types/models/errors.d.ts +51 -51
  47. package/dist-types/models/models_0.d.ts +788 -1
  48. package/dist-types/pagination/ListChannelsPaginator.d.ts +7 -0
  49. package/dist-types/pagination/index.d.ts +1 -0
  50. package/dist-types/schemas/schemas_0.d.ts +37 -0
  51. package/dist-types/ts3.4/Kinesis.d.ts +99 -0
  52. package/dist-types/ts3.4/KinesisClient.d.ts +30 -0
  53. package/dist-types/ts3.4/commandBuilder.d.ts +1 -0
  54. package/dist-types/ts3.4/commands/CreateChannelCommand.d.ts +38 -0
  55. package/dist-types/ts3.4/commands/DeleteChannelCommand.d.ts +38 -0
  56. package/dist-types/ts3.4/commands/DescribeChannelCommand.d.ts +38 -0
  57. package/dist-types/ts3.4/commands/ListChannelsCommand.d.ts +38 -0
  58. package/dist-types/ts3.4/commands/UpdateChannelCommand.d.ts +38 -0
  59. package/dist-types/ts3.4/commands/index.d.ts +5 -0
  60. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -0
  61. package/dist-types/ts3.4/models/enums.d.ts +49 -0
  62. package/dist-types/ts3.4/models/errors.d.ts +20 -20
  63. package/dist-types/ts3.4/models/models_0.d.ts +168 -0
  64. package/dist-types/ts3.4/pagination/ListChannelsPaginator.d.ts +11 -0
  65. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  66. package/dist-types/ts3.4/schemas/schemas_0.d.ts +37 -0
  67. package/dist-types/ts3.4/waiters/index.d.ts +1 -0
  68. package/dist-types/ts3.4/waiters/waitForChannelActive.d.ts +15 -0
  69. package/dist-types/waiters/index.d.ts +1 -0
  70. package/dist-types/waiters/waitForChannelActive.d.ts +15 -0
  71. package/package.json +1 -1
@@ -1,4 +1,4 @@
1
- import type { ConsumerStatus, EncryptionType, MetricsName, MinimumThroughputBillingCommitmentInputStatus, MinimumThroughputBillingCommitmentOutputStatus, ScalingType, ShardFilterType, ShardIteratorType, StreamMode, StreamStatus } from "./enums";
1
+ import type { ChannelDestinationType, ChannelEncryptionType, ChannelStatus, ConsumerStatus, EncryptionType, MetricsName, MinimumThroughputBillingCommitmentInputStatus, MinimumThroughputBillingCommitmentOutputStatus, PartitionTransform, RecordFormatType, S3CompressionType, S3StorageClass, S3TablesCompressionType, ScalingType, ShardFilterType, ShardIteratorType, StreamMode, StreamStatus } from "./enums";
2
2
  import type { InternalFailureException, KMSAccessDeniedException, KMSDisabledException, KMSInvalidStateException, KMSNotFoundException, KMSOptInRequired, KMSThrottlingException, ResourceInUseException, ResourceNotFoundException } from "./errors";
3
3
  /**
4
4
  * <p>Represents the input for <code>AddTagsToStream</code>.</p>
@@ -26,6 +26,543 @@ export interface AddTagsToStreamInput {
26
26
  */
27
27
  StreamId?: string | undefined;
28
28
  }
29
+ /**
30
+ * <p>The server-side encryption configuration for a channel.</p>
31
+ * @public
32
+ */
33
+ export interface ChannelEncryptionConfiguration {
34
+ /**
35
+ * <p>The encryption type. The only valid value is <code>KMS</code>.</p>
36
+ * @public
37
+ */
38
+ EncryptionType: ChannelEncryptionType | undefined;
39
+ /**
40
+ * <p>The identifier of the customer managed Amazon Web Services KMS key. You cannot use the Amazon Kinesis Data Streams service key (<code>aws/kinesis</code>).</p>
41
+ * @public
42
+ */
43
+ KeyId: string | undefined;
44
+ }
45
+ /**
46
+ * <p>The Amazon CloudWatch Logs settings for channel logging.</p>
47
+ * @public
48
+ */
49
+ export interface CloudWatchLogs {
50
+ /**
51
+ * <p>Specifies whether logging to Amazon CloudWatch Logs is enabled.</p>
52
+ * @public
53
+ */
54
+ Enabled: boolean | undefined;
55
+ /**
56
+ * <p>The name of the Amazon CloudWatch Logs log group. Defaults to <code>/aws/kinesis/\{channelName\}/\{channelId\}</code>.</p>
57
+ * @public
58
+ */
59
+ LogGroupName?: string | undefined;
60
+ /**
61
+ * <p>The name of the Amazon CloudWatch Logs log stream. Defaults to <code>DestinationDelivery</code>.</p>
62
+ * @public
63
+ */
64
+ LogStreamName?: string | undefined;
65
+ }
66
+ /**
67
+ * <p>The Amazon CloudWatch Logs configuration for a channel.</p>
68
+ * @public
69
+ */
70
+ export interface ChannelLoggingConfiguration {
71
+ /**
72
+ * <p>The Amazon CloudWatch Logs settings for the channel.</p>
73
+ * @public
74
+ */
75
+ CloudWatchLogs: CloudWatchLogs | undefined;
76
+ }
77
+ /**
78
+ * <p>The Amazon S3 dead-letter queue configuration for records that cannot be delivered.</p>
79
+ * @public
80
+ */
81
+ export interface DeadLetterQueueS3Configuration {
82
+ /**
83
+ * <p>The Amazon Resource Name (ARN) of the dead-letter queue Amazon S3 bucket.</p>
84
+ * @public
85
+ */
86
+ BucketARN: string | undefined;
87
+ /**
88
+ * <p>The Amazon Web Services account ID of the expected owner of the dead-letter queue bucket.</p>
89
+ * @public
90
+ */
91
+ ExpectedBucketOwner: string | undefined;
92
+ /**
93
+ * <p>The Amazon S3 key prefix for error records.</p>
94
+ * @public
95
+ */
96
+ ErrorOutputPrefix?: string | undefined;
97
+ }
98
+ /**
99
+ * <p>The Amazon S3 storage settings for a general purpose Amazon S3 destination.</p>
100
+ * @public
101
+ */
102
+ export interface S3StorageConfiguration {
103
+ /**
104
+ * <p>The Amazon Resource Name (ARN) of the destination Amazon S3 bucket.</p>
105
+ * @public
106
+ */
107
+ BucketARN: string | undefined;
108
+ /**
109
+ * <p>The Amazon Web Services account ID of the expected owner of the destination bucket. This value helps prevent delivery to an unintended bucket if ownership changes.</p>
110
+ * @public
111
+ */
112
+ ExpectedBucketOwner: string | undefined;
113
+ /**
114
+ * <p>The template used to construct the Amazon S3 object key for delivered objects. If not specified, a default template is used.</p>
115
+ * @public
116
+ */
117
+ OutputKeyTemplate?: string | undefined;
118
+ /**
119
+ * <p>The Amazon S3 storage class for delivered objects. Valid values:</p>
120
+ * <ul>
121
+ * <li>
122
+ * <p>
123
+ * <code>STANDARD</code> (default)</p>
124
+ * </li>
125
+ * <li>
126
+ * <p>
127
+ * <code>INTELLIGENT_TIERING</code>
128
+ * </p>
129
+ * </li>
130
+ * <li>
131
+ * <p>
132
+ * <code>GLACIER_IR</code>
133
+ * </p>
134
+ * </li>
135
+ * </ul>
136
+ * @public
137
+ */
138
+ StorageClass?: S3StorageClass | undefined;
139
+ /**
140
+ * <p>The compression applied to delivered objects. Valid values:</p>
141
+ * <ul>
142
+ * <li>
143
+ * <p>
144
+ * <code>NONE</code> - No compression.</p>
145
+ * </li>
146
+ * <li>
147
+ * <p>
148
+ * <code>GZIP</code> - gzip compression.</p>
149
+ * </li>
150
+ * <li>
151
+ * <p>
152
+ * <code>ZSTD</code> - Zstandard compression.</p>
153
+ * </li>
154
+ * </ul>
155
+ * @public
156
+ */
157
+ CompressionType: S3CompressionType | undefined;
158
+ }
159
+ /**
160
+ * <p>The configuration for delivery to a general purpose Amazon S3 bucket. Returned in <a>ChannelDescription</a>.</p>
161
+ * @public
162
+ */
163
+ export interface S3DestinationDescription {
164
+ /**
165
+ * <p>The maximum age, in seconds, of undelivered data.</p>
166
+ * @public
167
+ */
168
+ DataFreshnessInSeconds: number | undefined;
169
+ /**
170
+ * <p>The dead-letter queue configuration for records that cannot be delivered.</p>
171
+ * @public
172
+ */
173
+ DeadLetterQueueS3Configuration: DeadLetterQueueS3Configuration | undefined;
174
+ /**
175
+ * <p>The Amazon S3 storage configuration for the channel.</p>
176
+ * @public
177
+ */
178
+ StorageConfiguration: S3StorageConfiguration | undefined;
179
+ }
180
+ /**
181
+ * <p>Specifies a single partition field.</p>
182
+ * @public
183
+ */
184
+ export interface PartitionField {
185
+ /**
186
+ * <p>The partition transform to apply. The only valid value is <code>TIME_HOUR</code>.</p>
187
+ * @public
188
+ */
189
+ Transform: PartitionTransform | undefined;
190
+ /**
191
+ * <p>The name of the source column used for partitioning. This column must be of the <code>timestamptz</code> type.</p>
192
+ * @public
193
+ */
194
+ SourceName: string | undefined;
195
+ }
196
+ /**
197
+ * <p>Specifies how the destination table is partitioned.</p>
198
+ * @public
199
+ */
200
+ export interface PartitionSpec {
201
+ /**
202
+ * <p>The list of partition fields.</p>
203
+ * @public
204
+ */
205
+ PartitionFields: PartitionField[] | undefined;
206
+ }
207
+ /**
208
+ * <p>Specifies a destination streaming table on Apache Iceberg.</p>
209
+ * @public
210
+ */
211
+ export interface S3TablesConfiguration {
212
+ /**
213
+ * <p>The Amazon Resource Name (ARN) of the Amazon S3 table bucket.</p>
214
+ * @public
215
+ */
216
+ TableBucketARN: string | undefined;
217
+ /**
218
+ * <p>The namespace (database) of the destination table.</p>
219
+ * @public
220
+ */
221
+ Namespace: string | undefined;
222
+ /**
223
+ * <p>The name of the destination table. Amazon Kinesis Data Streams creates this table in the specified table bucket.</p>
224
+ * @public
225
+ */
226
+ TableName: string | undefined;
227
+ /**
228
+ * <p>The compression applied to Parquet data files. Valid values:</p>
229
+ * <ul>
230
+ * <li>
231
+ * <p>
232
+ * <code>NONE</code> - No compression.</p>
233
+ * </li>
234
+ * <li>
235
+ * <p>
236
+ * <code>ZSTD</code> - Zstandard compression.</p>
237
+ * </li>
238
+ * <li>
239
+ * <p>
240
+ * <code>SNAPPY</code> - Snappy compression.</p>
241
+ * </li>
242
+ * </ul>
243
+ * @public
244
+ */
245
+ CompressionType: S3TablesCompressionType | undefined;
246
+ /**
247
+ * <p>The partitioning specification for the destination table.</p>
248
+ * @public
249
+ */
250
+ PartitionSpec?: PartitionSpec | undefined;
251
+ }
252
+ /**
253
+ * <p>The configuration for delivery to streaming tables on Apache Iceberg. Returned in <a>ChannelDescription</a>.</p>
254
+ * @public
255
+ */
256
+ export interface S3TablesDestinationDescription {
257
+ /**
258
+ * <p>The maximum age, in seconds, of undelivered data.</p>
259
+ * @public
260
+ */
261
+ DataFreshnessInSeconds: number | undefined;
262
+ /**
263
+ * <p>The dead-letter queue configuration for records that cannot be delivered.</p>
264
+ * @public
265
+ */
266
+ DeadLetterQueueS3Configuration: DeadLetterQueueS3Configuration | undefined;
267
+ /**
268
+ * <p>The list of streaming table configurations.</p>
269
+ * @public
270
+ */
271
+ S3TablesConfigurationList: S3TablesConfiguration[] | undefined;
272
+ }
273
+ /**
274
+ * <p>Specifies the format of records read from the source stream.</p>
275
+ * @public
276
+ */
277
+ export interface RecordConfiguration {
278
+ /**
279
+ * <p>The format of records on the source stream. Valid values:</p>
280
+ * <ul>
281
+ * <li>
282
+ * <p>
283
+ * <code>GSR_JSON</code> - Supported only for streaming table (Amazon S3 Tables) destinations.</p>
284
+ * </li>
285
+ * <li>
286
+ * <p>
287
+ * <code>JSON</code> - Supported for both general purpose Amazon S3 and streaming table destinations.</p>
288
+ * </li>
289
+ * <li>
290
+ * <p>
291
+ * <code>STRING</code> - Supported only for general purpose Amazon S3 destinations.</p>
292
+ * </li>
293
+ * <li>
294
+ * <p>
295
+ * <code>BYTE_ARRAY</code> - Supported only for general purpose Amazon S3 destinations.</p>
296
+ * </li>
297
+ * </ul>
298
+ * @public
299
+ */
300
+ RecordFormatType: RecordFormatType | undefined;
301
+ /**
302
+ * <p>The Amazon Resource Name (ARN) of the Amazon Web Services Glue Schema Registry schema used to validate records. Required when the channel destination is a streaming table (Amazon S3 Tables), for both the <code>JSON</code> and <code>GSR_JSON</code> record formats.</p>
303
+ * @public
304
+ */
305
+ GSRSchemaARN?: string | undefined;
306
+ }
307
+ /**
308
+ * <p>Describes the source stream of a channel.</p>
309
+ * @public
310
+ */
311
+ export interface ChannelStreamDescription {
312
+ /**
313
+ * <p>The Amazon Resource Name (ARN) of the source Kinesis data stream.</p>
314
+ * @public
315
+ */
316
+ StreamARN: string | undefined;
317
+ /**
318
+ * <p>The time at which the source stream was created.</p>
319
+ * @public
320
+ */
321
+ StreamCreationTimestamp: Date | undefined;
322
+ /**
323
+ * <p>The record format configuration for the source stream.</p>
324
+ * @public
325
+ */
326
+ RecordConfiguration: RecordConfiguration | undefined;
327
+ }
328
+ /**
329
+ * <p>Describes the configuration and current status of a channel.</p>
330
+ * @public
331
+ */
332
+ export interface ChannelDescription {
333
+ /**
334
+ * <p>The name of the channel.</p>
335
+ * @public
336
+ */
337
+ ChannelName: string | undefined;
338
+ /**
339
+ * <p>The Amazon Resource Name (ARN) of the channel.</p>
340
+ * @public
341
+ */
342
+ ChannelARN: string | undefined;
343
+ /**
344
+ * <p>The unique identifier of the channel.</p>
345
+ * @public
346
+ */
347
+ ChannelId: string | undefined;
348
+ /**
349
+ * <p>The current status of the channel. Valid values:</p>
350
+ * <ul>
351
+ * <li>
352
+ * <p>
353
+ * <code>CREATING</code>
354
+ * </p>
355
+ * </li>
356
+ * <li>
357
+ * <p>
358
+ * <code>ACTIVE</code>
359
+ * </p>
360
+ * </li>
361
+ * <li>
362
+ * <p>
363
+ * <code>UPDATING</code>
364
+ * </p>
365
+ * </li>
366
+ * <li>
367
+ * <p>
368
+ * <code>DELETING</code>
369
+ * </p>
370
+ * </li>
371
+ * <li>
372
+ * <p>
373
+ * <code>FAILED</code> - See <code>ChannelStatusReason</code> for the failure cause.</p>
374
+ * </li>
375
+ * </ul>
376
+ * @public
377
+ */
378
+ ChannelStatus: ChannelStatus | undefined;
379
+ /**
380
+ * <p>A message describing the reason for a <code>FAILED</code> status.</p>
381
+ * @public
382
+ */
383
+ ChannelStatusReason?: string | undefined;
384
+ /**
385
+ * <p>The time at which the channel was created.</p>
386
+ * @public
387
+ */
388
+ ChannelCreationTimestamp: Date | undefined;
389
+ /**
390
+ * <p>The Amazon Resource Name (ARN) of the IAM role that Amazon Kinesis Data Streams assumes to write records to the destination.</p>
391
+ * @public
392
+ */
393
+ ServiceExecutionRoleARN: string | undefined;
394
+ /**
395
+ * <p>The source stream configuration for the channel.</p>
396
+ * @public
397
+ */
398
+ StreamConfigurationList: ChannelStreamDescription[] | undefined;
399
+ /**
400
+ * <p>The configuration for delivery to a general purpose Amazon S3 bucket. Present only when the channel destination is a general purpose Amazon S3 bucket.</p>
401
+ * @public
402
+ */
403
+ S3DestinationConfiguration?: S3DestinationDescription | undefined;
404
+ /**
405
+ * <p>The configuration for delivery to streaming tables on Apache Iceberg in Amazon S3 Tables. Present only when the channel destination is a streaming table.</p>
406
+ * @public
407
+ */
408
+ S3TablesDestinationConfiguration?: S3TablesDestinationDescription | undefined;
409
+ /**
410
+ * <p>The server-side encryption configuration for the channel.</p>
411
+ * @public
412
+ */
413
+ EncryptionConfiguration?: ChannelEncryptionConfiguration | undefined;
414
+ /**
415
+ * <p>The Amazon CloudWatch Logs configuration for the channel.</p>
416
+ * @public
417
+ */
418
+ LoggingConfiguration: ChannelLoggingConfiguration | undefined;
419
+ }
420
+ /**
421
+ * <p>The updated Amazon CloudWatch Logs settings for a channel.</p>
422
+ * @public
423
+ */
424
+ export interface CloudWatchLogsUpdateInput {
425
+ /**
426
+ * <p>Specifies whether logging to Amazon CloudWatch Logs is enabled.</p>
427
+ * @public
428
+ */
429
+ Enabled: boolean | undefined;
430
+ /**
431
+ * <p>The name of the Amazon CloudWatch Logs log group.</p>
432
+ * @public
433
+ */
434
+ LogGroupName?: string | undefined;
435
+ /**
436
+ * <p>The name of the Amazon CloudWatch Logs log stream.</p>
437
+ * @public
438
+ */
439
+ LogStreamName?: string | undefined;
440
+ }
441
+ /**
442
+ * <p>The updated Amazon CloudWatch Logs configuration for a channel. Used in <a>UpdateChannel</a>.</p>
443
+ * @public
444
+ */
445
+ export interface ChannelLoggingUpdateInput {
446
+ /**
447
+ * <p>The updated Amazon CloudWatch Logs settings for the channel.</p>
448
+ * @public
449
+ */
450
+ CloudWatchLogs: CloudWatchLogsUpdateInput | undefined;
451
+ }
452
+ /**
453
+ * <p>Specifies the source stream and record configuration when creating a channel.</p>
454
+ * @public
455
+ */
456
+ export interface ChannelStreamConfiguration {
457
+ /**
458
+ * <p>The Amazon Resource Name (ARN) of the source Kinesis data stream.</p>
459
+ * @public
460
+ */
461
+ StreamARN: string | undefined;
462
+ /**
463
+ * <p>The record format configuration for the source stream.</p>
464
+ * @public
465
+ */
466
+ RecordConfiguration: RecordConfiguration | undefined;
467
+ }
468
+ /**
469
+ * <p>Identifies a source stream associated with a channel.</p>
470
+ * @public
471
+ */
472
+ export interface ChannelStreamIdentifier {
473
+ /**
474
+ * <p>The Amazon Resource Name (ARN) of the source Kinesis data stream.</p>
475
+ * @public
476
+ */
477
+ StreamARN: string | undefined;
478
+ /**
479
+ * <p>The time at which the source stream was created.</p>
480
+ * @public
481
+ */
482
+ StreamCreationTimestamp: Date | undefined;
483
+ }
484
+ /**
485
+ * <p>A summary of a channel, returned by <a>ListChannels</a>.</p>
486
+ * @public
487
+ */
488
+ export interface ChannelSummary {
489
+ /**
490
+ * <p>The name of the channel.</p>
491
+ * @public
492
+ */
493
+ ChannelName: string | undefined;
494
+ /**
495
+ * <p>The Amazon Resource Name (ARN) of the channel.</p>
496
+ * @public
497
+ */
498
+ ChannelARN: string | undefined;
499
+ /**
500
+ * <p>The unique identifier of the channel.</p>
501
+ * @public
502
+ */
503
+ ChannelId: string | undefined;
504
+ /**
505
+ * <p>The current status of the channel. Valid values:</p>
506
+ * <ul>
507
+ * <li>
508
+ * <p>
509
+ * <code>CREATING</code>
510
+ * </p>
511
+ * </li>
512
+ * <li>
513
+ * <p>
514
+ * <code>ACTIVE</code>
515
+ * </p>
516
+ * </li>
517
+ * <li>
518
+ * <p>
519
+ * <code>UPDATING</code>
520
+ * </p>
521
+ * </li>
522
+ * <li>
523
+ * <p>
524
+ * <code>DELETING</code>
525
+ * </p>
526
+ * </li>
527
+ * <li>
528
+ * <p>
529
+ * <code>FAILED</code> - See <code>ChannelStatusReason</code> for the failure cause.</p>
530
+ * </li>
531
+ * </ul>
532
+ * @public
533
+ */
534
+ ChannelStatus: ChannelStatus | undefined;
535
+ /**
536
+ * <p>A message describing the reason for a <code>FAILED</code> status.</p>
537
+ * @public
538
+ */
539
+ ChannelStatusReason?: string | undefined;
540
+ /**
541
+ * <p>The time at which the channel was created.</p>
542
+ * @public
543
+ */
544
+ ChannelCreationTimestamp: Date | undefined;
545
+ /**
546
+ * <p>The destination type of the channel. Valid values:</p>
547
+ * <ul>
548
+ * <li>
549
+ * <p>
550
+ * <code>S3</code> - Delivery to a general purpose Amazon S3 bucket.</p>
551
+ * </li>
552
+ * <li>
553
+ * <p>
554
+ * <code>S3_TABLES</code> - Delivery to streaming tables on Apache Iceberg.</p>
555
+ * </li>
556
+ * </ul>
557
+ * @public
558
+ */
559
+ ChannelDestinationType: ChannelDestinationType | undefined;
560
+ /**
561
+ * <p>The source streams associated with the channel.</p>
562
+ * @public
563
+ */
564
+ Streams: ChannelStreamIdentifier[] | undefined;
565
+ }
29
566
  /**
30
567
  * <p>The range of possible hash key values for the shard, which is a set of ordered
31
568
  * contiguous positive integers.</p>
@@ -137,6 +674,103 @@ export interface ConsumerDescription {
137
674
  */
138
675
  StreamARN: string | undefined;
139
676
  }
677
+ /**
678
+ * <p>The configuration for delivery to a general purpose Amazon S3 bucket. Used in <a>CreateChannel</a>.</p>
679
+ * @public
680
+ */
681
+ export interface S3DestinationConfiguration {
682
+ /**
683
+ * <p>The maximum age, in seconds, of undelivered data. Valid range is 300 to 900 seconds (5 to 15 minutes). The default value is 300 seconds.</p>
684
+ * @public
685
+ */
686
+ DataFreshnessInSeconds?: number | undefined;
687
+ /**
688
+ * <p>The dead-letter queue configuration for records that cannot be delivered. Optional for general purpose Amazon S3 destinations. If not specified, it defaults to the destination bucket with an error prefix.</p>
689
+ * @public
690
+ */
691
+ DeadLetterQueueS3Configuration?: DeadLetterQueueS3Configuration | undefined;
692
+ /**
693
+ * <p>The Amazon S3 storage configuration for the channel.</p>
694
+ * @public
695
+ */
696
+ StorageConfiguration: S3StorageConfiguration | undefined;
697
+ }
698
+ /**
699
+ * <p>The configuration for delivery to streaming tables on Apache Iceberg. Used in <a>CreateChannel</a>.</p>
700
+ * @public
701
+ */
702
+ export interface S3TablesDestinationConfiguration {
703
+ /**
704
+ * <p>The maximum age, in seconds, of undelivered data. Valid range is 300 to 900 seconds (5 to 15 minutes). The default value is 300 seconds.</p>
705
+ * @public
706
+ */
707
+ DataFreshnessInSeconds?: number | undefined;
708
+ /**
709
+ * <p>The dead-letter queue configuration for records that cannot be delivered. Required for streaming table destinations.</p>
710
+ * @public
711
+ */
712
+ DeadLetterQueueS3Configuration: DeadLetterQueueS3Configuration | undefined;
713
+ /**
714
+ * <p>The list of streaming table configurations. Currently, one table is supported per channel.</p>
715
+ * @public
716
+ */
717
+ S3TablesConfigurationList: S3TablesConfiguration[] | undefined;
718
+ }
719
+ /**
720
+ * @public
721
+ */
722
+ export interface CreateChannelInput {
723
+ /**
724
+ * <p>The name of the channel. The name is unique within your Amazon Web Services account and Amazon Web Services Region.</p>
725
+ * @public
726
+ */
727
+ ChannelName: string | undefined;
728
+ /**
729
+ * <p>The Amazon Resource Name (ARN) of the IAM role that Amazon Kinesis Data Streams assumes to write records to the destination.</p>
730
+ * @public
731
+ */
732
+ ServiceExecutionRoleARN: string | undefined;
733
+ /**
734
+ * <p>The source stream configuration for the channel. Currently, one stream is supported per channel.</p>
735
+ * @public
736
+ */
737
+ StreamConfigurationList: ChannelStreamConfiguration[] | undefined;
738
+ /**
739
+ * <p>The configuration for delivery to a general purpose Amazon S3 bucket. You must specify either <code>S3DestinationConfiguration</code> or <code>S3TablesDestinationConfiguration</code>, but not both.</p>
740
+ * @public
741
+ */
742
+ S3DestinationConfiguration?: S3DestinationConfiguration | undefined;
743
+ /**
744
+ * <p>The configuration for delivery to streaming tables on Apache Iceberg in Amazon S3 Tables. You must specify either <code>S3DestinationConfiguration</code> or <code>S3TablesDestinationConfiguration</code>, but not both.</p>
745
+ * @public
746
+ */
747
+ S3TablesDestinationConfiguration?: S3TablesDestinationConfiguration | undefined;
748
+ /**
749
+ * <p>The server-side encryption configuration that uses an Amazon Web Services KMS key to encrypt data delivered to the destination.</p>
750
+ * @public
751
+ */
752
+ EncryptionConfiguration?: ChannelEncryptionConfiguration | undefined;
753
+ /**
754
+ * <p>A set of key-value pairs to assign to the channel. A tag consists of a required key and an optional value.</p>
755
+ * @public
756
+ */
757
+ Tags?: Record<string, string> | undefined;
758
+ /**
759
+ * <p>The Amazon CloudWatch Logs configuration for the channel.</p>
760
+ * @public
761
+ */
762
+ LoggingConfiguration?: ChannelLoggingConfiguration | undefined;
763
+ }
764
+ /**
765
+ * @public
766
+ */
767
+ export interface CreateChannelOutput {
768
+ /**
769
+ * <p>The configuration and current status of the channel.</p>
770
+ * @public
771
+ */
772
+ ChannelDescription: ChannelDescription | undefined;
773
+ }
140
774
  /**
141
775
  * <p> Specifies the capacity mode to which you want to set your data stream. Currently, in
142
776
  * Kinesis Data Streams, you can choose between an <b>on-demand</b> capacity mode and a <b>provisioned</b> capacity mode for your data streams. </p>
@@ -221,6 +855,16 @@ export interface DecreaseStreamRetentionPeriodInput {
221
855
  */
222
856
  StreamId?: string | undefined;
223
857
  }
858
+ /**
859
+ * @public
860
+ */
861
+ export interface DeleteChannelInput {
862
+ /**
863
+ * <p>The Amazon Resource Name (ARN) of the channel to delete.</p>
864
+ * @public
865
+ */
866
+ ChannelARN: string | undefined;
867
+ }
224
868
  /**
225
869
  * @public
226
870
  */
@@ -336,6 +980,26 @@ export interface DescribeAccountSettingsOutput {
336
980
  */
337
981
  MinimumThroughputBillingCommitment?: MinimumThroughputBillingCommitmentOutput | undefined;
338
982
  }
983
+ /**
984
+ * @public
985
+ */
986
+ export interface DescribeChannelInput {
987
+ /**
988
+ * <p>The Amazon Resource Name (ARN) of the channel to describe.</p>
989
+ * @public
990
+ */
991
+ ChannelARN: string | undefined;
992
+ }
993
+ /**
994
+ * @public
995
+ */
996
+ export interface DescribeChannelOutput {
997
+ /**
998
+ * <p>The configuration and current status of the channel.</p>
999
+ * @public
1000
+ */
1001
+ ChannelDescription: ChannelDescription | undefined;
1002
+ }
339
1003
  /**
340
1004
  * @public
341
1005
  */
@@ -365,6 +1029,16 @@ export interface DescribeLimitsOutput {
365
1029
  * @public
366
1030
  */
367
1031
  OnDemandStreamCountLimit: number | undefined;
1032
+ /**
1033
+ * <p>The number of channels in the account.</p>
1034
+ * @public
1035
+ */
1036
+ ChannelCount?: number | undefined;
1037
+ /**
1038
+ * <p>The maximum number of channels allowed in the account.</p>
1039
+ * @public
1040
+ */
1041
+ ChannelCountLimit?: number | undefined;
368
1042
  }
369
1043
  /**
370
1044
  * <p>Represents the input for <code>DescribeStream</code>.</p>
@@ -873,6 +1547,11 @@ export interface StreamDescriptionSummary {
873
1547
  * @public
874
1548
  */
875
1549
  MaxRecordSizeInKiB?: number | undefined;
1550
+ /**
1551
+ * <p>The number of channels associated with the stream.</p>
1552
+ * @public
1553
+ */
1554
+ ChannelCount?: number | undefined;
876
1555
  }
877
1556
  /**
878
1557
  * @public
@@ -1307,6 +1986,57 @@ export interface IncreaseStreamRetentionPeriodInput {
1307
1986
  */
1308
1987
  StreamId?: string | undefined;
1309
1988
  }
1989
+ /**
1990
+ * <p>Filters <a>ListChannels</a> results by source stream.</p>
1991
+ * @public
1992
+ */
1993
+ export interface StreamFilter {
1994
+ /**
1995
+ * <p>The Amazon Resource Name (ARN) of the source stream to filter by.</p>
1996
+ * @public
1997
+ */
1998
+ StreamARN: string | undefined;
1999
+ /**
2000
+ * <p>The creation timestamp of the source stream.</p>
2001
+ * @public
2002
+ */
2003
+ StreamCreationTimestamp?: Date | undefined;
2004
+ }
2005
+ /**
2006
+ * @public
2007
+ */
2008
+ export interface ListChannelsInput {
2009
+ /**
2010
+ * <p>Filters the results to channels associated with the specified streams.</p>
2011
+ * @public
2012
+ */
2013
+ StreamFilter?: StreamFilter[] | undefined;
2014
+ /**
2015
+ * <p>The maximum number of channels to return in a single call. The default value is 100. If you specify a value greater than 100, at most 100 results are returned.</p>
2016
+ * @public
2017
+ */
2018
+ MaxResults?: number | undefined;
2019
+ /**
2020
+ * <p>The pagination token returned by a previous call. Specify this token to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p>
2021
+ * @public
2022
+ */
2023
+ NextToken?: string | undefined;
2024
+ }
2025
+ /**
2026
+ * @public
2027
+ */
2028
+ export interface ListChannelsOutput {
2029
+ /**
2030
+ * <p>A list of channel summaries.</p>
2031
+ * @public
2032
+ */
2033
+ ChannelSummaries: ChannelSummary[] | undefined;
2034
+ /**
2035
+ * <p>The pagination token to use in a subsequent call to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.</p>
2036
+ * @public
2037
+ */
2038
+ NextToken?: string | undefined;
2039
+ }
1310
2040
  /**
1311
2041
  * <p>The request parameter used to filter out the response of the <code>ListShards</code>
1312
2042
  * API.</p>
@@ -2695,6 +3425,63 @@ export interface UpdateAccountSettingsOutput {
2695
3425
  */
2696
3426
  MinimumThroughputBillingCommitment?: MinimumThroughputBillingCommitmentOutput | undefined;
2697
3427
  }
3428
+ /**
3429
+ * <p>The updated configuration for a general purpose Amazon S3 destination. Used in <a>UpdateChannel</a>. Only <code>DataFreshnessInSeconds</code> can be updated.</p>
3430
+ * @public
3431
+ */
3432
+ export interface S3DestinationUpdateInput {
3433
+ /**
3434
+ * <p>The maximum age, in seconds, of undelivered data. Valid range is 300 to 900 seconds (5 to 15 minutes).</p>
3435
+ * @public
3436
+ */
3437
+ DataFreshnessInSeconds: number | undefined;
3438
+ }
3439
+ /**
3440
+ * <p>The updated configuration for a streaming table destination. Used in <a>UpdateChannel</a>. Only <code>DataFreshnessInSeconds</code> can be updated.</p>
3441
+ * @public
3442
+ */
3443
+ export interface S3TablesDestinationUpdateInput {
3444
+ /**
3445
+ * <p>The maximum age, in seconds, of undelivered data. Valid range is 300 to 900 seconds (5 to 15 minutes).</p>
3446
+ * @public
3447
+ */
3448
+ DataFreshnessInSeconds: number | undefined;
3449
+ }
3450
+ /**
3451
+ * @public
3452
+ */
3453
+ export interface UpdateChannelInput {
3454
+ /**
3455
+ * <p>The Amazon Resource Name (ARN) of the channel to update.</p>
3456
+ * @public
3457
+ */
3458
+ ChannelARN: string | undefined;
3459
+ /**
3460
+ * <p>The updated configuration for a general purpose Amazon S3 destination. Only <code>DataFreshnessInSeconds</code> can be updated.</p>
3461
+ * @public
3462
+ */
3463
+ S3DestinationConfiguration?: S3DestinationUpdateInput | undefined;
3464
+ /**
3465
+ * <p>The updated configuration for a streaming table destination. Only <code>DataFreshnessInSeconds</code> can be updated.</p>
3466
+ * @public
3467
+ */
3468
+ S3TablesDestinationConfiguration?: S3TablesDestinationUpdateInput | undefined;
3469
+ /**
3470
+ * <p>The updated Amazon CloudWatch Logs configuration for the channel.</p>
3471
+ * @public
3472
+ */
3473
+ LoggingConfiguration?: ChannelLoggingUpdateInput | undefined;
3474
+ }
3475
+ /**
3476
+ * @public
3477
+ */
3478
+ export interface UpdateChannelOutput {
3479
+ /**
3480
+ * <p>The configuration and current status of the updated channel.</p>
3481
+ * @public
3482
+ */
3483
+ ChannelDescription: ChannelDescription | undefined;
3484
+ }
2698
3485
  /**
2699
3486
  * @public
2700
3487
  */