aws-sdk-health 1.0.0.rc2

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.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 5e4c747fa56738b6c6348f9e3592151a99e43946
4
+ data.tar.gz: ca1a798e4c31c289040fddb81ad787ce6940481a
5
+ SHA512:
6
+ metadata.gz: 1222fd1494e2d6d9ca49b1de0255df753194daf96aa00ecd059250c95e1c640c7860922524603f528ffa6b418198580e4de20a070cecc65a0b1396251f2f3770
7
+ data.tar.gz: 0045ad4ebc27b365f22d15de631efddd4c4cd30770342017d8993978a08080692046e685d29bc6743105cf11fb190996e0cf6f7dfecf8b6edb57a907930181ee
@@ -0,0 +1,47 @@
1
+ # WARNING ABOUT GENERATED CODE
2
+ #
3
+ # This file is generated. See the contributing for info on making contributions:
4
+ # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
+ #
6
+ # WARNING ABOUT GENERATED CODE
7
+
8
+ require 'aws-sdk-core'
9
+ require 'aws-sigv4'
10
+
11
+ require_relative 'aws-sdk-health/types'
12
+ require_relative 'aws-sdk-health/client_api'
13
+ require_relative 'aws-sdk-health/client'
14
+ require_relative 'aws-sdk-health/errors'
15
+ require_relative 'aws-sdk-health/resource'
16
+ require_relative 'aws-sdk-health/customizations'
17
+
18
+ # This module provides support for AWS Health APIs and Notifications. This module is available in the
19
+ # `aws-sdk-health` gem.
20
+ #
21
+ # # Client
22
+ #
23
+ # The {Client} class provides one method for each API operation. Operation
24
+ # methods each accept a hash of request parameters and return a response
25
+ # structure.
26
+ #
27
+ # See {Client} for more information.
28
+ #
29
+ # # Errors
30
+ #
31
+ # Errors returned from AWS Health APIs and Notifications all
32
+ # extend {Errors::ServiceError}.
33
+ #
34
+ # begin
35
+ # # do stuff
36
+ # rescue Aws::Health::Errors::ServiceError
37
+ # # rescues all service API errors
38
+ # end
39
+ #
40
+ # See {Errors} for more information.
41
+ #
42
+ # @service
43
+ module Aws::Health
44
+
45
+ GEM_VERSION = '1.0.0.rc2'
46
+
47
+ end
@@ -0,0 +1,534 @@
1
+ # WARNING ABOUT GENERATED CODE
2
+ #
3
+ # This file is generated. See the contributing for info on making contributions:
4
+ # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
+ #
6
+ # WARNING ABOUT GENERATED CODE
7
+
8
+ require 'seahorse/client/plugins/content_length.rb'
9
+ require 'aws-sdk-core/plugins/credentials_configuration.rb'
10
+ require 'aws-sdk-core/plugins/logging.rb'
11
+ require 'aws-sdk-core/plugins/param_converter.rb'
12
+ require 'aws-sdk-core/plugins/param_validator.rb'
13
+ require 'aws-sdk-core/plugins/user_agent.rb'
14
+ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
15
+ require 'aws-sdk-core/plugins/retry_errors.rb'
16
+ require 'aws-sdk-core/plugins/global_configuration.rb'
17
+ require 'aws-sdk-core/plugins/regional_endpoint.rb'
18
+ require 'aws-sdk-core/plugins/response_paging.rb'
19
+ require 'aws-sdk-core/plugins/stub_responses.rb'
20
+ require 'aws-sdk-core/plugins/idempotency_token.rb'
21
+ require 'aws-sdk-core/plugins/signature_v4.rb'
22
+ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
23
+
24
+ Aws::Plugins::GlobalConfiguration.add_identifier(:health)
25
+
26
+ module Aws
27
+ module Health
28
+ class Client < Seahorse::Client::Base
29
+
30
+ include Aws::ClientStubs
31
+
32
+ @identifier = :health
33
+
34
+ set_api(ClientApi::API)
35
+
36
+ add_plugin(Seahorse::Client::Plugins::ContentLength)
37
+ add_plugin(Aws::Plugins::CredentialsConfiguration)
38
+ add_plugin(Aws::Plugins::Logging)
39
+ add_plugin(Aws::Plugins::ParamConverter)
40
+ add_plugin(Aws::Plugins::ParamValidator)
41
+ add_plugin(Aws::Plugins::UserAgent)
42
+ add_plugin(Aws::Plugins::HelpfulSocketErrors)
43
+ add_plugin(Aws::Plugins::RetryErrors)
44
+ add_plugin(Aws::Plugins::GlobalConfiguration)
45
+ add_plugin(Aws::Plugins::RegionalEndpoint)
46
+ add_plugin(Aws::Plugins::ResponsePaging)
47
+ add_plugin(Aws::Plugins::StubResponses)
48
+ add_plugin(Aws::Plugins::IdempotencyToken)
49
+ add_plugin(Aws::Plugins::SignatureV4)
50
+ add_plugin(Aws::Plugins::Protocols::JsonRpc)
51
+
52
+ # @option options [required, Aws::CredentialProvider] :credentials
53
+ # Your AWS credentials. This can be an instance of any one of the
54
+ # following classes:
55
+ #
56
+ # * `Aws::Credentials` - Used for configuring static, non-refreshing
57
+ # credentials.
58
+ #
59
+ # * `Aws::InstanceProfileCredentials` - Used for loading credentials
60
+ # from an EC2 IMDS on an EC2 instance.
61
+ #
62
+ # * `Aws::SharedCredentials` - Used for loading credentials from a
63
+ # shared file, such as `~/.aws/config`.
64
+ #
65
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
66
+ #
67
+ # When `:credentials` are not configured directly, the following
68
+ # locations will be searched for credentials:
69
+ #
70
+ # * `Aws.config[:credentials]`
71
+ # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
72
+ # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
73
+ # * `~/.aws/credentials`
74
+ # * `~/.aws/config`
75
+ # * EC2 IMDS instance profile - When used by default, the timeouts are
76
+ # very aggressive. Construct and pass an instance of
77
+ # `Aws::InstanceProfileCredentails` to enable retries and extended
78
+ # timeouts.
79
+ # @option options [required, String] :region
80
+ # The AWS region to connect to. The configured `:region` is
81
+ # used to determine the service `:endpoint`. When not passed,
82
+ # a default `:region` is search for in the following locations:
83
+ #
84
+ # * `Aws.config[:region]`
85
+ # * `ENV['AWS_REGION']`
86
+ # * `ENV['AMAZON_REGION']`
87
+ # * `ENV['AWS_DEFAULT_REGION']`
88
+ # * `~/.aws/credentials`
89
+ # * `~/.aws/config`
90
+ # @option options [String] :access_key_id
91
+ # @option options [Boolean] :convert_params (true)
92
+ # When `true`, an attempt is made to coerce request parameters into
93
+ # the required types.
94
+ # @option options [String] :endpoint
95
+ # The client endpoint is normally constructed from the `:region`
96
+ # option. You should only configure an `:endpoint` when connecting
97
+ # to test endpoints. This should be avalid HTTP(S) URI.
98
+ # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
99
+ # The log formatter.
100
+ # @option options [Symbol] :log_level (:info)
101
+ # The log level to send messages to the `:logger` at.
102
+ # @option options [Logger] :logger
103
+ # The Logger instance to send log messages to. If this option
104
+ # is not set, logging will be disabled.
105
+ # @option options [String] :profile ("default")
106
+ # Used when loading credentials from the shared credentials file
107
+ # at HOME/.aws/credentials. When not specified, 'default' is used.
108
+ # @option options [Integer] :retry_limit (3)
109
+ # The maximum number of times to retry failed requests. Only
110
+ # ~ 500 level server errors and certain ~ 400 level client errors
111
+ # are retried. Generally, these are throttling errors, data
112
+ # checksum errors, networking errors, timeout errors and auth
113
+ # errors from expired credentials.
114
+ # @option options [String] :secret_access_key
115
+ # @option options [String] :session_token
116
+ # @option options [Boolean] :simple_json (false)
117
+ # Disables request parameter conversion, validation, and formatting.
118
+ # Also disable response data type conversions. This option is useful
119
+ # when you want to ensure the highest level of performance by
120
+ # avoiding overhead of walking request parameters and response data
121
+ # structures.
122
+ #
123
+ # When `:simple_json` is enabled, the request parameters hash must
124
+ # be formatted exactly as the DynamoDB API expects.
125
+ # @option options [Boolean] :stub_responses (false)
126
+ # Causes the client to return stubbed responses. By default
127
+ # fake responses are generated and returned. You can specify
128
+ # the response data to return or errors to raise by calling
129
+ # {ClientStubs#stub_responses}. See {ClientStubs} for more information.
130
+ #
131
+ # ** Please note ** When response stubbing is enabled, no HTTP
132
+ # requests are made, and retries are disabled.
133
+ # @option options [Boolean] :validate_params (true)
134
+ # When `true`, request parameters are validated before
135
+ # sending the request.
136
+ def initialize(*args)
137
+ super
138
+ end
139
+
140
+ # @!group API Operations
141
+
142
+ # Returns a list of entities that have been affected by the specified
143
+ # events, based on the specified filter criteria. Entities can refer to
144
+ # individual customer resources, groups of customer resources, or any
145
+ # other construct, depending on the AWS service. Events that have impact
146
+ # beyond that of the affected entities, or where the extent of impact is
147
+ # unknown, include at least one entity indicating this.
148
+ #
149
+ # At least one event ARN is required. Results are sorted by the
150
+ # `lastUpdatedTime` of the entity, starting with the most recent.
151
+ # @option params [required, Types::EntityFilter] :filter
152
+ # Values to narrow the results returned. At least one event ARN is
153
+ # required.
154
+ # @option params [String] :locale
155
+ # The locale (language) to return information in. The default is
156
+ # English.
157
+ # @option params [String] :next_token
158
+ # If the results of a search are large, only a portion of the results
159
+ # are returned, and a `nextToken` pagination token is returned in the
160
+ # response. To retrieve the next batch of results, reissue the search
161
+ # request and include the returned token. When all results have been
162
+ # returned, the response does not contain a pagination token value.
163
+ # @option params [Integer] :max_results
164
+ # The maximum number of items to return in one batch.
165
+ # @return [Types::DescribeAffectedEntitiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
166
+ #
167
+ # * {Types::DescribeAffectedEntitiesResponse#entities #entities} => Array&lt;Types::AffectedEntity&gt;
168
+ # * {Types::DescribeAffectedEntitiesResponse#next_token #nextToken} => String
169
+ #
170
+ # @example Request syntax with placeholder values
171
+ # resp = client.describe_affected_entities({
172
+ # filter: { # required
173
+ # event_arns: ["eventArn"], # required
174
+ # entity_arns: ["entityArn"],
175
+ # entity_values: ["entityValue"],
176
+ # last_updated_times: [
177
+ # {
178
+ # from: Time.now,
179
+ # to: Time.now,
180
+ # },
181
+ # ],
182
+ # tags: [
183
+ # {
184
+ # "tagKey" => "tagValue",
185
+ # },
186
+ # ],
187
+ # status_codes: ["IMPAIRED"], # accepts IMPAIRED, UNIMPAIRED, UNKNOWN
188
+ # },
189
+ # locale: "locale",
190
+ # next_token: "nextToken",
191
+ # max_results: 1,
192
+ # })
193
+ #
194
+ # @example Response structure
195
+ # resp.entities #=> Array
196
+ # resp.entities[0].entity_arn #=> String
197
+ # resp.entities[0].event_arn #=> String
198
+ # resp.entities[0].entity_value #=> String
199
+ # resp.entities[0].aws_account_id #=> String
200
+ # resp.entities[0].last_updated_time #=> Time
201
+ # resp.entities[0].status_code #=> String, one of "IMPAIRED", "UNIMPAIRED", "UNKNOWN"
202
+ # resp.entities[0].tags #=> Hash
203
+ # resp.entities[0].tags["tagKey"] #=> String
204
+ # resp.next_token #=> String
205
+ # @overload describe_affected_entities(params = {})
206
+ # @param [Hash] params ({})
207
+ def describe_affected_entities(params = {}, options = {})
208
+ req = build_request(:describe_affected_entities, params)
209
+ req.send_request(options)
210
+ end
211
+
212
+ # Returns the number of entities that are affected by each of the
213
+ # specified events. If no events are specified, the counts of all
214
+ # affected entities are returned.
215
+ # @option params [Array<String>] :event_arns
216
+ # A list of event ARNs (unique identifiers). For example:
217
+ # `"arn:aws:health:us-east-1::event/AWS_EC2_MAINTENANCE_5331",
218
+ # "arn:aws:health:us-west-1::event/AWS_EBS_LOST_VOLUME_xyz"`
219
+ # @return [Types::DescribeEntityAggregatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
220
+ #
221
+ # * {Types::DescribeEntityAggregatesResponse#entity_aggregates #entityAggregates} => Array&lt;Types::EntityAggregate&gt;
222
+ #
223
+ # @example Request syntax with placeholder values
224
+ # resp = client.describe_entity_aggregates({
225
+ # event_arns: ["eventArn"],
226
+ # })
227
+ #
228
+ # @example Response structure
229
+ # resp.entity_aggregates #=> Array
230
+ # resp.entity_aggregates[0].event_arn #=> String
231
+ # resp.entity_aggregates[0].count #=> Integer
232
+ # @overload describe_entity_aggregates(params = {})
233
+ # @param [Hash] params ({})
234
+ def describe_entity_aggregates(params = {}, options = {})
235
+ req = build_request(:describe_entity_aggregates, params)
236
+ req.send_request(options)
237
+ end
238
+
239
+ # Returns the number of events of each event type (issue, scheduled
240
+ # change, and account notification). If no filter is specified, the
241
+ # counts of all events in each category are returned.
242
+ # @option params [Types::EventFilter] :filter
243
+ # Values to narrow the results returned.
244
+ # @option params [required, String] :aggregate_field
245
+ # The only currently supported value is `eventTypeCategory`.
246
+ # @option params [Integer] :max_results
247
+ # The maximum number of items to return in one batch.
248
+ # @option params [String] :next_token
249
+ # If the results of a search are large, only a portion of the results
250
+ # are returned, and a `nextToken` pagination token is returned in the
251
+ # response. To retrieve the next batch of results, reissue the search
252
+ # request and include the returned token. When all results have been
253
+ # returned, the response does not contain a pagination token value.
254
+ # @return [Types::DescribeEventAggregatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
255
+ #
256
+ # * {Types::DescribeEventAggregatesResponse#event_aggregates #eventAggregates} => Array&lt;Types::EventAggregate&gt;
257
+ # * {Types::DescribeEventAggregatesResponse#next_token #nextToken} => String
258
+ #
259
+ # @example Request syntax with placeholder values
260
+ # resp = client.describe_event_aggregates({
261
+ # filter: {
262
+ # event_arns: ["eventArn"],
263
+ # event_type_codes: ["eventType"],
264
+ # services: ["service"],
265
+ # regions: ["region"],
266
+ # availability_zones: ["availabilityZone"],
267
+ # start_times: [
268
+ # {
269
+ # from: Time.now,
270
+ # to: Time.now,
271
+ # },
272
+ # ],
273
+ # end_times: [
274
+ # {
275
+ # from: Time.now,
276
+ # to: Time.now,
277
+ # },
278
+ # ],
279
+ # last_updated_times: [
280
+ # {
281
+ # from: Time.now,
282
+ # to: Time.now,
283
+ # },
284
+ # ],
285
+ # entity_arns: ["entityArn"],
286
+ # entity_values: ["entityValue"],
287
+ # event_type_categories: ["issue"], # accepts issue, accountNotification, scheduledChange
288
+ # tags: [
289
+ # {
290
+ # "tagKey" => "tagValue",
291
+ # },
292
+ # ],
293
+ # event_status_codes: ["open"], # accepts open, closed, upcoming
294
+ # },
295
+ # aggregate_field: "eventTypeCategory", # required, accepts eventTypeCategory
296
+ # max_results: 1,
297
+ # next_token: "nextToken",
298
+ # })
299
+ #
300
+ # @example Response structure
301
+ # resp.event_aggregates #=> Array
302
+ # resp.event_aggregates[0].aggregate_value #=> String
303
+ # resp.event_aggregates[0].count #=> Integer
304
+ # resp.next_token #=> String
305
+ # @overload describe_event_aggregates(params = {})
306
+ # @param [Hash] params ({})
307
+ def describe_event_aggregates(params = {}, options = {})
308
+ req = build_request(:describe_event_aggregates, params)
309
+ req.send_request(options)
310
+ end
311
+
312
+ # Returns detailed information about one or more specified events.
313
+ # Information includes standard event data (region, service, etc., as
314
+ # returned by DescribeEvents), a detailed event description, and
315
+ # possible additional metadata that depends upon the nature of the
316
+ # event. Affected entities are not included; to retrieve those, use the
317
+ # DescribeAffectedEntities operation.
318
+ #
319
+ # If a specified event cannot be retrieved, an error message is returned
320
+ # for that event.
321
+ # @option params [required, Array<String>] :event_arns
322
+ # A list of event ARNs (unique identifiers). For example:
323
+ # `"arn:aws:health:us-east-1::event/AWS_EC2_MAINTENANCE_5331",
324
+ # "arn:aws:health:us-west-1::event/AWS_EBS_LOST_VOLUME_xyz"`
325
+ # @option params [String] :locale
326
+ # The locale (language) to return information in. The default is
327
+ # English.
328
+ # @return [Types::DescribeEventDetailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
329
+ #
330
+ # * {Types::DescribeEventDetailsResponse#successful_set #successfulSet} => Array&lt;Types::EventDetails&gt;
331
+ # * {Types::DescribeEventDetailsResponse#failed_set #failedSet} => Array&lt;Types::EventDetailsErrorItem&gt;
332
+ #
333
+ # @example Request syntax with placeholder values
334
+ # resp = client.describe_event_details({
335
+ # event_arns: ["eventArn"], # required
336
+ # locale: "locale",
337
+ # })
338
+ #
339
+ # @example Response structure
340
+ # resp.successful_set #=> Array
341
+ # resp.successful_set[0].event.arn #=> String
342
+ # resp.successful_set[0].event.service #=> String
343
+ # resp.successful_set[0].event.event_type_code #=> String
344
+ # resp.successful_set[0].event.event_type_category #=> String, one of "issue", "accountNotification", "scheduledChange"
345
+ # resp.successful_set[0].event.region #=> String
346
+ # resp.successful_set[0].event.availability_zone #=> String
347
+ # resp.successful_set[0].event.start_time #=> Time
348
+ # resp.successful_set[0].event.end_time #=> Time
349
+ # resp.successful_set[0].event.last_updated_time #=> Time
350
+ # resp.successful_set[0].event.status_code #=> String, one of "open", "closed", "upcoming"
351
+ # resp.successful_set[0].event_description.latest_description #=> String
352
+ # resp.successful_set[0].event_metadata #=> Hash
353
+ # resp.successful_set[0].event_metadata["metadataKey"] #=> String
354
+ # resp.failed_set #=> Array
355
+ # resp.failed_set[0].event_arn #=> String
356
+ # resp.failed_set[0].error_name #=> String
357
+ # resp.failed_set[0].error_message #=> String
358
+ # @overload describe_event_details(params = {})
359
+ # @param [Hash] params ({})
360
+ def describe_event_details(params = {}, options = {})
361
+ req = build_request(:describe_event_details, params)
362
+ req.send_request(options)
363
+ end
364
+
365
+ # Returns the event types that meet the specified filter criteria. If no
366
+ # filter criteria are specified, all event types are returned, in no
367
+ # particular order.
368
+ # @option params [Types::EventTypeFilter] :filter
369
+ # Values to narrow the results returned.
370
+ # @option params [String] :locale
371
+ # The locale (language) to return information in. The default is
372
+ # English.
373
+ # @option params [String] :next_token
374
+ # If the results of a search are large, only a portion of the results
375
+ # are returned, and a `nextToken` pagination token is returned in the
376
+ # response. To retrieve the next batch of results, reissue the search
377
+ # request and include the returned token. When all results have been
378
+ # returned, the response does not contain a pagination token value.
379
+ # @option params [Integer] :max_results
380
+ # The maximum number of items to return in one batch.
381
+ # @return [Types::DescribeEventTypesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
382
+ #
383
+ # * {Types::DescribeEventTypesResponse#event_types #eventTypes} => Array&lt;Types::EventType&gt;
384
+ # * {Types::DescribeEventTypesResponse#next_token #nextToken} => String
385
+ #
386
+ # @example Request syntax with placeholder values
387
+ # resp = client.describe_event_types({
388
+ # filter: {
389
+ # event_type_codes: ["eventTypeCode"],
390
+ # services: ["service"],
391
+ # event_type_categories: ["issue"], # accepts issue, accountNotification, scheduledChange
392
+ # },
393
+ # locale: "locale",
394
+ # next_token: "nextToken",
395
+ # max_results: 1,
396
+ # })
397
+ #
398
+ # @example Response structure
399
+ # resp.event_types #=> Array
400
+ # resp.event_types[0].service #=> String
401
+ # resp.event_types[0].code #=> String
402
+ # resp.event_types[0].category #=> String, one of "issue", "accountNotification", "scheduledChange"
403
+ # resp.next_token #=> String
404
+ # @overload describe_event_types(params = {})
405
+ # @param [Hash] params ({})
406
+ def describe_event_types(params = {}, options = {})
407
+ req = build_request(:describe_event_types, params)
408
+ req.send_request(options)
409
+ end
410
+
411
+ # Returns information about events that meet the specified filter
412
+ # criteria. Events are returned in a summary form and do not include the
413
+ # detailed description, any additional metadata that depends on the
414
+ # event type, or any affected resources. To retrieve that information,
415
+ # use the DescribeEventDetails and DescribeAffectedEntities operations.
416
+ #
417
+ # If no filter criteria are specified, all events are returned. Results
418
+ # are sorted by `lastModifiedTime`, starting with the most recent.
419
+ # @option params [Types::EventFilter] :filter
420
+ # Values to narrow the results returned.
421
+ # @option params [String] :next_token
422
+ # If the results of a search are large, only a portion of the results
423
+ # are returned, and a `nextToken` pagination token is returned in the
424
+ # response. To retrieve the next batch of results, reissue the search
425
+ # request and include the returned token. When all results have been
426
+ # returned, the response does not contain a pagination token value.
427
+ # @option params [Integer] :max_results
428
+ # The maximum number of items to return in one batch.
429
+ # @option params [String] :locale
430
+ # The locale (language) to return information in. The default is
431
+ # English.
432
+ # @return [Types::DescribeEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
433
+ #
434
+ # * {Types::DescribeEventsResponse#events #events} => Array&lt;Types::Event&gt;
435
+ # * {Types::DescribeEventsResponse#next_token #nextToken} => String
436
+ #
437
+ # @example Request syntax with placeholder values
438
+ # resp = client.describe_events({
439
+ # filter: {
440
+ # event_arns: ["eventArn"],
441
+ # event_type_codes: ["eventType"],
442
+ # services: ["service"],
443
+ # regions: ["region"],
444
+ # availability_zones: ["availabilityZone"],
445
+ # start_times: [
446
+ # {
447
+ # from: Time.now,
448
+ # to: Time.now,
449
+ # },
450
+ # ],
451
+ # end_times: [
452
+ # {
453
+ # from: Time.now,
454
+ # to: Time.now,
455
+ # },
456
+ # ],
457
+ # last_updated_times: [
458
+ # {
459
+ # from: Time.now,
460
+ # to: Time.now,
461
+ # },
462
+ # ],
463
+ # entity_arns: ["entityArn"],
464
+ # entity_values: ["entityValue"],
465
+ # event_type_categories: ["issue"], # accepts issue, accountNotification, scheduledChange
466
+ # tags: [
467
+ # {
468
+ # "tagKey" => "tagValue",
469
+ # },
470
+ # ],
471
+ # event_status_codes: ["open"], # accepts open, closed, upcoming
472
+ # },
473
+ # next_token: "nextToken",
474
+ # max_results: 1,
475
+ # locale: "locale",
476
+ # })
477
+ #
478
+ # @example Response structure
479
+ # resp.events #=> Array
480
+ # resp.events[0].arn #=> String
481
+ # resp.events[0].service #=> String
482
+ # resp.events[0].event_type_code #=> String
483
+ # resp.events[0].event_type_category #=> String, one of "issue", "accountNotification", "scheduledChange"
484
+ # resp.events[0].region #=> String
485
+ # resp.events[0].availability_zone #=> String
486
+ # resp.events[0].start_time #=> Time
487
+ # resp.events[0].end_time #=> Time
488
+ # resp.events[0].last_updated_time #=> Time
489
+ # resp.events[0].status_code #=> String, one of "open", "closed", "upcoming"
490
+ # resp.next_token #=> String
491
+ # @overload describe_events(params = {})
492
+ # @param [Hash] params ({})
493
+ def describe_events(params = {}, options = {})
494
+ req = build_request(:describe_events, params)
495
+ req.send_request(options)
496
+ end
497
+
498
+ # @!endgroup
499
+
500
+ # @param params ({})
501
+ # @api private
502
+ def build_request(operation_name, params = {})
503
+ handlers = @handlers.for(operation_name)
504
+ context = Seahorse::Client::RequestContext.new(
505
+ operation_name: operation_name,
506
+ operation: config.api.operation(operation_name),
507
+ client: self,
508
+ params: params,
509
+ config: config)
510
+ context[:gem_name] = 'aws-sdk-health'
511
+ context[:gem_version] = '1.0.0.rc2'
512
+ Seahorse::Client::Request.new(handlers, context)
513
+ end
514
+
515
+ # @api private
516
+ # @deprecated
517
+ def waiter_names
518
+ []
519
+ end
520
+
521
+ class << self
522
+
523
+ # @api private
524
+ attr_reader :identifier
525
+
526
+ # @api private
527
+ def errors_module
528
+ Errors
529
+ end
530
+
531
+ end
532
+ end
533
+ end
534
+ end