aws-sdk-health 1.0.0.rc2

Sign up to get free protection for your applications and to get access to all the features.
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