1{
2  "version":"2.0",
3  "metadata":{
4    "apiVersion":"2020-07-14",
5    "endpointPrefix":"ivsrealtime",
6    "jsonVersion":"1.1",
7    "protocol":"rest-json",
8    "serviceAbbreviation":"ivsrealtime",
9    "serviceFullName":"Amazon Interactive Video Service RealTime",
10    "serviceId":"IVS RealTime",
11    "signatureVersion":"v4",
12    "signingName":"ivs",
13    "uid":"ivs-realtime-2020-07-14"
14  },
15  "operations":{
16    "CreateEncoderConfiguration":{
17      "name":"CreateEncoderConfiguration",
18      "http":{
19        "method":"POST",
20        "requestUri":"/CreateEncoderConfiguration",
21        "responseCode":200
22      },
23      "input":{"shape":"CreateEncoderConfigurationRequest"},
24      "output":{"shape":"CreateEncoderConfigurationResponse"},
25      "errors":[
26        {"shape":"ResourceNotFoundException"},
27        {"shape":"ValidationException"},
28        {"shape":"AccessDeniedException"},
29        {"shape":"InternalServerException"},
30        {"shape":"ServiceQuotaExceededException"},
31        {"shape":"ConflictException"},
32        {"shape":"PendingVerification"}
33      ],
34      "documentation":"<p>Creates an EncoderConfiguration object.</p>"
35    },
36    "CreateParticipantToken":{
37      "name":"CreateParticipantToken",
38      "http":{
39        "method":"POST",
40        "requestUri":"/CreateParticipantToken",
41        "responseCode":200
42      },
43      "input":{"shape":"CreateParticipantTokenRequest"},
44      "output":{"shape":"CreateParticipantTokenResponse"},
45      "errors":[
46        {"shape":"ResourceNotFoundException"},
47        {"shape":"ValidationException"},
48        {"shape":"AccessDeniedException"},
49        {"shape":"ServiceQuotaExceededException"},
50        {"shape":"PendingVerification"}
51      ],
52      "documentation":"<p>Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire. Tokens always are scoped to the stage for which they are created.</p> <p>Encryption keys are owned by Amazon IVS and never used directly by your application.</p>"
53    },
54    "CreateStage":{
55      "name":"CreateStage",
56      "http":{
57        "method":"POST",
58        "requestUri":"/CreateStage",
59        "responseCode":200
60      },
61      "input":{"shape":"CreateStageRequest"},
62      "output":{"shape":"CreateStageResponse"},
63      "errors":[
64        {"shape":"ValidationException"},
65        {"shape":"AccessDeniedException"},
66        {"shape":"ServiceQuotaExceededException"},
67        {"shape":"PendingVerification"}
68      ],
69      "documentation":"<p>Creates a new stage (and optionally participant tokens).</p>"
70    },
71    "CreateStorageConfiguration":{
72      "name":"CreateStorageConfiguration",
73      "http":{
74        "method":"POST",
75        "requestUri":"/CreateStorageConfiguration",
76        "responseCode":200
77      },
78      "input":{"shape":"CreateStorageConfigurationRequest"},
79      "output":{"shape":"CreateStorageConfigurationResponse"},
80      "errors":[
81        {"shape":"ResourceNotFoundException"},
82        {"shape":"ValidationException"},
83        {"shape":"AccessDeniedException"},
84        {"shape":"InternalServerException"},
85        {"shape":"ServiceQuotaExceededException"},
86        {"shape":"ConflictException"},
87        {"shape":"PendingVerification"}
88      ],
89      "documentation":"<p>Creates a new storage configuration, used to enable recording to Amazon S3. When a StorageConfiguration is created, IVS will modify the S3 bucketPolicy of the provided bucket. This will ensure that IVS has sufficient permissions to write content to the provided bucket.</p>"
90    },
91    "DeleteEncoderConfiguration":{
92      "name":"DeleteEncoderConfiguration",
93      "http":{
94        "method":"POST",
95        "requestUri":"/DeleteEncoderConfiguration",
96        "responseCode":200
97      },
98      "input":{"shape":"DeleteEncoderConfigurationRequest"},
99      "output":{"shape":"DeleteEncoderConfigurationResponse"},
100      "errors":[
101        {"shape":"ResourceNotFoundException"},
102        {"shape":"ValidationException"},
103        {"shape":"AccessDeniedException"},
104        {"shape":"InternalServerException"},
105        {"shape":"ServiceQuotaExceededException"},
106        {"shape":"ConflictException"}
107      ],
108      "documentation":"<p>Deletes an EncoderConfiguration resource. Ensures that no Compositions are using this template; otherwise, returns an error.</p>"
109    },
110    "DeleteStage":{
111      "name":"DeleteStage",
112      "http":{
113        "method":"POST",
114        "requestUri":"/DeleteStage",
115        "responseCode":200
116      },
117      "input":{"shape":"DeleteStageRequest"},
118      "output":{"shape":"DeleteStageResponse"},
119      "errors":[
120        {"shape":"ResourceNotFoundException"},
121        {"shape":"ValidationException"},
122        {"shape":"AccessDeniedException"},
123        {"shape":"ConflictException"},
124        {"shape":"PendingVerification"}
125      ],
126      "documentation":"<p>Shuts down and deletes the specified stage (disconnecting all participants).</p>"
127    },
128    "DeleteStorageConfiguration":{
129      "name":"DeleteStorageConfiguration",
130      "http":{
131        "method":"POST",
132        "requestUri":"/DeleteStorageConfiguration",
133        "responseCode":200
134      },
135      "input":{"shape":"DeleteStorageConfigurationRequest"},
136      "output":{"shape":"DeleteStorageConfigurationResponse"},
137      "errors":[
138        {"shape":"ResourceNotFoundException"},
139        {"shape":"ValidationException"},
140        {"shape":"AccessDeniedException"},
141        {"shape":"InternalServerException"},
142        {"shape":"ServiceQuotaExceededException"},
143        {"shape":"ConflictException"}
144      ],
145      "documentation":"<p>Deletes the storage configuration for the specified ARN.</p> <p>If you try to delete a storage configuration that is used by a Composition, you will get an error (409 ConflictException). To avoid this, for all Compositions that reference the storage configuration, first use <a>StopComposition</a> and wait for it to complete, then use DeleteStorageConfiguration.</p>"
146    },
147    "DisconnectParticipant":{
148      "name":"DisconnectParticipant",
149      "http":{
150        "method":"POST",
151        "requestUri":"/DisconnectParticipant",
152        "responseCode":200
153      },
154      "input":{"shape":"DisconnectParticipantRequest"},
155      "output":{"shape":"DisconnectParticipantResponse"},
156      "errors":[
157        {"shape":"ResourceNotFoundException"},
158        {"shape":"ValidationException"},
159        {"shape":"AccessDeniedException"},
160        {"shape":"PendingVerification"}
161      ],
162      "documentation":"<p>Disconnects a specified participant and revokes the participant permanently from a specified stage.</p>"
163    },
164    "GetComposition":{
165      "name":"GetComposition",
166      "http":{
167        "method":"POST",
168        "requestUri":"/GetComposition",
169        "responseCode":200
170      },
171      "input":{"shape":"GetCompositionRequest"},
172      "output":{"shape":"GetCompositionResponse"},
173      "errors":[
174        {"shape":"ResourceNotFoundException"},
175        {"shape":"ValidationException"},
176        {"shape":"AccessDeniedException"},
177        {"shape":"InternalServerException"},
178        {"shape":"ServiceQuotaExceededException"},
179        {"shape":"ConflictException"}
180      ],
181      "documentation":"<p>Get information about the specified Composition resource.</p>"
182    },
183    "GetEncoderConfiguration":{
184      "name":"GetEncoderConfiguration",
185      "http":{
186        "method":"POST",
187        "requestUri":"/GetEncoderConfiguration",
188        "responseCode":200
189      },
190      "input":{"shape":"GetEncoderConfigurationRequest"},
191      "output":{"shape":"GetEncoderConfigurationResponse"},
192      "errors":[
193        {"shape":"ResourceNotFoundException"},
194        {"shape":"ValidationException"},
195        {"shape":"AccessDeniedException"},
196        {"shape":"InternalServerException"},
197        {"shape":"ServiceQuotaExceededException"},
198        {"shape":"ConflictException"}
199      ],
200      "documentation":"<p>Gets information about the specified EncoderConfiguration resource. </p>"
201    },
202    "GetParticipant":{
203      "name":"GetParticipant",
204      "http":{
205        "method":"POST",
206        "requestUri":"/GetParticipant",
207        "responseCode":200
208      },
209      "input":{"shape":"GetParticipantRequest"},
210      "output":{"shape":"GetParticipantResponse"},
211      "errors":[
212        {"shape":"ResourceNotFoundException"},
213        {"shape":"ValidationException"},
214        {"shape":"AccessDeniedException"}
215      ],
216      "documentation":"<p>Gets information about the specified participant token.</p>"
217    },
218    "GetStage":{
219      "name":"GetStage",
220      "http":{
221        "method":"POST",
222        "requestUri":"/GetStage",
223        "responseCode":200
224      },
225      "input":{"shape":"GetStageRequest"},
226      "output":{"shape":"GetStageResponse"},
227      "errors":[
228        {"shape":"ResourceNotFoundException"},
229        {"shape":"ValidationException"},
230        {"shape":"AccessDeniedException"}
231      ],
232      "documentation":"<p>Gets information for the specified stage.</p>"
233    },
234    "GetStageSession":{
235      "name":"GetStageSession",
236      "http":{
237        "method":"POST",
238        "requestUri":"/GetStageSession",
239        "responseCode":200
240      },
241      "input":{"shape":"GetStageSessionRequest"},
242      "output":{"shape":"GetStageSessionResponse"},
243      "errors":[
244        {"shape":"ResourceNotFoundException"},
245        {"shape":"ValidationException"},
246        {"shape":"AccessDeniedException"}
247      ],
248      "documentation":"<p>Gets information for the specified stage session.</p>"
249    },
250    "GetStorageConfiguration":{
251      "name":"GetStorageConfiguration",
252      "http":{
253        "method":"POST",
254        "requestUri":"/GetStorageConfiguration",
255        "responseCode":200
256      },
257      "input":{"shape":"GetStorageConfigurationRequest"},
258      "output":{"shape":"GetStorageConfigurationResponse"},
259      "errors":[
260        {"shape":"ResourceNotFoundException"},
261        {"shape":"ValidationException"},
262        {"shape":"AccessDeniedException"},
263        {"shape":"InternalServerException"},
264        {"shape":"ServiceQuotaExceededException"},
265        {"shape":"ConflictException"}
266      ],
267      "documentation":"<p>Gets the storage configuration for the specified ARN.</p>"
268    },
269    "ListCompositions":{
270      "name":"ListCompositions",
271      "http":{
272        "method":"POST",
273        "requestUri":"/ListCompositions",
274        "responseCode":200
275      },
276      "input":{"shape":"ListCompositionsRequest"},
277      "output":{"shape":"ListCompositionsResponse"},
278      "errors":[
279        {"shape":"ValidationException"},
280        {"shape":"AccessDeniedException"},
281        {"shape":"InternalServerException"},
282        {"shape":"ServiceQuotaExceededException"},
283        {"shape":"ConflictException"}
284      ],
285      "documentation":"<p>Gets summary information about all Compositions in your account, in the AWS region where the API request is processed. </p>"
286    },
287    "ListEncoderConfigurations":{
288      "name":"ListEncoderConfigurations",
289      "http":{
290        "method":"POST",
291        "requestUri":"/ListEncoderConfigurations",
292        "responseCode":200
293      },
294      "input":{"shape":"ListEncoderConfigurationsRequest"},
295      "output":{"shape":"ListEncoderConfigurationsResponse"},
296      "errors":[
297        {"shape":"ValidationException"},
298        {"shape":"AccessDeniedException"},
299        {"shape":"InternalServerException"},
300        {"shape":"ServiceQuotaExceededException"},
301        {"shape":"ConflictException"}
302      ],
303      "documentation":"<p>Gets summary information about all EncoderConfigurations in your account, in the AWS region where the API request is processed.</p>"
304    },
305    "ListParticipantEvents":{
306      "name":"ListParticipantEvents",
307      "http":{
308        "method":"POST",
309        "requestUri":"/ListParticipantEvents",
310        "responseCode":200
311      },
312      "input":{"shape":"ListParticipantEventsRequest"},
313      "output":{"shape":"ListParticipantEventsResponse"},
314      "errors":[
315        {"shape":"ValidationException"},
316        {"shape":"AccessDeniedException"}
317      ],
318      "documentation":"<p>Lists events for a specified participant that occurred during a specified stage session.</p>"
319    },
320    "ListParticipants":{
321      "name":"ListParticipants",
322      "http":{
323        "method":"POST",
324        "requestUri":"/ListParticipants",
325        "responseCode":200
326      },
327      "input":{"shape":"ListParticipantsRequest"},
328      "output":{"shape":"ListParticipantsResponse"},
329      "errors":[
330        {"shape":"ValidationException"},
331        {"shape":"AccessDeniedException"}
332      ],
333      "documentation":"<p>Lists all participants in a specified stage session.</p>"
334    },
335    "ListStageSessions":{
336      "name":"ListStageSessions",
337      "http":{
338        "method":"POST",
339        "requestUri":"/ListStageSessions",
340        "responseCode":200
341      },
342      "input":{"shape":"ListStageSessionsRequest"},
343      "output":{"shape":"ListStageSessionsResponse"},
344      "errors":[
345        {"shape":"ValidationException"},
346        {"shape":"AccessDeniedException"}
347      ],
348      "documentation":"<p>Gets all sessions for a specified stage.</p>"
349    },
350    "ListStages":{
351      "name":"ListStages",
352      "http":{
353        "method":"POST",
354        "requestUri":"/ListStages",
355        "responseCode":200
356      },
357      "input":{"shape":"ListStagesRequest"},
358      "output":{"shape":"ListStagesResponse"},
359      "errors":[
360        {"shape":"ValidationException"},
361        {"shape":"AccessDeniedException"},
362        {"shape":"ConflictException"}
363      ],
364      "documentation":"<p>Gets summary information about all stages in your account, in the AWS region where the API request is processed.</p>"
365    },
366    "ListStorageConfigurations":{
367      "name":"ListStorageConfigurations",
368      "http":{
369        "method":"POST",
370        "requestUri":"/ListStorageConfigurations",
371        "responseCode":200
372      },
373      "input":{"shape":"ListStorageConfigurationsRequest"},
374      "output":{"shape":"ListStorageConfigurationsResponse"},
375      "errors":[
376        {"shape":"ValidationException"},
377        {"shape":"AccessDeniedException"},
378        {"shape":"InternalServerException"},
379        {"shape":"ServiceQuotaExceededException"},
380        {"shape":"ConflictException"}
381      ],
382      "documentation":"<p>Gets summary information about all storage configurations in your account, in the AWS region where the API request is processed.</p>"
383    },
384    "ListTagsForResource":{
385      "name":"ListTagsForResource",
386      "http":{
387        "method":"GET",
388        "requestUri":"/tags/{resourceArn}",
389        "responseCode":200
390      },
391      "input":{"shape":"ListTagsForResourceRequest"},
392      "output":{"shape":"ListTagsForResourceResponse"},
393      "errors":[
394        {"shape":"ResourceNotFoundException"},
395        {"shape":"ValidationException"},
396        {"shape":"InternalServerException"}
397      ],
398      "documentation":"<p>Gets information about AWS tags for the specified ARN.</p>"
399    },
400    "StartComposition":{
401      "name":"StartComposition",
402      "http":{
403        "method":"POST",
404        "requestUri":"/StartComposition",
405        "responseCode":200
406      },
407      "input":{"shape":"StartCompositionRequest"},
408      "output":{"shape":"StartCompositionResponse"},
409      "errors":[
410        {"shape":"ResourceNotFoundException"},
411        {"shape":"ValidationException"},
412        {"shape":"AccessDeniedException"},
413        {"shape":"InternalServerException"},
414        {"shape":"ServiceQuotaExceededException"},
415        {"shape":"ConflictException"},
416        {"shape":"PendingVerification"}
417      ],
418      "documentation":"<p>Starts a Composition from a stage based on the configuration provided in the request.</p> <p>A Composition is an ephemeral resource that exists after this endpoint returns successfully. Composition stops and the resource is deleted:</p> <ul> <li> <p>When <a>StopComposition</a> is called.</p> </li> <li> <p>After a 1-minute timeout, when all participants are disconnected from the stage.</p> </li> <li> <p>After a 1-minute timeout, if there are no participants in the stage when StartComposition is called.</p> </li> <li> <p>When broadcasting to the IVS channel fails and all retries are exhausted.</p> </li> <li> <p>When broadcasting is disconnected and all attempts to reconnect are exhausted.</p> </li> </ul>"
419    },
420    "StopComposition":{
421      "name":"StopComposition",
422      "http":{
423        "method":"POST",
424        "requestUri":"/StopComposition",
425        "responseCode":200
426      },
427      "input":{"shape":"StopCompositionRequest"},
428      "output":{"shape":"StopCompositionResponse"},
429      "errors":[
430        {"shape":"ResourceNotFoundException"},
431        {"shape":"ValidationException"},
432        {"shape":"AccessDeniedException"},
433        {"shape":"InternalServerException"},
434        {"shape":"ServiceQuotaExceededException"},
435        {"shape":"ConflictException"}
436      ],
437      "documentation":"<p>Stops and deletes a Composition resource. Any broadcast from the Composition resource is stopped.</p>"
438    },
439    "TagResource":{
440      "name":"TagResource",
441      "http":{
442        "method":"POST",
443        "requestUri":"/tags/{resourceArn}",
444        "responseCode":200
445      },
446      "input":{"shape":"TagResourceRequest"},
447      "output":{"shape":"TagResourceResponse"},
448      "errors":[
449        {"shape":"ResourceNotFoundException"},
450        {"shape":"ValidationException"},
451        {"shape":"InternalServerException"}
452      ],
453      "documentation":"<p>Adds or updates tags for the AWS resource with the specified ARN.</p>"
454    },
455    "UntagResource":{
456      "name":"UntagResource",
457      "http":{
458        "method":"DELETE",
459        "requestUri":"/tags/{resourceArn}",
460        "responseCode":200
461      },
462      "input":{"shape":"UntagResourceRequest"},
463      "output":{"shape":"UntagResourceResponse"},
464      "errors":[
465        {"shape":"ResourceNotFoundException"},
466        {"shape":"ValidationException"},
467        {"shape":"InternalServerException"}
468      ],
469      "documentation":"<p>Removes tags from the resource with the specified ARN.</p>",
470      "idempotent":true
471    },
472    "UpdateStage":{
473      "name":"UpdateStage",
474      "http":{
475        "method":"POST",
476        "requestUri":"/UpdateStage",
477        "responseCode":200
478      },
479      "input":{"shape":"UpdateStageRequest"},
480      "output":{"shape":"UpdateStageResponse"},
481      "errors":[
482        {"shape":"ResourceNotFoundException"},
483        {"shape":"ValidationException"},
484        {"shape":"AccessDeniedException"},
485        {"shape":"ServiceQuotaExceededException"},
486        {"shape":"PendingVerification"}
487      ],
488      "documentation":"<p>Updates a stage’s configuration.</p>"
489    }
490  },
491  "shapes":{
492    "AccessDeniedException":{
493      "type":"structure",
494      "members":{
495        "exceptionMessage":{
496          "shape":"errorMessage",
497          "documentation":"<p>User does not have sufficient access to perform this action.</p>"
498        }
499      },
500      "documentation":"<p/>",
501      "error":{
502        "httpStatusCode":403,
503        "senderFault":true
504      },
505      "exception":true
506    },
507    "AttributeKey":{
508      "type":"string",
509      "max":128,
510      "min":0,
511      "pattern":"^[a-zA-Z0-9-_]*$"
512    },
513    "Bitrate":{
514      "type":"integer",
515      "box":true,
516      "max":8500000,
517      "min":1
518    },
519    "ChannelArn":{
520      "type":"string",
521      "max":128,
522      "min":1,
523      "pattern":"^arn:aws:[is]vs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+$"
524    },
525    "ChannelDestinationConfiguration":{
526      "type":"structure",
527      "required":["channelArn"],
528      "members":{
529        "channelArn":{
530          "shape":"ChannelArn",
531          "documentation":"<p>ARN of the channel to use for broadcasting. The channel and stage resources must be in the same AWS account and region. The channel must be offline (not broadcasting).</p>"
532        },
533        "encoderConfigurationArn":{
534          "shape":"EncoderConfigurationArn",
535          "documentation":"<p>ARN of the <a>EncoderConfiguration</a> resource. The encoder configuration and stage resources must be in the same AWS account and region.</p>"
536        }
537      },
538      "documentation":"<p>Object specifying a channel as a destination.</p>"
539    },
540    "Composition":{
541      "type":"structure",
542      "required":[
543        "arn",
544        "destinations",
545        "layout",
546        "stageArn",
547        "state"
548      ],
549      "members":{
550        "arn":{
551          "shape":"CompositionArn",
552          "documentation":"<p>ARN of the Composition resource.</p>"
553        },
554        "destinations":{
555          "shape":"DestinationList",
556          "documentation":"<p>Array of Destination objects. A Composition can contain either one destination (<code>channel</code> or <code>s3</code>) or two (one <code>channel</code> and one <code>s3</code>).</p>"
557        },
558        "endTime":{
559          "shape":"Time",
560          "documentation":"<p>UTC time of the Composition end. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
561        },
562        "layout":{
563          "shape":"LayoutConfiguration",
564          "documentation":"<p>Layout object to configure composition parameters.</p>"
565        },
566        "stageArn":{
567          "shape":"StageArn",
568          "documentation":"<p>ARN of the stage used as input</p>"
569        },
570        "startTime":{
571          "shape":"Time",
572          "documentation":"<p>UTC time of the Composition start. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
573        },
574        "state":{
575          "shape":"CompositionState",
576          "documentation":"<p>State of the Composition.</p>"
577        },
578        "tags":{
579          "shape":"Tags",
580          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
581        }
582      },
583      "documentation":"<p>Object specifying a Composition resource.</p>"
584    },
585    "CompositionArn":{
586      "type":"string",
587      "max":128,
588      "min":1,
589      "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:composition/[a-zA-Z0-9-]+$"
590    },
591    "CompositionClientToken":{
592      "type":"string",
593      "max":64,
594      "min":1,
595      "pattern":"^[a-zA-Z0-9-_]*$"
596    },
597    "CompositionState":{
598      "type":"string",
599      "enum":[
600        "STARTING",
601        "ACTIVE",
602        "STOPPING",
603        "FAILED",
604        "STOPPED"
605      ]
606    },
607    "CompositionSummary":{
608      "type":"structure",
609      "required":[
610        "arn",
611        "destinations",
612        "stageArn",
613        "state"
614      ],
615      "members":{
616        "arn":{
617          "shape":"CompositionArn",
618          "documentation":"<p>ARN of the Composition resource.</p>"
619        },
620        "destinations":{
621          "shape":"DestinationSummaryList",
622          "documentation":"<p>Array of Destination objects.</p>"
623        },
624        "endTime":{
625          "shape":"Time",
626          "documentation":"<p>UTC time of the Composition end. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
627        },
628        "stageArn":{
629          "shape":"StageArn",
630          "documentation":"<p>ARN of the attached stage.</p>"
631        },
632        "startTime":{
633          "shape":"Time",
634          "documentation":"<p>UTC time of the Composition start. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
635        },
636        "state":{
637          "shape":"CompositionState",
638          "documentation":"<p>State of the Composition resource.</p>"
639        },
640        "tags":{
641          "shape":"Tags",
642          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
643        }
644      },
645      "documentation":"<p>Summary information about a Composition.</p>"
646    },
647    "CompositionSummaryList":{
648      "type":"list",
649      "member":{"shape":"CompositionSummary"}
650    },
651    "ConflictException":{
652      "type":"structure",
653      "members":{
654        "exceptionMessage":{
655          "shape":"errorMessage",
656          "documentation":"<p>Updating or deleting a resource can cause an inconsistent state.</p>"
657        }
658      },
659      "documentation":"<p/>",
660      "error":{
661        "httpStatusCode":409,
662        "senderFault":true
663      },
664      "exception":true
665    },
666    "CreateEncoderConfigurationRequest":{
667      "type":"structure",
668      "members":{
669        "name":{
670          "shape":"EncoderConfigurationName",
671          "documentation":"<p>Optional name to identify the resource.</p>"
672        },
673        "tags":{
674          "shape":"Tags",
675          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
676        },
677        "video":{
678          "shape":"Video",
679          "documentation":"<p>Video configuration. Default: video resolution 1280x720, bitrate 2500 kbps, 30 fps.</p>"
680        }
681      }
682    },
683    "CreateEncoderConfigurationResponse":{
684      "type":"structure",
685      "members":{
686        "encoderConfiguration":{
687          "shape":"EncoderConfiguration",
688          "documentation":"<p>The EncoderConfiguration that was created.</p>"
689        }
690      }
691    },
692    "CreateParticipantTokenRequest":{
693      "type":"structure",
694      "required":["stageArn"],
695      "members":{
696        "attributes":{
697          "shape":"ParticipantTokenAttributes",
698          "documentation":"<p>Application-provided attributes to encode into the token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p>"
699        },
700        "capabilities":{
701          "shape":"ParticipantTokenCapabilities",
702          "documentation":"<p>Set of capabilities that the user is allowed to perform in the stage. Default: <code>PUBLISH, SUBSCRIBE</code>.</p>"
703        },
704        "duration":{
705          "shape":"ParticipantTokenDurationMinutes",
706          "documentation":"<p>Duration (in minutes), after which the token expires. Default: 720 (12 hours).</p>"
707        },
708        "stageArn":{
709          "shape":"StageArn",
710          "documentation":"<p>ARN of the stage to which this token is scoped.</p>"
711        },
712        "userId":{
713          "shape":"ParticipantTokenUserId",
714          "documentation":"<p>Name that can be specified to help identify the token. This can be any UTF-8 encoded text. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p>"
715        }
716      }
717    },
718    "CreateParticipantTokenResponse":{
719      "type":"structure",
720      "members":{
721        "participantToken":{
722          "shape":"ParticipantToken",
723          "documentation":"<p>The participant token that was created.</p>"
724        }
725      }
726    },
727    "CreateStageRequest":{
728      "type":"structure",
729      "members":{
730        "name":{
731          "shape":"StageName",
732          "documentation":"<p>Optional name that can be specified for the stage being created.</p>"
733        },
734        "participantTokenConfigurations":{
735          "shape":"ParticipantTokenConfigurations",
736          "documentation":"<p>Array of participant token configuration objects to attach to the new stage.</p>"
737        },
738        "tags":{
739          "shape":"Tags",
740          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there. </p>"
741        }
742      }
743    },
744    "CreateStageResponse":{
745      "type":"structure",
746      "members":{
747        "participantTokens":{
748          "shape":"ParticipantTokenList",
749          "documentation":"<p>Participant tokens attached to the stage. These correspond to the <code>participants</code> in the request.</p>"
750        },
751        "stage":{
752          "shape":"Stage",
753          "documentation":"<p>The stage that was created.</p>"
754        }
755      }
756    },
757    "CreateStorageConfigurationRequest":{
758      "type":"structure",
759      "required":["s3"],
760      "members":{
761        "name":{
762          "shape":"StorageConfigurationName",
763          "documentation":"<p>Storage configuration name. The value does not need to be unique.</p>"
764        },
765        "s3":{
766          "shape":"S3StorageConfiguration",
767          "documentation":"<p>A complex type that contains a storage configuration for where recorded video will be stored.</p>"
768        },
769        "tags":{
770          "shape":"Tags",
771          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
772        }
773      }
774    },
775    "CreateStorageConfigurationResponse":{
776      "type":"structure",
777      "members":{
778        "storageConfiguration":{
779          "shape":"StorageConfiguration",
780          "documentation":"<p>The StorageConfiguration that was created.</p>"
781        }
782      }
783    },
784    "DeleteEncoderConfigurationRequest":{
785      "type":"structure",
786      "required":["arn"],
787      "members":{
788        "arn":{
789          "shape":"EncoderConfigurationArn",
790          "documentation":"<p>ARN of the EncoderConfiguration.</p>"
791        }
792      }
793    },
794    "DeleteEncoderConfigurationResponse":{
795      "type":"structure",
796      "members":{
797      }
798    },
799    "DeleteStageRequest":{
800      "type":"structure",
801      "required":["arn"],
802      "members":{
803        "arn":{
804          "shape":"StageArn",
805          "documentation":"<p>ARN of the stage to be deleted.</p>"
806        }
807      }
808    },
809    "DeleteStageResponse":{
810      "type":"structure",
811      "members":{
812      }
813    },
814    "DeleteStorageConfigurationRequest":{
815      "type":"structure",
816      "required":["arn"],
817      "members":{
818        "arn":{
819          "shape":"StorageConfigurationArn",
820          "documentation":"<p>ARN of the storage configuration to be deleted.</p>"
821        }
822      }
823    },
824    "DeleteStorageConfigurationResponse":{
825      "type":"structure",
826      "members":{
827      }
828    },
829    "Destination":{
830      "type":"structure",
831      "required":[
832        "configuration",
833        "id",
834        "state"
835      ],
836      "members":{
837        "configuration":{
838          "shape":"DestinationConfiguration",
839          "documentation":"<p>Configuration used to create this destination.</p>"
840        },
841        "detail":{
842          "shape":"DestinationDetail",
843          "documentation":"<p>Optional details regarding the status of the destination.</p>"
844        },
845        "endTime":{
846          "shape":"Time",
847          "documentation":"<p>UTC time of the destination end. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
848        },
849        "id":{
850          "shape":"String",
851          "documentation":"<p>Unique identifier for this destination, assigned by IVS.</p>"
852        },
853        "startTime":{
854          "shape":"Time",
855          "documentation":"<p>UTC time of the destination start. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
856        },
857        "state":{
858          "shape":"DestinationState",
859          "documentation":"<p>State of the Composition Destination.</p>"
860        }
861      },
862      "documentation":"<p>Object specifying the status of a Destination.</p>"
863    },
864    "DestinationConfiguration":{
865      "type":"structure",
866      "members":{
867        "channel":{
868          "shape":"ChannelDestinationConfiguration",
869          "documentation":"<p>An IVS channel to be used for broadcasting, for server-side composition. Either a <code>channel</code> or an <code>s3</code> must be specified. </p>"
870        },
871        "name":{
872          "shape":"DestinationConfigurationName",
873          "documentation":"<p>Name that can be specified to help identify the destination.</p>"
874        },
875        "s3":{
876          "shape":"S3DestinationConfiguration",
877          "documentation":"<p>An S3 storage configuration to be used for recording video data. Either a <code>channel</code> or an <code>s3</code> must be specified.</p>"
878        }
879      },
880      "documentation":"<p>Complex data type that defines destination-configuration objects.</p>"
881    },
882    "DestinationConfigurationList":{
883      "type":"list",
884      "member":{"shape":"DestinationConfiguration"},
885      "max":2,
886      "min":1
887    },
888    "DestinationConfigurationName":{
889      "type":"string",
890      "max":128,
891      "min":0,
892      "pattern":"^[a-zA-Z0-9-_]*$"
893    },
894    "DestinationDetail":{
895      "type":"structure",
896      "members":{
897        "s3":{
898          "shape":"S3Detail",
899          "documentation":"<p>An S3 detail object to return information about the S3 destination.</p>"
900        }
901      },
902      "documentation":"<p>Complex data type that defines destination-detail objects.</p>"
903    },
904    "DestinationList":{
905      "type":"list",
906      "member":{"shape":"Destination"},
907      "max":2,
908      "min":1
909    },
910    "DestinationState":{
911      "type":"string",
912      "enum":[
913        "STARTING",
914        "ACTIVE",
915        "STOPPING",
916        "RECONNECTING",
917        "FAILED",
918        "STOPPED"
919      ]
920    },
921    "DestinationSummary":{
922      "type":"structure",
923      "required":[
924        "id",
925        "state"
926      ],
927      "members":{
928        "endTime":{
929          "shape":"Time",
930          "documentation":"<p>UTC time of the destination end. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
931        },
932        "id":{
933          "shape":"String",
934          "documentation":"<p>Unique identifier for this destination, assigned by IVS.</p>"
935        },
936        "startTime":{
937          "shape":"Time",
938          "documentation":"<p>UTC time of the destination start. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.</p>"
939        },
940        "state":{
941          "shape":"DestinationState",
942          "documentation":"<p>State of the Composition Destination.</p>"
943        }
944      },
945      "documentation":"<p>Summary information about a Destination.</p>"
946    },
947    "DestinationSummaryList":{
948      "type":"list",
949      "member":{"shape":"DestinationSummary"},
950      "max":2,
951      "min":1
952    },
953    "DisconnectParticipantReason":{
954      "type":"string",
955      "max":128,
956      "min":0
957    },
958    "DisconnectParticipantRequest":{
959      "type":"structure",
960      "required":[
961        "participantId",
962        "stageArn"
963      ],
964      "members":{
965        "participantId":{
966          "shape":"ParticipantTokenId",
967          "documentation":"<p>Identifier of the participant to be disconnected. This is assigned by IVS and returned by <a>CreateParticipantToken</a>.</p>"
968        },
969        "reason":{
970          "shape":"DisconnectParticipantReason",
971          "documentation":"<p>Description of why this participant is being disconnected.</p>"
972        },
973        "stageArn":{
974          "shape":"StageArn",
975          "documentation":"<p>ARN of the stage to which the participant is attached.</p>"
976        }
977      }
978    },
979    "DisconnectParticipantResponse":{
980      "type":"structure",
981      "members":{
982      }
983    },
984    "EncoderConfiguration":{
985      "type":"structure",
986      "required":["arn"],
987      "members":{
988        "arn":{
989          "shape":"EncoderConfigurationArn",
990          "documentation":"<p>ARN of the EncoderConfiguration resource.</p>"
991        },
992        "name":{
993          "shape":"EncoderConfigurationName",
994          "documentation":"<p>Optional name to identify the resource.</p>"
995        },
996        "tags":{
997          "shape":"Tags",
998          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
999        },
1000        "video":{
1001          "shape":"Video",
1002          "documentation":"<p>Video configuration. Default: video resolution 1280x720, bitrate 2500 kbps, 30 fps</p>"
1003        }
1004      },
1005      "documentation":"<p>Settings for transcoding.</p>"
1006    },
1007    "EncoderConfigurationArn":{
1008      "type":"string",
1009      "max":128,
1010      "min":1,
1011      "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:encoder-configuration/[a-zA-Z0-9-]+$"
1012    },
1013    "EncoderConfigurationArnList":{
1014      "type":"list",
1015      "member":{"shape":"EncoderConfigurationArn"},
1016      "max":1,
1017      "min":1
1018    },
1019    "EncoderConfigurationName":{
1020      "type":"string",
1021      "max":128,
1022      "min":0,
1023      "pattern":"^[a-zA-Z0-9-_]*$"
1024    },
1025    "EncoderConfigurationSummary":{
1026      "type":"structure",
1027      "required":["arn"],
1028      "members":{
1029        "arn":{
1030          "shape":"EncoderConfigurationArn",
1031          "documentation":"<p>ARN of the EncoderConfiguration resource.</p>"
1032        },
1033        "name":{
1034          "shape":"EncoderConfigurationName",
1035          "documentation":"<p>Optional name to identify the resource.</p>"
1036        },
1037        "tags":{
1038          "shape":"Tags",
1039          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
1040        }
1041      },
1042      "documentation":"<p>Summary information about an EncoderConfiguration.</p>"
1043    },
1044    "EncoderConfigurationSummaryList":{
1045      "type":"list",
1046      "member":{"shape":"EncoderConfigurationSummary"}
1047    },
1048    "Event":{
1049      "type":"structure",
1050      "members":{
1051        "errorCode":{
1052          "shape":"EventErrorCode",
1053          "documentation":"<p>If the event is an error event, the error code is provided to give insight into the specific error that occurred. If the event is not an error event, this field is null. <code>INSUFFICIENT_CAPABILITIES</code> indicates that the participant tried to take an action that the participant’s token is not allowed to do. For more information about participant capabilities, see the <code>capabilities</code> field in <a>CreateParticipantToken</a>. <code>QUOTA_EXCEEDED</code> indicates that the number of participants who want to publish/subscribe to a stage exceeds the quota; for more information, see <a href=\"https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/service-quotas.html\">Service Quotas</a>. <code>PUBLISHER_NOT_FOUND</code> indicates that the participant tried to subscribe to a publisher that doesn’t exist. </p>"
1054        },
1055        "eventTime":{
1056          "shape":"Time",
1057          "documentation":"<p>ISO 8601 timestamp (returned as a string) for when the event occurred.</p>"
1058        },
1059        "name":{
1060          "shape":"EventName",
1061          "documentation":"<p>The name of the event.</p>"
1062        },
1063        "participantId":{
1064          "shape":"ParticipantId",
1065          "documentation":"<p>Unique identifier for the participant who triggered the event. This is assigned by IVS.</p>"
1066        },
1067        "remoteParticipantId":{
1068          "shape":"ParticipantId",
1069          "documentation":"<p>Unique identifier for the remote participant. For a subscribe event, this is the publisher. For a publish or join event, this is null. This is assigned by IVS.</p>"
1070        }
1071      },
1072      "documentation":"<p>An occurrence during a stage session.</p>"
1073    },
1074    "EventErrorCode":{
1075      "type":"string",
1076      "enum":[
1077        "INSUFFICIENT_CAPABILITIES",
1078        "QUOTA_EXCEEDED",
1079        "PUBLISHER_NOT_FOUND"
1080      ]
1081    },
1082    "EventList":{
1083      "type":"list",
1084      "member":{"shape":"Event"}
1085    },
1086    "EventName":{
1087      "type":"string",
1088      "enum":[
1089        "JOINED",
1090        "LEFT",
1091        "PUBLISH_STARTED",
1092        "PUBLISH_STOPPED",
1093        "SUBSCRIBE_STARTED",
1094        "SUBSCRIBE_STOPPED",
1095        "PUBLISH_ERROR",
1096        "SUBSCRIBE_ERROR",
1097        "JOIN_ERROR"
1098      ]
1099    },
1100    "Framerate":{
1101      "type":"float",
1102      "box":true,
1103      "max":60,
1104      "min":1
1105    },
1106    "GetCompositionRequest":{
1107      "type":"structure",
1108      "required":["arn"],
1109      "members":{
1110        "arn":{
1111          "shape":"CompositionArn",
1112          "documentation":"<p>ARN of the Composition resource.</p>"
1113        }
1114      }
1115    },
1116    "GetCompositionResponse":{
1117      "type":"structure",
1118      "members":{
1119        "composition":{
1120          "shape":"Composition",
1121          "documentation":"<p>The Composition that was returned.</p>"
1122        }
1123      }
1124    },
1125    "GetEncoderConfigurationRequest":{
1126      "type":"structure",
1127      "required":["arn"],
1128      "members":{
1129        "arn":{
1130          "shape":"EncoderConfigurationArn",
1131          "documentation":"<p>ARN of the EncoderConfiguration resource.</p>"
1132        }
1133      }
1134    },
1135    "GetEncoderConfigurationResponse":{
1136      "type":"structure",
1137      "members":{
1138        "encoderConfiguration":{
1139          "shape":"EncoderConfiguration",
1140          "documentation":"<p>The EncoderConfiguration that was returned.</p>"
1141        }
1142      }
1143    },
1144    "GetParticipantRequest":{
1145      "type":"structure",
1146      "required":[
1147        "participantId",
1148        "sessionId",
1149        "stageArn"
1150      ],
1151      "members":{
1152        "participantId":{
1153          "shape":"ParticipantId",
1154          "documentation":"<p>Unique identifier for the participant. This is assigned by IVS and returned by <a>CreateParticipantToken</a>.</p>"
1155        },
1156        "sessionId":{
1157          "shape":"StageSessionId",
1158          "documentation":"<p>ID of a session within the stage.</p>"
1159        },
1160        "stageArn":{
1161          "shape":"StageArn",
1162          "documentation":"<p>Stage ARN.</p>"
1163        }
1164      }
1165    },
1166    "GetParticipantResponse":{
1167      "type":"structure",
1168      "members":{
1169        "participant":{
1170          "shape":"Participant",
1171          "documentation":"<p>The participant that is returned.</p>"
1172        }
1173      }
1174    },
1175    "GetStageRequest":{
1176      "type":"structure",
1177      "required":["arn"],
1178      "members":{
1179        "arn":{
1180          "shape":"StageArn",
1181          "documentation":"<p>ARN of the stage for which the information is to be retrieved.</p>"
1182        }
1183      }
1184    },
1185    "GetStageResponse":{
1186      "type":"structure",
1187      "members":{
1188        "stage":{
1189          "shape":"Stage",
1190          "documentation":"<p>The stage that is returned.</p>"
1191        }
1192      }
1193    },
1194    "GetStageSessionRequest":{
1195      "type":"structure",
1196      "required":[
1197        "sessionId",
1198        "stageArn"
1199      ],
1200      "members":{
1201        "sessionId":{
1202          "shape":"StageSessionId",
1203          "documentation":"<p>ID of a session within the stage.</p>"
1204        },
1205        "stageArn":{
1206          "shape":"StageArn",
1207          "documentation":"<p>ARN of the stage for which the information is to be retrieved.</p>"
1208        }
1209      }
1210    },
1211    "GetStageSessionResponse":{
1212      "type":"structure",
1213      "members":{
1214        "stageSession":{
1215          "shape":"StageSession",
1216          "documentation":"<p>The stage session that is returned.</p>"
1217        }
1218      }
1219    },
1220    "GetStorageConfigurationRequest":{
1221      "type":"structure",
1222      "required":["arn"],
1223      "members":{
1224        "arn":{
1225          "shape":"StorageConfigurationArn",
1226          "documentation":"<p>ARN of the storage configuration to be retrieved.</p>"
1227        }
1228      }
1229    },
1230    "GetStorageConfigurationResponse":{
1231      "type":"structure",
1232      "members":{
1233        "storageConfiguration":{
1234          "shape":"StorageConfiguration",
1235          "documentation":"<p>The StorageConfiguration that was returned.</p>"
1236        }
1237      }
1238    },
1239    "GridConfiguration":{
1240      "type":"structure",
1241      "members":{
1242        "featuredParticipantAttribute":{
1243          "shape":"AttributeKey",
1244          "documentation":"<p>This attribute name identifies the featured slot. A participant with this attribute set to <code>\"true\"</code> (as a string value) in <a>ParticipantTokenConfiguration</a> is placed in the featured slot.</p>"
1245        }
1246      },
1247      "documentation":"<p>Configuration information specific to Grid layout, for server-side composition. See \"Layouts\" in <a href=\"https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/server-side-composition.html\">Server-Side Composition</a>.</p>"
1248    },
1249    "Height":{
1250      "type":"integer",
1251      "box":true,
1252      "max":1920,
1253      "min":1
1254    },
1255    "InternalServerException":{
1256      "type":"structure",
1257      "members":{
1258        "exceptionMessage":{
1259          "shape":"errorMessage",
1260          "documentation":"<p>Unexpected error during processing of request.</p>"
1261        }
1262      },
1263      "documentation":"<p/>",
1264      "error":{"httpStatusCode":500},
1265      "exception":true,
1266      "fault":true
1267    },
1268    "LayoutConfiguration":{
1269      "type":"structure",
1270      "members":{
1271        "grid":{
1272          "shape":"GridConfiguration",
1273          "documentation":"<p>Configuration related to grid layout. Default: Grid layout.</p>"
1274        }
1275      },
1276      "documentation":"<p>Configuration information of supported layouts for server-side composition.</p>"
1277    },
1278    "ListCompositionsRequest":{
1279      "type":"structure",
1280      "members":{
1281        "filterByEncoderConfigurationArn":{
1282          "shape":"EncoderConfigurationArn",
1283          "documentation":"<p>Filters the Composition list to match the specified EncoderConfiguration attached to at least one of its output.</p>"
1284        },
1285        "filterByStageArn":{
1286          "shape":"StageArn",
1287          "documentation":"<p>Filters the Composition list to match the specified Stage ARN.</p>"
1288        },
1289        "maxResults":{
1290          "shape":"MaxCompositionResults",
1291          "documentation":"<p>Maximum number of results to return. Default: 100.</p>"
1292        },
1293        "nextToken":{
1294          "shape":"PaginationToken",
1295          "documentation":"<p>The first Composition to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1296        }
1297      }
1298    },
1299    "ListCompositionsResponse":{
1300      "type":"structure",
1301      "required":["compositions"],
1302      "members":{
1303        "compositions":{
1304          "shape":"CompositionSummaryList",
1305          "documentation":"<p>List of the matching Compositions (summary information only).</p>"
1306        },
1307        "nextToken":{
1308          "shape":"PaginationToken",
1309          "documentation":"<p>If there are more compositions than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.</p>"
1310        }
1311      }
1312    },
1313    "ListEncoderConfigurationsRequest":{
1314      "type":"structure",
1315      "members":{
1316        "maxResults":{
1317          "shape":"MaxEncoderConfigurationResults",
1318          "documentation":"<p>Maximum number of results to return. Default: 100.</p>"
1319        },
1320        "nextToken":{
1321          "shape":"PaginationToken",
1322          "documentation":"<p>The first encoder configuration to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1323        }
1324      }
1325    },
1326    "ListEncoderConfigurationsResponse":{
1327      "type":"structure",
1328      "required":["encoderConfigurations"],
1329      "members":{
1330        "encoderConfigurations":{
1331          "shape":"EncoderConfigurationSummaryList",
1332          "documentation":"<p>List of the matching EncoderConfigurations (summary information only).</p>"
1333        },
1334        "nextToken":{
1335          "shape":"PaginationToken",
1336          "documentation":"<p>If there are more encoder configurations than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.</p>"
1337        }
1338      }
1339    },
1340    "ListParticipantEventsRequest":{
1341      "type":"structure",
1342      "required":[
1343        "participantId",
1344        "sessionId",
1345        "stageArn"
1346      ],
1347      "members":{
1348        "maxResults":{
1349          "shape":"MaxParticipantEventResults",
1350          "documentation":"<p>Maximum number of results to return. Default: 50.</p>"
1351        },
1352        "nextToken":{
1353          "shape":"PaginationToken",
1354          "documentation":"<p>The first participant event to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1355        },
1356        "participantId":{
1357          "shape":"ParticipantId",
1358          "documentation":"<p>Unique identifier for this participant. This is assigned by IVS and returned by <a>CreateParticipantToken</a>.</p>"
1359        },
1360        "sessionId":{
1361          "shape":"StageSessionId",
1362          "documentation":"<p>ID of a session within the stage.</p>"
1363        },
1364        "stageArn":{
1365          "shape":"StageArn",
1366          "documentation":"<p>Stage ARN.</p>"
1367        }
1368      }
1369    },
1370    "ListParticipantEventsResponse":{
1371      "type":"structure",
1372      "required":["events"],
1373      "members":{
1374        "events":{
1375          "shape":"EventList",
1376          "documentation":"<p>List of the matching events.</p>"
1377        },
1378        "nextToken":{
1379          "shape":"PaginationToken",
1380          "documentation":"<p>If there are more events than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set. </p>"
1381        }
1382      }
1383    },
1384    "ListParticipantsRequest":{
1385      "type":"structure",
1386      "required":[
1387        "sessionId",
1388        "stageArn"
1389      ],
1390      "members":{
1391        "filterByPublished":{
1392          "shape":"Published",
1393          "documentation":"<p>Filters the response list to only show participants who published during the stage session. Only one of <code>filterByUserId</code>, <code>filterByPublished</code>, or <code>filterByState</code> can be provided per request.</p>"
1394        },
1395        "filterByState":{
1396          "shape":"ParticipantState",
1397          "documentation":"<p>Filters the response list to only show participants in the specified state. Only one of <code>filterByUserId</code>, <code>filterByPublished</code>, or <code>filterByState</code> can be provided per request.</p>"
1398        },
1399        "filterByUserId":{
1400          "shape":"UserId",
1401          "documentation":"<p>Filters the response list to match the specified user ID. Only one of <code>filterByUserId</code>, <code>filterByPublished</code>, or <code>filterByState</code> can be provided per request. A <code>userId</code> is a customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems.</p>"
1402        },
1403        "maxResults":{
1404          "shape":"MaxParticipantResults",
1405          "documentation":"<p>Maximum number of results to return. Default: 50.</p>"
1406        },
1407        "nextToken":{
1408          "shape":"PaginationToken",
1409          "documentation":"<p>The first participant to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1410        },
1411        "sessionId":{
1412          "shape":"StageSessionId",
1413          "documentation":"<p>ID of the session within the stage.</p>"
1414        },
1415        "stageArn":{
1416          "shape":"StageArn",
1417          "documentation":"<p>Stage ARN.</p>"
1418        }
1419      }
1420    },
1421    "ListParticipantsResponse":{
1422      "type":"structure",
1423      "required":["participants"],
1424      "members":{
1425        "nextToken":{
1426          "shape":"PaginationToken",
1427          "documentation":"<p>If there are more participants than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.</p>"
1428        },
1429        "participants":{
1430          "shape":"ParticipantList",
1431          "documentation":"<p>List of the matching participants (summary information only).</p>"
1432        }
1433      }
1434    },
1435    "ListStageSessionsRequest":{
1436      "type":"structure",
1437      "required":["stageArn"],
1438      "members":{
1439        "maxResults":{
1440          "shape":"MaxStageSessionResults",
1441          "documentation":"<p>Maximum number of results to return. Default: 50.</p>"
1442        },
1443        "nextToken":{
1444          "shape":"PaginationToken",
1445          "documentation":"<p>The first stage session to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1446        },
1447        "stageArn":{
1448          "shape":"StageArn",
1449          "documentation":"<p>Stage ARN.</p>"
1450        }
1451      }
1452    },
1453    "ListStageSessionsResponse":{
1454      "type":"structure",
1455      "required":["stageSessions"],
1456      "members":{
1457        "nextToken":{
1458          "shape":"PaginationToken",
1459          "documentation":"<p>If there are more stage sessions than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.</p>"
1460        },
1461        "stageSessions":{
1462          "shape":"StageSessionList",
1463          "documentation":"<p>List of matching stage sessions.</p>"
1464        }
1465      }
1466    },
1467    "ListStagesRequest":{
1468      "type":"structure",
1469      "members":{
1470        "maxResults":{
1471          "shape":"MaxStageResults",
1472          "documentation":"<p>Maximum number of results to return. Default: 50.</p>"
1473        },
1474        "nextToken":{
1475          "shape":"PaginationToken",
1476          "documentation":"<p>The first stage to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1477        }
1478      }
1479    },
1480    "ListStagesResponse":{
1481      "type":"structure",
1482      "required":["stages"],
1483      "members":{
1484        "nextToken":{
1485          "shape":"PaginationToken",
1486          "documentation":"<p>If there are more stages than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.</p>"
1487        },
1488        "stages":{
1489          "shape":"StageSummaryList",
1490          "documentation":"<p>List of the matching stages (summary information only).</p>"
1491        }
1492      }
1493    },
1494    "ListStorageConfigurationsRequest":{
1495      "type":"structure",
1496      "members":{
1497        "maxResults":{
1498          "shape":"MaxStorageConfigurationResults",
1499          "documentation":"<p>Maximum number of storage configurations to return. Default: your service quota or 100, whichever is smaller.</p>"
1500        },
1501        "nextToken":{
1502          "shape":"PaginationToken",
1503          "documentation":"<p>The first storage configuration to retrieve. This is used for pagination; see the <code>nextToken</code> response field.</p>"
1504        }
1505      }
1506    },
1507    "ListStorageConfigurationsResponse":{
1508      "type":"structure",
1509      "required":["storageConfigurations"],
1510      "members":{
1511        "nextToken":{
1512          "shape":"PaginationToken",
1513          "documentation":"<p>If there are more storage configurations than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.</p>"
1514        },
1515        "storageConfigurations":{
1516          "shape":"StorageConfigurationSummaryList",
1517          "documentation":"<p>List of the matching storage configurations.</p>"
1518        }
1519      }
1520    },
1521    "ListTagsForResourceRequest":{
1522      "type":"structure",
1523      "required":["resourceArn"],
1524      "members":{
1525        "resourceArn":{
1526          "shape":"ResourceArn",
1527          "documentation":"<p>The ARN of the resource to be retrieved. The ARN must be URL-encoded.</p>",
1528          "location":"uri",
1529          "locationName":"resourceArn"
1530        }
1531      }
1532    },
1533    "ListTagsForResourceResponse":{
1534      "type":"structure",
1535      "required":["tags"],
1536      "members":{
1537        "tags":{
1538          "shape":"Tags",
1539          "documentation":"<p>Tags attached to the resource. Array of maps, each of the form <code>string:string (key:value)</code>.</p>"
1540        }
1541      }
1542    },
1543    "MaxCompositionResults":{
1544      "type":"integer",
1545      "box":true,
1546      "max":100,
1547      "min":1
1548    },
1549    "MaxEncoderConfigurationResults":{
1550      "type":"integer",
1551      "box":true,
1552      "max":100,
1553      "min":1
1554    },
1555    "MaxParticipantEventResults":{
1556      "type":"integer",
1557      "box":true,
1558      "max":100,
1559      "min":1
1560    },
1561    "MaxParticipantResults":{
1562      "type":"integer",
1563      "box":true,
1564      "max":100,
1565      "min":1
1566    },
1567    "MaxStageResults":{
1568      "type":"integer",
1569      "box":true,
1570      "max":100,
1571      "min":1
1572    },
1573    "MaxStageSessionResults":{
1574      "type":"integer",
1575      "box":true,
1576      "max":100,
1577      "min":1
1578    },
1579    "MaxStorageConfigurationResults":{
1580      "type":"integer",
1581      "box":true,
1582      "max":100,
1583      "min":1
1584    },
1585    "PaginationToken":{
1586      "type":"string",
1587      "max":1024,
1588      "min":0,
1589      "pattern":"^[a-zA-Z0-9+/=_-]*$"
1590    },
1591    "Participant":{
1592      "type":"structure",
1593      "members":{
1594        "attributes":{
1595          "shape":"ParticipantAttributes",
1596          "documentation":"<p>Application-provided attributes to encode into the token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information</i>.</p>"
1597        },
1598        "browserName":{
1599          "shape":"ParticipantClientAttribute",
1600          "documentation":"<p>The participant’s browser.</p>"
1601        },
1602        "browserVersion":{
1603          "shape":"ParticipantClientAttribute",
1604          "documentation":"<p>The participant’s browser version.</p>"
1605        },
1606        "firstJoinTime":{
1607          "shape":"Time",
1608          "documentation":"<p>ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.</p>"
1609        },
1610        "ispName":{
1611          "shape":"ParticipantClientAttribute",
1612          "documentation":"<p>The participant’s Internet Service Provider.</p>"
1613        },
1614        "osName":{
1615          "shape":"ParticipantClientAttribute",
1616          "documentation":"<p>The participant’s operating system.</p>"
1617        },
1618        "osVersion":{
1619          "shape":"ParticipantClientAttribute",
1620          "documentation":"<p>The participant’s operating system version.</p>"
1621        },
1622        "participantId":{
1623          "shape":"ParticipantId",
1624          "documentation":"<p>Unique identifier for this participant, assigned by IVS.</p>"
1625        },
1626        "published":{
1627          "shape":"Published",
1628          "documentation":"<p>Whether the participant ever published to the stage session.</p>"
1629        },
1630        "sdkVersion":{
1631          "shape":"ParticipantClientAttribute",
1632          "documentation":"<p>The participant’s SDK version.</p>"
1633        },
1634        "state":{
1635          "shape":"ParticipantState",
1636          "documentation":"<p>Whether the participant is connected to or disconnected from the stage.</p>"
1637        },
1638        "userId":{
1639          "shape":"UserId",
1640          "documentation":"<p>Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information</i>.</p>"
1641        }
1642      },
1643      "documentation":"<p>Object describing a participant that has joined a stage.</p>"
1644    },
1645    "ParticipantAttributes":{
1646      "type":"map",
1647      "key":{"shape":"String"},
1648      "value":{"shape":"String"}
1649    },
1650    "ParticipantClientAttribute":{
1651      "type":"string",
1652      "max":128,
1653      "min":0,
1654      "pattern":"^[a-zA-Z0-9-_.,:;\\s]*$"
1655    },
1656    "ParticipantId":{
1657      "type":"string",
1658      "max":64,
1659      "min":0,
1660      "pattern":"^[a-zA-Z0-9-]*$"
1661    },
1662    "ParticipantList":{
1663      "type":"list",
1664      "member":{"shape":"ParticipantSummary"}
1665    },
1666    "ParticipantState":{
1667      "type":"string",
1668      "enum":[
1669        "CONNECTED",
1670        "DISCONNECTED"
1671      ]
1672    },
1673    "ParticipantSummary":{
1674      "type":"structure",
1675      "members":{
1676        "firstJoinTime":{
1677          "shape":"Time",
1678          "documentation":"<p>ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.</p>"
1679        },
1680        "participantId":{
1681          "shape":"ParticipantId",
1682          "documentation":"<p>Unique identifier for this participant, assigned by IVS.</p>"
1683        },
1684        "published":{
1685          "shape":"Published",
1686          "documentation":"<p>Whether the participant ever published to the stage session.</p>"
1687        },
1688        "state":{
1689          "shape":"ParticipantState",
1690          "documentation":"<p>Whether the participant is connected to or disconnected from the stage.</p>"
1691        },
1692        "userId":{
1693          "shape":"UserId",
1694          "documentation":"<p>Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information</i>.</p>"
1695        }
1696      },
1697      "documentation":"<p>Summary object describing a participant that has joined a stage.</p>"
1698    },
1699    "ParticipantToken":{
1700      "type":"structure",
1701      "members":{
1702        "attributes":{
1703          "shape":"ParticipantTokenAttributes",
1704          "documentation":"<p>Application-provided attributes to encode into the token and attach to a stage. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p>"
1705        },
1706        "capabilities":{
1707          "shape":"ParticipantTokenCapabilities",
1708          "documentation":"<p>Set of capabilities that the user is allowed to perform in the stage.</p>"
1709        },
1710        "duration":{
1711          "shape":"ParticipantTokenDurationMinutes",
1712          "documentation":"<p>Duration (in minutes), after which the participant token expires. Default: 720 (12 hours).</p>"
1713        },
1714        "expirationTime":{
1715          "shape":"ParticipantTokenExpirationTime",
1716          "documentation":"<p>ISO 8601 timestamp (returned as a string) for when this token expires.</p>"
1717        },
1718        "participantId":{
1719          "shape":"ParticipantTokenId",
1720          "documentation":"<p>Unique identifier for this participant token, assigned by IVS.</p>"
1721        },
1722        "token":{
1723          "shape":"ParticipantTokenString",
1724          "documentation":"<p>The issued client token, encrypted.</p>"
1725        },
1726        "userId":{
1727          "shape":"ParticipantTokenUserId",
1728          "documentation":"<p>Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p>"
1729        }
1730      },
1731      "documentation":"<p>Object specifying a participant token in a stage.</p> <p> <b>Important</b>: Treat tokens as opaque; i.e., do not build functionality based on token contents. The format of tokens could change in the future.</p>"
1732    },
1733    "ParticipantTokenAttributes":{
1734      "type":"map",
1735      "key":{"shape":"String"},
1736      "value":{"shape":"String"}
1737    },
1738    "ParticipantTokenCapabilities":{
1739      "type":"list",
1740      "member":{"shape":"ParticipantTokenCapability"},
1741      "max":2,
1742      "min":0
1743    },
1744    "ParticipantTokenCapability":{
1745      "type":"string",
1746      "enum":[
1747        "PUBLISH",
1748        "SUBSCRIBE"
1749      ]
1750    },
1751    "ParticipantTokenConfiguration":{
1752      "type":"structure",
1753      "members":{
1754        "attributes":{
1755          "shape":"ParticipantTokenAttributes",
1756          "documentation":"<p>Application-provided attributes to encode into the corresponding participant token and attach to a stage. Map keys and values can contain UTF-8 encoded text. The maximum length of this field is 1 KB total. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p>"
1757        },
1758        "capabilities":{
1759          "shape":"ParticipantTokenCapabilities",
1760          "documentation":"<p>Set of capabilities that the user is allowed to perform in the stage.</p>"
1761        },
1762        "duration":{
1763          "shape":"ParticipantTokenDurationMinutes",
1764          "documentation":"<p>Duration (in minutes), after which the corresponding participant token expires. Default: 720 (12 hours).</p>"
1765        },
1766        "userId":{
1767          "shape":"ParticipantTokenUserId",
1768          "documentation":"<p>Customer-assigned name to help identify the token; this can be used to link a participant to a user in the customer’s own systems. This can be any UTF-8 encoded text. <i>This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.</i> </p>"
1769        }
1770      },
1771      "documentation":"<p>Object specifying a participant token configuration in a stage.</p>"
1772    },
1773    "ParticipantTokenConfigurations":{
1774      "type":"list",
1775      "member":{"shape":"ParticipantTokenConfiguration"},
1776      "max":12,
1777      "min":0
1778    },
1779    "ParticipantTokenDurationMinutes":{
1780      "type":"integer",
1781      "box":true,
1782      "max":20160,
1783      "min":1
1784    },
1785    "ParticipantTokenExpirationTime":{
1786      "type":"timestamp",
1787      "timestampFormat":"iso8601"
1788    },
1789    "ParticipantTokenId":{"type":"string"},
1790    "ParticipantTokenList":{
1791      "type":"list",
1792      "member":{"shape":"ParticipantToken"}
1793    },
1794    "ParticipantTokenString":{
1795      "type":"string",
1796      "sensitive":true
1797    },
1798    "ParticipantTokenUserId":{
1799      "type":"string",
1800      "max":128,
1801      "min":0
1802    },
1803    "PendingVerification":{
1804      "type":"structure",
1805      "members":{
1806        "exceptionMessage":{
1807          "shape":"errorMessage",
1808          "documentation":"<p> Your account is pending verification. </p>"
1809        }
1810      },
1811      "documentation":"<p/>",
1812      "error":{
1813        "httpStatusCode":403,
1814        "senderFault":true
1815      },
1816      "exception":true
1817    },
1818    "Published":{"type":"boolean"},
1819    "RecordingConfiguration":{
1820      "type":"structure",
1821      "members":{
1822        "format":{
1823          "shape":"RecordingConfigurationFormat",
1824          "documentation":"<p>The recording format for storing a recording in Amazon S3.</p>"
1825        }
1826      },
1827      "documentation":"<p>An object representing a configuration to record a stage stream.</p>"
1828    },
1829    "RecordingConfigurationFormat":{
1830      "type":"string",
1831      "enum":["HLS"]
1832    },
1833    "ResourceArn":{
1834      "type":"string",
1835      "max":128,
1836      "min":1,
1837      "pattern":"^arn:aws:[is]vs:[a-z0-9-]+:[0-9]+:[a-z-]/[a-zA-Z0-9-]+$"
1838    },
1839    "ResourceNotFoundException":{
1840      "type":"structure",
1841      "members":{
1842        "exceptionMessage":{
1843          "shape":"errorMessage",
1844          "documentation":"<p>Request references a resource which does not exist.</p>"
1845        }
1846      },
1847      "documentation":"<p/>",
1848      "error":{
1849        "httpStatusCode":404,
1850        "senderFault":true
1851      },
1852      "exception":true
1853    },
1854    "S3BucketName":{
1855      "type":"string",
1856      "max":63,
1857      "min":3,
1858      "pattern":"^[a-z0-9-.]+$"
1859    },
1860    "S3DestinationConfiguration":{
1861      "type":"structure",
1862      "required":[
1863        "encoderConfigurationArns",
1864        "storageConfigurationArn"
1865      ],
1866      "members":{
1867        "encoderConfigurationArns":{
1868          "shape":"EncoderConfigurationArnList",
1869          "documentation":"<p>ARNs of the <a>EncoderConfiguration</a> resource. The encoder configuration and stage resources must be in the same AWS account and region. </p>"
1870        },
1871        "recordingConfiguration":{
1872          "shape":"RecordingConfiguration",
1873          "documentation":"<p>Array of maps, each of the form <code>string:string (key:value)</code>. This is an optional customer specification, currently used only to specify the recording format for storing a recording in Amazon S3.</p>"
1874        },
1875        "storageConfigurationArn":{
1876          "shape":"StorageConfigurationArn",
1877          "documentation":"<p>ARN of the <a>StorageConfiguration</a> where recorded videos will be stored.</p>"
1878        }
1879      },
1880      "documentation":"<p>A complex type that describes an S3 location where recorded videos will be stored.</p>"
1881    },
1882    "S3Detail":{
1883      "type":"structure",
1884      "required":["recordingPrefix"],
1885      "members":{
1886        "recordingPrefix":{
1887          "shape":"String",
1888          "documentation":"<p>The S3 bucket prefix under which the recording is stored.</p>"
1889        }
1890      },
1891      "documentation":"<p>Complex data type that defines S3Detail objects.</p>"
1892    },
1893    "S3StorageConfiguration":{
1894      "type":"structure",
1895      "required":["bucketName"],
1896      "members":{
1897        "bucketName":{
1898          "shape":"S3BucketName",
1899          "documentation":"<p>Location (S3 bucket name) where recorded videos will be stored. Note that the StorageConfiguration and S3 bucket must be in the same region as the Composition.</p>"
1900        }
1901      },
1902      "documentation":"<p>A complex type that describes an S3 location where recorded videos will be stored.</p>"
1903    },
1904    "ServiceQuotaExceededException":{
1905      "type":"structure",
1906      "members":{
1907        "exceptionMessage":{
1908          "shape":"errorMessage",
1909          "documentation":"<p>Request would cause a service quota to be exceeded.</p>"
1910        }
1911      },
1912      "documentation":"<p/>",
1913      "error":{
1914        "httpStatusCode":402,
1915        "senderFault":true
1916      },
1917      "exception":true
1918    },
1919    "Stage":{
1920      "type":"structure",
1921      "required":["arn"],
1922      "members":{
1923        "activeSessionId":{
1924          "shape":"StageSessionId",
1925          "documentation":"<p>ID of the active session within the stage.</p>"
1926        },
1927        "arn":{
1928          "shape":"StageArn",
1929          "documentation":"<p>Stage ARN.</p>"
1930        },
1931        "name":{
1932          "shape":"StageName",
1933          "documentation":"<p>Stage name.</p>"
1934        },
1935        "tags":{
1936          "shape":"Tags",
1937          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
1938        }
1939      },
1940      "documentation":"<p>Object specifying a stage.</p>"
1941    },
1942    "StageArn":{
1943      "type":"string",
1944      "max":128,
1945      "min":1,
1946      "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:stage/[a-zA-Z0-9-]+$"
1947    },
1948    "StageName":{
1949      "type":"string",
1950      "max":128,
1951      "min":0,
1952      "pattern":"^[a-zA-Z0-9-_]*$"
1953    },
1954    "StageSession":{
1955      "type":"structure",
1956      "members":{
1957        "endTime":{
1958          "shape":"Time",
1959          "documentation":"<p>ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.</p>"
1960        },
1961        "sessionId":{
1962          "shape":"StageSessionId",
1963          "documentation":"<p>ID of the session within the stage.</p>"
1964        },
1965        "startTime":{
1966          "shape":"Time",
1967          "documentation":"<p> ISO 8601 timestamp (returned as a string) when this stage session began.</p>"
1968        }
1969      },
1970      "documentation":"<p>A stage session begins when the first participant joins a stage and ends after the last participant leaves the stage. A stage session helps with debugging stages by grouping events and participants into shorter periods of time (i.e., a session), which is helpful when stages are used over long periods of time.</p>"
1971    },
1972    "StageSessionId":{
1973      "type":"string",
1974      "max":16,
1975      "min":16,
1976      "pattern":"^st-[a-zA-Z0-9]+$"
1977    },
1978    "StageSessionList":{
1979      "type":"list",
1980      "member":{"shape":"StageSessionSummary"}
1981    },
1982    "StageSessionSummary":{
1983      "type":"structure",
1984      "members":{
1985        "endTime":{
1986          "shape":"Time",
1987          "documentation":"<p>ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.</p>"
1988        },
1989        "sessionId":{
1990          "shape":"StageSessionId",
1991          "documentation":"<p>ID of the session within the stage.</p>"
1992        },
1993        "startTime":{
1994          "shape":"Time",
1995          "documentation":"<p> ISO 8601 timestamp (returned as a string) when this stage session began.</p>"
1996        }
1997      },
1998      "documentation":"<p>Summary information about a stage session.</p>"
1999    },
2000    "StageSummary":{
2001      "type":"structure",
2002      "required":["arn"],
2003      "members":{
2004        "activeSessionId":{
2005          "shape":"StageSessionId",
2006          "documentation":"<p>ID of the active session within the stage.</p>"
2007        },
2008        "arn":{
2009          "shape":"StageArn",
2010          "documentation":"<p>Stage ARN.</p>"
2011        },
2012        "name":{
2013          "shape":"StageName",
2014          "documentation":"<p>Stage name.</p>"
2015        },
2016        "tags":{
2017          "shape":"Tags",
2018          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
2019        }
2020      },
2021      "documentation":"<p>Summary information about a stage.</p>"
2022    },
2023    "StageSummaryList":{
2024      "type":"list",
2025      "member":{"shape":"StageSummary"}
2026    },
2027    "StartCompositionRequest":{
2028      "type":"structure",
2029      "required":[
2030        "destinations",
2031        "stageArn"
2032      ],
2033      "members":{
2034        "destinations":{
2035          "shape":"DestinationConfigurationList",
2036          "documentation":"<p>Array of destination configuration.</p>"
2037        },
2038        "idempotencyToken":{
2039          "shape":"CompositionClientToken",
2040          "documentation":"<p>Idempotency token.</p>",
2041          "idempotencyToken":true
2042        },
2043        "layout":{
2044          "shape":"LayoutConfiguration",
2045          "documentation":"<p>Layout object to configure composition parameters.</p>"
2046        },
2047        "stageArn":{
2048          "shape":"StageArn",
2049          "documentation":"<p>ARN of the stage to be used for compositing.</p>"
2050        },
2051        "tags":{
2052          "shape":"Tags",
2053          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
2054        }
2055      }
2056    },
2057    "StartCompositionResponse":{
2058      "type":"structure",
2059      "members":{
2060        "composition":{
2061          "shape":"Composition",
2062          "documentation":"<p>The Composition that was created.</p>"
2063        }
2064      }
2065    },
2066    "StopCompositionRequest":{
2067      "type":"structure",
2068      "required":["arn"],
2069      "members":{
2070        "arn":{
2071          "shape":"CompositionArn",
2072          "documentation":"<p>ARN of the Composition.</p>"
2073        }
2074      }
2075    },
2076    "StopCompositionResponse":{
2077      "type":"structure",
2078      "members":{
2079      }
2080    },
2081    "StorageConfiguration":{
2082      "type":"structure",
2083      "required":["arn"],
2084      "members":{
2085        "arn":{
2086          "shape":"StorageConfigurationArn",
2087          "documentation":"<p>ARN of the storage configuration.</p>"
2088        },
2089        "name":{
2090          "shape":"StorageConfigurationName",
2091          "documentation":"<p>Name of the storage configuration.</p>"
2092        },
2093        "s3":{
2094          "shape":"S3StorageConfiguration",
2095          "documentation":"<p>An S3 destination configuration where recorded videos will be stored.</p>"
2096        },
2097        "tags":{
2098          "shape":"Tags",
2099          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
2100        }
2101      },
2102      "documentation":"<p>A complex type that describes a location where recorded videos will be stored.</p>"
2103    },
2104    "StorageConfigurationArn":{
2105      "type":"string",
2106      "max":128,
2107      "min":1,
2108      "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:storage-configuration/[a-zA-Z0-9-]+$"
2109    },
2110    "StorageConfigurationName":{
2111      "type":"string",
2112      "max":128,
2113      "min":0,
2114      "pattern":"^[a-zA-Z0-9-_]*$"
2115    },
2116    "StorageConfigurationSummary":{
2117      "type":"structure",
2118      "required":["arn"],
2119      "members":{
2120        "arn":{
2121          "shape":"StorageConfigurationArn",
2122          "documentation":"<p>ARN of the storage configuration.</p>"
2123        },
2124        "name":{
2125          "shape":"StorageConfigurationName",
2126          "documentation":"<p>Name of the storage configuration.</p>"
2127        },
2128        "s3":{
2129          "shape":"S3StorageConfiguration",
2130          "documentation":"<p>An S3 destination configuration where recorded videos will be stored.</p>"
2131        },
2132        "tags":{
2133          "shape":"Tags",
2134          "documentation":"<p>Tags attached to the resource. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.</p>"
2135        }
2136      },
2137      "documentation":"<p>Summary information about a storage configuration.</p>"
2138    },
2139    "StorageConfigurationSummaryList":{
2140      "type":"list",
2141      "member":{"shape":"StorageConfigurationSummary"}
2142    },
2143    "String":{"type":"string"},
2144    "TagKey":{
2145      "type":"string",
2146      "max":128,
2147      "min":1
2148    },
2149    "TagKeyList":{
2150      "type":"list",
2151      "member":{"shape":"TagKey"},
2152      "max":50,
2153      "min":0
2154    },
2155    "TagResourceRequest":{
2156      "type":"structure",
2157      "required":[
2158        "resourceArn",
2159        "tags"
2160      ],
2161      "members":{
2162        "resourceArn":{
2163          "shape":"ResourceArn",
2164          "documentation":"<p>The ARN of the resource to be tagged. The ARN must be URL-encoded.</p>",
2165          "location":"uri",
2166          "locationName":"resourceArn"
2167        },
2168        "tags":{
2169          "shape":"Tags",
2170          "documentation":"<p>Array of tags to be added or updated. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints beyond what is documented there.</p>"
2171        }
2172      }
2173    },
2174    "TagResourceResponse":{
2175      "type":"structure",
2176      "members":{
2177      }
2178    },
2179    "TagValue":{
2180      "type":"string",
2181      "max":256,
2182      "min":0
2183    },
2184    "Tags":{
2185      "type":"map",
2186      "key":{"shape":"TagKey"},
2187      "value":{"shape":"TagValue"},
2188      "max":50,
2189      "min":0
2190    },
2191    "Time":{
2192      "type":"timestamp",
2193      "timestampFormat":"iso8601"
2194    },
2195    "UntagResourceRequest":{
2196      "type":"structure",
2197      "required":[
2198        "resourceArn",
2199        "tagKeys"
2200      ],
2201      "members":{
2202        "resourceArn":{
2203          "shape":"ResourceArn",
2204          "documentation":"<p>The ARN of the resource to be untagged. The ARN must be URL-encoded.</p>",
2205          "location":"uri",
2206          "locationName":"resourceArn"
2207        },
2208        "tagKeys":{
2209          "shape":"TagKeyList",
2210          "documentation":"<p>Array of tags to be removed. Array of 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 AWS Resources</a> for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints beyond what is documented there.</p>",
2211          "location":"querystring",
2212          "locationName":"tagKeys"
2213        }
2214      }
2215    },
2216    "UntagResourceResponse":{
2217      "type":"structure",
2218      "members":{
2219      }
2220    },
2221    "UpdateStageRequest":{
2222      "type":"structure",
2223      "required":["arn"],
2224      "members":{
2225        "arn":{
2226          "shape":"StageArn",
2227          "documentation":"<p>ARN of the stage to be updated.</p>"
2228        },
2229        "name":{
2230          "shape":"StageName",
2231          "documentation":"<p>Name of the stage to be updated.</p>"
2232        }
2233      }
2234    },
2235    "UpdateStageResponse":{
2236      "type":"structure",
2237      "members":{
2238        "stage":{
2239          "shape":"Stage",
2240          "documentation":"<p>The updated stage.</p>"
2241        }
2242      }
2243    },
2244    "UserId":{
2245      "type":"string",
2246      "max":128,
2247      "min":0
2248    },
2249    "ValidationException":{
2250      "type":"structure",
2251      "members":{
2252        "exceptionMessage":{
2253          "shape":"errorMessage",
2254          "documentation":"<p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>"
2255        }
2256      },
2257      "documentation":"<p/>",
2258      "error":{
2259        "httpStatusCode":400,
2260        "senderFault":true
2261      },
2262      "exception":true
2263    },
2264    "Video":{
2265      "type":"structure",
2266      "members":{
2267        "bitrate":{
2268          "shape":"Bitrate",
2269          "documentation":"<p>Bitrate for generated output, in bps. Default: 2500000.</p>"
2270        },
2271        "framerate":{
2272          "shape":"Framerate",
2273          "documentation":"<p>Video frame rate, in fps. Default: 30.</p>"
2274        },
2275        "height":{
2276          "shape":"Height",
2277          "documentation":"<p>Video-resolution height. Note that the maximum value is determined by <code>width</code> times <code>height</code>, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 720.</p>"
2278        },
2279        "width":{
2280          "shape":"Width",
2281          "documentation":"<p>Video-resolution width. Note that the maximum value is determined by <code>width</code> times <code>height</code>, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 1280.</p>"
2282        }
2283      },
2284      "documentation":"<p>Settings for video.</p>"
2285    },
2286    "Width":{
2287      "type":"integer",
2288      "box":true,
2289      "max":1920,
2290      "min":1
2291    },
2292    "errorMessage":{"type":"string"}
2293  },
2294  "documentation":"<p> <b>Introduction</b> </p> <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>Terminology:</p> <ul> <li> <p>A <i>stage</i> is a virtual space where participants can exchange video in real time.</p> </li> <li> <p>A <i>participant token</i> is a token that authenticates a participant when they join a stage.</p> </li> <li> <p>A <i>participant object</i> 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> <li> <p>Server-side composition: The <i>composition</i> process composites participants of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels). Composition endpoints support this process.</p> </li> <li> <p>Server-side composition: A <i>composition</i> controls the look of the outputs, including how participants are positioned in the video.</p> </li> </ul> <p> <b>Resources</b> </p> <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> <ul> <li> <p> <b>Stage</b> — A stage is a virtual space where participants can exchange video in real time.</p> </li> </ul> <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/general/latest/gr/aws_tagging.html\">Tagging AWS Resources</a> for more information, 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 endpoints: <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> <p> <b>Stages Endpoints</b> </p> <ul> <li> <p> <a>CreateParticipantToken</a> — Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire.</p> </li> <li> <p> <a>CreateStage</a> — Creates a new stage (and optionally participant tokens).</p> </li> <li> <p> <a>DeleteStage</a> — Shuts down and deletes the specified stage (disconnecting all participants).</p> </li> <li> <p> <a>DisconnectParticipant</a> — Disconnects a specified participant and revokes the participant permanently from a specified stage.</p> </li> <li> <p> <a>GetParticipant</a> — Gets information about the specified participant token.</p> </li> <li> <p> <a>GetStage</a> — Gets information for the specified stage.</p> </li> <li> <p> <a>GetStageSession</a> — Gets information for the specified stage session.</p> </li> <li> <p> <a>ListParticipantEvents</a> — Lists events for a specified participant that occurred during a specified stage session.</p> </li> <li> <p> <a>ListParticipants</a> — Lists all participants in a specified stage session.</p> </li> <li> <p> <a>ListStages</a> — Gets summary information about all stages in your account, in the AWS region where the API request is processed.</p> </li> <li> <p> <a>ListStageSessions</a> — Gets all sessions for a specified stage.</p> </li> <li> <p> <a>UpdateStage</a> — Updates a stage’s configuration.</p> </li> </ul> <p> <b>Composition Endpoints</b> </p> <ul> <li> <p> <a>GetComposition</a> — Gets information about the specified Composition resource.</p> </li> <li> <p> <a>ListCompositions</a> — Gets summary information about all Compositions in your account, in the AWS region where the API request is processed.</p> </li> <li> <p> <a>StartComposition</a> — Starts a Composition from a stage based on the configuration provided in the request.</p> </li> <li> <p> <a>StopComposition</a> — Stops and deletes a Composition resource. Any broadcast from the Composition resource is stopped.</p> </li> </ul> <p> <b>EncoderConfiguration Endpoints</b> </p> <ul> <li> <p> <a>CreateEncoderConfiguration</a> — Creates an EncoderConfiguration object.</p> </li> <li> <p> <a>DeleteEncoderConfiguration</a> — Deletes an EncoderConfiguration resource. Ensures that no Compositions are using this template; otherwise, returns an error.</p> </li> <li> <p> <a>GetEncoderConfiguration</a> — Gets information about the specified EncoderConfiguration resource.</p> </li> <li> <p> <a>ListEncoderConfigurations</a> — Gets summary information about all EncoderConfigurations in your account, in the AWS region where the API request is processed.</p> </li> </ul> <p> <b>StorageConfiguration Endpoints</b> </p> <ul> <li> <p> <a>CreateStorageConfiguration</a> — Creates a new storage configuration, used to enable recording to Amazon S3.</p> </li> <li> <p> <a>DeleteStorageConfiguration</a> — Deletes the storage configuration for the specified ARN.</p> </li> <li> <p> <a>GetStorageConfiguration</a> — Gets the storage configuration for the specified ARN.</p> </li> <li> <p> <a>ListStorageConfigurations</a> — Gets summary information about all storage configurations in your account, in the AWS region where the API request is processed.</p> </li> </ul> <p> <b>Tags Endpoints</b> </p> <ul> <li> <p> <a>ListTagsForResource</a> — Gets information about AWS tags for the specified ARN.</p> </li> <li> <p> <a>TagResource</a> — Adds or updates tags for the AWS resource with the specified ARN.</p> </li> <li> <p> <a>UntagResource</a> — Removes tags from the resource with the specified ARN.</p> </li> </ul>"
2295}
2296