File: doc.go

package info (click to toggle)
golang-github-aws-aws-sdk-go-v2 1.24.1-2~bpo12%2B1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-backports
  • size: 554,032 kB
  • sloc: java: 15,941; makefile: 419; sh: 175
file content (97 lines) | stat: -rw-r--r-- 5,879 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
// Code generated by smithy-go-codegen DO NOT EDIT.

// Package ivsrealtime provides the API client, operations, and parameter types
// for Amazon Interactive Video Service RealTime.
//
// Introduction 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.
// Terminology:
//   - A stage is a virtual space where participants can exchange video in real
//     time.
//   - A participant token is a token that authenticates a participant when they
//     join a stage.
//   - A participant object 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.
//   - Server-side composition: The composition 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.
//   - Server-side composition: A composition controls the look of the outputs,
//     including how participants are positioned in the video.
//
// Resources The following resources contain information about your IVS live
// stream (see Getting Started with Amazon IVS Real-Time Streaming (https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started.html)
// ):
//   - Stage — A stage is a virtual space where participants can exchange video in
//     real time.
//
// Tagging A tag is a metadata label that you assign to an AWS resource. A tag
// comprises a key and a value, both set by you. For example, you might set a tag
// as topic:nature to label a particular video category. See Tagging AWS Resources (https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)
// 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. 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
// Access Tags (https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)
// ). The Amazon IVS real-time API has these tag-related endpoints: TagResource ,
// UntagResource , and ListTagsForResource . The following resource supports
// tagging: Stage. At most 50 tags can be applied to a resource. Stages Endpoints
//   - CreateParticipantToken — Creates an additional token for a specified stage.
//     This can be done after stage creation or when tokens expire.
//   - CreateStage — Creates a new stage (and optionally participant tokens).
//   - DeleteStage — Shuts down and deletes the specified stage (disconnecting all
//     participants).
//   - DisconnectParticipant — Disconnects a specified participant and revokes the
//     participant permanently from a specified stage.
//   - GetParticipant — Gets information about the specified participant token.
//   - GetStage — Gets information for the specified stage.
//   - GetStageSession — Gets information for the specified stage session.
//   - ListParticipantEvents — Lists events for a specified participant that
//     occurred during a specified stage session.
//   - ListParticipants — Lists all participants in a specified stage session.
//   - ListStages — Gets summary information about all stages in your account, in
//     the AWS region where the API request is processed.
//   - ListStageSessions — Gets all sessions for a specified stage.
//   - UpdateStage — Updates a stage’s configuration.
//
// Composition Endpoints
//   - GetComposition — Gets information about the specified Composition resource.
//   - ListCompositions — Gets summary information about all Compositions in your
//     account, in the AWS region where the API request is processed.
//   - StartComposition — Starts a Composition from a stage based on the
//     configuration provided in the request.
//   - StopComposition — Stops and deletes a Composition resource. Any broadcast
//     from the Composition resource is stopped.
//
// EncoderConfiguration Endpoints
//   - CreateEncoderConfiguration — Creates an EncoderConfiguration object.
//   - DeleteEncoderConfiguration — Deletes an EncoderConfiguration resource.
//     Ensures that no Compositions are using this template; otherwise, returns an
//     error.
//   - GetEncoderConfiguration — Gets information about the specified
//     EncoderConfiguration resource.
//   - ListEncoderConfigurations — Gets summary information about all
//     EncoderConfigurations in your account, in the AWS region where the API request
//     is processed.
//
// StorageConfiguration Endpoints
//   - CreateStorageConfiguration — Creates a new storage configuration, used to
//     enable recording to Amazon S3.
//   - DeleteStorageConfiguration — Deletes the storage configuration for the
//     specified ARN.
//   - GetStorageConfiguration — Gets the storage configuration for the specified
//     ARN.
//   - ListStorageConfigurations — Gets summary information about all storage
//     configurations in your account, in the AWS region where the API request is
//     processed.
//
// Tags Endpoints
//   - ListTagsForResource — Gets information about AWS tags for the specified ARN.
//   - TagResource — Adds or updates tags for the AWS resource with the specified
//     ARN.
//   - UntagResource — Removes tags from the resource with the specified ARN.
package ivsrealtime