@aws-sdk/client-ivs-realtime 3.600.0 → 3.605.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 (41) hide show
  1. package/README.md +49 -170
  2. package/dist-cjs/index.js +230 -0
  3. package/dist-es/IVSRealTime.js +8 -0
  4. package/dist-es/commands/DeletePublicKeyCommand.js +24 -0
  5. package/dist-es/commands/GetPublicKeyCommand.js +24 -0
  6. package/dist-es/commands/ImportPublicKeyCommand.js +24 -0
  7. package/dist-es/commands/ListPublicKeysCommand.js +24 -0
  8. package/dist-es/commands/index.js +4 -0
  9. package/dist-es/models/models_0.js +19 -0
  10. package/dist-es/pagination/ListPublicKeysPaginator.js +4 -0
  11. package/dist-es/pagination/index.js +1 -0
  12. package/dist-es/protocols/Aws_restJson1.js +115 -0
  13. package/dist-types/IVSRealTime.d.ts +53 -177
  14. package/dist-types/IVSRealTimeClient.d.ts +30 -179
  15. package/dist-types/commands/CreateStageCommand.d.ts +16 -0
  16. package/dist-types/commands/DeletePublicKeyCommand.d.ts +75 -0
  17. package/dist-types/commands/GetParticipantCommand.d.ts +3 -0
  18. package/dist-types/commands/GetPublicKeyCommand.d.ts +77 -0
  19. package/dist-types/commands/GetStageCommand.d.ts +10 -0
  20. package/dist-types/commands/ImportPublicKeyCommand.d.ts +87 -0
  21. package/dist-types/commands/ListParticipantsCommand.d.ts +2 -0
  22. package/dist-types/commands/ListPublicKeysCommand.d.ts +76 -0
  23. package/dist-types/commands/UpdateStageCommand.d.ts +16 -0
  24. package/dist-types/commands/index.d.ts +4 -0
  25. package/dist-types/index.d.ts +24 -177
  26. package/dist-types/models/models_0.d.ts +305 -22
  27. package/dist-types/pagination/ListPublicKeysPaginator.d.ts +7 -0
  28. package/dist-types/pagination/index.d.ts +1 -0
  29. package/dist-types/protocols/Aws_restJson1.d.ts +36 -0
  30. package/dist-types/ts3.4/IVSRealTime.d.ts +69 -0
  31. package/dist-types/ts3.4/IVSRealTimeClient.d.ts +24 -0
  32. package/dist-types/ts3.4/commands/DeletePublicKeyCommand.d.ts +39 -0
  33. package/dist-types/ts3.4/commands/GetPublicKeyCommand.d.ts +36 -0
  34. package/dist-types/ts3.4/commands/ImportPublicKeyCommand.d.ts +39 -0
  35. package/dist-types/ts3.4/commands/ListPublicKeysCommand.d.ts +39 -0
  36. package/dist-types/ts3.4/commands/index.d.ts +4 -0
  37. package/dist-types/ts3.4/models/models_0.d.ts +80 -0
  38. package/dist-types/ts3.4/pagination/ListPublicKeysPaginator.d.ts +11 -0
  39. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  40. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +48 -0
  41. package/package.json +1 -1
