@aws-sdk/client-ivs-realtime 3.1135.0 → 3.1137.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 (49) hide show
  1. package/README.md +1 -78
  2. package/dist-cjs/index.js +5 -5
  3. package/dist-es/schemas/schemas_0.js +4 -4
  4. package/dist-types/IVSRealTime.d.ts +1 -78
  5. package/dist-types/IVSRealTimeClient.d.ts +1 -78
  6. package/dist-types/commands/CreateEncoderConfigurationCommand.d.ts +7 -7
  7. package/dist-types/commands/CreateIngestConfigurationCommand.d.ts +11 -4
  8. package/dist-types/commands/CreateParticipantTokenCommand.d.ts +6 -10
  9. package/dist-types/commands/CreateStageCommand.d.ts +4 -4
  10. package/dist-types/commands/CreateStorageConfigurationCommand.d.ts +8 -10
  11. package/dist-types/commands/DeleteEncoderConfigurationCommand.d.ts +7 -8
  12. package/dist-types/commands/DeleteIngestConfigurationCommand.d.ts +5 -5
  13. package/dist-types/commands/DeletePublicKeyCommand.d.ts +6 -8
  14. package/dist-types/commands/DeleteStageCommand.d.ts +6 -8
  15. package/dist-types/commands/DeleteStorageConfigurationCommand.d.ts +7 -10
  16. package/dist-types/commands/DisconnectParticipantCommand.d.ts +5 -7
  17. package/dist-types/commands/GetCompositionCommand.d.ts +6 -6
  18. package/dist-types/commands/GetEncoderConfigurationCommand.d.ts +6 -6
  19. package/dist-types/commands/GetIngestConfigurationCommand.d.ts +3 -3
  20. package/dist-types/commands/GetParticipantCommand.d.ts +3 -3
  21. package/dist-types/commands/GetPublicKeyCommand.d.ts +3 -3
  22. package/dist-types/commands/GetStageCommand.d.ts +3 -3
  23. package/dist-types/commands/GetStageSessionCommand.d.ts +3 -3
  24. package/dist-types/commands/GetStorageConfigurationCommand.d.ts +6 -6
  25. package/dist-types/commands/ImportPublicKeyCommand.d.ts +5 -5
  26. package/dist-types/commands/ListCompositionsCommand.d.ts +6 -7
  27. package/dist-types/commands/ListEncoderConfigurationsCommand.d.ts +6 -7
  28. package/dist-types/commands/ListIngestConfigurationsCommand.d.ts +2 -2
  29. package/dist-types/commands/ListParticipantEventsCommand.d.ts +3 -4
  30. package/dist-types/commands/ListParticipantReplicasCommand.d.ts +2 -2
  31. package/dist-types/commands/ListParticipantsCommand.d.ts +2 -2
  32. package/dist-types/commands/ListPublicKeysCommand.d.ts +2 -2
  33. package/dist-types/commands/ListStageSessionsCommand.d.ts +2 -2
  34. package/dist-types/commands/ListStagesCommand.d.ts +4 -5
  35. package/dist-types/commands/ListStorageConfigurationsCommand.d.ts +6 -7
  36. package/dist-types/commands/ListTagsForResourceCommand.d.ts +3 -3
  37. package/dist-types/commands/StartCompositionCommand.d.ts +8 -31
  38. package/dist-types/commands/StartParticipantReplicationCommand.d.ts +7 -7
  39. package/dist-types/commands/StopCompositionCommand.d.ts +7 -8
  40. package/dist-types/commands/StopParticipantReplicationCommand.d.ts +4 -4
  41. package/dist-types/commands/TagResourceCommand.d.ts +3 -3
  42. package/dist-types/commands/UntagResourceCommand.d.ts +3 -3
  43. package/dist-types/commands/UpdateIngestConfigurationCommand.d.ts +12 -5
  44. package/dist-types/commands/UpdateStageCommand.d.ts +6 -6
  45. package/dist-types/index.d.ts +1 -78
  46. package/dist-types/models/errors.d.ts +7 -7
  47. package/dist-types/models/models_0.d.ts +210 -533
  48. package/dist-types/ts3.4/models/models_0.d.ts +14 -0
  49. package/package.json +1 -1
