@aws-sdk/client-ivs 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.
@@ -8,6 +8,7 @@ export declare class AccessDeniedException extends __BaseException {
8
8
  readonly name: "AccessDeniedException";
9
9
  readonly $fault: "client";
10
10
  /**
11
+ * @public
11
12
  * <p>User does not have sufficient access to perform this action.</p>
12
13
  */
13
14
  exceptionMessage?: string;
@@ -21,6 +22,7 @@ export declare class AccessDeniedException extends __BaseException {
21
22
  */
22
23
  export interface BatchGetChannelRequest {
23
24
  /**
25
+ * @public
24
26
  * <p>Array of ARNs, one per channel.</p>
25
27
  */
26
28
  arns: string[] | undefined;
@@ -69,14 +71,17 @@ export type ChannelType = (typeof ChannelType)[keyof typeof ChannelType];
69
71
  */
70
72
  export interface Channel {
71
73
  /**
74
+ * @public
72
75
  * <p>Channel ARN.</p>
73
76
  */
74
77
  arn?: string;
75
78
  /**
79
+ * @public
76
80
  * <p>Channel name.</p>
77
81
  */
78
82
  name?: string;
79
83
  /**
84
+ * @public
80
85
  * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to
81
86
  * Full HD. Use <code>LOW</code> for near-real-time interaction with viewers. Default:
82
87
  * <code>LOW</code>. (Note: In the Amazon IVS console, <code>LOW</code> and <code>NORMAL</code>
@@ -84,6 +89,7 @@ export interface Channel {
84
89
  */
85
90
  latencyMode?: ChannelLatencyMode | string;
86
91
  /**
92
+ * @public
87
93
  * <p>Channel type, which determines the allowable resolution and bitrate. <i>If you
88
94
  * exceed the allowable input resolution or bitrate, the stream probably will disconnect
89
95
  * immediately.</i> Some types generate multiple qualities (renditions) from the
@@ -147,25 +153,30 @@ export interface Channel {
147
153
  */
148
154
  type?: ChannelType | string;
149
155
  /**
156
+ * @public
150
157
  * <p>Recording-configuration ARN. A value other than an empty string indicates that recording
151
158
  * is enabled. Default: "" (empty string, recording is disabled).</p>
152
159
  */
153
160
  recordingConfigurationArn?: string;
154
161
  /**
162
+ * @public
155
163
  * <p>Channel ingest endpoint, part of the definition of an ingest server, used when you set up
156
164
  * streaming software.</p>
157
165
  */
158
166
  ingestEndpoint?: string;
159
167
  /**
168
+ * @public
160
169
  * <p>Channel playback URL.</p>
161
170
  */
162
171
  playbackUrl?: string;
163
172
  /**
173
+ * @public
164
174
  * <p>Whether the channel is private (enabled for playback authorization). Default:
165
175
  * <code>false</code>.</p>
166
176
  */
167
177
  authorized?: boolean;
168
178
  /**
179
+ * @public
169
180
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
170
181
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
171
182
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -173,10 +184,12 @@ export interface Channel {
173
184
  */
174
185
  tags?: Record<string, string>;
175
186
  /**
187
+ * @public
176
188
  * <p>Whether the channel allows insecure RTMP ingest. Default: <code>false</code>.</p>
177
189
  */
178
190
  insecureIngest?: boolean;
179
191
  /**
192
+ * @public
180
193
  * <p>Optional transcode preset for the channel. This is selectable only for
181
194
  * <code>ADVANCED_HD</code> and <code>ADVANCED_SD</code> channel types. For those channel
182
195
  * types, the default <code>preset</code> is <code>HIGHER_BANDWIDTH_DELIVERY</code>. For other
@@ -191,14 +204,17 @@ export interface Channel {
191
204
  */
192
205
  export interface BatchError {
193
206
  /**
207
+ * @public
194
208
  * <p>Channel ARN.</p>
195
209
  */
196
210
  arn?: string;
197
211
  /**
212
+ * @public
198
213
  * <p>Error code.</p>
199
214
  */
200
215
  code?: string;
201
216
  /**
217
+ * @public
202
218
  * <p>Error message, determined by the application.</p>
203
219
  */
204
220
  message?: string;
@@ -208,10 +224,12 @@ export interface BatchError {
208
224
  */
209
225
  export interface BatchGetChannelResponse {
210
226
  /**
227
+ * @public
211
228
  * <p/>
212
229
  */
213
230
  channels?: Channel[];
214
231
  /**
232
+ * @public
215
233
  * <p>Each error object is related to a specific ARN in the request.</p>
216
234
  */
217
235
  errors?: BatchError[];
@@ -221,6 +239,7 @@ export interface BatchGetChannelResponse {
221
239
  */
222
240
  export interface BatchGetStreamKeyRequest {
223
241
  /**
242
+ * @public
224
243
  * <p>Array of ARNs, one per stream key.</p>
225
244
  */
226
245
  arns: string[] | undefined;
@@ -231,18 +250,22 @@ export interface BatchGetStreamKeyRequest {
231
250
  */
232
251
  export interface StreamKey {
233
252
  /**
253
+ * @public
234
254
  * <p>Stream-key ARN.</p>
235
255
  */
236
256
  arn?: string;
237
257
  /**
258
+ * @public
238
259
  * <p>Stream-key value.</p>
239
260
  */
240
261
  value?: string;
241
262
  /**
263
+ * @public
242
264
  * <p>Channel ARN for the stream.</p>
243
265
  */
244
266
  channelArn?: string;
245
267
  /**
268
+ * @public
246
269
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
247
270
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
248
271
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -255,10 +278,12 @@ export interface StreamKey {
255
278
  */
256
279
  export interface BatchGetStreamKeyResponse {
257
280
  /**
281
+ * @public
258
282
  * <p/>
259
283
  */
260
284
  streamKeys?: StreamKey[];
261
285
  /**
286
+ * @public
262
287
  * <p/>
263
288
  */
264
289
  errors?: BatchError[];
@@ -269,15 +294,18 @@ export interface BatchGetStreamKeyResponse {
269
294
  */
270
295
  export interface BatchStartViewerSessionRevocationViewerSession {
271
296
  /**
297
+ * @public
272
298
  * <p>The ARN of the channel associated with the viewer session to revoke.</p>
273
299
  */
274
300
  channelArn: string | undefined;
275
301
  /**
302
+ * @public
276
303
  * <p>The ID of the viewer associated with the viewer session to revoke. Do not use this field
277
304
  * for personally identifying, confidential, or sensitive information.</p>
278
305
  */
279
306
  viewerId: string | undefined;
280
307
  /**
308
+ * @public
281
309
  * <p>An optional filter on which versions of the viewer session to revoke. All versions less
282
310
  * than or equal to the specified version will be revoked. Default: 0.</p>
283
311
  */
@@ -288,6 +316,7 @@ export interface BatchStartViewerSessionRevocationViewerSession {
288
316
  */
289
317
  export interface BatchStartViewerSessionRevocationRequest {
290
318
  /**
319
+ * @public
291
320
  * <p>Array of viewer sessions, one per channel-ARN and viewer-ID pair.</p>
292
321
  */
293
322
  viewerSessions: BatchStartViewerSessionRevocationViewerSession[] | undefined;
@@ -299,18 +328,22 @@ export interface BatchStartViewerSessionRevocationRequest {
299
328
  */
300
329
  export interface BatchStartViewerSessionRevocationError {
301
330
  /**
331
+ * @public
302
332
  * <p>Channel ARN.</p>
303
333
  */
304
334
  channelArn: string | undefined;
305
335
  /**
336
+ * @public
306
337
  * <p>The ID of the viewer session to revoke.</p>
307
338
  */
308
339
  viewerId: string | undefined;
309
340
  /**
341
+ * @public
310
342
  * <p>Error code.</p>
311
343
  */
312
344
  code?: string;
313
345
  /**
346
+ * @public
314
347
  * <p>Error message, determined by the application.</p>
315
348
  */
316
349
  message?: string;
@@ -320,6 +353,7 @@ export interface BatchStartViewerSessionRevocationError {
320
353
  */
321
354
  export interface BatchStartViewerSessionRevocationResponse {
322
355
  /**
356
+ * @public
323
357
  * <p>Each error object is related to a specific <code>channelArn</code> and
324
358
  * <code>viewerId</code> pair in the request.</p>
325
359
  */
@@ -333,6 +367,7 @@ export declare class PendingVerification extends __BaseException {
333
367
  readonly name: "PendingVerification";
334
368
  readonly $fault: "client";
335
369
  /**
370
+ * @public
336
371
  * <p> Your account is pending verification. </p>
337
372
  */
338
373
  exceptionMessage?: string;
@@ -349,6 +384,7 @@ export declare class ThrottlingException extends __BaseException {
349
384
  readonly name: "ThrottlingException";
350
385
  readonly $fault: "client";
351
386
  /**
387
+ * @public
352
388
  * <p>Request was denied due to request throttling.</p>
353
389
  */
354
390
  exceptionMessage?: string;
@@ -365,6 +401,7 @@ export declare class ValidationException extends __BaseException {
365
401
  readonly name: "ValidationException";
366
402
  readonly $fault: "client";
367
403
  /**
404
+ * @public
368
405
  * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
369
406
  */
370
407
  exceptionMessage?: string;
@@ -378,10 +415,12 @@ export declare class ValidationException extends __BaseException {
378
415
  */
379
416
  export interface CreateChannelRequest {
380
417
  /**
418
+ * @public
381
419
  * <p>Channel name.</p>
382
420
  */
383
421
  name?: string;
384
422
  /**
423
+ * @public
385
424
  * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to
386
425
  * Full HD. Use <code>LOW</code> for near-real-time interaction with viewers. (Note: In the
387
426
  * Amazon IVS console, <code>LOW</code> and <code>NORMAL</code> correspond to Ultra-low and
@@ -389,6 +428,7 @@ export interface CreateChannelRequest {
389
428
  */
390
429
  latencyMode?: ChannelLatencyMode | string;
391
430
  /**
431
+ * @public
392
432
  * <p>Channel type, which determines the allowable resolution and bitrate. <i>If you
393
433
  * exceed the allowable input resolution or bitrate, the stream probably will disconnect
394
434
  * immediately.</i> Some types generate multiple qualities (renditions) from the
@@ -452,15 +492,18 @@ export interface CreateChannelRequest {
452
492
  */
453
493
  type?: ChannelType | string;
454
494
  /**
495
+ * @public
455
496
  * <p>Whether the channel is private (enabled for playback authorization). Default:
456
497
  * <code>false</code>.</p>
457
498
  */
458
499
  authorized?: boolean;
459
500
  /**
501
+ * @public
460
502
  * <p>Recording-configuration ARN. Default: "" (empty string, recording is disabled).</p>
461
503
  */
462
504
  recordingConfigurationArn?: string;
463
505
  /**
506
+ * @public
464
507
  * <p>Array of 1-50 maps, each of the form <code>string:string (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services
465
508
  * Resources</a> for more information, including restrictions that apply to tags and "Tag
466
509
  * naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is
@@ -468,10 +511,12 @@ export interface CreateChannelRequest {
468
511
  */
469
512
  tags?: Record<string, string>;
470
513
  /**
514
+ * @public
471
515
  * <p>Whether the channel allows insecure RTMP ingest. Default: <code>false</code>.</p>
472
516
  */
473
517
  insecureIngest?: boolean;
474
518
  /**
519
+ * @public
475
520
  * <p>Optional transcode preset for the channel. This is selectable only for
476
521
  * <code>ADVANCED_HD</code> and <code>ADVANCED_SD</code> channel types. For those channel
477
522
  * types, the default <code>preset</code> is <code>HIGHER_BANDWIDTH_DELIVERY</code>. For other
@@ -485,10 +530,12 @@ export interface CreateChannelRequest {
485
530
  */
486
531
  export interface CreateChannelResponse {
487
532
  /**
533
+ * @public
488
534
  * <p/>
489
535
  */
490
536
  channel?: Channel;
491
537
  /**
538
+ * @public
492
539
  * <p/>
493
540
  */
494
541
  streamKey?: StreamKey;
@@ -501,6 +548,7 @@ export declare class ResourceNotFoundException extends __BaseException {
501
548
  readonly name: "ResourceNotFoundException";
502
549
  readonly $fault: "client";
503
550
  /**
551
+ * @public
504
552
  * <p>Request references a resource which does not exist.</p>
505
553
  */
506
554
  exceptionMessage?: string;
@@ -517,6 +565,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
517
565
  readonly name: "ServiceQuotaExceededException";
518
566
  readonly $fault: "client";
519
567
  /**
568
+ * @public
520
569
  * <p>Request would cause a service quota to be exceeded.</p>
521
570
  */
522
571
  exceptionMessage?: string;
@@ -533,6 +582,7 @@ export declare class ConflictException extends __BaseException {
533
582
  readonly name: "ConflictException";
534
583
  readonly $fault: "client";
535
584
  /**
585
+ * @public
536
586
  * <p>Updating or deleting a resource can cause an inconsistent state.</p>
537
587
  */
538
588
  exceptionMessage?: string;
@@ -547,6 +597,7 @@ export declare class ConflictException extends __BaseException {
547
597
  */
548
598
  export interface S3DestinationConfiguration {
549
599
  /**
600
+ * @public
550
601
  * <p>Location (S3 bucket name) where recorded videos will be stored.</p>
551
602
  */
552
603
  bucketName: string | undefined;
@@ -559,6 +610,7 @@ export interface S3DestinationConfiguration {
559
610
  */
560
611
  export interface DestinationConfiguration {
561
612
  /**
613
+ * @public
562
614
  * <p>An S3 destination configuration where recorded videos will be stored.</p>
563
615
  */
564
616
  s3?: S3DestinationConfiguration;
@@ -596,6 +648,7 @@ export type RenditionConfigurationRenditionSelection = (typeof RenditionConfigur
596
648
  */
597
649
  export interface RenditionConfiguration {
598
650
  /**
651
+ * @public
599
652
  * <p>Indicates which set of renditions are recorded for a stream. For <code>BASIC</code>
600
653
  * channels, the <code>CUSTOM</code> value has no effect. If <code>CUSTOM</code> is specified, a
601
654
  * set of renditions must be specified in the <code>renditions</code> field. Default:
@@ -603,6 +656,7 @@ export interface RenditionConfiguration {
603
656
  */
604
657
  renditionSelection?: RenditionConfigurationRenditionSelection | string;
605
658
  /**
659
+ * @public
606
660
  * <p>Indicates which renditions are recorded for a stream, if <code>renditionSelection</code>
607
661
  * is <code>CUSTOM</code>; otherwise, this field is irrelevant. The selected renditions are
608
662
  * recorded if they are available during the stream. If a selected rendition is unavailable, the
@@ -655,10 +709,12 @@ export type ThumbnailConfigurationStorage = (typeof ThumbnailConfigurationStorag
655
709
  */
656
710
  export interface ThumbnailConfiguration {
657
711
  /**
712
+ * @public
658
713
  * <p>Thumbnail recording mode. Default: <code>INTERVAL</code>.</p>
659
714
  */
660
715
  recordingMode?: RecordingMode | string;
661
716
  /**
717
+ * @public
662
718
  * <p>The targeted thumbnail-generation interval in seconds. This is configurable (and required)
663
719
  * only if <code>recordingMode</code> is <code>INTERVAL</code>. Default: 60.</p>
664
720
  * <p>
@@ -672,6 +728,7 @@ export interface ThumbnailConfiguration {
672
728
  */
673
729
  targetIntervalSeconds?: number;
674
730
  /**
731
+ * @public
675
732
  * <p>Indicates the desired resolution of recorded thumbnails. Thumbnails are recorded at the
676
733
  * selected resolution if the corresponding rendition is available during the stream; otherwise,
677
734
  * they are recorded at source resolution. For more information about resolution values and their
@@ -680,6 +737,7 @@ export interface ThumbnailConfiguration {
680
737
  */
681
738
  resolution?: ThumbnailConfigurationResolution | string;
682
739
  /**
740
+ * @public
683
741
  * <p>Indicates the format in which thumbnails are recorded. <code>SEQUENTIAL</code> records all
684
742
  * generated thumbnails in a serial manner, to the media/thumbnails directory.
685
743
  * <code>LATEST</code> saves the latest thumbnail in media/latest_thumbnail/thumb.jpg and
@@ -693,15 +751,18 @@ export interface ThumbnailConfiguration {
693
751
  */
694
752
  export interface CreateRecordingConfigurationRequest {
695
753
  /**
754
+ * @public
696
755
  * <p>Recording-configuration name. The value does not need to be unique.</p>
697
756
  */
698
757
  name?: string;
699
758
  /**
759
+ * @public
700
760
  * <p>A complex type that contains a destination configuration for where recorded video will be
701
761
  * stored.</p>
702
762
  */
703
763
  destinationConfiguration: DestinationConfiguration | undefined;
704
764
  /**
765
+ * @public
705
766
  * <p>Array of 1-50 maps, each of the form <code>string:string (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services
706
767
  * Resources</a> for more information, including restrictions that apply to tags and "Tag
707
768
  * naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is
@@ -709,16 +770,19 @@ export interface CreateRecordingConfigurationRequest {
709
770
  */
710
771
  tags?: Record<string, string>;
711
772
  /**
773
+ * @public
712
774
  * <p>A complex type that allows you to enable/disable the recording of thumbnails for a live
713
775
  * session and modify the interval at which thumbnails are generated for the live session.</p>
714
776
  */
715
777
  thumbnailConfiguration?: ThumbnailConfiguration;
716
778
  /**
779
+ * @public
717
780
  * <p>If a broadcast disconnects and then reconnects within the specified interval, the multiple
718
781
  * streams will be considered a single broadcast and merged together. Default: 0.</p>
719
782
  */
720
783
  recordingReconnectWindowSeconds?: number;
721
784
  /**
785
+ * @public
722
786
  * <p>Object that describes which renditions should be recorded for a stream.</p>
723
787
  */
724
788
  renditionConfiguration?: RenditionConfiguration;
@@ -742,23 +806,28 @@ export type RecordingConfigurationState = (typeof RecordingConfigurationState)[k
742
806
  */
743
807
  export interface RecordingConfiguration {
744
808
  /**
809
+ * @public
745
810
  * <p>Recording-configuration ARN.</p>
746
811
  */
747
812
  arn: string | undefined;
748
813
  /**
814
+ * @public
749
815
  * <p>Recording-configuration name. The value does not need to be unique.</p>
750
816
  */
751
817
  name?: string;
752
818
  /**
819
+ * @public
753
820
  * <p>A complex type that contains information about where recorded video will be stored.</p>
754
821
  */
755
822
  destinationConfiguration: DestinationConfiguration | undefined;
756
823
  /**
824
+ * @public
757
825
  * <p>Indicates the current state of the recording configuration. When the state is
758
826
  * <code>ACTIVE</code>, the configuration is ready for recording a channel stream.</p>
759
827
  */
760
828
  state: RecordingConfigurationState | string | undefined;
761
829
  /**
830
+ * @public
762
831
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
763
832
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
764
833
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -766,16 +835,19 @@ export interface RecordingConfiguration {
766
835
  */
767
836
  tags?: Record<string, string>;
768
837
  /**
838
+ * @public
769
839
  * <p>A complex type that allows you to enable/disable the recording of thumbnails for a live
770
840
  * session and modify the interval at which thumbnails are generated for the live session.</p>
771
841
  */
772
842
  thumbnailConfiguration?: ThumbnailConfiguration;
773
843
  /**
844
+ * @public
774
845
  * <p>If a broadcast disconnects and then reconnects within the specified interval, the multiple
775
846
  * streams will be considered a single broadcast and merged together. Default: 0.</p>
776
847
  */
777
848
  recordingReconnectWindowSeconds?: number;
778
849
  /**
850
+ * @public
779
851
  * <p>Object that describes which renditions should be recorded for a stream.</p>
780
852
  */
781
853
  renditionConfiguration?: RenditionConfiguration;
@@ -785,6 +857,7 @@ export interface RecordingConfiguration {
785
857
  */
786
858
  export interface CreateRecordingConfigurationResponse {
787
859
  /**
860
+ * @public
788
861
  *
789
862
  */
790
863
  recordingConfiguration?: RecordingConfiguration;
@@ -797,6 +870,7 @@ export declare class InternalServerException extends __BaseException {
797
870
  readonly name: "InternalServerException";
798
871
  readonly $fault: "server";
799
872
  /**
873
+ * @public
800
874
  * <p>Unexpected error during processing of request.</p>
801
875
  */
802
876
  exceptionMessage?: string;
@@ -810,10 +884,12 @@ export declare class InternalServerException extends __BaseException {
810
884
  */
811
885
  export interface CreateStreamKeyRequest {
812
886
  /**
887
+ * @public
813
888
  * <p>ARN of the channel for which to create the stream key.</p>
814
889
  */
815
890
  channelArn: string | undefined;
816
891
  /**
892
+ * @public
817
893
  * <p>Array of 1-50 maps, each of the form <code>string:string (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services
818
894
  * Resources</a> for more information, including restrictions that apply to tags and "Tag
819
895
  * naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is
@@ -826,6 +902,7 @@ export interface CreateStreamKeyRequest {
826
902
  */
827
903
  export interface CreateStreamKeyResponse {
828
904
  /**
905
+ * @public
829
906
  * <p>Stream key used to authenticate an RTMPS stream for ingestion.</p>
830
907
  */
831
908
  streamKey?: StreamKey;
@@ -835,6 +912,7 @@ export interface CreateStreamKeyResponse {
835
912
  */
836
913
  export interface DeleteChannelRequest {
837
914
  /**
915
+ * @public
838
916
  * <p>ARN of the channel to be deleted.</p>
839
917
  */
840
918
  arn: string | undefined;
@@ -844,6 +922,7 @@ export interface DeleteChannelRequest {
844
922
  */
845
923
  export interface DeletePlaybackKeyPairRequest {
846
924
  /**
925
+ * @public
847
926
  * <p>ARN of the key pair to be deleted.</p>
848
927
  */
849
928
  arn: string | undefined;
@@ -858,6 +937,7 @@ export interface DeletePlaybackKeyPairResponse {
858
937
  */
859
938
  export interface DeleteRecordingConfigurationRequest {
860
939
  /**
940
+ * @public
861
941
  * <p>ARN of the recording configuration to be deleted.</p>
862
942
  */
863
943
  arn: string | undefined;
@@ -867,6 +947,7 @@ export interface DeleteRecordingConfigurationRequest {
867
947
  */
868
948
  export interface DeleteStreamKeyRequest {
869
949
  /**
950
+ * @public
870
951
  * <p>ARN of the stream key to be deleted.</p>
871
952
  */
872
953
  arn: string | undefined;
@@ -876,6 +957,7 @@ export interface DeleteStreamKeyRequest {
876
957
  */
877
958
  export interface GetChannelRequest {
878
959
  /**
960
+ * @public
879
961
  * <p>ARN of the channel for which the configuration is to be retrieved.</p>
880
962
  */
881
963
  arn: string | undefined;
@@ -885,6 +967,7 @@ export interface GetChannelRequest {
885
967
  */
886
968
  export interface GetChannelResponse {
887
969
  /**
970
+ * @public
888
971
  * <p/>
889
972
  */
890
973
  channel?: Channel;
@@ -894,6 +977,7 @@ export interface GetChannelResponse {
894
977
  */
895
978
  export interface GetPlaybackKeyPairRequest {
896
979
  /**
980
+ * @public
897
981
  * <p>ARN of the key pair to be returned.</p>
898
982
  */
899
983
  arn: string | undefined;
@@ -904,18 +988,22 @@ export interface GetPlaybackKeyPairRequest {
904
988
  */
905
989
  export interface PlaybackKeyPair {
906
990
  /**
991
+ * @public
907
992
  * <p>Key-pair ARN.</p>
908
993
  */
909
994
  arn?: string;
910
995
  /**
996
+ * @public
911
997
  * <p>Playback-key-pair name. The value does not need to be unique.</p>
912
998
  */
913
999
  name?: string;
914
1000
  /**
1001
+ * @public
915
1002
  * <p>Key-pair identifier.</p>
916
1003
  */
917
1004
  fingerprint?: string;
918
1005
  /**
1006
+ * @public
919
1007
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
920
1008
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
921
1009
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -928,6 +1016,7 @@ export interface PlaybackKeyPair {
928
1016
  */
929
1017
  export interface GetPlaybackKeyPairResponse {
930
1018
  /**
1019
+ * @public
931
1020
  *
932
1021
  */
933
1022
  keyPair?: PlaybackKeyPair;
@@ -937,6 +1026,7 @@ export interface GetPlaybackKeyPairResponse {
937
1026
  */
938
1027
  export interface GetRecordingConfigurationRequest {
939
1028
  /**
1029
+ * @public
940
1030
  * <p>ARN of the recording configuration to be retrieved.</p>
941
1031
  */
942
1032
  arn: string | undefined;
@@ -946,6 +1036,7 @@ export interface GetRecordingConfigurationRequest {
946
1036
  */
947
1037
  export interface GetRecordingConfigurationResponse {
948
1038
  /**
1039
+ * @public
949
1040
  *
950
1041
  */
951
1042
  recordingConfiguration?: RecordingConfiguration;
@@ -958,6 +1049,7 @@ export declare class ChannelNotBroadcasting extends __BaseException {
958
1049
  readonly name: "ChannelNotBroadcasting";
959
1050
  readonly $fault: "client";
960
1051
  /**
1052
+ * @public
961
1053
  * <p>The stream is offline for the given channel ARN.</p>
962
1054
  */
963
1055
  exceptionMessage?: string;
@@ -971,6 +1063,7 @@ export declare class ChannelNotBroadcasting extends __BaseException {
971
1063
  */
972
1064
  export interface GetStreamRequest {
973
1065
  /**
1066
+ * @public
974
1067
  * <p>Channel ARN for stream to be accessed.</p>
975
1068
  */
976
1069
  channelArn: string | undefined;
@@ -1006,33 +1099,40 @@ export type StreamState = (typeof StreamState)[keyof typeof StreamState];
1006
1099
  */
1007
1100
  export interface _Stream {
1008
1101
  /**
1102
+ * @public
1009
1103
  * <p>Channel ARN for the stream.</p>
1010
1104
  */
1011
1105
  channelArn?: string;
1012
1106
  /**
1107
+ * @public
1013
1108
  * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
1014
1109
  */
1015
1110
  streamId?: string;
1016
1111
  /**
1112
+ * @public
1017
1113
  * <p>URL of the master playlist, required by the video player to play the HLS stream.</p>
1018
1114
  */
1019
1115
  playbackUrl?: string;
1020
1116
  /**
1117
+ * @public
1021
1118
  * <p>Time of the stream’s start. This is an ISO 8601 timestamp; <i>note that this is
1022
1119
  * returned as a string</i>.</p>
1023
1120
  */
1024
1121
  startTime?: Date;
1025
1122
  /**
1123
+ * @public
1026
1124
  * <p>The stream’s state. Do not rely on the <code>OFFLINE</code> state, as the API may not
1027
1125
  * return it; instead, a "NotBroadcasting" error will indicate that the stream is not
1028
1126
  * live.</p>
1029
1127
  */
1030
1128
  state?: StreamState | string;
1031
1129
  /**
1130
+ * @public
1032
1131
  * <p>The stream’s health.</p>
1033
1132
  */
1034
1133
  health?: StreamHealth | string;
1035
1134
  /**
1135
+ * @public
1036
1136
  * <p>A count of concurrent views of the stream. Typically, a new view appears in
1037
1137
  * <code>viewerCount</code> within 15 seconds of when video playback starts and a view is
1038
1138
  * removed from <code>viewerCount</code> within 1 minute of when video playback ends. A value of
@@ -1045,6 +1145,7 @@ export interface _Stream {
1045
1145
  */
1046
1146
  export interface GetStreamResponse {
1047
1147
  /**
1148
+ * @public
1048
1149
  * <p/>
1049
1150
  */
1050
1151
  stream?: _Stream;
@@ -1054,6 +1155,7 @@ export interface GetStreamResponse {
1054
1155
  */
1055
1156
  export interface GetStreamKeyRequest {
1056
1157
  /**
1158
+ * @public
1057
1159
  * <p>ARN for the stream key to be retrieved.</p>
1058
1160
  */
1059
1161
  arn: string | undefined;
@@ -1063,6 +1165,7 @@ export interface GetStreamKeyRequest {
1063
1165
  */
1064
1166
  export interface GetStreamKeyResponse {
1065
1167
  /**
1168
+ * @public
1066
1169
  *
1067
1170
  */
1068
1171
  streamKey?: StreamKey;
@@ -1072,10 +1175,12 @@ export interface GetStreamKeyResponse {
1072
1175
  */
1073
1176
  export interface GetStreamSessionRequest {
1074
1177
  /**
1178
+ * @public
1075
1179
  * <p>ARN of the channel resource</p>
1076
1180
  */
1077
1181
  channelArn: string | undefined;
1078
1182
  /**
1183
+ * @public
1079
1184
  * <p>Unique identifier for a live or previously live stream in the specified channel. If no
1080
1185
  * <code>streamId</code> is provided, this returns the most recent stream session for the
1081
1186
  * channel, if it exists.</p>
@@ -1090,18 +1195,22 @@ export interface GetStreamSessionRequest {
1090
1195
  */
1091
1196
  export interface AudioConfiguration {
1092
1197
  /**
1198
+ * @public
1093
1199
  * <p>Codec used for the audio encoding.</p>
1094
1200
  */
1095
1201
  codec?: string;
1096
1202
  /**
1203
+ * @public
1097
1204
  * <p>The expected ingest bitrate (bits per second). This is configured in the encoder.</p>
1098
1205
  */
1099
1206
  targetBitrate?: number;
1100
1207
  /**
1208
+ * @public
1101
1209
  * <p>Number of audio samples recorded per second.</p>
1102
1210
  */
1103
1211
  sampleRate?: number;
1104
1212
  /**
1213
+ * @public
1105
1214
  * <p>Number of audio channels.</p>
1106
1215
  */
1107
1216
  channels?: number;
@@ -1114,36 +1223,44 @@ export interface AudioConfiguration {
1114
1223
  */
1115
1224
  export interface VideoConfiguration {
1116
1225
  /**
1226
+ * @public
1117
1227
  * <p>Indicates to the decoder the requirements for decoding the stream. For definitions of the
1118
1228
  * valid values, see the H.264 specification.</p>
1119
1229
  */
1120
1230
  avcProfile?: string;
1121
1231
  /**
1232
+ * @public
1122
1233
  * <p>Indicates the degree of required decoder performance for a profile. Normally this is set
1123
1234
  * automatically by the encoder. For details, see the H.264 specification.</p>
1124
1235
  */
1125
1236
  avcLevel?: string;
1126
1237
  /**
1238
+ * @public
1127
1239
  * <p>Codec used for the video encoding.</p>
1128
1240
  */
1129
1241
  codec?: string;
1130
1242
  /**
1243
+ * @public
1131
1244
  * <p>Software or hardware used to encode the video.</p>
1132
1245
  */
1133
1246
  encoder?: string;
1134
1247
  /**
1248
+ * @public
1135
1249
  * <p>The expected ingest bitrate (bits per second). This is configured in the encoder.</p>
1136
1250
  */
1137
1251
  targetBitrate?: number;
1138
1252
  /**
1253
+ * @public
1139
1254
  * <p>The expected ingest framerate. This is configured in the encoder.</p>
1140
1255
  */
1141
1256
  targetFramerate?: number;
1142
1257
  /**
1258
+ * @public
1143
1259
  * <p>Video-resolution height in pixels.</p>
1144
1260
  */
1145
1261
  videoHeight?: number;
1146
1262
  /**
1263
+ * @public
1147
1264
  * <p>Video-resolution width in pixels.</p>
1148
1265
  */
1149
1266
  videoWidth?: number;
@@ -1155,10 +1272,12 @@ export interface VideoConfiguration {
1155
1272
  */
1156
1273
  export interface IngestConfiguration {
1157
1274
  /**
1275
+ * @public
1158
1276
  * <p>Encoder settings for video.</p>
1159
1277
  */
1160
1278
  video?: VideoConfiguration;
1161
1279
  /**
1280
+ * @public
1162
1281
  * <p>Encoder settings for audio.</p>
1163
1282
  */
1164
1283
  audio?: AudioConfiguration;
@@ -1170,14 +1289,17 @@ export interface IngestConfiguration {
1170
1289
  */
1171
1290
  export interface StreamEvent {
1172
1291
  /**
1292
+ * @public
1173
1293
  * <p>Name that identifies the stream event within a <code>type</code>.</p>
1174
1294
  */
1175
1295
  name?: string;
1176
1296
  /**
1297
+ * @public
1177
1298
  * <p>Logical group for certain events.</p>
1178
1299
  */
1179
1300
  type?: string;
1180
1301
  /**
1302
+ * @public
1181
1303
  * <p>Time when the event occurred. This is an ISO 8601 timestamp; <i>note that this is
1182
1304
  * returned as a string</i>.</p>
1183
1305
  */
@@ -1191,32 +1313,39 @@ export interface StreamEvent {
1191
1313
  */
1192
1314
  export interface StreamSession {
1193
1315
  /**
1316
+ * @public
1194
1317
  * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
1195
1318
  */
1196
1319
  streamId?: string;
1197
1320
  /**
1321
+ * @public
1198
1322
  * <p>Time when the channel went live. This is an ISO 8601 timestamp; <i>note that this
1199
1323
  * is returned as a string</i>.</p>
1200
1324
  */
1201
1325
  startTime?: Date;
1202
1326
  /**
1327
+ * @public
1203
1328
  * <p>Time when the channel went offline. This is an ISO 8601 timestamp; <i>note that
1204
1329
  * this is returned as a string</i>. For live streams, this is <code>NULL</code>.</p>
1205
1330
  */
1206
1331
  endTime?: Date;
1207
1332
  /**
1333
+ * @public
1208
1334
  * <p>The properties of the channel at the time of going live.</p>
1209
1335
  */
1210
1336
  channel?: Channel;
1211
1337
  /**
1338
+ * @public
1212
1339
  * <p>The properties of the incoming RTMP stream for the stream.</p>
1213
1340
  */
1214
1341
  ingestConfiguration?: IngestConfiguration;
1215
1342
  /**
1343
+ * @public
1216
1344
  * <p>The properties of recording the live stream.</p>
1217
1345
  */
1218
1346
  recordingConfiguration?: RecordingConfiguration;
1219
1347
  /**
1348
+ * @public
1220
1349
  * <p>List of Amazon IVS events that the stream encountered. The list is sorted by most recent
1221
1350
  * events and contains up to 500 events. For Amazon IVS events, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html">Using Amazon EventBridge with Amazon
1222
1351
  * IVS</a>.</p>
@@ -1228,6 +1357,7 @@ export interface StreamSession {
1228
1357
  */
1229
1358
  export interface GetStreamSessionResponse {
1230
1359
  /**
1360
+ * @public
1231
1361
  * <p>List of stream details.</p>
1232
1362
  */
1233
1363
  streamSession?: StreamSession;
@@ -1237,14 +1367,17 @@ export interface GetStreamSessionResponse {
1237
1367
  */
1238
1368
  export interface ImportPlaybackKeyPairRequest {
1239
1369
  /**
1370
+ * @public
1240
1371
  * <p>The public portion of a customer-generated key pair.</p>
1241
1372
  */
1242
1373
  publicKeyMaterial: string | undefined;
1243
1374
  /**
1375
+ * @public
1244
1376
  * <p>Playback-key-pair name. The value does not need to be unique.</p>
1245
1377
  */
1246
1378
  name?: string;
1247
1379
  /**
1380
+ * @public
1248
1381
  * <p>Any tags provided with the request are added to the playback key pair tags. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services
1249
1382
  * Resources</a> for more information, including restrictions that apply to tags and "Tag
1250
1383
  * naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is
@@ -1257,6 +1390,7 @@ export interface ImportPlaybackKeyPairRequest {
1257
1390
  */
1258
1391
  export interface ImportPlaybackKeyPairResponse {
1259
1392
  /**
1393
+ * @public
1260
1394
  * <p/>
1261
1395
  */
1262
1396
  keyPair?: PlaybackKeyPair;
@@ -1266,19 +1400,23 @@ export interface ImportPlaybackKeyPairResponse {
1266
1400
  */
1267
1401
  export interface ListChannelsRequest {
1268
1402
  /**
1403
+ * @public
1269
1404
  * <p>Filters the channel list to match the specified name.</p>
1270
1405
  */
1271
1406
  filterByName?: string;
1272
1407
  /**
1408
+ * @public
1273
1409
  * <p>Filters the channel list to match the specified recording-configuration ARN.</p>
1274
1410
  */
1275
1411
  filterByRecordingConfigurationArn?: string;
1276
1412
  /**
1413
+ * @public
1277
1414
  * <p>The first channel to retrieve. This is used for pagination; see the <code>nextToken</code>
1278
1415
  * response field.</p>
1279
1416
  */
1280
1417
  nextToken?: string;
1281
1418
  /**
1419
+ * @public
1282
1420
  * <p>Maximum number of channels to return. Default: 100.</p>
1283
1421
  */
1284
1422
  maxResults?: number;
@@ -1289,14 +1427,17 @@ export interface ListChannelsRequest {
1289
1427
  */
1290
1428
  export interface ChannelSummary {
1291
1429
  /**
1430
+ * @public
1292
1431
  * <p>Channel ARN.</p>
1293
1432
  */
1294
1433
  arn?: string;
1295
1434
  /**
1435
+ * @public
1296
1436
  * <p>Channel name.</p>
1297
1437
  */
1298
1438
  name?: string;
1299
1439
  /**
1440
+ * @public
1300
1441
  * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to
1301
1442
  * Full HD. Use <code>LOW</code> for near-real-time interaction with viewers. Default:
1302
1443
  * <code>LOW</code>. (Note: In the Amazon IVS console, <code>LOW</code> and <code>NORMAL</code>
@@ -1304,16 +1445,19 @@ export interface ChannelSummary {
1304
1445
  */
1305
1446
  latencyMode?: ChannelLatencyMode | string;
1306
1447
  /**
1448
+ * @public
1307
1449
  * <p>Whether the channel is private (enabled for playback authorization). Default:
1308
1450
  * <code>false</code>.</p>
1309
1451
  */
1310
1452
  authorized?: boolean;
1311
1453
  /**
1454
+ * @public
1312
1455
  * <p>Recording-configuration ARN. A value other than an empty string indicates that recording
1313
1456
  * is enabled. Default: "" (empty string, recording is disabled).</p>
1314
1457
  */
1315
1458
  recordingConfigurationArn?: string;
1316
1459
  /**
1460
+ * @public
1317
1461
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
1318
1462
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
1319
1463
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -1321,10 +1465,12 @@ export interface ChannelSummary {
1321
1465
  */
1322
1466
  tags?: Record<string, string>;
1323
1467
  /**
1468
+ * @public
1324
1469
  * <p>Whether the channel allows insecure RTMP ingest. Default: <code>false</code>.</p>
1325
1470
  */
1326
1471
  insecureIngest?: boolean;
1327
1472
  /**
1473
+ * @public
1328
1474
  * <p>Channel type, which determines the allowable resolution and bitrate. <i>If you
1329
1475
  * exceed the allowable input resolution or bitrate, the stream probably will disconnect
1330
1476
  * immediately.</i> Some types generate multiple qualities (renditions) from the
@@ -1388,6 +1534,7 @@ export interface ChannelSummary {
1388
1534
  */
1389
1535
  type?: ChannelType | string;
1390
1536
  /**
1537
+ * @public
1391
1538
  * <p>Optional transcode preset for the channel. This is selectable only for
1392
1539
  * <code>ADVANCED_HD</code> and <code>ADVANCED_SD</code> channel types. For those channel
1393
1540
  * types, the default <code>preset</code> is <code>HIGHER_BANDWIDTH_DELIVERY</code>. For other
@@ -1401,10 +1548,12 @@ export interface ChannelSummary {
1401
1548
  */
1402
1549
  export interface ListChannelsResponse {
1403
1550
  /**
1551
+ * @public
1404
1552
  * <p>List of the matching channels.</p>
1405
1553
  */
1406
1554
  channels: ChannelSummary[] | undefined;
1407
1555
  /**
1556
+ * @public
1408
1557
  * <p>If there are more channels than <code>maxResults</code>, use <code>nextToken</code> in the
1409
1558
  * request to get the next set.</p>
1410
1559
  */
@@ -1415,11 +1564,13 @@ export interface ListChannelsResponse {
1415
1564
  */
1416
1565
  export interface ListPlaybackKeyPairsRequest {
1417
1566
  /**
1567
+ * @public
1418
1568
  * <p>The first key pair to retrieve. This is used for pagination; see the
1419
1569
  * <code>nextToken</code> response field.</p>
1420
1570
  */
1421
1571
  nextToken?: string;
1422
1572
  /**
1573
+ * @public
1423
1574
  * <p>Maximum number of key pairs to return. Default: your service quota or 100, whichever is
1424
1575
  * smaller.</p>
1425
1576
  */
@@ -1431,14 +1582,17 @@ export interface ListPlaybackKeyPairsRequest {
1431
1582
  */
1432
1583
  export interface PlaybackKeyPairSummary {
1433
1584
  /**
1585
+ * @public
1434
1586
  * <p>Key-pair ARN.</p>
1435
1587
  */
1436
1588
  arn?: string;
1437
1589
  /**
1590
+ * @public
1438
1591
  * <p>Playback-key-pair name. The value does not need to be unique.</p>
1439
1592
  */
1440
1593
  name?: string;
1441
1594
  /**
1595
+ * @public
1442
1596
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
1443
1597
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
1444
1598
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -1451,10 +1605,12 @@ export interface PlaybackKeyPairSummary {
1451
1605
  */
1452
1606
  export interface ListPlaybackKeyPairsResponse {
1453
1607
  /**
1608
+ * @public
1454
1609
  * <p>List of key pairs.</p>
1455
1610
  */
1456
1611
  keyPairs: PlaybackKeyPairSummary[] | undefined;
1457
1612
  /**
1613
+ * @public
1458
1614
  * <p>If there are more key pairs than <code>maxResults</code>, use <code>nextToken</code> in
1459
1615
  * the request to get the next set.</p>
1460
1616
  */
@@ -1465,11 +1621,13 @@ export interface ListPlaybackKeyPairsResponse {
1465
1621
  */
1466
1622
  export interface ListRecordingConfigurationsRequest {
1467
1623
  /**
1624
+ * @public
1468
1625
  * <p>The first recording configuration to retrieve. This is used for pagination; see the
1469
1626
  * <code>nextToken</code> response field.</p>
1470
1627
  */
1471
1628
  nextToken?: string;
1472
1629
  /**
1630
+ * @public
1473
1631
  * <p>Maximum number of recording configurations to return. Default: your service quota or 100,
1474
1632
  * whichever is smaller. </p>
1475
1633
  */
@@ -1481,23 +1639,28 @@ export interface ListRecordingConfigurationsRequest {
1481
1639
  */
1482
1640
  export interface RecordingConfigurationSummary {
1483
1641
  /**
1642
+ * @public
1484
1643
  * <p>Recording-configuration ARN.</p>
1485
1644
  */
1486
1645
  arn: string | undefined;
1487
1646
  /**
1647
+ * @public
1488
1648
  * <p>Recording-configuration name. The value does not need to be unique.</p>
1489
1649
  */
1490
1650
  name?: string;
1491
1651
  /**
1652
+ * @public
1492
1653
  * <p>A complex type that contains information about where recorded video will be stored.</p>
1493
1654
  */
1494
1655
  destinationConfiguration: DestinationConfiguration | undefined;
1495
1656
  /**
1657
+ * @public
1496
1658
  * <p>Indicates the current state of the recording configuration. When the state is
1497
1659
  * <code>ACTIVE</code>, the configuration is ready for recording a channel stream.</p>
1498
1660
  */
1499
1661
  state: RecordingConfigurationState | string | undefined;
1500
1662
  /**
1663
+ * @public
1501
1664
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
1502
1665
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
1503
1666
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -1510,10 +1673,12 @@ export interface RecordingConfigurationSummary {
1510
1673
  */
1511
1674
  export interface ListRecordingConfigurationsResponse {
1512
1675
  /**
1676
+ * @public
1513
1677
  * <p>List of the matching recording configurations.</p>
1514
1678
  */
1515
1679
  recordingConfigurations: RecordingConfigurationSummary[] | undefined;
1516
1680
  /**
1681
+ * @public
1517
1682
  * <p>If there are more recording configurations than <code>maxResults</code>, use
1518
1683
  * <code>nextToken</code> in the request to get the next set.</p>
1519
1684
  */
@@ -1524,15 +1689,18 @@ export interface ListRecordingConfigurationsResponse {
1524
1689
  */
1525
1690
  export interface ListStreamKeysRequest {
1526
1691
  /**
1692
+ * @public
1527
1693
  * <p>Channel ARN used to filter the list.</p>
1528
1694
  */
1529
1695
  channelArn: string | undefined;
1530
1696
  /**
1697
+ * @public
1531
1698
  * <p>The first stream key to retrieve. This is used for pagination; see the
1532
1699
  * <code>nextToken</code> response field.</p>
1533
1700
  */
1534
1701
  nextToken?: string;
1535
1702
  /**
1703
+ * @public
1536
1704
  * <p>Maximum number of streamKeys to return. Default: 1.</p>
1537
1705
  */
1538
1706
  maxResults?: number;
@@ -1543,14 +1711,17 @@ export interface ListStreamKeysRequest {
1543
1711
  */
1544
1712
  export interface StreamKeySummary {
1545
1713
  /**
1714
+ * @public
1546
1715
  * <p>Stream-key ARN.</p>
1547
1716
  */
1548
1717
  arn?: string;
1549
1718
  /**
1719
+ * @public
1550
1720
  * <p>Channel ARN for the stream.</p>
1551
1721
  */
1552
1722
  channelArn?: string;
1553
1723
  /**
1724
+ * @public
1554
1725
  * <p>Tags attached to the resource. Array of 1-50 maps, each of the form <code>string:string
1555
1726
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
1556
1727
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -1563,10 +1734,12 @@ export interface StreamKeySummary {
1563
1734
  */
1564
1735
  export interface ListStreamKeysResponse {
1565
1736
  /**
1737
+ * @public
1566
1738
  * <p>List of stream keys.</p>
1567
1739
  */
1568
1740
  streamKeys: StreamKeySummary[] | undefined;
1569
1741
  /**
1742
+ * @public
1570
1743
  * <p>If there are more stream keys than <code>maxResults</code>, use <code>nextToken</code> in
1571
1744
  * the request to get the next set.</p>
1572
1745
  */
@@ -1578,6 +1751,7 @@ export interface ListStreamKeysResponse {
1578
1751
  */
1579
1752
  export interface StreamFilters {
1580
1753
  /**
1754
+ * @public
1581
1755
  * <p>The stream’s health.</p>
1582
1756
  */
1583
1757
  health?: StreamHealth | string;
@@ -1587,15 +1761,18 @@ export interface StreamFilters {
1587
1761
  */
1588
1762
  export interface ListStreamsRequest {
1589
1763
  /**
1764
+ * @public
1590
1765
  * <p>Filters the stream list to match the specified criterion.</p>
1591
1766
  */
1592
1767
  filterBy?: StreamFilters;
1593
1768
  /**
1769
+ * @public
1594
1770
  * <p>The first stream to retrieve. This is used for pagination; see the <code>nextToken</code>
1595
1771
  * response field.</p>
1596
1772
  */
1597
1773
  nextToken?: string;
1598
1774
  /**
1775
+ * @public
1599
1776
  * <p>Maximum number of streams to return. Default: 100.</p>
1600
1777
  */
1601
1778
  maxResults?: number;
@@ -1606,24 +1783,29 @@ export interface ListStreamsRequest {
1606
1783
  */
1607
1784
  export interface StreamSummary {
1608
1785
  /**
1786
+ * @public
1609
1787
  * <p>Channel ARN for the stream.</p>
1610
1788
  */
1611
1789
  channelArn?: string;
1612
1790
  /**
1791
+ * @public
1613
1792
  * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
1614
1793
  */
1615
1794
  streamId?: string;
1616
1795
  /**
1796
+ * @public
1617
1797
  * <p>The stream’s state. Do not rely on the <code>OFFLINE</code> state, as the API may not
1618
1798
  * return it; instead, a "NotBroadcasting" error will indicate that the stream is not
1619
1799
  * live.</p>
1620
1800
  */
1621
1801
  state?: StreamState | string;
1622
1802
  /**
1803
+ * @public
1623
1804
  * <p>The stream’s health.</p>
1624
1805
  */
1625
1806
  health?: StreamHealth | string;
1626
1807
  /**
1808
+ * @public
1627
1809
  * <p>A count of concurrent views of the stream. Typically, a new view appears in
1628
1810
  * <code>viewerCount</code> within 15 seconds of when video playback starts and a view is
1629
1811
  * removed from <code>viewerCount</code> within 1 minute of when video playback ends. A value of
@@ -1631,6 +1813,7 @@ export interface StreamSummary {
1631
1813
  */
1632
1814
  viewerCount?: number;
1633
1815
  /**
1816
+ * @public
1634
1817
  * <p>Time of the stream’s start. This is an ISO 8601 timestamp; <i>note that this is
1635
1818
  * returned as a string</i>. </p>
1636
1819
  */
@@ -1641,10 +1824,12 @@ export interface StreamSummary {
1641
1824
  */
1642
1825
  export interface ListStreamsResponse {
1643
1826
  /**
1827
+ * @public
1644
1828
  * <p>List of streams.</p>
1645
1829
  */
1646
1830
  streams: StreamSummary[] | undefined;
1647
1831
  /**
1832
+ * @public
1648
1833
  * <p>If there are more streams than <code>maxResults</code>, use <code>nextToken</code> in the
1649
1834
  * request to get the next set.</p>
1650
1835
  */
@@ -1655,15 +1840,18 @@ export interface ListStreamsResponse {
1655
1840
  */
1656
1841
  export interface ListStreamSessionsRequest {
1657
1842
  /**
1843
+ * @public
1658
1844
  * <p>Channel ARN used to filter the list.</p>
1659
1845
  */
1660
1846
  channelArn: string | undefined;
1661
1847
  /**
1848
+ * @public
1662
1849
  * <p>The first stream to retrieve. This is used for pagination; see the <code>nextToken</code>
1663
1850
  * response field.</p>
1664
1851
  */
1665
1852
  nextToken?: string;
1666
1853
  /**
1854
+ * @public
1667
1855
  * <p>Maximum number of streams to return. Default: 100.</p>
1668
1856
  */
1669
1857
  maxResults?: number;
@@ -1674,20 +1862,24 @@ export interface ListStreamSessionsRequest {
1674
1862
  */
1675
1863
  export interface StreamSessionSummary {
1676
1864
  /**
1865
+ * @public
1677
1866
  * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
1678
1867
  */
1679
1868
  streamId?: string;
1680
1869
  /**
1870
+ * @public
1681
1871
  * <p>Time when the channel went live. This is an ISO 8601 timestamp; <i>note that this
1682
1872
  * is returned as a string</i>.</p>
1683
1873
  */
1684
1874
  startTime?: Date;
1685
1875
  /**
1876
+ * @public
1686
1877
  * <p>Time when the channel went offline. This is an ISO 8601 timestamp; <i>note that
1687
1878
  * this is returned as a string</i>. For live streams, this is <code>NULL</code>.</p>
1688
1879
  */
1689
1880
  endTime?: Date;
1690
1881
  /**
1882
+ * @public
1691
1883
  * <p>If <code>true</code>, this stream encountered a quota breach or failure.</p>
1692
1884
  */
1693
1885
  hasErrorEvent?: boolean;
@@ -1697,10 +1889,12 @@ export interface StreamSessionSummary {
1697
1889
  */
1698
1890
  export interface ListStreamSessionsResponse {
1699
1891
  /**
1892
+ * @public
1700
1893
  * <p>List of stream sessions.</p>
1701
1894
  */
1702
1895
  streamSessions: StreamSessionSummary[] | undefined;
1703
1896
  /**
1897
+ * @public
1704
1898
  * <p>If there are more streams than <code>maxResults</code>, use <code>nextToken</code> in the
1705
1899
  * request to get the next set.</p>
1706
1900
  */
@@ -1711,6 +1905,7 @@ export interface ListStreamSessionsResponse {
1711
1905
  */
1712
1906
  export interface ListTagsForResourceRequest {
1713
1907
  /**
1908
+ * @public
1714
1909
  * <p>The ARN of the resource to be retrieved. The ARN must be URL-encoded.</p>
1715
1910
  */
1716
1911
  resourceArn: string | undefined;
@@ -1720,6 +1915,7 @@ export interface ListTagsForResourceRequest {
1720
1915
  */
1721
1916
  export interface ListTagsForResourceResponse {
1722
1917
  /**
1918
+ * @public
1723
1919
  * <p>Tags attached to the resource. Array of maps, each of the form <code>string:string
1724
1920
  * (key:value)</code>.</p>
1725
1921
  */
@@ -1730,11 +1926,13 @@ export interface ListTagsForResourceResponse {
1730
1926
  */
1731
1927
  export interface PutMetadataRequest {
1732
1928
  /**
1929
+ * @public
1733
1930
  * <p>ARN of the channel into which metadata is inserted. This channel must have an active
1734
1931
  * stream.</p>
1735
1932
  */
1736
1933
  channelArn: string | undefined;
1737
1934
  /**
1935
+ * @public
1738
1936
  * <p>Metadata to insert into the stream. Maximum: 1 KB per request.</p>
1739
1937
  */
1740
1938
  metadata: string | undefined;
@@ -1744,15 +1942,18 @@ export interface PutMetadataRequest {
1744
1942
  */
1745
1943
  export interface StartViewerSessionRevocationRequest {
1746
1944
  /**
1945
+ * @public
1747
1946
  * <p>The ARN of the channel associated with the viewer session to revoke.</p>
1748
1947
  */
1749
1948
  channelArn: string | undefined;
1750
1949
  /**
1950
+ * @public
1751
1951
  * <p>The ID of the viewer associated with the viewer session to revoke. Do not use this field
1752
1952
  * for personally identifying, confidential, or sensitive information.</p>
1753
1953
  */
1754
1954
  viewerId: string | undefined;
1755
1955
  /**
1956
+ * @public
1756
1957
  * <p>An optional filter on which versions of the viewer session to revoke. All versions less
1757
1958
  * than or equal to the specified version will be revoked. Default: 0.</p>
1758
1959
  */
@@ -1768,6 +1969,7 @@ export interface StartViewerSessionRevocationResponse {
1768
1969
  */
1769
1970
  export interface StopStreamRequest {
1770
1971
  /**
1972
+ * @public
1771
1973
  * <p>ARN of the channel for which the stream is to be stopped.</p>
1772
1974
  */
1773
1975
  channelArn: string | undefined;
@@ -1785,6 +1987,7 @@ export declare class StreamUnavailable extends __BaseException {
1785
1987
  readonly name: "StreamUnavailable";
1786
1988
  readonly $fault: "server";
1787
1989
  /**
1990
+ * @public
1788
1991
  * <p>The stream is temporarily unavailable.</p>
1789
1992
  */
1790
1993
  exceptionMessage?: string;
@@ -1798,11 +2001,13 @@ export declare class StreamUnavailable extends __BaseException {
1798
2001
  */
1799
2002
  export interface TagResourceRequest {
1800
2003
  /**
2004
+ * @public
1801
2005
  * <p>ARN of the resource for which tags are to be added or updated. The ARN must be
1802
2006
  * URL-encoded.</p>
1803
2007
  */
1804
2008
  resourceArn: string | undefined;
1805
2009
  /**
2010
+ * @public
1806
2011
  * <p>Array of tags to be added or updated. Array of maps, each of the form <code>string:string
1807
2012
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
1808
2013
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -1820,10 +2025,12 @@ export interface TagResourceResponse {
1820
2025
  */
1821
2026
  export interface UntagResourceRequest {
1822
2027
  /**
2028
+ * @public
1823
2029
  * <p>ARN of the resource for which tags are to be removed. The ARN must be URL-encoded.</p>
1824
2030
  */
1825
2031
  resourceArn: string | undefined;
1826
2032
  /**
2033
+ * @public
1827
2034
  * <p>Array of tags to be removed. Array of maps, each of the form s<code>tring:string
1828
2035
  * (key:value)</code>. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for more information, including restrictions
1829
2036
  * that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no
@@ -1841,14 +2048,17 @@ export interface UntagResourceResponse {
1841
2048
  */
1842
2049
  export interface UpdateChannelRequest {
1843
2050
  /**
2051
+ * @public
1844
2052
  * <p>ARN of the channel to be updated.</p>
1845
2053
  */
1846
2054
  arn: string | undefined;
1847
2055
  /**
2056
+ * @public
1848
2057
  * <p>Channel name.</p>
1849
2058
  */
1850
2059
  name?: string;
1851
2060
  /**
2061
+ * @public
1852
2062
  * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to
1853
2063
  * Full HD. Use <code>LOW</code> for near-real-time interaction with viewers. (Note: In the
1854
2064
  * Amazon IVS console, <code>LOW</code> and <code>NORMAL</code> correspond to Ultra-low and
@@ -1856,6 +2066,7 @@ export interface UpdateChannelRequest {
1856
2066
  */
1857
2067
  latencyMode?: ChannelLatencyMode | string;
1858
2068
  /**
2069
+ * @public
1859
2070
  * <p>Channel type, which determines the allowable resolution and bitrate. <i>If you
1860
2071
  * exceed the allowable input resolution or bitrate, the stream probably will disconnect
1861
2072
  * immediately.</i> Some types generate multiple qualities (renditions) from the
@@ -1919,19 +2130,23 @@ export interface UpdateChannelRequest {
1919
2130
  */
1920
2131
  type?: ChannelType | string;
1921
2132
  /**
2133
+ * @public
1922
2134
  * <p>Whether the channel is private (enabled for playback authorization).</p>
1923
2135
  */
1924
2136
  authorized?: boolean;
1925
2137
  /**
2138
+ * @public
1926
2139
  * <p>Recording-configuration ARN. If this is set to an empty string, recording is disabled. A
1927
2140
  * value other than an empty string indicates that recording is enabled</p>
1928
2141
  */
1929
2142
  recordingConfigurationArn?: string;
1930
2143
  /**
2144
+ * @public
1931
2145
  * <p>Whether the channel allows insecure RTMP ingest. Default: <code>false</code>.</p>
1932
2146
  */
1933
2147
  insecureIngest?: boolean;
1934
2148
  /**
2149
+ * @public
1935
2150
  * <p>Optional transcode preset for the channel. This is selectable only for
1936
2151
  * <code>ADVANCED_HD</code> and <code>ADVANCED_SD</code> channel types. For those channel
1937
2152
  * types, the default <code>preset</code> is <code>HIGHER_BANDWIDTH_DELIVERY</code>. For other
@@ -1945,6 +2160,7 @@ export interface UpdateChannelRequest {
1945
2160
  */
1946
2161
  export interface UpdateChannelResponse {
1947
2162
  /**
2163
+ * @public
1948
2164
  * <p>Object specifying a channel.</p>
1949
2165
  */
1950
2166
  channel?: Channel;