@@ -0,0 +1,76 @@
1
+ import { Command as $Command } from "@smithy/smithy-client";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import { IVSRealTimeClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../IVSRealTimeClient";
4
+ import { ListPublicKeysRequest, ListPublicKeysResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link ListPublicKeysCommand}.
14
+ */
15
+ export interface ListPublicKeysCommandInput extends ListPublicKeysRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListPublicKeysCommand}.
21
+ */
22
+ export interface ListPublicKeysCommandOutput extends ListPublicKeysResponse, __MetadataBearer {
23
+ }
24
+ declare const ListPublicKeysCommand_base: {
25
+ new (input: ListPublicKeysCommandInput): import("@smithy/smithy-client").CommandImpl<ListPublicKeysCommandInput, ListPublicKeysCommandOutput, IVSRealTimeClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (...[input]: [] | [ListPublicKeysCommandInput]): import("@smithy/smithy-client").CommandImpl<ListPublicKeysCommandInput, ListPublicKeysCommandOutput, IVSRealTimeClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
+ };
29
+ /**
30
+ * <p>Gets summary information about all public keys in your account, in the AWS region where the API request is processed.</p>
31
+ * @example
32
+ * Use a bare-bones client and the command you need to make an API call.
33
+ * ```javascript
34
+ * import { IVSRealTimeClient, ListPublicKeysCommand } from "@aws-sdk/client-ivs-realtime"; // ES Modules import
35
+ * // const { IVSRealTimeClient, ListPublicKeysCommand } = require("@aws-sdk/client-ivs-realtime"); // CommonJS import
36
+ * const client = new IVSRealTimeClient(config);
37
+ * const input = { // ListPublicKeysRequest
38
+ * nextToken: "STRING_VALUE",
39
+ * maxResults: Number("int"),
40
+ * };
41
+ * const command = new ListPublicKeysCommand(input);
42
+ * const response = await client.send(command);
43
+ * // { // ListPublicKeysResponse
44
+ * // publicKeys: [ // PublicKeyList // required
45
+ * // { // PublicKeySummary
46
+ * // arn: "STRING_VALUE",
47
+ * // name: "STRING_VALUE",
48
+ * // tags: { // Tags
49
+ * // "<keys>": "STRING_VALUE",
50
+ * // },
51
+ * // },
52
+ * // ],
53
+ * // nextToken: "STRING_VALUE",
54
+ * // };
55
+ *
56
+ * ```
57
+ *
58
+ * @param ListPublicKeysCommandInput - {@link ListPublicKeysCommandInput}
59
+ * @returns {@link ListPublicKeysCommandOutput}
60
+ * @see {@link ListPublicKeysCommandInput} for command's `input` shape.
61
+ * @see {@link ListPublicKeysCommandOutput} for command's `response` shape.
62
+ * @see {@link IVSRealTimeClientResolvedConfig | config} for IVSRealTimeClient's `config` shape.
63
+ *
64
+ * @throws {@link AccessDeniedException} (client fault)
65
+ * <p/>
66
+ *
67
+ * @throws {@link ValidationException} (client fault)
68
+ * <p/>
69
+ *
70
+ * @throws {@link IVSRealTimeServiceException}
71
+ * <p>Base exception class for all service exceptions from IVSRealTime service.</p>
72
+ *
73
+ * @public
74
+ */
75
+ export declare class ListPublicKeysCommand extends ListPublicKeysCommand_base {
76
+ }
@@ -37,6 +37,12 @@ declare const UpdateStageCommand_base: {
37
37
  * const input = { // UpdateStageRequest
38
38
  * arn: "STRING_VALUE", // required
39
39
  * name: "STRING_VALUE",
40
+ * autoParticipantRecordingConfiguration: { // AutoParticipantRecordingConfiguration
41
+ * storageConfigurationArn: "STRING_VALUE", // required
42
+ * mediaTypes: [ // ParticipantRecordingMediaTypeList
43
+ * "STRING_VALUE",
44
+ * ],
45
+ * },
40
46
  * };
41
47
  * const command = new UpdateStageCommand(input);
42
48
  * const response = await client.send(command);
@@ -48,6 +54,16 @@ declare const UpdateStageCommand_base: {
48
54
  * // tags: { // Tags
49
55
  * // "<keys>": "STRING_VALUE",
50
56
  * // },
57
+ * // autoParticipantRecordingConfiguration: { // AutoParticipantRecordingConfiguration
58
+ * // storageConfigurationArn: "STRING_VALUE", // required
59
+ * // mediaTypes: [ // ParticipantRecordingMediaTypeList
60
+ * // "STRING_VALUE",
61
+ * // ],
62
+ * // },
63
+ * // endpoints: { // StageEndpoints
64
+ * // events: "STRING_VALUE",
65
+ * // whip: "STRING_VALUE",
66
+ * // },
51
67
  * // },
52
68
  * // };
53
69
  *
@@ -3,19 +3,23 @@ export * from "./CreateParticipantTokenCommand";
3
3
  export * from "./CreateStageCommand";
4
4
  export * from "./CreateStorageConfigurationCommand";
5
5
  export * from "./DeleteEncoderConfigurationCommand";
6
+ export * from "./DeletePublicKeyCommand";
6
7
  export * from "./DeleteStageCommand";
7
8
  export * from "./DeleteStorageConfigurationCommand";
8
9
  export * from "./DisconnectParticipantCommand";
9
10
  export * from "./GetCompositionCommand";
10
11
  export * from "./GetEncoderConfigurationCommand";
11
12
  export * from "./GetParticipantCommand";
13
+ export * from "./GetPublicKeyCommand";
12
14
  export * from "./GetStageCommand";
13
15
  export * from "./GetStageSessionCommand";
14
16
  export * from "./GetStorageConfigurationCommand";
17
+ export * from "./ImportPublicKeyCommand";
15
18
  export * from "./ListCompositionsCommand";
16
19
  export * from "./ListEncoderConfigurationsCommand";
17
20
  export * from "./ListParticipantEventsCommand";
18
21
  export * from "./ListParticipantsCommand";
22
+ export * from "./ListPublicKeysCommand";
19
23
  export * from "./ListStageSessionsCommand";
20
24
  export * from "./ListStagesCommand";
21
25
  export * from "./ListStorageConfigurationsCommand";
@@ -1,46 +1,44 @@
1
1
  /**
2
- * <p>
3
- * <b>Introduction</b>
4
- * </p>
5
- * <p>The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP
2
+ * <p>The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP
6
3
  * API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses,
7
4
  * including errors.
8
5
  * </p>
9
- * <p>Terminology:</p>
6
+ * <p>
7
+ * <b>Key Concepts</b>
8
+ * </p>
10
9
  * <ul>
11
10
  * <li>
12
- * <p>A <i>stage</i> is a virtual space where participants can exchange video in real time.</p>
13
- * </li>
14
- * <li>
15
- * <p>A <i>participant token</i> is a token that authenticates a participant when they join a stage.</p>
16
- * </li>
17
- * <li>
18
- * <p>A <i>participant object</i> represents participants (people) in the stage and
19
- * contains information about them. When a token is created, it includes a participant ID;
20
- * when a participant uses that token to join a stage, the participant is associated with
21
- * that participant ID. There is a 1:1 mapping between participant tokens and
22
- * participants.</p>
11
+ * <p>
12
+ * <b>Stage</b> — A virtual space where participants can exchange video in real time.</p>
23
13
  * </li>
24
14
  * <li>
25
- * <p>Server-side composition: The <i>composition</i> process composites participants
26
- * of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels).
27
- * Composition endpoints support this process.</p>
15
+ * <p>
16
+ * <b>Participant token</b> A token that authenticates a participant when they join a stage.</p>
28
17
  * </li>
29
18
  * <li>
30
- * <p>Server-side composition: A <i>composition</i> controls the look of the outputs,
31
- * including how participants are positioned in the video.</p>
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>
32
25
  * </li>
33
26
  * </ul>
34
- * <p>
35
- * <b>Resources</b>
36
- * </p>
37
- * <p>The following resources contain information about your IVS live stream (see <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started.html">Getting Started with Amazon IVS Real-Time Streaming</a>):</p>
27
+ * <p>For server-side composition:</p>
38
28
  * <ul>
39
29
  * <li>
40
30
  * <p>
41
- * <b>Stage</b> — A stage is a virtual space where participants can exchange video in real time.</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 endpoints 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>
42
39
  * </li>
43
40
  * </ul>
41
+ * <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>
44
42
  * <p>
45
43
  * <b>Tagging</b>
46
44
  * </p>
@@ -56,157 +54,6 @@
56
54
  * <p>The Amazon IVS real-time API has these tag-related endpoints: <a>TagResource</a>, <a>UntagResource</a>, and
57
55
  * <a>ListTagsForResource</a>. The following resource supports tagging: Stage.</p>
58
56
  * <p>At most 50 tags can be applied to a resource.</p>
59
- * <p>
60
- * <b>Stages Endpoints</b>
61
- * </p>
62
- * <ul>
63
- * <li>
64
- * <p>
65
- * <a>CreateParticipantToken</a> — Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire.</p>
66
- * </li>
67
- * <li>
68
- * <p>
69
- * <a>CreateStage</a> — Creates a new stage (and optionally participant tokens).</p>
70
- * </li>
71
- * <li>
72
- * <p>
73
- * <a>DeleteStage</a> — Shuts down and deletes the specified stage (disconnecting all participants).</p>
74
- * </li>
75
- * <li>
76
- * <p>
77
- * <a>DisconnectParticipant</a> — Disconnects a specified participant and revokes the participant permanently from a specified stage.</p>
78
- * </li>
79
- * <li>
80
- * <p>
81
- * <a>GetParticipant</a> — Gets information about the specified
82
- * participant token.</p>
83
- * </li>
84
- * <li>
85
- * <p>
86
- * <a>GetStage</a> — Gets information for the specified stage.</p>
87
- * </li>
88
- * <li>
89
- * <p>
90
- * <a>GetStageSession</a> — Gets information for the specified stage
91
- * session.</p>
92
- * </li>
93
- * <li>
94
- * <p>
95
- * <a>ListParticipantEvents</a> — Lists events for a specified
96
- * participant that occurred during a specified stage session.</p>
97
- * </li>
98
- * <li>
99
- * <p>
100
- * <a>ListParticipants</a> — Lists all participants in a specified stage
101
- * session.</p>
102
- * </li>
103
- * <li>
104
- * <p>
105
- * <a>ListStages</a> — Gets summary information about all stages in your account, in the AWS region where the API request is processed.</p>
106
- * </li>
107
- * <li>
108
- * <p>
109
- * <a>ListStageSessions</a> — Gets all sessions for a specified stage.</p>
110
- * </li>
111
- * <li>
112
- * <p>
113
- * <a>UpdateStage</a> — Updates a stage’s configuration.</p>
114
- * </li>
115
- * </ul>
116
- * <p>
117
- * <b>Composition Endpoints</b>
118
- * </p>
119
- * <ul>
120
- * <li>
121
- * <p>
122
- * <a>GetComposition</a> — Gets information about the specified
123
- * Composition resource.</p>
124
- * </li>
125
- * <li>
126
- * <p>
127
- * <a>ListCompositions</a> — Gets summary information about all
128
- * Compositions in your account, in the AWS region where the API request is processed.</p>
129
- * </li>
130
- * <li>
131
- * <p>
132
- * <a>StartComposition</a> — Starts a Composition from a stage based on
133
- * the configuration provided in the request.</p>
134
- * </li>
135
- * <li>
136
- * <p>
137
- * <a>StopComposition</a> — Stops and deletes a Composition resource.
138
- * Any broadcast from the Composition resource is stopped.</p>
139
- * </li>
140
- * </ul>
141
- * <p>
142
- * <b>EncoderConfiguration Endpoints</b>
143
- * </p>
144
- * <ul>
145
- * <li>
146
- * <p>
147
- * <a>CreateEncoderConfiguration</a> — Creates an EncoderConfiguration object.</p>
148
- * </li>
149
- * <li>
150
- * <p>
151
- * <a>DeleteEncoderConfiguration</a> — Deletes an EncoderConfiguration
152
- * resource. Ensures that no Compositions are using this template; otherwise, returns an
153
- * error.</p>
154
- * </li>
155
- * <li>
156
- * <p>
157
- * <a>GetEncoderConfiguration</a> — Gets information about the specified
158
- * EncoderConfiguration resource.</p>
159
- * </li>
160
- * <li>
161
- * <p>
162
- * <a>ListEncoderConfigurations</a> — Gets summary information about all
163
- * EncoderConfigurations in your account, in the AWS region where the API request is
164
- * processed.</p>
165
- * </li>
166
- * </ul>
167
- * <p>
168
- * <b>StorageConfiguration Endpoints</b>
169
- * </p>
170
- * <ul>
171
- * <li>
172
- * <p>
173
- * <a>CreateStorageConfiguration</a> — Creates a new storage configuration, used to enable
174
- * recording to Amazon S3.</p>
175
- * </li>
176
- * <li>
177
- * <p>
178
- * <a>DeleteStorageConfiguration</a> — Deletes the storage configuration for the specified ARN.</p>
179
- * </li>
180
- * <li>
181
- * <p>
182
- * <a>GetStorageConfiguration</a> — Gets the storage configuration for the specified ARN.</p>
183
- * </li>
184
- * <li>
185
- * <p>
186
- * <a>ListStorageConfigurations</a> — Gets summary information about all storage configurations in your
187
- * account, in the AWS region where the API request is processed.</p>
188
- * </li>
189
- * </ul>
190
- * <p>
191
- * <b>Tags Endpoints</b>
192
- * </p>
193
- * <ul>
194
- * <li>
195
- * <p>
196
- * <a>ListTagsForResource</a> — Gets information about AWS tags for the
197
- * specified ARN.</p>
198
- * </li>
199
- * <li>
200
- * <p>
201
- * <a>TagResource</a> — Adds or updates tags for the AWS resource with
202
- * the specified ARN.</p>
203
- * </li>
204
- * <li>
205
- * <p>
206
- * <a>UntagResource</a> — Removes tags from the resource with the
207
- * specified ARN.</p>
208
- * </li>
209
- * </ul>
210
57
  *
211
58
  * @packageDocumentation
212
59
  */