@@ -63,25 +63,25 @@ declare const StartParticipantReplicationCommand_base: {
63
63
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
64
64
  *
65
65
  * @throws {@link AccessDeniedException} (client fault)
66
- * <p/>
66
+ * <p>User does not have sufficient access to perform this action.</p>
67
67
  *
68
68
  * @throws {@link ConflictException} (client fault)
69
- * <p/>
69
+ * <p>Updating or deleting a resource can cause an inconsistent state.</p>
70
70
  *
71
71
  * @throws {@link InternalServerException} (server fault)
72
- * <p/>
72
+ * <p>Unexpected error during processing of request.</p>
73
73
  *
74
74
  * @throws {@link PendingVerification} (client fault)
75
- * <p/>
75
+ * <p>Your account is pending verification.</p>
76
76
  *
77
77
  * @throws {@link ResourceNotFoundException} (client fault)
78
- * <p/>
78
+ * <p>Request references a resource which does not exist.</p>
79
79
  *
80
80
  * @throws {@link ServiceQuotaExceededException} (client fault)
81
- * <p/>
81
+ * <p>Request would cause a service quota to be exceeded.</p>
82
82
  *
83
83
  * @throws {@link ValidationException} (client fault)
84
- * <p/>
84
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
85
85
  *
86
86
  * @throws {@link IVSRealTimeServiceException}
87
87
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -24,8 +24,7 @@ declare const StopCompositionCommand_base: {
24
24
  getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
25
25
  };
26
26
  /**
27
- * <p>Stops and deletes a Composition resource. Any broadcast from the Composition resource
28
- * is stopped.</p>
27
+ * <p>Stops and deletes a Composition resource. Any broadcast from the Composition resource is stopped.</p>
29
28
  * @example
30
29
  * Use a bare-bones client and the command you need to make an API call.
31
30
  * ```javascript
@@ -50,22 +49,22 @@ declare const StopCompositionCommand_base: {
50
49
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
51
50
  *
52
51
  * @throws {@link AccessDeniedException} (client fault)
53
- * <p/>
52
+ * <p>User does not have sufficient access to perform this action.</p>
54
53
  *
55
54
  * @throws {@link ConflictException} (client fault)
56
- * <p/>
55
+ * <p>Updating or deleting a resource can cause an inconsistent state.</p>
57
56
  *
58
57
  * @throws {@link InternalServerException} (server fault)
59
- * <p/>
58
+ * <p>Unexpected error during processing of request.</p>
60
59
  *
61
60
  * @throws {@link ResourceNotFoundException} (client fault)
62
- * <p/>
61
+ * <p>Request references a resource which does not exist.</p>
63
62
  *
64
63
  * @throws {@link ServiceQuotaExceededException} (client fault)
65
- * <p/>
64
+ * <p>Request would cause a service quota to be exceeded.</p>
66
65
  *
67
66
  * @throws {@link ValidationException} (client fault)
68
- * <p/>
67
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
69
68
  *
70
69
  * @throws {@link IVSRealTimeServiceException}
71
70
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -59,16 +59,16 @@ declare const StopParticipantReplicationCommand_base: {
59
59
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
60
60
  *
61
61
  * @throws {@link AccessDeniedException} (client fault)
62
- * <p/>
62
+ * <p>User does not have sufficient access to perform this action.</p>
63
63
  *
64
64
  * @throws {@link InternalServerException} (server fault)
65
- * <p/>
65
+ * <p>Unexpected error during processing of request.</p>
66
66
  *
67
67
  * @throws {@link ResourceNotFoundException} (client fault)
68
- * <p/>
68
+ * <p>Request references a resource which does not exist.</p>
69
69
  *
70
70
  * @throws {@link ValidationException} (client fault)
71
- * <p/>
71
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
72
72
  *
73
73
  * @throws {@link IVSRealTimeServiceException}
74
74
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -52,13 +52,13 @@ declare const TagResourceCommand_base: {
52
52
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
53
53
  *
54
54
  * @throws {@link InternalServerException} (server fault)
55
- * <p/>
55
+ * <p>Unexpected error during processing of request.</p>
56
56
  *
57
57
  * @throws {@link ResourceNotFoundException} (client fault)
58
- * <p/>
58
+ * <p>Request references a resource which does not exist.</p>
59
59
  *
60
60
  * @throws {@link ValidationException} (client fault)
61
- * <p/>
61
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
62
62
  *
63
63
  * @throws {@link IVSRealTimeServiceException}
64
64
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -52,13 +52,13 @@ declare const UntagResourceCommand_base: {
52
52
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
53
53
  *
54
54
  * @throws {@link InternalServerException} (server fault)
55
- * <p/>
55
+ * <p>Unexpected error during processing of request.</p>
56
56
  *
57
57
  * @throws {@link ResourceNotFoundException} (client fault)
58
- * <p/>
58
+ * <p>Request references a resource which does not exist.</p>
59
59
  *
60
60
  * @throws {@link ValidationException} (client fault)
61
- * <p/>
61
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
62
62
  *
63
63
  * @throws {@link IVSRealTimeServiceException}
64
64
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -41,6 +41,13 @@ declare const UpdateIngestConfigurationCommand_base: {
41
41
  * const command = new UpdateIngestConfigurationCommand(input);
42
42
  * const response = await client.send(command);
43
43
  * // { // UpdateIngestConfigurationResponse
44
+ * // accessControlAllowOrigin: "STRING_VALUE",
45
+ * // accessControlExposeHeaders: "STRING_VALUE",
46
+ * // cacheControl: "STRING_VALUE",
47
+ * // contentSecurityPolicy: "STRING_VALUE",
48
+ * // strictTransportSecurity: "STRING_VALUE",
49
+ * // xContentTypeOptions: "STRING_VALUE",
50
+ * // xFrameOptions: "STRING_VALUE",
44
51
  * // ingestConfiguration: { // IngestConfiguration
45
52
  * // name: "STRING_VALUE",
46
53
  * // arn: "STRING_VALUE", // required
@@ -75,19 +82,19 @@ declare const UpdateIngestConfigurationCommand_base: {
75
82
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
76
83
  *
77
84
  * @throws {@link AccessDeniedException} (client fault)
78
- * <p/>
85
+ * <p>User does not have sufficient access to perform this action.</p>
79
86
  *
80
87
  * @throws {@link ConflictException} (client fault)
81
- * <p/>
88
+ * <p>Updating or deleting a resource can cause an inconsistent state.</p>
82
89
  *
83
90
  * @throws {@link PendingVerification} (client fault)
84
- * <p/>
91
+ * <p>Your account is pending verification.</p>
85
92
  *
86
93
  * @throws {@link ResourceNotFoundException} (client fault)
87
- * <p/>
94
+ * <p>Request references a resource which does not exist.</p>
88
95
  *
89
96
  * @throws {@link ValidationException} (client fault)
90
- * <p/>
97
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
91
98
  *
92
99
  * @throws {@link IVSRealTimeServiceException}
93
100
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -101,22 +101,22 @@ declare const UpdateStageCommand_base: {
101
101
  * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
102
102
  *
103
103
  * @throws {@link AccessDeniedException} (client fault)
104
- * <p/>
104
+ * <p>User does not have sufficient access to perform this action.</p>
105
105
  *
106
106
  * @throws {@link ConflictException} (client fault)
107
- * <p/>
107
+ * <p>Updating or deleting a resource can cause an inconsistent state.</p>
108
108
  *
109
109
  * @throws {@link PendingVerification} (client fault)
110
- * <p/>
110
+ * <p>Your account is pending verification.</p>
111
111
  *
112
112
  * @throws {@link ResourceNotFoundException} (client fault)
113
- * <p/>
113
+ * <p>Request references a resource which does not exist.</p>
114
114
  *
115
115
  * @throws {@link ServiceQuotaExceededException} (client fault)
116
- * <p/>
116
+ * <p>Request would cause a service quota to be exceeded.</p>
117
117
  *
118
118
  * @throws {@link ValidationException} (client fault)
119
- * <p/>
119
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
120
120
  *
121
121
  * @throws {@link IVSRealTimeServiceException}
122
122
  * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
@@ -1,82 +1,5 @@
1
1
  /**
2
- * <p>The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP
3
- * API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses,
4
- * including errors.
5
- * </p>
6
- * <p>
7
- * <b>Key Concepts</b>
8
- * </p>
9
- * <ul>
10
- * <li>
11
- * <p>
12
- * <b>Stage</b> — A virtual space where participants can exchange video in real time.</p>
13
- * </li>
14
- * <li>
15
- * <p>
16
- * <b>Participant token</b> — A token that authenticates a participant when they join a stage.</p>
17
- * </li>
18
- * <li>
19
- * <p>
20
- * <b>Participant object</b> — Represents participants (people) in the stage and
21
- * contains information about them. When a token is created, it includes a participant ID;
22
- * when a participant uses that token to join a stage, the participant is associated with
23
- * that participant ID. There is a 1:1 mapping between participant tokens and
24
- * participants.</p>
25
- * </li>
26
- * </ul>
27
- * <p>For server-side composition:</p>
28
- * <ul>
29
- * <li>
30
- * <p>
31
- * <b>Composition process</b> — Composites participants
32
- * of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels).
33
- * Composition operations support this process.</p>
34
- * </li>
35
- * <li>
36
- * <p>
37
- * <b>Composition</b> — Controls the look of the outputs,
38
- * including how participants are positioned in the video.</p>
39
- * </li>
40
- * </ul>
41
- * <p>For participant replication:</p>
42
- * <ul>
43
- * <li>
44
- * <p>
45
- * <b>Source stage</b> — The stage where the participant originally joined, which is used as the source for
46
- * replication.</p>
47
- * </li>
48
- * <li>
49
- * <p>
50
- * <b>Destination stage</b> — The stage to which the participant is replicated.
51
- * </p>
52
- * </li>
53
- * <li>
54
- * <p>
55
- * <b>Replicated participant</b> — A participant in a stage that is replicated to one or more destination stages.
56
- * </p>
57
- * </li>
58
- * <li>
59
- * <p>
60
- * <b>Replica participant</b> — A participant in a destination stage that is replicated from another stage
61
- * (the source stage).</p>
62
- * </li>
63
- * </ul>
64
- * <p>For more information about your IVS live stream, also see <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started.html">Getting Started with Amazon IVS Real-Time Streaming</a>.</p>
65
- * <p>
66
- * <b>Tagging</b>
67
- * </p>
68
- * <p>A <i>tag</i> is a metadata label that you assign to an AWS resource. A tag
69
- * comprises a <i>key</i> and a <i>value</i>, both set by you. For
70
- * example, you might set a tag as <code>topic:nature</code> to label a particular video
71
- * category. See <a href="https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html">Best practices and strategies</a>
72
- * in <i>Tagging AWS Resources and Tag Editor</i> for details, including restrictions that apply to tags and "Tag naming
73
- * limits and requirements"; Amazon IVS stages has no service-specific constraints beyond what is documented there.</p>
74
- * <p>Tags can help you identify and organize your AWS resources. For example, you can use the
75
- * same tag for different resources to indicate that they are related. You can also use tags to
76
- * manage access (see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Access Tags</a>).</p>
77
- * <p>The Amazon IVS real-time API has these tag-related operations: <a>TagResource</a>, <a>UntagResource</a>, and
78
- * <a>ListTagsForResource</a>. The following resource supports tagging: Stage.</p>
79
- * <p>At most 50 tags can be applied to a resource.</p>
2
+ * <p>The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses, including errors. </p> <p> <b>Key Concepts</b> </p> <ul> <li> <p> <b>Stage</b> — A virtual space where participants can exchange video in real time.</p> </li> <li> <p> <b>Participant token</b> — A token that authenticates a participant when they join a stage.</p> </li> <li> <p> <b>Participant object</b> — Represents participants (people) in the stage and contains information about them. When a token is created, it includes a participant ID; when a participant uses that token to join a stage, the participant is associated with that participant ID. There is a 1:1 mapping between participant tokens and participants.</p> </li> </ul> <p>For server-side composition:</p> <ul> <li> <p> <b>Composition process</b> — Composites participants of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels). Composition operations support this process.</p> </li> <li> <p> <b>Composition</b> — Controls the look of the outputs, including how participants are positioned in the video.</p> </li> </ul> <p>For participant replication:</p> <ul> <li> <p> <b>Source stage</b> — The stage where the participant originally joined, which is used as the source for replication.</p> </li> <li> <p> <b>Destination stage</b> — The stage to which the participant is replicated. </p> </li> <li> <p> <b>Replicated participant</b> — A participant in a stage that is replicated to one or more destination stages. </p> </li> <li> <p> <b>Replica participant</b> — A participant in a destination stage that is replicated from another stage (the source stage).</p> </li> </ul> <p>For more information about your IVS live stream, also see <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started.html">Getting Started with Amazon IVS Real-Time Streaming</a>.</p> <p> <b>Tagging</b> </p> <p>A <i>tag</i> is a metadata label that you assign to an AWS resource. A tag comprises a <i>key</i> and a <i>value</i>, both set by you. For example, you might set a tag as <code>topic:nature</code> to label a particular video category. See <a href="https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html">Best practices and strategies</a> in <i>Tagging AWS Resources and Tag Editor</i> for details, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS stages has no service-specific constraints beyond what is documented there.</p> <p>Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different resources to indicate that they are related. You can also use tags to manage access (see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">Access Tags</a>).</p> <p>The Amazon IVS real-time API has these tag-related operations: <a>TagResource</a>, <a>UntagResource</a>, and <a>ListTagsForResource</a>. The following resource supports tagging: Stage.</p> <p>At most 50 tags can be applied to a resource.</p>
80
3
  *
81
4
  * @packageDocumentation
82
5
  */
@@ -1,7 +1,7 @@
1
1
  import type { ExceptionOptionType as __ExceptionOptionType } from "@smithy/core/client";
2
2
  import { IVSRealTimeServiceException as __BaseException } from "./IVSRealTimeServiceException";
3
3
  /**
4
- * <p/>
4
+ * <p>User does not have sufficient access to perform this action.</p>
5
5
  * @public
6
6
  */
7
7
  export declare class AccessDeniedException extends __BaseException {
@@ -58,7 +58,7 @@ export declare class AccessDeniedException extends __BaseException {
58
58
  constructor(opts: __ExceptionOptionType<AccessDeniedException, __BaseException>);
59
59
  }
60
60
  /**
61
- * <p/>
61
+ * <p>Updating or deleting a resource can cause an inconsistent state.</p>
62
62
  * @public
63
63
  */
64
64
  export declare class ConflictException extends __BaseException {
@@ -115,7 +115,7 @@ export declare class ConflictException extends __BaseException {
115
115
  constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
116
116
  }
117
117
  /**
118
- * <p/>
118
+ * <p>Unexpected error during processing of request.</p>
119
119
  * @public
120
120
  */
121
121
  export declare class InternalServerException extends __BaseException {
@@ -172,7 +172,7 @@ export declare class InternalServerException extends __BaseException {
172
172
  constructor(opts: __ExceptionOptionType<InternalServerException, __BaseException>);
173
173
  }
174
174
  /**
175
- * <p/>
175
+ * <p>Your account is pending verification.</p>
176
176
  * @public
177
177
  */
178
178
  export declare class PendingVerification extends __BaseException {
@@ -229,7 +229,7 @@ export declare class PendingVerification extends __BaseException {
229
229
  constructor(opts: __ExceptionOptionType<PendingVerification, __BaseException>);
230
230
  }
231
231
  /**
232
- * <p/>
232
+ * <p>Request references a resource which does not exist.</p>
233
233
  * @public
234
234
  */
235
235
  export declare class ResourceNotFoundException extends __BaseException {
@@ -286,7 +286,7 @@ export declare class ResourceNotFoundException extends __BaseException {
286
286
  constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
287
287
  }
288
288
  /**
289
- * <p/>
289
+ * <p>Request would cause a service quota to be exceeded.</p>
290
290
  * @public
291
291
  */
292
292
  export declare class ServiceQuotaExceededException extends __BaseException {
@@ -343,7 +343,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
343
343
  constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
344
344
  }
345
345
  /**
346
- * <p/>
346
+ * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
347
347
  * @public
348
348
  */
349
349
  export declare class ValidationException extends __BaseException {