aws-sdk-ivschat 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,931 @@
1
+ # frozen_string_literal: true
2
+
3
+ # WARNING ABOUT GENERATED CODE
4
+ #
5
+ # This file is generated. See the contributing guide for more information:
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
+ #
8
+ # WARNING ABOUT GENERATED CODE
9
+
10
+ require 'seahorse/client/plugins/content_length.rb'
11
+ require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
+ require 'aws-sdk-core/plugins/logging.rb'
13
+ require 'aws-sdk-core/plugins/param_converter.rb'
14
+ require 'aws-sdk-core/plugins/param_validator.rb'
15
+ require 'aws-sdk-core/plugins/user_agent.rb'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
+ require 'aws-sdk-core/plugins/retry_errors.rb'
18
+ require 'aws-sdk-core/plugins/global_configuration.rb'
19
+ require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
+ require 'aws-sdk-core/plugins/response_paging.rb'
23
+ require 'aws-sdk-core/plugins/stub_responses.rb'
24
+ require 'aws-sdk-core/plugins/idempotency_token.rb'
25
+ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
26
+ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
+ require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
32
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
33
+ require 'aws-sdk-core/plugins/signature_v4.rb'
34
+ require 'aws-sdk-core/plugins/protocols/rest_json.rb'
35
+
36
+ Aws::Plugins::GlobalConfiguration.add_identifier(:ivschat)
37
+
38
+ module Aws::Ivschat
39
+ # An API client for Ivschat. To construct a client, you need to configure a `:region` and `:credentials`.
40
+ #
41
+ # client = Aws::Ivschat::Client.new(
42
+ # region: region_name,
43
+ # credentials: credentials,
44
+ # # ...
45
+ # )
46
+ #
47
+ # For details on configuring region and credentials see
48
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
49
+ #
50
+ # See {#initialize} for a full list of supported configuration options.
51
+ class Client < Seahorse::Client::Base
52
+
53
+ include Aws::ClientStubs
54
+
55
+ @identifier = :ivschat
56
+
57
+ set_api(ClientApi::API)
58
+
59
+ add_plugin(Seahorse::Client::Plugins::ContentLength)
60
+ add_plugin(Aws::Plugins::CredentialsConfiguration)
61
+ add_plugin(Aws::Plugins::Logging)
62
+ add_plugin(Aws::Plugins::ParamConverter)
63
+ add_plugin(Aws::Plugins::ParamValidator)
64
+ add_plugin(Aws::Plugins::UserAgent)
65
+ add_plugin(Aws::Plugins::HelpfulSocketErrors)
66
+ add_plugin(Aws::Plugins::RetryErrors)
67
+ add_plugin(Aws::Plugins::GlobalConfiguration)
68
+ add_plugin(Aws::Plugins::RegionalEndpoint)
69
+ add_plugin(Aws::Plugins::EndpointDiscovery)
70
+ add_plugin(Aws::Plugins::EndpointPattern)
71
+ add_plugin(Aws::Plugins::ResponsePaging)
72
+ add_plugin(Aws::Plugins::StubResponses)
73
+ add_plugin(Aws::Plugins::IdempotencyToken)
74
+ add_plugin(Aws::Plugins::JsonvalueConverter)
75
+ add_plugin(Aws::Plugins::ClientMetricsPlugin)
76
+ add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
77
+ add_plugin(Aws::Plugins::TransferEncoding)
78
+ add_plugin(Aws::Plugins::HttpChecksum)
79
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
80
+ add_plugin(Aws::Plugins::DefaultsMode)
81
+ add_plugin(Aws::Plugins::RecursionDetection)
82
+ add_plugin(Aws::Plugins::SignatureV4)
83
+ add_plugin(Aws::Plugins::Protocols::RestJson)
84
+
85
+ # @overload initialize(options)
86
+ # @param [Hash] options
87
+ # @option options [required, Aws::CredentialProvider] :credentials
88
+ # Your AWS credentials. This can be an instance of any one of the
89
+ # following classes:
90
+ #
91
+ # * `Aws::Credentials` - Used for configuring static, non-refreshing
92
+ # credentials.
93
+ #
94
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
95
+ # shared file, such as `~/.aws/config`.
96
+ #
97
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
98
+ #
99
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
100
+ # assume a role after providing credentials via the web.
101
+ #
102
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
103
+ # access token generated from `aws login`.
104
+ #
105
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
106
+ # process that outputs to stdout.
107
+ #
108
+ # * `Aws::InstanceProfileCredentials` - Used for loading credentials
109
+ # from an EC2 IMDS on an EC2 instance.
110
+ #
111
+ # * `Aws::ECSCredentials` - Used for loading credentials from
112
+ # instances running in ECS.
113
+ #
114
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
115
+ # from the Cognito Identity service.
116
+ #
117
+ # When `:credentials` are not configured directly, the following
118
+ # locations will be searched for credentials:
119
+ #
120
+ # * `Aws.config[:credentials]`
121
+ # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
122
+ # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
123
+ # * `~/.aws/credentials`
124
+ # * `~/.aws/config`
125
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
126
+ # are very aggressive. Construct and pass an instance of
127
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
128
+ # enable retries and extended timeouts. Instance profile credential
129
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
130
+ # to true.
131
+ #
132
+ # @option options [required, String] :region
133
+ # The AWS region to connect to. The configured `:region` is
134
+ # used to determine the service `:endpoint`. When not passed,
135
+ # a default `:region` is searched for in the following locations:
136
+ #
137
+ # * `Aws.config[:region]`
138
+ # * `ENV['AWS_REGION']`
139
+ # * `ENV['AMAZON_REGION']`
140
+ # * `ENV['AWS_DEFAULT_REGION']`
141
+ # * `~/.aws/credentials`
142
+ # * `~/.aws/config`
143
+ #
144
+ # @option options [String] :access_key_id
145
+ #
146
+ # @option options [Boolean] :active_endpoint_cache (false)
147
+ # When set to `true`, a thread polling for endpoints will be running in
148
+ # the background every 60 secs (default). Defaults to `false`.
149
+ #
150
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
151
+ # Used only in `adaptive` retry mode. When true, the request will sleep
152
+ # until there is sufficent client side capacity to retry the request.
153
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
154
+ # not retry instead of sleeping.
155
+ #
156
+ # @option options [Boolean] :client_side_monitoring (false)
157
+ # When `true`, client-side metrics will be collected for all API requests from
158
+ # this client.
159
+ #
160
+ # @option options [String] :client_side_monitoring_client_id ("")
161
+ # Allows you to provide an identifier for this client which will be attached to
162
+ # all generated client side metrics. Defaults to an empty string.
163
+ #
164
+ # @option options [String] :client_side_monitoring_host ("127.0.0.1")
165
+ # Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client
166
+ # side monitoring agent is running on, where client metrics will be published via UDP.
167
+ #
168
+ # @option options [Integer] :client_side_monitoring_port (31000)
169
+ # Required for publishing client metrics. The port that the client side monitoring
170
+ # agent is running on, where client metrics will be published via UDP.
171
+ #
172
+ # @option options [Aws::ClientSideMonitoring::Publisher] :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher)
173
+ # Allows you to provide a custom client-side monitoring publisher class. By default,
174
+ # will use the Client Side Monitoring Agent Publisher.
175
+ #
176
+ # @option options [Boolean] :convert_params (true)
177
+ # When `true`, an attempt is made to coerce request parameters into
178
+ # the required types.
179
+ #
180
+ # @option options [Boolean] :correct_clock_skew (true)
181
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
182
+ # a clock skew correction and retry requests with skewed client clocks.
183
+ #
184
+ # @option options [String] :defaults_mode ("legacy")
185
+ # See {Aws::DefaultsModeConfiguration} for a list of the
186
+ # accepted modes and the configuration defaults that are included.
187
+ #
188
+ # @option options [Boolean] :disable_host_prefix_injection (false)
189
+ # Set to true to disable SDK automatically adding host prefix
190
+ # to default service endpoint when available.
191
+ #
192
+ # @option options [String] :endpoint
193
+ # The client endpoint is normally constructed from the `:region`
194
+ # option. You should only configure an `:endpoint` when connecting
195
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
196
+ #
197
+ # @option options [Integer] :endpoint_cache_max_entries (1000)
198
+ # Used for the maximum size limit of the LRU cache storing endpoints data
199
+ # for endpoint discovery enabled operations. Defaults to 1000.
200
+ #
201
+ # @option options [Integer] :endpoint_cache_max_threads (10)
202
+ # Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
203
+ #
204
+ # @option options [Integer] :endpoint_cache_poll_interval (60)
205
+ # When :endpoint_discovery and :active_endpoint_cache is enabled,
206
+ # Use this option to config the time interval in seconds for making
207
+ # requests fetching endpoints information. Defaults to 60 sec.
208
+ #
209
+ # @option options [Boolean] :endpoint_discovery (false)
210
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
211
+ #
212
+ # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
213
+ # The log formatter.
214
+ #
215
+ # @option options [Symbol] :log_level (:info)
216
+ # The log level to send messages to the `:logger` at.
217
+ #
218
+ # @option options [Logger] :logger
219
+ # The Logger instance to send log messages to. If this option
220
+ # is not set, logging will be disabled.
221
+ #
222
+ # @option options [Integer] :max_attempts (3)
223
+ # An integer representing the maximum number attempts that will be made for
224
+ # a single request, including the initial attempt. For example,
225
+ # setting this value to 5 will result in a request being retried up to
226
+ # 4 times. Used in `standard` and `adaptive` retry modes.
227
+ #
228
+ # @option options [String] :profile ("default")
229
+ # Used when loading credentials from the shared credentials file
230
+ # at HOME/.aws/credentials. When not specified, 'default' is used.
231
+ #
232
+ # @option options [Proc] :retry_backoff
233
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
234
+ # This option is only used in the `legacy` retry mode.
235
+ #
236
+ # @option options [Float] :retry_base_delay (0.3)
237
+ # The base delay in seconds used by the default backoff function. This option
238
+ # is only used in the `legacy` retry mode.
239
+ #
240
+ # @option options [Symbol] :retry_jitter (:none)
241
+ # A delay randomiser function used by the default backoff function.
242
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
243
+ # otherwise a Proc that takes and returns a number. This option is only used
244
+ # in the `legacy` retry mode.
245
+ #
246
+ # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
247
+ #
248
+ # @option options [Integer] :retry_limit (3)
249
+ # The maximum number of times to retry failed requests. Only
250
+ # ~ 500 level server errors and certain ~ 400 level client errors
251
+ # are retried. Generally, these are throttling errors, data
252
+ # checksum errors, networking errors, timeout errors, auth errors,
253
+ # endpoint discovery, and errors from expired credentials.
254
+ # This option is only used in the `legacy` retry mode.
255
+ #
256
+ # @option options [Integer] :retry_max_delay (0)
257
+ # The maximum number of seconds to delay between retries (0 for no limit)
258
+ # used by the default backoff function. This option is only used in the
259
+ # `legacy` retry mode.
260
+ #
261
+ # @option options [String] :retry_mode ("legacy")
262
+ # Specifies which retry algorithm to use. Values are:
263
+ #
264
+ # * `legacy` - The pre-existing retry behavior. This is default value if
265
+ # no retry mode is provided.
266
+ #
267
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
268
+ # This includes support for retry quotas, which limit the number of
269
+ # unsuccessful retries a client can make.
270
+ #
271
+ # * `adaptive` - An experimental retry mode that includes all the
272
+ # functionality of `standard` mode along with automatic client side
273
+ # throttling. This is a provisional mode that may change behavior
274
+ # in the future.
275
+ #
276
+ #
277
+ # @option options [String] :secret_access_key
278
+ #
279
+ # @option options [String] :session_token
280
+ #
281
+ # @option options [Boolean] :stub_responses (false)
282
+ # Causes the client to return stubbed responses. By default
283
+ # fake responses are generated and returned. You can specify
284
+ # the response data to return or errors to raise by calling
285
+ # {ClientStubs#stub_responses}. See {ClientStubs} for more information.
286
+ #
287
+ # ** Please note ** When response stubbing is enabled, no HTTP
288
+ # requests are made, and retries are disabled.
289
+ #
290
+ # @option options [Boolean] :use_dualstack_endpoint
291
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
292
+ # will be used if available.
293
+ #
294
+ # @option options [Boolean] :use_fips_endpoint
295
+ # When set to `true`, fips compatible endpoints will be used if available.
296
+ # When a `fips` region is used, the region is normalized and this config
297
+ # is set to `true`.
298
+ #
299
+ # @option options [Boolean] :validate_params (true)
300
+ # When `true`, request parameters are validated before
301
+ # sending the request.
302
+ #
303
+ # @option options [URI::HTTP,String] :http_proxy A proxy to send
304
+ # requests through. Formatted like 'http://proxy.com:123'.
305
+ #
306
+ # @option options [Float] :http_open_timeout (15) The number of
307
+ # seconds to wait when opening a HTTP session before raising a
308
+ # `Timeout::Error`.
309
+ #
310
+ # @option options [Float] :http_read_timeout (60) The default
311
+ # number of seconds to wait for response data. This value can
312
+ # safely be set per-request on the session.
313
+ #
314
+ # @option options [Float] :http_idle_timeout (5) The number of
315
+ # seconds a connection is allowed to sit idle before it is
316
+ # considered stale. Stale connections are closed and removed
317
+ # from the pool before making a request.
318
+ #
319
+ # @option options [Float] :http_continue_timeout (1) The number of
320
+ # seconds to wait for a 100-continue response before sending the
321
+ # request body. This option has no effect unless the request has
322
+ # "Expect" header set to "100-continue". Defaults to `nil` which
323
+ # disables this behaviour. This value can safely be set per
324
+ # request on the session.
325
+ #
326
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
327
+ # in seconds.
328
+ #
329
+ # @option options [Boolean] :http_wire_trace (false) When `true`,
330
+ # HTTP debug output will be sent to the `:logger`.
331
+ #
332
+ # @option options [Boolean] :ssl_verify_peer (true) When `true`,
333
+ # SSL peer certificates are verified when establishing a
334
+ # connection.
335
+ #
336
+ # @option options [String] :ssl_ca_bundle Full path to the SSL
337
+ # certificate authority bundle file that should be used when
338
+ # verifying peer certificates. If you do not pass
339
+ # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
340
+ # will be used if available.
341
+ #
342
+ # @option options [String] :ssl_ca_directory Full path of the
343
+ # directory that contains the unbundled SSL certificate
344
+ # authority files for verifying peer certificates. If you do
345
+ # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
346
+ # system default will be used if available.
347
+ #
348
+ def initialize(*args)
349
+ super
350
+ end
351
+
352
+ # @!group API Operations
353
+
354
+ # Creates an encrypted token that is used to establish an individual
355
+ # WebSocket connection to a room. The token is valid for one minute, and
356
+ # a connection (session) established with the token is valid for the
357
+ # specified duration.
358
+ #
359
+ # Encryption keys are owned by Amazon IVS Chat and never used directly
360
+ # by your application.
361
+ #
362
+ # @option params [Hash<String,String>] :attributes
363
+ # Application-provided attributes to encode into the token and attach to
364
+ # a chat session. Map keys and values can contain UTF-8 encoded text.
365
+ # The maximum length of this field is 1 KB total.
366
+ #
367
+ # @option params [Array<String>] :capabilities
368
+ # Set of capabilities that the user is allowed to perform in the room.
369
+ # Default: None (the capability to view messages is implicitly included
370
+ # in all requests).
371
+ #
372
+ # @option params [required, String] :room_identifier
373
+ # Identifier of the room that the client is trying to access. Currently
374
+ # this must be an ARN.
375
+ #
376
+ # @option params [Integer] :session_duration_in_minutes
377
+ # Session duration (in minutes), after which the session expires.
378
+ # Default: 60 (1 hour).
379
+ #
380
+ # @option params [required, String] :user_id
381
+ # Application-provided ID that uniquely identifies the user associated
382
+ # with this token. This can be any UTF-8 encoded text.
383
+ #
384
+ # @return [Types::CreateChatTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
385
+ #
386
+ # * {Types::CreateChatTokenResponse#session_expiration_time #session_expiration_time} => Time
387
+ # * {Types::CreateChatTokenResponse#token #token} => String
388
+ # * {Types::CreateChatTokenResponse#token_expiration_time #token_expiration_time} => Time
389
+ #
390
+ # @example Request syntax with placeholder values
391
+ #
392
+ # resp = client.create_chat_token({
393
+ # attributes: {
394
+ # "String" => "String",
395
+ # },
396
+ # capabilities: ["SEND_MESSAGE"], # accepts SEND_MESSAGE, DISCONNECT_USER, DELETE_MESSAGE
397
+ # room_identifier: "RoomIdentifier", # required
398
+ # session_duration_in_minutes: 1,
399
+ # user_id: "UserID", # required
400
+ # })
401
+ #
402
+ # @example Response structure
403
+ #
404
+ # resp.session_expiration_time #=> Time
405
+ # resp.token #=> String
406
+ # resp.token_expiration_time #=> Time
407
+ #
408
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/CreateChatToken AWS API Documentation
409
+ #
410
+ # @overload create_chat_token(params = {})
411
+ # @param [Hash] params ({})
412
+ def create_chat_token(params = {}, options = {})
413
+ req = build_request(:create_chat_token, params)
414
+ req.send_request(options)
415
+ end
416
+
417
+ # Creates a room that allows clients to connect and pass messages.
418
+ #
419
+ # @option params [Integer] :maximum_message_length
420
+ # Maximum number of characters in a single message. Messages are
421
+ # expected to be UTF-8 encoded and this limit applies specifically to
422
+ # rune/code-point count, not number of bytes. Default: 500.
423
+ #
424
+ # @option params [Integer] :maximum_message_rate_per_second
425
+ # Maximum number of messages per second that a client can send to the
426
+ # room. Default: 10.
427
+ #
428
+ # @option params [Types::MessageReviewHandler] :message_review_handler
429
+ # Configuration information for optional review of messages.
430
+ #
431
+ # @option params [String] :name
432
+ # Room name. The value does not need to be unique.
433
+ #
434
+ # @option params [Hash<String,String>] :tags
435
+ # Tags to attach to the resource. Array of maps, each of the form
436
+ # `string:string (key:value)`.
437
+ #
438
+ # @return [Types::CreateRoomResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
439
+ #
440
+ # * {Types::CreateRoomResponse#arn #arn} => String
441
+ # * {Types::CreateRoomResponse#create_time #create_time} => Time
442
+ # * {Types::CreateRoomResponse#id #id} => String
443
+ # * {Types::CreateRoomResponse#maximum_message_length #maximum_message_length} => Integer
444
+ # * {Types::CreateRoomResponse#maximum_message_rate_per_second #maximum_message_rate_per_second} => Integer
445
+ # * {Types::CreateRoomResponse#message_review_handler #message_review_handler} => Types::MessageReviewHandler
446
+ # * {Types::CreateRoomResponse#name #name} => String
447
+ # * {Types::CreateRoomResponse#tags #tags} => Hash&lt;String,String&gt;
448
+ # * {Types::CreateRoomResponse#update_time #update_time} => Time
449
+ #
450
+ # @example Request syntax with placeholder values
451
+ #
452
+ # resp = client.create_room({
453
+ # maximum_message_length: 1,
454
+ # maximum_message_rate_per_second: 1,
455
+ # message_review_handler: {
456
+ # fallback_result: "ALLOW", # accepts ALLOW, DENY
457
+ # uri: "LambdaArn",
458
+ # },
459
+ # name: "RoomName",
460
+ # tags: {
461
+ # "TagKey" => "TagValue",
462
+ # },
463
+ # })
464
+ #
465
+ # @example Response structure
466
+ #
467
+ # resp.arn #=> String
468
+ # resp.create_time #=> Time
469
+ # resp.id #=> String
470
+ # resp.maximum_message_length #=> Integer
471
+ # resp.maximum_message_rate_per_second #=> Integer
472
+ # resp.message_review_handler.fallback_result #=> String, one of "ALLOW", "DENY"
473
+ # resp.message_review_handler.uri #=> String
474
+ # resp.name #=> String
475
+ # resp.tags #=> Hash
476
+ # resp.tags["TagKey"] #=> String
477
+ # resp.update_time #=> Time
478
+ #
479
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/CreateRoom AWS API Documentation
480
+ #
481
+ # @overload create_room(params = {})
482
+ # @param [Hash] params ({})
483
+ def create_room(params = {}, options = {})
484
+ req = build_request(:create_room, params)
485
+ req.send_request(options)
486
+ end
487
+
488
+ # Sends an event to a specific room which directs clients to delete a
489
+ # specific message; that is, unrender it from view and delete it from
490
+ # the client’s chat history. This event’s `EventName` is
491
+ # `aws:DELETE_MESSAGE`. This replicates the [ DeleteMessage][1]
492
+ # WebSocket operation in the Amazon IVS Chat Messaging API.
493
+ #
494
+ #
495
+ #
496
+ # [1]: https://docs.aws.amazon.com/ivs/latest/chatmsgapireference/actions-deletemessage-publish.html
497
+ #
498
+ # @option params [required, String] :id
499
+ # ID of the message to be deleted. This is the `Id` field in the
500
+ # received message (see [ Message (Subscribe)][1] in the Chat Messaging
501
+ # API).
502
+ #
503
+ #
504
+ #
505
+ # [1]: https://docs.aws.amazon.com/ivs/latest/chatmsgapireference/actions-message-subscribe.html
506
+ #
507
+ # @option params [String] :reason
508
+ # Reason for deleting the message.
509
+ #
510
+ # @option params [required, String] :room_identifier
511
+ # Identifier of the room where the message should be deleted. Currently
512
+ # this must be an ARN.
513
+ #
514
+ # @return [Types::DeleteMessageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
515
+ #
516
+ # * {Types::DeleteMessageResponse#id #id} => String
517
+ #
518
+ # @example Request syntax with placeholder values
519
+ #
520
+ # resp = client.delete_message({
521
+ # id: "MessageID", # required
522
+ # reason: "Reason",
523
+ # room_identifier: "RoomIdentifier", # required
524
+ # })
525
+ #
526
+ # @example Response structure
527
+ #
528
+ # resp.id #=> String
529
+ #
530
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/DeleteMessage AWS API Documentation
531
+ #
532
+ # @overload delete_message(params = {})
533
+ # @param [Hash] params ({})
534
+ def delete_message(params = {}, options = {})
535
+ req = build_request(:delete_message, params)
536
+ req.send_request(options)
537
+ end
538
+
539
+ # Deletes the specified room.
540
+ #
541
+ # @option params [required, String] :identifier
542
+ # Identifier of the room to be deleted. Currently this must be an ARN.
543
+ #
544
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
545
+ #
546
+ # @example Request syntax with placeholder values
547
+ #
548
+ # resp = client.delete_room({
549
+ # identifier: "RoomIdentifier", # required
550
+ # })
551
+ #
552
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/DeleteRoom AWS API Documentation
553
+ #
554
+ # @overload delete_room(params = {})
555
+ # @param [Hash] params ({})
556
+ def delete_room(params = {}, options = {})
557
+ req = build_request(:delete_room, params)
558
+ req.send_request(options)
559
+ end
560
+
561
+ # Disconnects all connections using a specified user ID from a room.
562
+ # This replicates the [ DisconnectUser][1] WebSocket operation in the
563
+ # Amazon IVS Chat Messaging API.
564
+ #
565
+ #
566
+ #
567
+ # [1]: https://docs.aws.amazon.com/ivs/latest/chatmsgapireference/actions-disconnectuser-publish.html
568
+ #
569
+ # @option params [String] :reason
570
+ # Reason for disconnecting the user.
571
+ #
572
+ # @option params [required, String] :room_identifier
573
+ # Identifier of the room from which the user's clients should be
574
+ # disconnected. Currently this must be an ARN.
575
+ #
576
+ # @option params [required, String] :user_id
577
+ # ID of the user (connection) to disconnect from the room.
578
+ #
579
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
580
+ #
581
+ # @example Request syntax with placeholder values
582
+ #
583
+ # resp = client.disconnect_user({
584
+ # reason: "Reason",
585
+ # room_identifier: "RoomIdentifier", # required
586
+ # user_id: "UserID", # required
587
+ # })
588
+ #
589
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/DisconnectUser AWS API Documentation
590
+ #
591
+ # @overload disconnect_user(params = {})
592
+ # @param [Hash] params ({})
593
+ def disconnect_user(params = {}, options = {})
594
+ req = build_request(:disconnect_user, params)
595
+ req.send_request(options)
596
+ end
597
+
598
+ # Gets the specified room.
599
+ #
600
+ # @option params [required, String] :identifier
601
+ # Identifier of the room for which the configuration is to be retrieved.
602
+ # Currently this must be an ARN.
603
+ #
604
+ # @return [Types::GetRoomResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
605
+ #
606
+ # * {Types::GetRoomResponse#arn #arn} => String
607
+ # * {Types::GetRoomResponse#create_time #create_time} => Time
608
+ # * {Types::GetRoomResponse#id #id} => String
609
+ # * {Types::GetRoomResponse#maximum_message_length #maximum_message_length} => Integer
610
+ # * {Types::GetRoomResponse#maximum_message_rate_per_second #maximum_message_rate_per_second} => Integer
611
+ # * {Types::GetRoomResponse#message_review_handler #message_review_handler} => Types::MessageReviewHandler
612
+ # * {Types::GetRoomResponse#name #name} => String
613
+ # * {Types::GetRoomResponse#tags #tags} => Hash&lt;String,String&gt;
614
+ # * {Types::GetRoomResponse#update_time #update_time} => Time
615
+ #
616
+ # @example Request syntax with placeholder values
617
+ #
618
+ # resp = client.get_room({
619
+ # identifier: "RoomIdentifier", # required
620
+ # })
621
+ #
622
+ # @example Response structure
623
+ #
624
+ # resp.arn #=> String
625
+ # resp.create_time #=> Time
626
+ # resp.id #=> String
627
+ # resp.maximum_message_length #=> Integer
628
+ # resp.maximum_message_rate_per_second #=> Integer
629
+ # resp.message_review_handler.fallback_result #=> String, one of "ALLOW", "DENY"
630
+ # resp.message_review_handler.uri #=> String
631
+ # resp.name #=> String
632
+ # resp.tags #=> Hash
633
+ # resp.tags["TagKey"] #=> String
634
+ # resp.update_time #=> Time
635
+ #
636
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/GetRoom AWS API Documentation
637
+ #
638
+ # @overload get_room(params = {})
639
+ # @param [Hash] params ({})
640
+ def get_room(params = {}, options = {})
641
+ req = build_request(:get_room, params)
642
+ req.send_request(options)
643
+ end
644
+
645
+ # Gets summary information about all your rooms in the AWS region where
646
+ # the API request is processed. Results are sorted in descending order
647
+ # of `updateTime`.
648
+ #
649
+ # @option params [Integer] :max_results
650
+ # Maximum number of rooms to return. Default: 50.
651
+ #
652
+ # @option params [String] :message_review_handler_uri
653
+ # Filters the list to match the specified message review handler URI.
654
+ #
655
+ # @option params [String] :name
656
+ # Filters the list to match the specified room name.
657
+ #
658
+ # @option params [String] :next_token
659
+ # The first room to retrieve. This is used for pagination; see the
660
+ # `nextToken` response field.
661
+ #
662
+ # @return [Types::ListRoomsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
663
+ #
664
+ # * {Types::ListRoomsResponse#next_token #next_token} => String
665
+ # * {Types::ListRoomsResponse#rooms #rooms} => Array&lt;Types::RoomSummary&gt;
666
+ #
667
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
668
+ #
669
+ # @example Request syntax with placeholder values
670
+ #
671
+ # resp = client.list_rooms({
672
+ # max_results: 1,
673
+ # message_review_handler_uri: "LambdaArn",
674
+ # name: "RoomName",
675
+ # next_token: "PaginationToken",
676
+ # })
677
+ #
678
+ # @example Response structure
679
+ #
680
+ # resp.next_token #=> String
681
+ # resp.rooms #=> Array
682
+ # resp.rooms[0].arn #=> String
683
+ # resp.rooms[0].create_time #=> Time
684
+ # resp.rooms[0].id #=> String
685
+ # resp.rooms[0].message_review_handler.fallback_result #=> String, one of "ALLOW", "DENY"
686
+ # resp.rooms[0].message_review_handler.uri #=> String
687
+ # resp.rooms[0].name #=> String
688
+ # resp.rooms[0].tags #=> Hash
689
+ # resp.rooms[0].tags["TagKey"] #=> String
690
+ # resp.rooms[0].update_time #=> Time
691
+ #
692
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/ListRooms AWS API Documentation
693
+ #
694
+ # @overload list_rooms(params = {})
695
+ # @param [Hash] params ({})
696
+ def list_rooms(params = {}, options = {})
697
+ req = build_request(:list_rooms, params)
698
+ req.send_request(options)
699
+ end
700
+
701
+ # Gets information about AWS tags for the specified ARN.
702
+ #
703
+ # @option params [required, String] :resource_arn
704
+ # The ARN of the resource to be retrieved. The ARN must be URL-encoded.
705
+ #
706
+ # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
707
+ #
708
+ # * {Types::ListTagsForResourceResponse#tags #tags} => Hash&lt;String,String&gt;
709
+ #
710
+ # @example Request syntax with placeholder values
711
+ #
712
+ # resp = client.list_tags_for_resource({
713
+ # resource_arn: "ResourceArn", # required
714
+ # })
715
+ #
716
+ # @example Response structure
717
+ #
718
+ # resp.tags #=> Hash
719
+ # resp.tags["TagKey"] #=> String
720
+ #
721
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/ListTagsForResource AWS API Documentation
722
+ #
723
+ # @overload list_tags_for_resource(params = {})
724
+ # @param [Hash] params ({})
725
+ def list_tags_for_resource(params = {}, options = {})
726
+ req = build_request(:list_tags_for_resource, params)
727
+ req.send_request(options)
728
+ end
729
+
730
+ # Sends an event to a room. Use this within your application’s business
731
+ # logic to send events to clients of a room; e.g., to notify clients to
732
+ # change the way the chat UI is rendered.
733
+ #
734
+ # @option params [Hash<String,String>] :attributes
735
+ # Application-defined metadata to attach to the event sent to clients.
736
+ # The maximum length of the metadata is 1 KB total.
737
+ #
738
+ # @option params [required, String] :event_name
739
+ # Application-defined name of the event to send to clients.
740
+ #
741
+ # @option params [required, String] :room_identifier
742
+ # Identifier of the room to which the event will be sent. Currently this
743
+ # must be an ARN.
744
+ #
745
+ # @return [Types::SendEventResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
746
+ #
747
+ # * {Types::SendEventResponse#id #id} => String
748
+ #
749
+ # @example Request syntax with placeholder values
750
+ #
751
+ # resp = client.send_event({
752
+ # attributes: {
753
+ # "String" => "String",
754
+ # },
755
+ # event_name: "EventName", # required
756
+ # room_identifier: "RoomIdentifier", # required
757
+ # })
758
+ #
759
+ # @example Response structure
760
+ #
761
+ # resp.id #=> String
762
+ #
763
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/SendEvent AWS API Documentation
764
+ #
765
+ # @overload send_event(params = {})
766
+ # @param [Hash] params ({})
767
+ def send_event(params = {}, options = {})
768
+ req = build_request(:send_event, params)
769
+ req.send_request(options)
770
+ end
771
+
772
+ # Adds or updates tags for the AWS resource with the specified ARN.
773
+ #
774
+ # @option params [required, String] :resource_arn
775
+ # The ARN of the resource to be tagged. The ARN must be URL-encoded.
776
+ #
777
+ # @option params [required, Hash<String,String>] :tags
778
+ # Array of tags to be added or updated.
779
+ #
780
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
781
+ #
782
+ # @example Request syntax with placeholder values
783
+ #
784
+ # resp = client.tag_resource({
785
+ # resource_arn: "ResourceArn", # required
786
+ # tags: { # required
787
+ # "TagKey" => "TagValue",
788
+ # },
789
+ # })
790
+ #
791
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/TagResource AWS API Documentation
792
+ #
793
+ # @overload tag_resource(params = {})
794
+ # @param [Hash] params ({})
795
+ def tag_resource(params = {}, options = {})
796
+ req = build_request(:tag_resource, params)
797
+ req.send_request(options)
798
+ end
799
+
800
+ # Removes tags from the resource with the specified ARN.
801
+ #
802
+ # @option params [required, String] :resource_arn
803
+ # The ARN of the resource to be untagged. The ARN must be URL-encoded.
804
+ #
805
+ # @option params [required, Array<String>] :tag_keys
806
+ # Array of tags to be removed.
807
+ #
808
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
809
+ #
810
+ # @example Request syntax with placeholder values
811
+ #
812
+ # resp = client.untag_resource({
813
+ # resource_arn: "ResourceArn", # required
814
+ # tag_keys: ["TagKey"], # required
815
+ # })
816
+ #
817
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/UntagResource AWS API Documentation
818
+ #
819
+ # @overload untag_resource(params = {})
820
+ # @param [Hash] params ({})
821
+ def untag_resource(params = {}, options = {})
822
+ req = build_request(:untag_resource, params)
823
+ req.send_request(options)
824
+ end
825
+
826
+ # Updates a room’s configuration.
827
+ #
828
+ # @option params [required, String] :identifier
829
+ # Identifier of the room to be updated. Currently this must be an ARN.
830
+ #
831
+ # @option params [Integer] :maximum_message_length
832
+ # The maximum number of characters in a single message. Messages are
833
+ # expected to be UTF-8 encoded and this limit applies specifically to
834
+ # rune/code-point count, not number of bytes. Default: 500.
835
+ #
836
+ # @option params [Integer] :maximum_message_rate_per_second
837
+ # The maximum number of messages per second that a client can send to
838
+ # the room. Default: 10.
839
+ #
840
+ # @option params [Types::MessageReviewHandler] :message_review_handler
841
+ # Configuration information for optional review of messages. Specify an
842
+ # empty `uri` string to disassociate a message review handler from the
843
+ # specified room.
844
+ #
845
+ # @option params [String] :name
846
+ # Room name. The value does not need to be unique.
847
+ #
848
+ # @return [Types::UpdateRoomResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
849
+ #
850
+ # * {Types::UpdateRoomResponse#arn #arn} => String
851
+ # * {Types::UpdateRoomResponse#create_time #create_time} => Time
852
+ # * {Types::UpdateRoomResponse#id #id} => String
853
+ # * {Types::UpdateRoomResponse#maximum_message_length #maximum_message_length} => Integer
854
+ # * {Types::UpdateRoomResponse#maximum_message_rate_per_second #maximum_message_rate_per_second} => Integer
855
+ # * {Types::UpdateRoomResponse#message_review_handler #message_review_handler} => Types::MessageReviewHandler
856
+ # * {Types::UpdateRoomResponse#name #name} => String
857
+ # * {Types::UpdateRoomResponse#tags #tags} => Hash&lt;String,String&gt;
858
+ # * {Types::UpdateRoomResponse#update_time #update_time} => Time
859
+ #
860
+ # @example Request syntax with placeholder values
861
+ #
862
+ # resp = client.update_room({
863
+ # identifier: "RoomIdentifier", # required
864
+ # maximum_message_length: 1,
865
+ # maximum_message_rate_per_second: 1,
866
+ # message_review_handler: {
867
+ # fallback_result: "ALLOW", # accepts ALLOW, DENY
868
+ # uri: "LambdaArn",
869
+ # },
870
+ # name: "RoomName",
871
+ # })
872
+ #
873
+ # @example Response structure
874
+ #
875
+ # resp.arn #=> String
876
+ # resp.create_time #=> Time
877
+ # resp.id #=> String
878
+ # resp.maximum_message_length #=> Integer
879
+ # resp.maximum_message_rate_per_second #=> Integer
880
+ # resp.message_review_handler.fallback_result #=> String, one of "ALLOW", "DENY"
881
+ # resp.message_review_handler.uri #=> String
882
+ # resp.name #=> String
883
+ # resp.tags #=> Hash
884
+ # resp.tags["TagKey"] #=> String
885
+ # resp.update_time #=> Time
886
+ #
887
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ivschat-2020-07-14/UpdateRoom AWS API Documentation
888
+ #
889
+ # @overload update_room(params = {})
890
+ # @param [Hash] params ({})
891
+ def update_room(params = {}, options = {})
892
+ req = build_request(:update_room, params)
893
+ req.send_request(options)
894
+ end
895
+
896
+ # @!endgroup
897
+
898
+ # @param params ({})
899
+ # @api private
900
+ def build_request(operation_name, params = {})
901
+ handlers = @handlers.for(operation_name)
902
+ context = Seahorse::Client::RequestContext.new(
903
+ operation_name: operation_name,
904
+ operation: config.api.operation(operation_name),
905
+ client: self,
906
+ params: params,
907
+ config: config)
908
+ context[:gem_name] = 'aws-sdk-ivschat'
909
+ context[:gem_version] = '1.0.0'
910
+ Seahorse::Client::Request.new(handlers, context)
911
+ end
912
+
913
+ # @api private
914
+ # @deprecated
915
+ def waiter_names
916
+ []
917
+ end
918
+
919
+ class << self
920
+
921
+ # @api private
922
+ attr_reader :identifier
923
+
924
+ # @api private
925
+ def errors_module
926
+ Errors
927
+ end
928
+
929
+ end
930
+ end
931
+ end