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 +7 -0
- data/lib/aws-sdk-health.rb +47 -0
- data/lib/aws-sdk-health/client.rb +534 -0
- data/lib/aws-sdk-health/client_api.rb +372 -0
- data/lib/aws-sdk-health/customizations.rb +0 -0
- data/lib/aws-sdk-health/errors.rb +23 -0
- data/lib/aws-sdk-health/resource.rb +25 -0
- data/lib/aws-sdk-health/types.rb +827 -0
- metadata +80 -0
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<Types::AffectedEntity>
|
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<Types::EntityAggregate>
|
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<Types::EventAggregate>
|
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<Types::EventDetails>
|
331
|
+
# * {Types::DescribeEventDetailsResponse#failed_set #failedSet} => Array<Types::EventDetailsErrorItem>
|
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<Types::EventType>
|
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<Types::Event>
|
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
|