aws-sdk-inspector 1.0.0.rc1 → 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 +4 -4
- data/lib/aws-sdk-inspector.rb +1 -1
- data/lib/aws-sdk-inspector/client.rb +1417 -1221
- data/lib/aws-sdk-inspector/client_api.rb +999 -1001
- data/lib/aws-sdk-inspector/errors.rb +4 -13
- data/lib/aws-sdk-inspector/resource.rb +12 -14
- data/lib/aws-sdk-inspector/types.rb +2222 -2077
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 529bc71c497a75c18332508ce218e7d95ae3f340
|
4
|
+
data.tar.gz: ad532ff5e345ebd3507bbd939a844d006d4d2c40
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3a6883221752872dd9073d241ee4798a8731adc0c5f64be81b89c8b959060e95de41e0a229fe447c009cada7cca93cc51d4b503292b33c8b5a0ef2c695455935
|
7
|
+
data.tar.gz: 12d2d93addc1a43f462d08e8aa12bb7ef11ac32f9d964a015a633d9b62586f7753d3ca2c637132abc1c190bae3289ef5e36ce296f6cbf6342880a271bfa58c0a
|
data/lib/aws-sdk-inspector.rb
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
# WARNING ABOUT GENERATED CODE
|
2
2
|
#
|
3
|
-
# This file is generated. See the contributing for
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
4
|
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
5
|
#
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
@@ -1,6 +1,6 @@
|
|
1
1
|
# WARNING ABOUT GENERATED CODE
|
2
2
|
#
|
3
|
-
# This file is generated. See the contributing for
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
4
|
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
5
|
#
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
@@ -23,1271 +23,1467 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
|
23
23
|
|
24
24
|
Aws::Plugins::GlobalConfiguration.add_identifier(:inspector)
|
25
25
|
|
26
|
-
module Aws
|
27
|
-
|
28
|
-
class Client < Seahorse::Client::Base
|
26
|
+
module Aws::Inspector
|
27
|
+
class Client < Seahorse::Client::Base
|
29
28
|
|
30
|
-
|
29
|
+
include Aws::ClientStubs
|
31
30
|
|
32
|
-
|
31
|
+
@identifier = :inspector
|
33
32
|
|
34
|
-
|
33
|
+
set_api(ClientApi::API)
|
35
34
|
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
35
|
+
add_plugin(Seahorse::Client::Plugins::ContentLength)
|
36
|
+
add_plugin(Aws::Plugins::CredentialsConfiguration)
|
37
|
+
add_plugin(Aws::Plugins::Logging)
|
38
|
+
add_plugin(Aws::Plugins::ParamConverter)
|
39
|
+
add_plugin(Aws::Plugins::ParamValidator)
|
40
|
+
add_plugin(Aws::Plugins::UserAgent)
|
41
|
+
add_plugin(Aws::Plugins::HelpfulSocketErrors)
|
42
|
+
add_plugin(Aws::Plugins::RetryErrors)
|
43
|
+
add_plugin(Aws::Plugins::GlobalConfiguration)
|
44
|
+
add_plugin(Aws::Plugins::RegionalEndpoint)
|
45
|
+
add_plugin(Aws::Plugins::ResponsePaging)
|
46
|
+
add_plugin(Aws::Plugins::StubResponses)
|
47
|
+
add_plugin(Aws::Plugins::IdempotencyToken)
|
48
|
+
add_plugin(Aws::Plugins::SignatureV4)
|
49
|
+
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
51
50
|
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
51
|
+
# @option options [required, Aws::CredentialProvider] :credentials
|
52
|
+
# Your AWS credentials. This can be an instance of any one of the
|
53
|
+
# following classes:
|
54
|
+
#
|
55
|
+
# * `Aws::Credentials` - Used for configuring static, non-refreshing
|
56
|
+
# credentials.
|
57
|
+
#
|
58
|
+
# * `Aws::InstanceProfileCredentials` - Used for loading credentials
|
59
|
+
# from an EC2 IMDS on an EC2 instance.
|
60
|
+
#
|
61
|
+
# * `Aws::SharedCredentials` - Used for loading credentials from a
|
62
|
+
# shared file, such as `~/.aws/config`.
|
63
|
+
#
|
64
|
+
# * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
|
65
|
+
#
|
66
|
+
# When `:credentials` are not configured directly, the following
|
67
|
+
# locations will be searched for credentials:
|
68
|
+
#
|
69
|
+
# * `Aws.config[:credentials]`
|
70
|
+
# * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
|
71
|
+
# * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
|
72
|
+
# * `~/.aws/credentials`
|
73
|
+
# * `~/.aws/config`
|
74
|
+
# * EC2 IMDS instance profile - When used by default, the timeouts are
|
75
|
+
# very aggressive. Construct and pass an instance of
|
76
|
+
# `Aws::InstanceProfileCredentails` to enable retries and extended
|
77
|
+
# timeouts.
|
78
|
+
#
|
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
|
+
#
|
91
|
+
# @option options [String] :access_key_id
|
92
|
+
#
|
93
|
+
# @option options [Boolean] :convert_params (true)
|
94
|
+
# When `true`, an attempt is made to coerce request parameters into
|
95
|
+
# the required types.
|
96
|
+
#
|
97
|
+
# @option options [String] :endpoint
|
98
|
+
# The client endpoint is normally constructed from the `:region`
|
99
|
+
# option. You should only configure an `:endpoint` when connecting
|
100
|
+
# to test endpoints. This should be avalid HTTP(S) URI.
|
101
|
+
#
|
102
|
+
# @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
|
103
|
+
# The log formatter.
|
104
|
+
#
|
105
|
+
# @option options [Symbol] :log_level (:info)
|
106
|
+
# The log level to send messages to the `:logger` at.
|
107
|
+
#
|
108
|
+
# @option options [Logger] :logger
|
109
|
+
# The Logger instance to send log messages to. If this option
|
110
|
+
# is not set, logging will be disabled.
|
111
|
+
#
|
112
|
+
# @option options [String] :profile ("default")
|
113
|
+
# Used when loading credentials from the shared credentials file
|
114
|
+
# at HOME/.aws/credentials. When not specified, 'default' is used.
|
115
|
+
#
|
116
|
+
# @option options [Integer] :retry_limit (3)
|
117
|
+
# The maximum number of times to retry failed requests. Only
|
118
|
+
# ~ 500 level server errors and certain ~ 400 level client errors
|
119
|
+
# are retried. Generally, these are throttling errors, data
|
120
|
+
# checksum errors, networking errors, timeout errors and auth
|
121
|
+
# errors from expired credentials.
|
122
|
+
#
|
123
|
+
# @option options [String] :secret_access_key
|
124
|
+
#
|
125
|
+
# @option options [String] :session_token
|
126
|
+
#
|
127
|
+
# @option options [Boolean] :simple_json (false)
|
128
|
+
# Disables request parameter conversion, validation, and formatting.
|
129
|
+
# Also disable response data type conversions. This option is useful
|
130
|
+
# when you want to ensure the highest level of performance by
|
131
|
+
# avoiding overhead of walking request parameters and response data
|
132
|
+
# structures.
|
133
|
+
#
|
134
|
+
# When `:simple_json` is enabled, the request parameters hash must
|
135
|
+
# be formatted exactly as the DynamoDB API expects.
|
136
|
+
#
|
137
|
+
# @option options [Boolean] :stub_responses (false)
|
138
|
+
# Causes the client to return stubbed responses. By default
|
139
|
+
# fake responses are generated and returned. You can specify
|
140
|
+
# the response data to return or errors to raise by calling
|
141
|
+
# {ClientStubs#stub_responses}. See {ClientStubs} for more information.
|
142
|
+
#
|
143
|
+
# ** Please note ** When response stubbing is enabled, no HTTP
|
144
|
+
# requests are made, and retries are disabled.
|
145
|
+
#
|
146
|
+
# @option options [Boolean] :validate_params (true)
|
147
|
+
# When `true`, request parameters are validated before
|
148
|
+
# sending the request.
|
149
|
+
#
|
150
|
+
def initialize(*args)
|
151
|
+
super
|
152
|
+
end
|
139
153
|
|
140
|
-
|
154
|
+
# @!group API Operations
|
141
155
|
|
142
|
-
|
143
|
-
|
144
|
-
|
145
|
-
|
146
|
-
|
147
|
-
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
|
166
|
-
|
167
|
-
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
|
172
|
-
|
173
|
-
|
174
|
-
|
175
|
-
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
#
|
181
|
-
#
|
182
|
-
#
|
183
|
-
# [1]: http://docs.aws.amazon.com/inspector/latest/userguide/inspector_applications.html
|
184
|
-
# @option params [required, String] :assessment_target_name
|
185
|
-
# The user-defined name that identifies the assessment target that you
|
186
|
-
# want to create. The name must be unique within the AWS account.
|
187
|
-
# @option params [required, String] :resource_group_arn
|
188
|
-
# The ARN that specifies the resource group that is used to create the
|
189
|
-
# assessment target.
|
190
|
-
# @return [Types::CreateAssessmentTargetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
191
|
-
#
|
192
|
-
# * {Types::CreateAssessmentTargetResponse#assessment_target_arn #assessmentTargetArn} => String
|
193
|
-
#
|
194
|
-
# @example Request syntax with placeholder values
|
195
|
-
# resp = client.create_assessment_target({
|
196
|
-
# assessment_target_name: "AssessmentTargetName", # required
|
197
|
-
# resource_group_arn: "Arn", # required
|
198
|
-
# })
|
199
|
-
#
|
200
|
-
# @example Response structure
|
201
|
-
# resp.assessment_target_arn #=> String
|
202
|
-
# @overload create_assessment_target(params = {})
|
203
|
-
# @param [Hash] params ({})
|
204
|
-
def create_assessment_target(params = {}, options = {})
|
205
|
-
req = build_request(:create_assessment_target, params)
|
206
|
-
req.send_request(options)
|
207
|
-
end
|
156
|
+
# Assigns attributes (key and value pairs) to the findings that are
|
157
|
+
# specified by the ARNs of the findings.
|
158
|
+
#
|
159
|
+
# @option params [required, Array<String>] :finding_arns
|
160
|
+
# The ARNs that specify the findings that you want to assign attributes
|
161
|
+
# to.
|
162
|
+
#
|
163
|
+
# @option params [required, Array<Types::Attribute>] :attributes
|
164
|
+
# The array of attributes that you want to assign to specified findings.
|
165
|
+
#
|
166
|
+
# @return [Types::AddAttributesToFindingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
167
|
+
#
|
168
|
+
# * {Types::AddAttributesToFindingsResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
169
|
+
#
|
170
|
+
# @example Request syntax with placeholder values
|
171
|
+
#
|
172
|
+
# resp = client.add_attributes_to_findings({
|
173
|
+
# finding_arns: ["Arn"], # required
|
174
|
+
# attributes: [ # required
|
175
|
+
# {
|
176
|
+
# key: "AttributeKey", # required
|
177
|
+
# value: "AttributeValue",
|
178
|
+
# },
|
179
|
+
# ],
|
180
|
+
# })
|
181
|
+
#
|
182
|
+
# @example Response structure
|
183
|
+
#
|
184
|
+
# resp.failed_items #=> Hash
|
185
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
186
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
187
|
+
#
|
188
|
+
# @overload add_attributes_to_findings(params = {})
|
189
|
+
# @param [Hash] params ({})
|
190
|
+
def add_attributes_to_findings(params = {}, options = {})
|
191
|
+
req = build_request(:add_attributes_to_findings, params)
|
192
|
+
req.send_request(options)
|
193
|
+
end
|
208
194
|
|
209
|
-
|
210
|
-
|
211
|
-
|
212
|
-
|
213
|
-
|
214
|
-
|
215
|
-
|
216
|
-
|
217
|
-
|
218
|
-
|
219
|
-
|
220
|
-
|
221
|
-
|
222
|
-
|
223
|
-
|
224
|
-
|
225
|
-
|
226
|
-
|
227
|
-
|
228
|
-
|
229
|
-
|
230
|
-
|
231
|
-
|
232
|
-
|
233
|
-
|
234
|
-
|
235
|
-
|
236
|
-
|
237
|
-
|
238
|
-
|
239
|
-
|
240
|
-
|
241
|
-
|
242
|
-
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
# @overload create_assessment_template(params = {})
|
249
|
-
# @param [Hash] params ({})
|
250
|
-
def create_assessment_template(params = {}, options = {})
|
251
|
-
req = build_request(:create_assessment_template, params)
|
252
|
-
req.send_request(options)
|
253
|
-
end
|
195
|
+
# Creates a new assessment target using the ARN of the resource group
|
196
|
+
# that is generated by CreateResourceGroup. You can create up to 50
|
197
|
+
# assessment targets per AWS account. You can run up to 500 concurrent
|
198
|
+
# agents per AWS account. For more information, see [ Amazon Inspector
|
199
|
+
# Assessment Targets][1].
|
200
|
+
#
|
201
|
+
#
|
202
|
+
#
|
203
|
+
# [1]: http://docs.aws.amazon.com/inspector/latest/userguide/inspector_applications.html
|
204
|
+
#
|
205
|
+
# @option params [required, String] :assessment_target_name
|
206
|
+
# The user-defined name that identifies the assessment target that you
|
207
|
+
# want to create. The name must be unique within the AWS account.
|
208
|
+
#
|
209
|
+
# @option params [required, String] :resource_group_arn
|
210
|
+
# The ARN that specifies the resource group that is used to create the
|
211
|
+
# assessment target.
|
212
|
+
#
|
213
|
+
# @return [Types::CreateAssessmentTargetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
214
|
+
#
|
215
|
+
# * {Types::CreateAssessmentTargetResponse#assessment_target_arn #assessment_target_arn} => String
|
216
|
+
#
|
217
|
+
# @example Request syntax with placeholder values
|
218
|
+
#
|
219
|
+
# resp = client.create_assessment_target({
|
220
|
+
# assessment_target_name: "AssessmentTargetName", # required
|
221
|
+
# resource_group_arn: "Arn", # required
|
222
|
+
# })
|
223
|
+
#
|
224
|
+
# @example Response structure
|
225
|
+
#
|
226
|
+
# resp.assessment_target_arn #=> String
|
227
|
+
#
|
228
|
+
# @overload create_assessment_target(params = {})
|
229
|
+
# @param [Hash] params ({})
|
230
|
+
def create_assessment_target(params = {}, options = {})
|
231
|
+
req = build_request(:create_assessment_target, params)
|
232
|
+
req.send_request(options)
|
233
|
+
end
|
254
234
|
|
255
|
-
|
256
|
-
|
257
|
-
|
258
|
-
|
259
|
-
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
|
264
|
-
|
265
|
-
|
266
|
-
|
267
|
-
|
268
|
-
|
269
|
-
|
270
|
-
|
271
|
-
|
272
|
-
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
|
281
|
-
|
282
|
-
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
|
287
|
-
|
235
|
+
# Creates an assessment template for the assessment target that is
|
236
|
+
# specified by the ARN of the assessment target.
|
237
|
+
#
|
238
|
+
# @option params [required, String] :assessment_target_arn
|
239
|
+
# The ARN that specifies the assessment target for which you want to
|
240
|
+
# create the assessment template.
|
241
|
+
#
|
242
|
+
# @option params [required, String] :assessment_template_name
|
243
|
+
# The user-defined name that identifies the assessment template that you
|
244
|
+
# want to create. You can create several assessment templates for an
|
245
|
+
# assessment target. The names of the assessment templates that
|
246
|
+
# correspond to a particular assessment target must be unique.
|
247
|
+
#
|
248
|
+
# @option params [required, Integer] :duration_in_seconds
|
249
|
+
# The duration of the assessment run in seconds. The default value is
|
250
|
+
# 3600 seconds (one hour).
|
251
|
+
#
|
252
|
+
# @option params [required, Array<String>] :rules_package_arns
|
253
|
+
# The ARNs that specify the rules packages that you want to attach to
|
254
|
+
# the assessment template.
|
255
|
+
#
|
256
|
+
# @option params [Array<Types::Attribute>] :user_attributes_for_findings
|
257
|
+
# The user-defined attributes that are assigned to every finding that is
|
258
|
+
# generated by the assessment run that uses this assessment template.
|
259
|
+
#
|
260
|
+
# @return [Types::CreateAssessmentTemplateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
261
|
+
#
|
262
|
+
# * {Types::CreateAssessmentTemplateResponse#assessment_template_arn #assessment_template_arn} => String
|
263
|
+
#
|
264
|
+
# @example Request syntax with placeholder values
|
265
|
+
#
|
266
|
+
# resp = client.create_assessment_template({
|
267
|
+
# assessment_target_arn: "Arn", # required
|
268
|
+
# assessment_template_name: "AssessmentTemplateName", # required
|
269
|
+
# duration_in_seconds: 1, # required
|
270
|
+
# rules_package_arns: ["Arn"], # required
|
271
|
+
# user_attributes_for_findings: [
|
272
|
+
# {
|
273
|
+
# key: "AttributeKey", # required
|
274
|
+
# value: "AttributeValue",
|
275
|
+
# },
|
276
|
+
# ],
|
277
|
+
# })
|
278
|
+
#
|
279
|
+
# @example Response structure
|
280
|
+
#
|
281
|
+
# resp.assessment_template_arn #=> String
|
282
|
+
#
|
283
|
+
# @overload create_assessment_template(params = {})
|
284
|
+
# @param [Hash] params ({})
|
285
|
+
def create_assessment_template(params = {}, options = {})
|
286
|
+
req = build_request(:create_assessment_template, params)
|
287
|
+
req.send_request(options)
|
288
|
+
end
|
288
289
|
|
289
|
-
|
290
|
-
|
291
|
-
|
292
|
-
|
293
|
-
|
294
|
-
|
295
|
-
|
296
|
-
|
297
|
-
|
298
|
-
|
299
|
-
|
300
|
-
|
301
|
-
|
302
|
-
|
303
|
-
|
304
|
-
|
290
|
+
# Creates a resource group using the specified set of tags (key and
|
291
|
+
# value pairs) that are used to select the EC2 instances to be included
|
292
|
+
# in an Amazon Inspector assessment target. The created resource group
|
293
|
+
# is then used to create an Amazon Inspector assessment target. For more
|
294
|
+
# information, see CreateAssessmentTarget.
|
295
|
+
#
|
296
|
+
# @option params [required, Array<Types::ResourceGroupTag>] :resource_group_tags
|
297
|
+
# A collection of keys and an array of possible values,
|
298
|
+
# '\[\\\{"key":"key1","values":\["Value1","Value2"\]\\},\\\{"key":"Key2","values":\["Value3"\]\\}\]'.
|
299
|
+
#
|
300
|
+
# For
|
301
|
+
# example,'\[\\\{"key":"Name","values":\["TestEC2Instance"\]\\}\]'.
|
302
|
+
#
|
303
|
+
# @return [Types::CreateResourceGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
304
|
+
#
|
305
|
+
# * {Types::CreateResourceGroupResponse#resource_group_arn #resource_group_arn} => String
|
306
|
+
#
|
307
|
+
# @example Request syntax with placeholder values
|
308
|
+
#
|
309
|
+
# resp = client.create_resource_group({
|
310
|
+
# resource_group_tags: [ # required
|
311
|
+
# {
|
312
|
+
# key: "TagKey", # required
|
313
|
+
# value: "TagValue",
|
314
|
+
# },
|
315
|
+
# ],
|
316
|
+
# })
|
317
|
+
#
|
318
|
+
# @example Response structure
|
319
|
+
#
|
320
|
+
# resp.resource_group_arn #=> String
|
321
|
+
#
|
322
|
+
# @overload create_resource_group(params = {})
|
323
|
+
# @param [Hash] params ({})
|
324
|
+
def create_resource_group(params = {}, options = {})
|
325
|
+
req = build_request(:create_resource_group, params)
|
326
|
+
req.send_request(options)
|
327
|
+
end
|
305
328
|
|
306
|
-
|
307
|
-
|
308
|
-
|
309
|
-
|
310
|
-
|
311
|
-
|
312
|
-
|
313
|
-
|
314
|
-
|
315
|
-
|
316
|
-
|
317
|
-
|
318
|
-
|
319
|
-
|
320
|
-
|
321
|
-
|
329
|
+
# Deletes the assessment run that is specified by the ARN of the
|
330
|
+
# assessment run.
|
331
|
+
#
|
332
|
+
# @option params [required, String] :assessment_run_arn
|
333
|
+
# The ARN that specifies the assessment run that you want to delete.
|
334
|
+
#
|
335
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
336
|
+
#
|
337
|
+
# @example Request syntax with placeholder values
|
338
|
+
#
|
339
|
+
# resp = client.delete_assessment_run({
|
340
|
+
# assessment_run_arn: "Arn", # required
|
341
|
+
# })
|
342
|
+
#
|
343
|
+
# @overload delete_assessment_run(params = {})
|
344
|
+
# @param [Hash] params ({})
|
345
|
+
def delete_assessment_run(params = {}, options = {})
|
346
|
+
req = build_request(:delete_assessment_run, params)
|
347
|
+
req.send_request(options)
|
348
|
+
end
|
322
349
|
|
323
|
-
|
324
|
-
|
325
|
-
|
326
|
-
|
327
|
-
|
328
|
-
|
329
|
-
|
330
|
-
|
331
|
-
|
332
|
-
|
333
|
-
|
334
|
-
|
335
|
-
|
336
|
-
|
337
|
-
|
338
|
-
|
339
|
-
|
350
|
+
# Deletes the assessment target that is specified by the ARN of the
|
351
|
+
# assessment target.
|
352
|
+
#
|
353
|
+
# @option params [required, String] :assessment_target_arn
|
354
|
+
# The ARN that specifies the assessment target that you want to delete.
|
355
|
+
#
|
356
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
357
|
+
#
|
358
|
+
# @example Request syntax with placeholder values
|
359
|
+
#
|
360
|
+
# resp = client.delete_assessment_target({
|
361
|
+
# assessment_target_arn: "Arn", # required
|
362
|
+
# })
|
363
|
+
#
|
364
|
+
# @overload delete_assessment_target(params = {})
|
365
|
+
# @param [Hash] params ({})
|
366
|
+
def delete_assessment_target(params = {}, options = {})
|
367
|
+
req = build_request(:delete_assessment_target, params)
|
368
|
+
req.send_request(options)
|
369
|
+
end
|
340
370
|
|
341
|
-
|
342
|
-
|
343
|
-
|
344
|
-
|
345
|
-
|
346
|
-
|
347
|
-
|
348
|
-
|
349
|
-
|
350
|
-
|
351
|
-
|
352
|
-
|
353
|
-
|
354
|
-
|
355
|
-
|
356
|
-
|
357
|
-
|
358
|
-
|
359
|
-
|
360
|
-
|
361
|
-
|
362
|
-
# resp.assessment_runs[0].rules_package_arns #=> Array
|
363
|
-
# resp.assessment_runs[0].rules_package_arns[0] #=> String
|
364
|
-
# resp.assessment_runs[0].user_attributes_for_findings #=> Array
|
365
|
-
# resp.assessment_runs[0].user_attributes_for_findings[0].key #=> String
|
366
|
-
# resp.assessment_runs[0].user_attributes_for_findings[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
367
|
-
# resp.assessment_runs[0].created_at #=> Time
|
368
|
-
# resp.assessment_runs[0].started_at #=> Time
|
369
|
-
# resp.assessment_runs[0].completed_at #=> Time
|
370
|
-
# resp.assessment_runs[0].state_changed_at #=> Time
|
371
|
-
# resp.assessment_runs[0].data_collected #=> Boolean
|
372
|
-
# resp.assessment_runs[0].state_changes #=> Array
|
373
|
-
# resp.assessment_runs[0].state_changes[0].state_changed_at #=> Time
|
374
|
-
# resp.assessment_runs[0].state_changes[0].state #=> String, one of "CREATED", "START_DATA_COLLECTION_PENDING", "START_DATA_COLLECTION_IN_PROGRESS", "COLLECTING_DATA", "STOP_DATA_COLLECTION_PENDING", "DATA_COLLECTED", "EVALUATING_RULES", "FAILED", "COMPLETED", "COMPLETED_WITH_ERRORS"
|
375
|
-
# resp.assessment_runs[0].notifications #=> Array
|
376
|
-
# resp.assessment_runs[0].notifications[0].date #=> Time
|
377
|
-
# resp.assessment_runs[0].notifications[0].event #=> String, one of "ASSESSMENT_RUN_STARTED", "ASSESSMENT_RUN_COMPLETED", "ASSESSMENT_RUN_STATE_CHANGED", "FINDING_REPORTED", "OTHER"
|
378
|
-
# resp.assessment_runs[0].notifications[0].message #=> String
|
379
|
-
# resp.assessment_runs[0].notifications[0].error #=> Boolean
|
380
|
-
# resp.assessment_runs[0].notifications[0].sns_topic_arn #=> String
|
381
|
-
# resp.assessment_runs[0].notifications[0].sns_publish_status_code #=> String, one of "SUCCESS", "TOPIC_DOES_NOT_EXIST", "ACCESS_DENIED", "INTERNAL_ERROR"
|
382
|
-
# resp.failed_items #=> Hash
|
383
|
-
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
384
|
-
# resp.failed_items["Arn"].retryable #=> Boolean
|
385
|
-
# @overload describe_assessment_runs(params = {})
|
386
|
-
# @param [Hash] params ({})
|
387
|
-
def describe_assessment_runs(params = {}, options = {})
|
388
|
-
req = build_request(:describe_assessment_runs, params)
|
389
|
-
req.send_request(options)
|
390
|
-
end
|
371
|
+
# Deletes the assessment template that is specified by the ARN of the
|
372
|
+
# assessment template.
|
373
|
+
#
|
374
|
+
# @option params [required, String] :assessment_template_arn
|
375
|
+
# The ARN that specifies the assessment template that you want to
|
376
|
+
# delete.
|
377
|
+
#
|
378
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
379
|
+
#
|
380
|
+
# @example Request syntax with placeholder values
|
381
|
+
#
|
382
|
+
# resp = client.delete_assessment_template({
|
383
|
+
# assessment_template_arn: "Arn", # required
|
384
|
+
# })
|
385
|
+
#
|
386
|
+
# @overload delete_assessment_template(params = {})
|
387
|
+
# @param [Hash] params ({})
|
388
|
+
def delete_assessment_template(params = {}, options = {})
|
389
|
+
req = build_request(:delete_assessment_template, params)
|
390
|
+
req.send_request(options)
|
391
|
+
end
|
391
392
|
|
392
|
-
|
393
|
-
|
394
|
-
|
395
|
-
|
396
|
-
|
397
|
-
|
398
|
-
|
399
|
-
|
400
|
-
|
401
|
-
|
402
|
-
|
403
|
-
|
404
|
-
|
405
|
-
|
406
|
-
|
407
|
-
|
408
|
-
|
409
|
-
|
410
|
-
|
411
|
-
|
412
|
-
|
413
|
-
|
414
|
-
|
415
|
-
|
416
|
-
|
417
|
-
|
418
|
-
|
419
|
-
|
420
|
-
|
421
|
-
|
422
|
-
|
393
|
+
# Describes the assessment runs that are specified by the ARNs of the
|
394
|
+
# assessment runs.
|
395
|
+
#
|
396
|
+
# @option params [required, Array<String>] :assessment_run_arns
|
397
|
+
# The ARN that specifies the assessment run that you want to describe.
|
398
|
+
#
|
399
|
+
# @return [Types::DescribeAssessmentRunsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
400
|
+
#
|
401
|
+
# * {Types::DescribeAssessmentRunsResponse#assessment_runs #assessment_runs} => Array<Types::AssessmentRun>
|
402
|
+
# * {Types::DescribeAssessmentRunsResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
403
|
+
#
|
404
|
+
# @example Request syntax with placeholder values
|
405
|
+
#
|
406
|
+
# resp = client.describe_assessment_runs({
|
407
|
+
# assessment_run_arns: ["Arn"], # required
|
408
|
+
# })
|
409
|
+
#
|
410
|
+
# @example Response structure
|
411
|
+
#
|
412
|
+
# resp.assessment_runs #=> Array
|
413
|
+
# resp.assessment_runs[0].arn #=> String
|
414
|
+
# resp.assessment_runs[0].name #=> String
|
415
|
+
# resp.assessment_runs[0].assessment_template_arn #=> String
|
416
|
+
# resp.assessment_runs[0].state #=> String, one of "CREATED", "START_DATA_COLLECTION_PENDING", "START_DATA_COLLECTION_IN_PROGRESS", "COLLECTING_DATA", "STOP_DATA_COLLECTION_PENDING", "DATA_COLLECTED", "EVALUATING_RULES", "FAILED", "COMPLETED", "COMPLETED_WITH_ERRORS"
|
417
|
+
# resp.assessment_runs[0].duration_in_seconds #=> Integer
|
418
|
+
# resp.assessment_runs[0].rules_package_arns #=> Array
|
419
|
+
# resp.assessment_runs[0].rules_package_arns[0] #=> String
|
420
|
+
# resp.assessment_runs[0].user_attributes_for_findings #=> Array
|
421
|
+
# resp.assessment_runs[0].user_attributes_for_findings[0].key #=> String
|
422
|
+
# resp.assessment_runs[0].user_attributes_for_findings[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
423
|
+
# resp.assessment_runs[0].created_at #=> Time
|
424
|
+
# resp.assessment_runs[0].started_at #=> Time
|
425
|
+
# resp.assessment_runs[0].completed_at #=> Time
|
426
|
+
# resp.assessment_runs[0].state_changed_at #=> Time
|
427
|
+
# resp.assessment_runs[0].data_collected #=> Boolean
|
428
|
+
# resp.assessment_runs[0].state_changes #=> Array
|
429
|
+
# resp.assessment_runs[0].state_changes[0].state_changed_at #=> Time
|
430
|
+
# resp.assessment_runs[0].state_changes[0].state #=> String, one of "CREATED", "START_DATA_COLLECTION_PENDING", "START_DATA_COLLECTION_IN_PROGRESS", "COLLECTING_DATA", "STOP_DATA_COLLECTION_PENDING", "DATA_COLLECTED", "EVALUATING_RULES", "FAILED", "COMPLETED", "COMPLETED_WITH_ERRORS"
|
431
|
+
# resp.assessment_runs[0].notifications #=> Array
|
432
|
+
# resp.assessment_runs[0].notifications[0].date #=> Time
|
433
|
+
# resp.assessment_runs[0].notifications[0].event #=> String, one of "ASSESSMENT_RUN_STARTED", "ASSESSMENT_RUN_COMPLETED", "ASSESSMENT_RUN_STATE_CHANGED", "FINDING_REPORTED", "OTHER"
|
434
|
+
# resp.assessment_runs[0].notifications[0].message #=> String
|
435
|
+
# resp.assessment_runs[0].notifications[0].error #=> Boolean
|
436
|
+
# resp.assessment_runs[0].notifications[0].sns_topic_arn #=> String
|
437
|
+
# resp.assessment_runs[0].notifications[0].sns_publish_status_code #=> String, one of "SUCCESS", "TOPIC_DOES_NOT_EXIST", "ACCESS_DENIED", "INTERNAL_ERROR"
|
438
|
+
# resp.failed_items #=> Hash
|
439
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
440
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
441
|
+
#
|
442
|
+
# @overload describe_assessment_runs(params = {})
|
443
|
+
# @param [Hash] params ({})
|
444
|
+
def describe_assessment_runs(params = {}, options = {})
|
445
|
+
req = build_request(:describe_assessment_runs, params)
|
446
|
+
req.send_request(options)
|
447
|
+
end
|
423
448
|
|
424
|
-
|
425
|
-
|
426
|
-
|
427
|
-
|
428
|
-
|
429
|
-
|
430
|
-
|
431
|
-
|
432
|
-
|
433
|
-
|
434
|
-
|
435
|
-
|
436
|
-
|
437
|
-
|
438
|
-
|
439
|
-
|
440
|
-
|
441
|
-
|
442
|
-
|
443
|
-
|
444
|
-
|
445
|
-
|
446
|
-
|
447
|
-
|
448
|
-
|
449
|
-
|
450
|
-
|
451
|
-
|
452
|
-
|
453
|
-
|
454
|
-
|
455
|
-
|
456
|
-
|
457
|
-
|
458
|
-
|
459
|
-
|
449
|
+
# Describes the assessment targets that are specified by the ARNs of the
|
450
|
+
# assessment targets.
|
451
|
+
#
|
452
|
+
# @option params [required, Array<String>] :assessment_target_arns
|
453
|
+
# The ARNs that specifies the assessment targets that you want to
|
454
|
+
# describe.
|
455
|
+
#
|
456
|
+
# @return [Types::DescribeAssessmentTargetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
457
|
+
#
|
458
|
+
# * {Types::DescribeAssessmentTargetsResponse#assessment_targets #assessment_targets} => Array<Types::AssessmentTarget>
|
459
|
+
# * {Types::DescribeAssessmentTargetsResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
460
|
+
#
|
461
|
+
# @example Request syntax with placeholder values
|
462
|
+
#
|
463
|
+
# resp = client.describe_assessment_targets({
|
464
|
+
# assessment_target_arns: ["Arn"], # required
|
465
|
+
# })
|
466
|
+
#
|
467
|
+
# @example Response structure
|
468
|
+
#
|
469
|
+
# resp.assessment_targets #=> Array
|
470
|
+
# resp.assessment_targets[0].arn #=> String
|
471
|
+
# resp.assessment_targets[0].name #=> String
|
472
|
+
# resp.assessment_targets[0].resource_group_arn #=> String
|
473
|
+
# resp.assessment_targets[0].created_at #=> Time
|
474
|
+
# resp.assessment_targets[0].updated_at #=> Time
|
475
|
+
# resp.failed_items #=> Hash
|
476
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
477
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
478
|
+
#
|
479
|
+
# @overload describe_assessment_targets(params = {})
|
480
|
+
# @param [Hash] params ({})
|
481
|
+
def describe_assessment_targets(params = {}, options = {})
|
482
|
+
req = build_request(:describe_assessment_targets, params)
|
483
|
+
req.send_request(options)
|
484
|
+
end
|
460
485
|
|
461
|
-
|
462
|
-
|
463
|
-
|
464
|
-
|
465
|
-
|
466
|
-
|
467
|
-
|
468
|
-
|
469
|
-
|
470
|
-
|
471
|
-
|
472
|
-
|
473
|
-
|
474
|
-
|
475
|
-
|
476
|
-
|
477
|
-
|
478
|
-
|
486
|
+
# Describes the assessment templates that are specified by the ARNs of
|
487
|
+
# the assessment templates.
|
488
|
+
#
|
489
|
+
# @option params [required, Array<String>] :assessment_template_arns
|
490
|
+
#
|
491
|
+
# @return [Types::DescribeAssessmentTemplatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
492
|
+
#
|
493
|
+
# * {Types::DescribeAssessmentTemplatesResponse#assessment_templates #assessment_templates} => Array<Types::AssessmentTemplate>
|
494
|
+
# * {Types::DescribeAssessmentTemplatesResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
495
|
+
#
|
496
|
+
# @example Request syntax with placeholder values
|
497
|
+
#
|
498
|
+
# resp = client.describe_assessment_templates({
|
499
|
+
# assessment_template_arns: ["Arn"], # required
|
500
|
+
# })
|
501
|
+
#
|
502
|
+
# @example Response structure
|
503
|
+
#
|
504
|
+
# resp.assessment_templates #=> Array
|
505
|
+
# resp.assessment_templates[0].arn #=> String
|
506
|
+
# resp.assessment_templates[0].name #=> String
|
507
|
+
# resp.assessment_templates[0].assessment_target_arn #=> String
|
508
|
+
# resp.assessment_templates[0].duration_in_seconds #=> Integer
|
509
|
+
# resp.assessment_templates[0].rules_package_arns #=> Array
|
510
|
+
# resp.assessment_templates[0].rules_package_arns[0] #=> String
|
511
|
+
# resp.assessment_templates[0].user_attributes_for_findings #=> Array
|
512
|
+
# resp.assessment_templates[0].user_attributes_for_findings[0].key #=> String
|
513
|
+
# resp.assessment_templates[0].user_attributes_for_findings[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
514
|
+
# resp.assessment_templates[0].created_at #=> Time
|
515
|
+
# resp.failed_items #=> Hash
|
516
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
517
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
518
|
+
#
|
519
|
+
# @overload describe_assessment_templates(params = {})
|
520
|
+
# @param [Hash] params ({})
|
521
|
+
def describe_assessment_templates(params = {}, options = {})
|
522
|
+
req = build_request(:describe_assessment_templates, params)
|
523
|
+
req.send_request(options)
|
524
|
+
end
|
479
525
|
|
480
|
-
|
481
|
-
|
482
|
-
|
483
|
-
|
484
|
-
|
485
|
-
|
486
|
-
|
487
|
-
|
488
|
-
|
489
|
-
|
490
|
-
|
491
|
-
|
492
|
-
|
493
|
-
|
494
|
-
|
495
|
-
|
496
|
-
|
497
|
-
|
498
|
-
|
499
|
-
|
500
|
-
|
501
|
-
# resp.findings[0].service #=> String
|
502
|
-
# resp.findings[0].service_attributes.schema_version #=> Integer
|
503
|
-
# resp.findings[0].service_attributes.assessment_run_arn #=> String
|
504
|
-
# resp.findings[0].service_attributes.rules_package_arn #=> String
|
505
|
-
# resp.findings[0].asset_type #=> String, one of "ec2-instance"
|
506
|
-
# resp.findings[0].asset_attributes.schema_version #=> Integer
|
507
|
-
# resp.findings[0].asset_attributes.agent_id #=> String
|
508
|
-
# resp.findings[0].asset_attributes.auto_scaling_group #=> String
|
509
|
-
# resp.findings[0].asset_attributes.ami_id #=> String
|
510
|
-
# resp.findings[0].asset_attributes.hostname #=> String
|
511
|
-
# resp.findings[0].asset_attributes.ipv4_addresses #=> Array
|
512
|
-
# resp.findings[0].asset_attributes.ipv4_addresses[0] #=> String
|
513
|
-
# resp.findings[0].id #=> String
|
514
|
-
# resp.findings[0].title #=> String
|
515
|
-
# resp.findings[0].description #=> String
|
516
|
-
# resp.findings[0].recommendation #=> String
|
517
|
-
# resp.findings[0].severity #=> String, one of "Low", "Medium", "High", "Informational", "Undefined"
|
518
|
-
# resp.findings[0].numeric_severity #=> Float
|
519
|
-
# resp.findings[0].confidence #=> Integer
|
520
|
-
# resp.findings[0].indicator_of_compromise #=> Boolean
|
521
|
-
# resp.findings[0].attributes #=> Array
|
522
|
-
# resp.findings[0].attributes[0].key #=> String
|
523
|
-
# resp.findings[0].attributes[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
524
|
-
# resp.findings[0].user_attributes #=> Array
|
525
|
-
# resp.findings[0].user_attributes[0].key #=> String
|
526
|
-
# resp.findings[0].user_attributes[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
527
|
-
# resp.findings[0].created_at #=> Time
|
528
|
-
# resp.findings[0].updated_at #=> Time
|
529
|
-
# resp.failed_items #=> Hash
|
530
|
-
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
531
|
-
# resp.failed_items["Arn"].retryable #=> Boolean
|
532
|
-
# @overload describe_findings(params = {})
|
533
|
-
# @param [Hash] params ({})
|
534
|
-
def describe_findings(params = {}, options = {})
|
535
|
-
req = build_request(:describe_findings, params)
|
536
|
-
req.send_request(options)
|
537
|
-
end
|
526
|
+
# Describes the IAM role that enables Amazon Inspector to access your
|
527
|
+
# AWS account.
|
528
|
+
#
|
529
|
+
# @return [Types::DescribeCrossAccountAccessRoleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
530
|
+
#
|
531
|
+
# * {Types::DescribeCrossAccountAccessRoleResponse#role_arn #role_arn} => String
|
532
|
+
# * {Types::DescribeCrossAccountAccessRoleResponse#valid #valid} => Boolean
|
533
|
+
# * {Types::DescribeCrossAccountAccessRoleResponse#registered_at #registered_at} => Time
|
534
|
+
#
|
535
|
+
# @example Response structure
|
536
|
+
#
|
537
|
+
# resp.role_arn #=> String
|
538
|
+
# resp.valid #=> Boolean
|
539
|
+
# resp.registered_at #=> Time
|
540
|
+
#
|
541
|
+
# @overload describe_cross_account_access_role(params = {})
|
542
|
+
# @param [Hash] params ({})
|
543
|
+
def describe_cross_account_access_role(params = {}, options = {})
|
544
|
+
req = build_request(:describe_cross_account_access_role, params)
|
545
|
+
req.send_request(options)
|
546
|
+
end
|
538
547
|
|
539
|
-
|
540
|
-
|
541
|
-
|
542
|
-
|
543
|
-
|
544
|
-
|
545
|
-
|
546
|
-
|
547
|
-
|
548
|
-
|
549
|
-
|
550
|
-
|
551
|
-
|
552
|
-
|
553
|
-
|
554
|
-
|
555
|
-
|
556
|
-
|
557
|
-
|
558
|
-
|
559
|
-
|
560
|
-
|
561
|
-
|
562
|
-
|
563
|
-
|
564
|
-
|
565
|
-
|
566
|
-
|
567
|
-
|
568
|
-
|
548
|
+
# Describes the findings that are specified by the ARNs of the findings.
|
549
|
+
#
|
550
|
+
# @option params [required, Array<String>] :finding_arns
|
551
|
+
# The ARN that specifies the finding that you want to describe.
|
552
|
+
#
|
553
|
+
# @option params [String] :locale
|
554
|
+
# The locale into which you want to translate a finding description,
|
555
|
+
# recommendation, and the short description that identifies the finding.
|
556
|
+
#
|
557
|
+
# @return [Types::DescribeFindingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
558
|
+
#
|
559
|
+
# * {Types::DescribeFindingsResponse#findings #findings} => Array<Types::Finding>
|
560
|
+
# * {Types::DescribeFindingsResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
561
|
+
#
|
562
|
+
# @example Request syntax with placeholder values
|
563
|
+
#
|
564
|
+
# resp = client.describe_findings({
|
565
|
+
# finding_arns: ["Arn"], # required
|
566
|
+
# locale: "EN_US", # accepts EN_US
|
567
|
+
# })
|
568
|
+
#
|
569
|
+
# @example Response structure
|
570
|
+
#
|
571
|
+
# resp.findings #=> Array
|
572
|
+
# resp.findings[0].arn #=> String
|
573
|
+
# resp.findings[0].schema_version #=> Integer
|
574
|
+
# resp.findings[0].service #=> String
|
575
|
+
# resp.findings[0].service_attributes.schema_version #=> Integer
|
576
|
+
# resp.findings[0].service_attributes.assessment_run_arn #=> String
|
577
|
+
# resp.findings[0].service_attributes.rules_package_arn #=> String
|
578
|
+
# resp.findings[0].asset_type #=> String, one of "ec2-instance"
|
579
|
+
# resp.findings[0].asset_attributes.schema_version #=> Integer
|
580
|
+
# resp.findings[0].asset_attributes.agent_id #=> String
|
581
|
+
# resp.findings[0].asset_attributes.auto_scaling_group #=> String
|
582
|
+
# resp.findings[0].asset_attributes.ami_id #=> String
|
583
|
+
# resp.findings[0].asset_attributes.hostname #=> String
|
584
|
+
# resp.findings[0].asset_attributes.ipv4_addresses #=> Array
|
585
|
+
# resp.findings[0].asset_attributes.ipv4_addresses[0] #=> String
|
586
|
+
# resp.findings[0].id #=> String
|
587
|
+
# resp.findings[0].title #=> String
|
588
|
+
# resp.findings[0].description #=> String
|
589
|
+
# resp.findings[0].recommendation #=> String
|
590
|
+
# resp.findings[0].severity #=> String, one of "Low", "Medium", "High", "Informational", "Undefined"
|
591
|
+
# resp.findings[0].numeric_severity #=> Float
|
592
|
+
# resp.findings[0].confidence #=> Integer
|
593
|
+
# resp.findings[0].indicator_of_compromise #=> Boolean
|
594
|
+
# resp.findings[0].attributes #=> Array
|
595
|
+
# resp.findings[0].attributes[0].key #=> String
|
596
|
+
# resp.findings[0].attributes[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
597
|
+
# resp.findings[0].user_attributes #=> Array
|
598
|
+
# resp.findings[0].user_attributes[0].key #=> String
|
599
|
+
# resp.findings[0].user_attributes[0].value #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
600
|
+
# resp.findings[0].created_at #=> Time
|
601
|
+
# resp.findings[0].updated_at #=> Time
|
602
|
+
# resp.failed_items #=> Hash
|
603
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
604
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
605
|
+
#
|
606
|
+
# @overload describe_findings(params = {})
|
607
|
+
# @param [Hash] params ({})
|
608
|
+
def describe_findings(params = {}, options = {})
|
609
|
+
req = build_request(:describe_findings, params)
|
610
|
+
req.send_request(options)
|
611
|
+
end
|
569
612
|
|
570
|
-
|
571
|
-
|
572
|
-
|
573
|
-
|
574
|
-
|
575
|
-
|
576
|
-
|
577
|
-
|
578
|
-
|
579
|
-
|
580
|
-
|
581
|
-
|
582
|
-
|
583
|
-
|
584
|
-
|
585
|
-
|
586
|
-
|
587
|
-
|
588
|
-
|
589
|
-
|
590
|
-
|
591
|
-
|
592
|
-
|
593
|
-
|
594
|
-
|
595
|
-
|
596
|
-
|
597
|
-
|
598
|
-
|
599
|
-
|
600
|
-
|
601
|
-
|
602
|
-
|
603
|
-
|
613
|
+
# Describes the resource groups that are specified by the ARNs of the
|
614
|
+
# resource groups.
|
615
|
+
#
|
616
|
+
# @option params [required, Array<String>] :resource_group_arns
|
617
|
+
# The ARN that specifies the resource group that you want to describe.
|
618
|
+
#
|
619
|
+
# @return [Types::DescribeResourceGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
620
|
+
#
|
621
|
+
# * {Types::DescribeResourceGroupsResponse#resource_groups #resource_groups} => Array<Types::ResourceGroup>
|
622
|
+
# * {Types::DescribeResourceGroupsResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
623
|
+
#
|
624
|
+
# @example Request syntax with placeholder values
|
625
|
+
#
|
626
|
+
# resp = client.describe_resource_groups({
|
627
|
+
# resource_group_arns: ["Arn"], # required
|
628
|
+
# })
|
629
|
+
#
|
630
|
+
# @example Response structure
|
631
|
+
#
|
632
|
+
# resp.resource_groups #=> Array
|
633
|
+
# resp.resource_groups[0].arn #=> String
|
634
|
+
# resp.resource_groups[0].tags #=> Array
|
635
|
+
# resp.resource_groups[0].tags[0].key #=> String
|
636
|
+
# resp.resource_groups[0].tags[0].value #=> String
|
637
|
+
# resp.resource_groups[0].created_at #=> Time
|
638
|
+
# resp.failed_items #=> Hash
|
639
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
640
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
641
|
+
#
|
642
|
+
# @overload describe_resource_groups(params = {})
|
643
|
+
# @param [Hash] params ({})
|
644
|
+
def describe_resource_groups(params = {}, options = {})
|
645
|
+
req = build_request(:describe_resource_groups, params)
|
646
|
+
req.send_request(options)
|
647
|
+
end
|
604
648
|
|
605
|
-
|
606
|
-
|
607
|
-
|
608
|
-
|
609
|
-
|
610
|
-
|
611
|
-
|
612
|
-
|
613
|
-
|
614
|
-
|
615
|
-
|
616
|
-
|
617
|
-
|
618
|
-
|
619
|
-
|
620
|
-
|
621
|
-
|
622
|
-
|
623
|
-
|
624
|
-
|
625
|
-
|
626
|
-
|
627
|
-
|
628
|
-
|
629
|
-
|
649
|
+
# Describes the rules packages that are specified by the ARNs of the
|
650
|
+
# rules packages.
|
651
|
+
#
|
652
|
+
# @option params [required, Array<String>] :rules_package_arns
|
653
|
+
# The ARN that specifies the rules package that you want to describe.
|
654
|
+
#
|
655
|
+
# @option params [String] :locale
|
656
|
+
# The locale that you want to translate a rules package description
|
657
|
+
# into.
|
658
|
+
#
|
659
|
+
# @return [Types::DescribeRulesPackagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
660
|
+
#
|
661
|
+
# * {Types::DescribeRulesPackagesResponse#rules_packages #rules_packages} => Array<Types::RulesPackage>
|
662
|
+
# * {Types::DescribeRulesPackagesResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
663
|
+
#
|
664
|
+
# @example Request syntax with placeholder values
|
665
|
+
#
|
666
|
+
# resp = client.describe_rules_packages({
|
667
|
+
# rules_package_arns: ["Arn"], # required
|
668
|
+
# locale: "EN_US", # accepts EN_US
|
669
|
+
# })
|
670
|
+
#
|
671
|
+
# @example Response structure
|
672
|
+
#
|
673
|
+
# resp.rules_packages #=> Array
|
674
|
+
# resp.rules_packages[0].arn #=> String
|
675
|
+
# resp.rules_packages[0].name #=> String
|
676
|
+
# resp.rules_packages[0].version #=> String
|
677
|
+
# resp.rules_packages[0].provider #=> String
|
678
|
+
# resp.rules_packages[0].description #=> String
|
679
|
+
# resp.failed_items #=> Hash
|
680
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
681
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
682
|
+
#
|
683
|
+
# @overload describe_rules_packages(params = {})
|
684
|
+
# @param [Hash] params ({})
|
685
|
+
def describe_rules_packages(params = {}, options = {})
|
686
|
+
req = build_request(:describe_rules_packages, params)
|
687
|
+
req.send_request(options)
|
688
|
+
end
|
630
689
|
|
631
|
-
|
632
|
-
|
633
|
-
|
634
|
-
|
635
|
-
|
636
|
-
|
637
|
-
|
638
|
-
|
639
|
-
|
640
|
-
|
641
|
-
|
642
|
-
|
643
|
-
|
644
|
-
|
645
|
-
|
646
|
-
|
647
|
-
|
648
|
-
|
649
|
-
|
650
|
-
|
651
|
-
|
652
|
-
|
653
|
-
|
654
|
-
|
655
|
-
|
656
|
-
|
657
|
-
|
658
|
-
|
659
|
-
|
660
|
-
|
661
|
-
# filter: {
|
662
|
-
# agent_healths: ["HEALTHY"], # required, accepts HEALTHY, UNHEALTHY
|
663
|
-
# agent_health_codes: ["IDLE"], # required, accepts IDLE, RUNNING, SHUTDOWN, UNHEALTHY, THROTTLED, UNKNOWN
|
664
|
-
# },
|
665
|
-
# next_token: "PaginationToken",
|
666
|
-
# max_results: 1,
|
667
|
-
# })
|
668
|
-
#
|
669
|
-
# @example Response structure
|
670
|
-
# resp.assessment_run_agents #=> Array
|
671
|
-
# resp.assessment_run_agents[0].agent_id #=> String
|
672
|
-
# resp.assessment_run_agents[0].assessment_run_arn #=> String
|
673
|
-
# resp.assessment_run_agents[0].agent_health #=> String, one of "HEALTHY", "UNHEALTHY"
|
674
|
-
# resp.assessment_run_agents[0].agent_health_code #=> String, one of "IDLE", "RUNNING", "SHUTDOWN", "UNHEALTHY", "THROTTLED", "UNKNOWN"
|
675
|
-
# resp.assessment_run_agents[0].agent_health_details #=> String
|
676
|
-
# resp.assessment_run_agents[0].auto_scaling_group #=> String
|
677
|
-
# resp.assessment_run_agents[0].telemetry_metadata #=> Array
|
678
|
-
# resp.assessment_run_agents[0].telemetry_metadata[0].message_type #=> String
|
679
|
-
# resp.assessment_run_agents[0].telemetry_metadata[0].count #=> Integer
|
680
|
-
# resp.assessment_run_agents[0].telemetry_metadata[0].data_size #=> Integer
|
681
|
-
# resp.next_token #=> String
|
682
|
-
# @overload list_assessment_run_agents(params = {})
|
683
|
-
# @param [Hash] params ({})
|
684
|
-
def list_assessment_run_agents(params = {}, options = {})
|
685
|
-
req = build_request(:list_assessment_run_agents, params)
|
686
|
-
req.send_request(options)
|
687
|
-
end
|
690
|
+
# Information about the data that is collected for the specified
|
691
|
+
# assessment run.
|
692
|
+
#
|
693
|
+
# @option params [required, String] :assessment_run_arn
|
694
|
+
# The ARN that specifies the assessment run that has the telemetry data
|
695
|
+
# that you want to obtain.
|
696
|
+
#
|
697
|
+
# @return [Types::GetTelemetryMetadataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
698
|
+
#
|
699
|
+
# * {Types::GetTelemetryMetadataResponse#telemetry_metadata #telemetry_metadata} => Array<Types::TelemetryMetadata>
|
700
|
+
#
|
701
|
+
# @example Request syntax with placeholder values
|
702
|
+
#
|
703
|
+
# resp = client.get_telemetry_metadata({
|
704
|
+
# assessment_run_arn: "Arn", # required
|
705
|
+
# })
|
706
|
+
#
|
707
|
+
# @example Response structure
|
708
|
+
#
|
709
|
+
# resp.telemetry_metadata #=> Array
|
710
|
+
# resp.telemetry_metadata[0].message_type #=> String
|
711
|
+
# resp.telemetry_metadata[0].count #=> Integer
|
712
|
+
# resp.telemetry_metadata[0].data_size #=> Integer
|
713
|
+
#
|
714
|
+
# @overload get_telemetry_metadata(params = {})
|
715
|
+
# @param [Hash] params ({})
|
716
|
+
def get_telemetry_metadata(params = {}, options = {})
|
717
|
+
req = build_request(:get_telemetry_metadata, params)
|
718
|
+
req.send_request(options)
|
719
|
+
end
|
688
720
|
|
689
|
-
|
690
|
-
|
691
|
-
|
692
|
-
|
693
|
-
|
694
|
-
|
695
|
-
|
696
|
-
|
697
|
-
|
698
|
-
|
699
|
-
|
700
|
-
|
701
|
-
|
702
|
-
|
703
|
-
|
704
|
-
|
705
|
-
|
706
|
-
|
707
|
-
|
708
|
-
|
709
|
-
|
710
|
-
|
711
|
-
|
712
|
-
|
713
|
-
|
714
|
-
|
715
|
-
|
716
|
-
|
717
|
-
|
718
|
-
|
719
|
-
|
720
|
-
|
721
|
-
|
722
|
-
|
723
|
-
|
724
|
-
|
725
|
-
|
726
|
-
|
727
|
-
|
728
|
-
|
729
|
-
|
730
|
-
|
731
|
-
|
732
|
-
|
733
|
-
|
734
|
-
|
735
|
-
|
736
|
-
|
737
|
-
|
738
|
-
|
739
|
-
|
740
|
-
|
741
|
-
|
742
|
-
|
743
|
-
|
744
|
-
|
745
|
-
|
746
|
-
|
747
|
-
|
748
|
-
|
749
|
-
|
750
|
-
|
751
|
-
|
752
|
-
|
753
|
-
|
721
|
+
# Lists the agents of the assessment runs that are specified by the ARNs
|
722
|
+
# of the assessment runs.
|
723
|
+
#
|
724
|
+
# @option params [required, String] :assessment_run_arn
|
725
|
+
# The ARN that specifies the assessment run whose agents you want to
|
726
|
+
# list.
|
727
|
+
#
|
728
|
+
# @option params [Types::AgentFilter] :filter
|
729
|
+
# You can use this parameter to specify a subset of data to be included
|
730
|
+
# in the action's response.
|
731
|
+
#
|
732
|
+
# For a record to match a filter, all specified filter attributes must
|
733
|
+
# match. When multiple values are specified for a filter attribute, any
|
734
|
+
# of the values can match.
|
735
|
+
#
|
736
|
+
# @option params [String] :next_token
|
737
|
+
# You can use this parameter when paginating results. Set the value of
|
738
|
+
# this parameter to null on your first call to the
|
739
|
+
# **ListAssessmentRunAgents** action. Subsequent calls to the action
|
740
|
+
# fill **nextToken** in the request with the value of **NextToken** from
|
741
|
+
# the previous response to continue listing data.
|
742
|
+
#
|
743
|
+
# @option params [Integer] :max_results
|
744
|
+
# You can use this parameter to indicate the maximum number of items
|
745
|
+
# that you want in the response. The default value is 10. The maximum
|
746
|
+
# value is 500.
|
747
|
+
#
|
748
|
+
# @return [Types::ListAssessmentRunAgentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
749
|
+
#
|
750
|
+
# * {Types::ListAssessmentRunAgentsResponse#assessment_run_agents #assessment_run_agents} => Array<Types::AssessmentRunAgent>
|
751
|
+
# * {Types::ListAssessmentRunAgentsResponse#next_token #next_token} => String
|
752
|
+
#
|
753
|
+
# @example Request syntax with placeholder values
|
754
|
+
#
|
755
|
+
# resp = client.list_assessment_run_agents({
|
756
|
+
# assessment_run_arn: "Arn", # required
|
757
|
+
# filter: {
|
758
|
+
# agent_healths: ["HEALTHY"], # required, accepts HEALTHY, UNHEALTHY
|
759
|
+
# agent_health_codes: ["IDLE"], # required, accepts IDLE, RUNNING, SHUTDOWN, UNHEALTHY, THROTTLED, UNKNOWN
|
760
|
+
# },
|
761
|
+
# next_token: "PaginationToken",
|
762
|
+
# max_results: 1,
|
763
|
+
# })
|
764
|
+
#
|
765
|
+
# @example Response structure
|
766
|
+
#
|
767
|
+
# resp.assessment_run_agents #=> Array
|
768
|
+
# resp.assessment_run_agents[0].agent_id #=> String
|
769
|
+
# resp.assessment_run_agents[0].assessment_run_arn #=> String
|
770
|
+
# resp.assessment_run_agents[0].agent_health #=> String, one of "HEALTHY", "UNHEALTHY"
|
771
|
+
# resp.assessment_run_agents[0].agent_health_code #=> String, one of "IDLE", "RUNNING", "SHUTDOWN", "UNHEALTHY", "THROTTLED", "UNKNOWN"
|
772
|
+
# resp.assessment_run_agents[0].agent_health_details #=> String
|
773
|
+
# resp.assessment_run_agents[0].auto_scaling_group #=> String
|
774
|
+
# resp.assessment_run_agents[0].telemetry_metadata #=> Array
|
775
|
+
# resp.assessment_run_agents[0].telemetry_metadata[0].message_type #=> String
|
776
|
+
# resp.assessment_run_agents[0].telemetry_metadata[0].count #=> Integer
|
777
|
+
# resp.assessment_run_agents[0].telemetry_metadata[0].data_size #=> Integer
|
778
|
+
# resp.next_token #=> String
|
779
|
+
#
|
780
|
+
# @overload list_assessment_run_agents(params = {})
|
781
|
+
# @param [Hash] params ({})
|
782
|
+
def list_assessment_run_agents(params = {}, options = {})
|
783
|
+
req = build_request(:list_assessment_run_agents, params)
|
784
|
+
req.send_request(options)
|
785
|
+
end
|
754
786
|
|
755
|
-
|
756
|
-
|
757
|
-
|
758
|
-
|
759
|
-
|
760
|
-
|
761
|
-
|
762
|
-
|
763
|
-
|
764
|
-
|
765
|
-
|
766
|
-
|
767
|
-
|
768
|
-
|
769
|
-
|
770
|
-
|
771
|
-
|
772
|
-
|
773
|
-
|
774
|
-
|
775
|
-
|
776
|
-
|
777
|
-
|
778
|
-
|
779
|
-
|
780
|
-
|
781
|
-
|
782
|
-
|
783
|
-
|
784
|
-
|
785
|
-
|
786
|
-
|
787
|
-
|
788
|
-
|
789
|
-
|
790
|
-
|
791
|
-
|
792
|
-
|
793
|
-
|
794
|
-
|
795
|
-
|
796
|
-
|
797
|
-
|
798
|
-
|
799
|
-
|
800
|
-
|
801
|
-
|
802
|
-
|
787
|
+
# Lists the assessment runs that correspond to the assessment templates
|
788
|
+
# that are specified by the ARNs of the assessment templates.
|
789
|
+
#
|
790
|
+
# @option params [Array<String>] :assessment_template_arns
|
791
|
+
# The ARNs that specify the assessment templates whose assessment runs
|
792
|
+
# you want to list.
|
793
|
+
#
|
794
|
+
# @option params [Types::AssessmentRunFilter] :filter
|
795
|
+
# You can use this parameter to specify a subset of data to be included
|
796
|
+
# in the action's response.
|
797
|
+
#
|
798
|
+
# For a record to match a filter, all specified filter attributes must
|
799
|
+
# match. When multiple values are specified for a filter attribute, any
|
800
|
+
# of the values can match.
|
801
|
+
#
|
802
|
+
# @option params [String] :next_token
|
803
|
+
# You can use this parameter when paginating results. Set the value of
|
804
|
+
# this parameter to null on your first call to the
|
805
|
+
# **ListAssessmentRuns** action. Subsequent calls to the action fill
|
806
|
+
# **nextToken** in the request with the value of **NextToken** from the
|
807
|
+
# previous response to continue listing data.
|
808
|
+
#
|
809
|
+
# @option params [Integer] :max_results
|
810
|
+
# You can use this parameter to indicate the maximum number of items
|
811
|
+
# that you want in the response. The default value is 10. The maximum
|
812
|
+
# value is 500.
|
813
|
+
#
|
814
|
+
# @return [Types::ListAssessmentRunsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
815
|
+
#
|
816
|
+
# * {Types::ListAssessmentRunsResponse#assessment_run_arns #assessment_run_arns} => Array<String>
|
817
|
+
# * {Types::ListAssessmentRunsResponse#next_token #next_token} => String
|
818
|
+
#
|
819
|
+
# @example Request syntax with placeholder values
|
820
|
+
#
|
821
|
+
# resp = client.list_assessment_runs({
|
822
|
+
# assessment_template_arns: ["Arn"],
|
823
|
+
# filter: {
|
824
|
+
# name_pattern: "NamePattern",
|
825
|
+
# states: ["CREATED"], # accepts CREATED, START_DATA_COLLECTION_PENDING, START_DATA_COLLECTION_IN_PROGRESS, COLLECTING_DATA, STOP_DATA_COLLECTION_PENDING, DATA_COLLECTED, EVALUATING_RULES, FAILED, COMPLETED, COMPLETED_WITH_ERRORS
|
826
|
+
# duration_range: {
|
827
|
+
# min_seconds: 1,
|
828
|
+
# max_seconds: 1,
|
829
|
+
# },
|
830
|
+
# rules_package_arns: ["Arn"],
|
831
|
+
# start_time_range: {
|
832
|
+
# begin_date: Time.now,
|
833
|
+
# end_date: Time.now,
|
834
|
+
# },
|
835
|
+
# completion_time_range: {
|
836
|
+
# begin_date: Time.now,
|
837
|
+
# end_date: Time.now,
|
838
|
+
# },
|
839
|
+
# state_change_time_range: {
|
840
|
+
# begin_date: Time.now,
|
841
|
+
# end_date: Time.now,
|
842
|
+
# },
|
843
|
+
# },
|
844
|
+
# next_token: "PaginationToken",
|
845
|
+
# max_results: 1,
|
846
|
+
# })
|
847
|
+
#
|
848
|
+
# @example Response structure
|
849
|
+
#
|
850
|
+
# resp.assessment_run_arns #=> Array
|
851
|
+
# resp.assessment_run_arns[0] #=> String
|
852
|
+
# resp.next_token #=> String
|
853
|
+
#
|
854
|
+
# @overload list_assessment_runs(params = {})
|
855
|
+
# @param [Hash] params ({})
|
856
|
+
def list_assessment_runs(params = {}, options = {})
|
857
|
+
req = build_request(:list_assessment_runs, params)
|
858
|
+
req.send_request(options)
|
859
|
+
end
|
803
860
|
|
804
|
-
|
805
|
-
|
806
|
-
|
807
|
-
|
808
|
-
|
809
|
-
|
810
|
-
|
811
|
-
|
812
|
-
|
813
|
-
|
814
|
-
|
815
|
-
|
816
|
-
|
817
|
-
|
818
|
-
|
819
|
-
|
820
|
-
|
821
|
-
|
822
|
-
|
823
|
-
|
824
|
-
|
825
|
-
|
826
|
-
|
827
|
-
|
828
|
-
|
829
|
-
|
830
|
-
|
831
|
-
|
832
|
-
|
833
|
-
|
834
|
-
|
835
|
-
|
836
|
-
|
837
|
-
|
838
|
-
|
839
|
-
|
840
|
-
|
841
|
-
|
842
|
-
|
843
|
-
|
844
|
-
|
845
|
-
|
846
|
-
|
847
|
-
|
848
|
-
|
849
|
-
|
850
|
-
|
851
|
-
|
852
|
-
|
853
|
-
|
854
|
-
|
855
|
-
|
861
|
+
# Lists the ARNs of the assessment targets within this AWS account. For
|
862
|
+
# more information about assessment targets, see [Amazon Inspector
|
863
|
+
# Assessment Targets][1].
|
864
|
+
#
|
865
|
+
#
|
866
|
+
#
|
867
|
+
# [1]: http://docs.aws.amazon.com/inspector/latest/userguide/inspector_applications.html
|
868
|
+
#
|
869
|
+
# @option params [Types::AssessmentTargetFilter] :filter
|
870
|
+
# You can use this parameter to specify a subset of data to be included
|
871
|
+
# in the action's response.
|
872
|
+
#
|
873
|
+
# For a record to match a filter, all specified filter attributes must
|
874
|
+
# match. When multiple values are specified for a filter attribute, any
|
875
|
+
# of the values can match.
|
876
|
+
#
|
877
|
+
# @option params [String] :next_token
|
878
|
+
# You can use this parameter when paginating results. Set the value of
|
879
|
+
# this parameter to null on your first call to the
|
880
|
+
# **ListAssessmentTargets** action. Subsequent calls to the action fill
|
881
|
+
# **nextToken** in the request with the value of **NextToken** from the
|
882
|
+
# previous response to continue listing data.
|
883
|
+
#
|
884
|
+
# @option params [Integer] :max_results
|
885
|
+
# You can use this parameter to indicate the maximum number of items you
|
886
|
+
# want in the response. The default value is 10. The maximum value is
|
887
|
+
# 500.
|
888
|
+
#
|
889
|
+
# @return [Types::ListAssessmentTargetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
890
|
+
#
|
891
|
+
# * {Types::ListAssessmentTargetsResponse#assessment_target_arns #assessment_target_arns} => Array<String>
|
892
|
+
# * {Types::ListAssessmentTargetsResponse#next_token #next_token} => String
|
893
|
+
#
|
894
|
+
# @example Request syntax with placeholder values
|
895
|
+
#
|
896
|
+
# resp = client.list_assessment_targets({
|
897
|
+
# filter: {
|
898
|
+
# assessment_target_name_pattern: "NamePattern",
|
899
|
+
# },
|
900
|
+
# next_token: "PaginationToken",
|
901
|
+
# max_results: 1,
|
902
|
+
# })
|
903
|
+
#
|
904
|
+
# @example Response structure
|
905
|
+
#
|
906
|
+
# resp.assessment_target_arns #=> Array
|
907
|
+
# resp.assessment_target_arns[0] #=> String
|
908
|
+
# resp.next_token #=> String
|
909
|
+
#
|
910
|
+
# @overload list_assessment_targets(params = {})
|
911
|
+
# @param [Hash] params ({})
|
912
|
+
def list_assessment_targets(params = {}, options = {})
|
913
|
+
req = build_request(:list_assessment_targets, params)
|
914
|
+
req.send_request(options)
|
915
|
+
end
|
856
916
|
|
857
|
-
|
858
|
-
|
859
|
-
|
860
|
-
|
861
|
-
|
862
|
-
|
863
|
-
|
864
|
-
|
865
|
-
|
866
|
-
|
867
|
-
|
868
|
-
|
869
|
-
|
870
|
-
|
871
|
-
|
872
|
-
|
873
|
-
|
874
|
-
|
875
|
-
|
876
|
-
|
877
|
-
|
878
|
-
|
879
|
-
|
880
|
-
|
881
|
-
|
882
|
-
|
883
|
-
|
884
|
-
|
885
|
-
|
886
|
-
|
887
|
-
|
888
|
-
|
889
|
-
|
890
|
-
|
891
|
-
|
892
|
-
|
893
|
-
|
894
|
-
|
895
|
-
|
896
|
-
|
897
|
-
|
898
|
-
|
917
|
+
# Lists the assessment templates that correspond to the assessment
|
918
|
+
# targets that are specified by the ARNs of the assessment targets.
|
919
|
+
#
|
920
|
+
# @option params [Array<String>] :assessment_target_arns
|
921
|
+
# A list of ARNs that specifies the assessment targets whose assessment
|
922
|
+
# templates you want to list.
|
923
|
+
#
|
924
|
+
# @option params [Types::AssessmentTemplateFilter] :filter
|
925
|
+
# You can use this parameter to specify a subset of data to be included
|
926
|
+
# in the action's response.
|
927
|
+
#
|
928
|
+
# For a record to match a filter, all specified filter attributes must
|
929
|
+
# match. When multiple values are specified for a filter attribute, any
|
930
|
+
# of the values can match.
|
931
|
+
#
|
932
|
+
# @option params [String] :next_token
|
933
|
+
# You can use this parameter when paginating results. Set the value of
|
934
|
+
# this parameter to null on your first call to the
|
935
|
+
# **ListAssessmentTemplates** action. Subsequent calls to the action
|
936
|
+
# fill **nextToken** in the request with the value of **NextToken** from
|
937
|
+
# the previous response to continue listing data.
|
938
|
+
#
|
939
|
+
# @option params [Integer] :max_results
|
940
|
+
# You can use this parameter to indicate the maximum number of items you
|
941
|
+
# want in the response. The default value is 10. The maximum value is
|
942
|
+
# 500.
|
943
|
+
#
|
944
|
+
# @return [Types::ListAssessmentTemplatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
945
|
+
#
|
946
|
+
# * {Types::ListAssessmentTemplatesResponse#assessment_template_arns #assessment_template_arns} => Array<String>
|
947
|
+
# * {Types::ListAssessmentTemplatesResponse#next_token #next_token} => String
|
948
|
+
#
|
949
|
+
# @example Request syntax with placeholder values
|
950
|
+
#
|
951
|
+
# resp = client.list_assessment_templates({
|
952
|
+
# assessment_target_arns: ["Arn"],
|
953
|
+
# filter: {
|
954
|
+
# name_pattern: "NamePattern",
|
955
|
+
# duration_range: {
|
956
|
+
# min_seconds: 1,
|
957
|
+
# max_seconds: 1,
|
958
|
+
# },
|
959
|
+
# rules_package_arns: ["Arn"],
|
960
|
+
# },
|
961
|
+
# next_token: "PaginationToken",
|
962
|
+
# max_results: 1,
|
963
|
+
# })
|
964
|
+
#
|
965
|
+
# @example Response structure
|
966
|
+
#
|
967
|
+
# resp.assessment_template_arns #=> Array
|
968
|
+
# resp.assessment_template_arns[0] #=> String
|
969
|
+
# resp.next_token #=> String
|
970
|
+
#
|
971
|
+
# @overload list_assessment_templates(params = {})
|
972
|
+
# @param [Hash] params ({})
|
973
|
+
def list_assessment_templates(params = {}, options = {})
|
974
|
+
req = build_request(:list_assessment_templates, params)
|
975
|
+
req.send_request(options)
|
976
|
+
end
|
899
977
|
|
900
|
-
|
901
|
-
|
902
|
-
|
903
|
-
|
904
|
-
|
905
|
-
|
906
|
-
|
907
|
-
|
908
|
-
|
909
|
-
|
910
|
-
|
911
|
-
|
912
|
-
|
913
|
-
|
914
|
-
|
915
|
-
|
916
|
-
|
917
|
-
|
918
|
-
|
919
|
-
|
920
|
-
|
921
|
-
|
922
|
-
|
923
|
-
|
924
|
-
|
925
|
-
|
926
|
-
|
927
|
-
|
928
|
-
|
929
|
-
|
930
|
-
|
931
|
-
|
932
|
-
|
933
|
-
|
934
|
-
|
935
|
-
|
936
|
-
|
937
|
-
|
938
|
-
|
939
|
-
|
940
|
-
|
941
|
-
|
942
|
-
|
943
|
-
|
944
|
-
|
945
|
-
|
946
|
-
|
947
|
-
|
948
|
-
|
949
|
-
# begin_date: Time.now,
|
950
|
-
# end_date: Time.now,
|
951
|
-
# },
|
952
|
-
# },
|
953
|
-
# next_token: "PaginationToken",
|
954
|
-
# max_results: 1,
|
955
|
-
# })
|
956
|
-
#
|
957
|
-
# @example Response structure
|
958
|
-
# resp.finding_arns #=> Array
|
959
|
-
# resp.finding_arns[0] #=> String
|
960
|
-
# resp.next_token #=> String
|
961
|
-
# @overload list_findings(params = {})
|
962
|
-
# @param [Hash] params ({})
|
963
|
-
def list_findings(params = {}, options = {})
|
964
|
-
req = build_request(:list_findings, params)
|
965
|
-
req.send_request(options)
|
966
|
-
end
|
978
|
+
# Lists all the event subscriptions for the assessment template that is
|
979
|
+
# specified by the ARN of the assessment template. For more information,
|
980
|
+
# see SubscribeToEvent and UnsubscribeFromEvent.
|
981
|
+
#
|
982
|
+
# @option params [String] :resource_arn
|
983
|
+
# The ARN of the assessment template for which you want to list the
|
984
|
+
# existing event subscriptions.
|
985
|
+
#
|
986
|
+
# @option params [String] :next_token
|
987
|
+
# You can use this parameter when paginating results. Set the value of
|
988
|
+
# this parameter to null on your first call to the
|
989
|
+
# **ListEventSubscriptions** action. Subsequent calls to the action fill
|
990
|
+
# **nextToken** in the request with the value of **NextToken** from the
|
991
|
+
# previous response to continue listing data.
|
992
|
+
#
|
993
|
+
# @option params [Integer] :max_results
|
994
|
+
# You can use this parameter to indicate the maximum number of items you
|
995
|
+
# want in the response. The default value is 10. The maximum value is
|
996
|
+
# 500.
|
997
|
+
#
|
998
|
+
# @return [Types::ListEventSubscriptionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
999
|
+
#
|
1000
|
+
# * {Types::ListEventSubscriptionsResponse#subscriptions #subscriptions} => Array<Types::Subscription>
|
1001
|
+
# * {Types::ListEventSubscriptionsResponse#next_token #next_token} => String
|
1002
|
+
#
|
1003
|
+
# @example Request syntax with placeholder values
|
1004
|
+
#
|
1005
|
+
# resp = client.list_event_subscriptions({
|
1006
|
+
# resource_arn: "Arn",
|
1007
|
+
# next_token: "PaginationToken",
|
1008
|
+
# max_results: 1,
|
1009
|
+
# })
|
1010
|
+
#
|
1011
|
+
# @example Response structure
|
1012
|
+
#
|
1013
|
+
# resp.subscriptions #=> Array
|
1014
|
+
# resp.subscriptions[0].resource_arn #=> String
|
1015
|
+
# resp.subscriptions[0].topic_arn #=> String
|
1016
|
+
# resp.subscriptions[0].event_subscriptions #=> Array
|
1017
|
+
# resp.subscriptions[0].event_subscriptions[0].event #=> String, one of "ASSESSMENT_RUN_STARTED", "ASSESSMENT_RUN_COMPLETED", "ASSESSMENT_RUN_STATE_CHANGED", "FINDING_REPORTED", "OTHER"
|
1018
|
+
# resp.subscriptions[0].event_subscriptions[0].subscribed_at #=> Time
|
1019
|
+
# resp.next_token #=> String
|
1020
|
+
#
|
1021
|
+
# @overload list_event_subscriptions(params = {})
|
1022
|
+
# @param [Hash] params ({})
|
1023
|
+
def list_event_subscriptions(params = {}, options = {})
|
1024
|
+
req = build_request(:list_event_subscriptions, params)
|
1025
|
+
req.send_request(options)
|
1026
|
+
end
|
967
1027
|
|
968
|
-
|
969
|
-
|
970
|
-
|
971
|
-
|
972
|
-
|
973
|
-
|
974
|
-
|
975
|
-
|
976
|
-
|
977
|
-
|
978
|
-
|
979
|
-
|
980
|
-
|
981
|
-
|
982
|
-
|
983
|
-
|
984
|
-
|
985
|
-
|
986
|
-
|
987
|
-
|
988
|
-
|
989
|
-
|
990
|
-
|
991
|
-
|
992
|
-
|
993
|
-
|
994
|
-
|
995
|
-
|
996
|
-
|
997
|
-
|
998
|
-
|
999
|
-
|
1028
|
+
# Lists findings that are generated by the assessment runs that are
|
1029
|
+
# specified by the ARNs of the assessment runs.
|
1030
|
+
#
|
1031
|
+
# @option params [Array<String>] :assessment_run_arns
|
1032
|
+
# The ARNs of the assessment runs that generate the findings that you
|
1033
|
+
# want to list.
|
1034
|
+
#
|
1035
|
+
# @option params [Types::FindingFilter] :filter
|
1036
|
+
# You can use this parameter to specify a subset of data to be included
|
1037
|
+
# in the action's response.
|
1038
|
+
#
|
1039
|
+
# For a record to match a filter, all specified filter attributes must
|
1040
|
+
# match. When multiple values are specified for a filter attribute, any
|
1041
|
+
# of the values can match.
|
1042
|
+
#
|
1043
|
+
# @option params [String] :next_token
|
1044
|
+
# You can use this parameter when paginating results. Set the value of
|
1045
|
+
# this parameter to null on your first call to the **ListFindings**
|
1046
|
+
# action. Subsequent calls to the action fill **nextToken** in the
|
1047
|
+
# request with the value of **NextToken** from the previous response to
|
1048
|
+
# continue listing data.
|
1049
|
+
#
|
1050
|
+
# @option params [Integer] :max_results
|
1051
|
+
# You can use this parameter to indicate the maximum number of items you
|
1052
|
+
# want in the response. The default value is 10. The maximum value is
|
1053
|
+
# 500.
|
1054
|
+
#
|
1055
|
+
# @return [Types::ListFindingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1056
|
+
#
|
1057
|
+
# * {Types::ListFindingsResponse#finding_arns #finding_arns} => Array<String>
|
1058
|
+
# * {Types::ListFindingsResponse#next_token #next_token} => String
|
1059
|
+
#
|
1060
|
+
# @example Request syntax with placeholder values
|
1061
|
+
#
|
1062
|
+
# resp = client.list_findings({
|
1063
|
+
# assessment_run_arns: ["Arn"],
|
1064
|
+
# filter: {
|
1065
|
+
# agent_ids: ["AgentId"],
|
1066
|
+
# auto_scaling_groups: ["AutoScalingGroup"],
|
1067
|
+
# rule_names: ["RuleName"],
|
1068
|
+
# severities: ["Low"], # accepts Low, Medium, High, Informational, Undefined
|
1069
|
+
# rules_package_arns: ["Arn"],
|
1070
|
+
# attributes: [
|
1071
|
+
# {
|
1072
|
+
# key: "AttributeKey", # required
|
1073
|
+
# value: "AttributeValue",
|
1074
|
+
# },
|
1075
|
+
# ],
|
1076
|
+
# user_attributes: [
|
1077
|
+
# {
|
1078
|
+
# key: "AttributeKey", # required
|
1079
|
+
# value: "AttributeValue",
|
1080
|
+
# },
|
1081
|
+
# ],
|
1082
|
+
# creation_time_range: {
|
1083
|
+
# begin_date: Time.now,
|
1084
|
+
# end_date: Time.now,
|
1085
|
+
# },
|
1086
|
+
# },
|
1087
|
+
# next_token: "PaginationToken",
|
1088
|
+
# max_results: 1,
|
1089
|
+
# })
|
1090
|
+
#
|
1091
|
+
# @example Response structure
|
1092
|
+
#
|
1093
|
+
# resp.finding_arns #=> Array
|
1094
|
+
# resp.finding_arns[0] #=> String
|
1095
|
+
# resp.next_token #=> String
|
1096
|
+
#
|
1097
|
+
# @overload list_findings(params = {})
|
1098
|
+
# @param [Hash] params ({})
|
1099
|
+
def list_findings(params = {}, options = {})
|
1100
|
+
req = build_request(:list_findings, params)
|
1101
|
+
req.send_request(options)
|
1102
|
+
end
|
1000
1103
|
|
1001
|
-
|
1002
|
-
|
1003
|
-
|
1004
|
-
|
1005
|
-
|
1006
|
-
|
1007
|
-
|
1008
|
-
|
1009
|
-
|
1010
|
-
|
1011
|
-
|
1012
|
-
|
1013
|
-
|
1014
|
-
|
1015
|
-
|
1016
|
-
|
1017
|
-
|
1018
|
-
|
1019
|
-
|
1020
|
-
|
1021
|
-
|
1022
|
-
|
1023
|
-
|
1104
|
+
# Lists all available Amazon Inspector rules packages.
|
1105
|
+
#
|
1106
|
+
# @option params [String] :next_token
|
1107
|
+
# You can use this parameter when paginating results. Set the value of
|
1108
|
+
# this parameter to null on your first call to the **ListRulesPackages**
|
1109
|
+
# action. Subsequent calls to the action fill **nextToken** in the
|
1110
|
+
# request with the value of **NextToken** from the previous response to
|
1111
|
+
# continue listing data.
|
1112
|
+
#
|
1113
|
+
# @option params [Integer] :max_results
|
1114
|
+
# You can use this parameter to indicate the maximum number of items you
|
1115
|
+
# want in the response. The default value is 10. The maximum value is
|
1116
|
+
# 500.
|
1117
|
+
#
|
1118
|
+
# @return [Types::ListRulesPackagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1119
|
+
#
|
1120
|
+
# * {Types::ListRulesPackagesResponse#rules_package_arns #rules_package_arns} => Array<String>
|
1121
|
+
# * {Types::ListRulesPackagesResponse#next_token #next_token} => String
|
1122
|
+
#
|
1123
|
+
# @example Request syntax with placeholder values
|
1124
|
+
#
|
1125
|
+
# resp = client.list_rules_packages({
|
1126
|
+
# next_token: "PaginationToken",
|
1127
|
+
# max_results: 1,
|
1128
|
+
# })
|
1129
|
+
#
|
1130
|
+
# @example Response structure
|
1131
|
+
#
|
1132
|
+
# resp.rules_package_arns #=> Array
|
1133
|
+
# resp.rules_package_arns[0] #=> String
|
1134
|
+
# resp.next_token #=> String
|
1135
|
+
#
|
1136
|
+
# @overload list_rules_packages(params = {})
|
1137
|
+
# @param [Hash] params ({})
|
1138
|
+
def list_rules_packages(params = {}, options = {})
|
1139
|
+
req = build_request(:list_rules_packages, params)
|
1140
|
+
req.send_request(options)
|
1141
|
+
end
|
1024
1142
|
|
1025
|
-
|
1026
|
-
|
1027
|
-
|
1028
|
-
|
1029
|
-
|
1030
|
-
|
1031
|
-
|
1032
|
-
|
1033
|
-
|
1034
|
-
|
1035
|
-
|
1036
|
-
|
1037
|
-
|
1038
|
-
|
1039
|
-
|
1040
|
-
|
1041
|
-
|
1042
|
-
|
1043
|
-
|
1044
|
-
|
1045
|
-
|
1046
|
-
|
1047
|
-
|
1048
|
-
|
1049
|
-
|
1050
|
-
|
1051
|
-
|
1052
|
-
|
1053
|
-
# resp.agent_previews[0].agent_id #=> String
|
1054
|
-
# resp.agent_previews[0].auto_scaling_group #=> String
|
1055
|
-
# resp.next_token #=> String
|
1056
|
-
# @overload preview_agents(params = {})
|
1057
|
-
# @param [Hash] params ({})
|
1058
|
-
def preview_agents(params = {}, options = {})
|
1059
|
-
req = build_request(:preview_agents, params)
|
1060
|
-
req.send_request(options)
|
1061
|
-
end
|
1143
|
+
# Lists all tags associated with an assessment template.
|
1144
|
+
#
|
1145
|
+
# @option params [required, String] :resource_arn
|
1146
|
+
# The ARN that specifies the assessment template whose tags you want to
|
1147
|
+
# list.
|
1148
|
+
#
|
1149
|
+
# @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1150
|
+
#
|
1151
|
+
# * {Types::ListTagsForResourceResponse#tags #tags} => Array<Types::Tag>
|
1152
|
+
#
|
1153
|
+
# @example Request syntax with placeholder values
|
1154
|
+
#
|
1155
|
+
# resp = client.list_tags_for_resource({
|
1156
|
+
# resource_arn: "Arn", # required
|
1157
|
+
# })
|
1158
|
+
#
|
1159
|
+
# @example Response structure
|
1160
|
+
#
|
1161
|
+
# resp.tags #=> Array
|
1162
|
+
# resp.tags[0].key #=> String
|
1163
|
+
# resp.tags[0].value #=> String
|
1164
|
+
#
|
1165
|
+
# @overload list_tags_for_resource(params = {})
|
1166
|
+
# @param [Hash] params ({})
|
1167
|
+
def list_tags_for_resource(params = {}, options = {})
|
1168
|
+
req = build_request(:list_tags_for_resource, params)
|
1169
|
+
req.send_request(options)
|
1170
|
+
end
|
1062
1171
|
|
1063
|
-
|
1064
|
-
|
1065
|
-
|
1066
|
-
|
1067
|
-
|
1068
|
-
|
1069
|
-
|
1070
|
-
|
1071
|
-
|
1072
|
-
|
1073
|
-
|
1074
|
-
|
1075
|
-
|
1076
|
-
|
1077
|
-
|
1078
|
-
|
1079
|
-
|
1080
|
-
|
1081
|
-
|
1172
|
+
# Previews the agents installed on the EC2 instances that are part of
|
1173
|
+
# the specified assessment target.
|
1174
|
+
#
|
1175
|
+
# @option params [required, String] :preview_agents_arn
|
1176
|
+
# The ARN of the assessment target whose agents you want to preview.
|
1177
|
+
#
|
1178
|
+
# @option params [String] :next_token
|
1179
|
+
# You can use this parameter when paginating results. Set the value of
|
1180
|
+
# this parameter to null on your first call to the **PreviewAgents**
|
1181
|
+
# action. Subsequent calls to the action fill **nextToken** in the
|
1182
|
+
# request with the value of **NextToken** from the previous response to
|
1183
|
+
# continue listing data.
|
1184
|
+
#
|
1185
|
+
# @option params [Integer] :max_results
|
1186
|
+
# You can use this parameter to indicate the maximum number of items you
|
1187
|
+
# want in the response. The default value is 10. The maximum value is
|
1188
|
+
# 500.
|
1189
|
+
#
|
1190
|
+
# @return [Types::PreviewAgentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1191
|
+
#
|
1192
|
+
# * {Types::PreviewAgentsResponse#agent_previews #agent_previews} => Array<Types::AgentPreview>
|
1193
|
+
# * {Types::PreviewAgentsResponse#next_token #next_token} => String
|
1194
|
+
#
|
1195
|
+
# @example Request syntax with placeholder values
|
1196
|
+
#
|
1197
|
+
# resp = client.preview_agents({
|
1198
|
+
# preview_agents_arn: "Arn", # required
|
1199
|
+
# next_token: "PaginationToken",
|
1200
|
+
# max_results: 1,
|
1201
|
+
# })
|
1202
|
+
#
|
1203
|
+
# @example Response structure
|
1204
|
+
#
|
1205
|
+
# resp.agent_previews #=> Array
|
1206
|
+
# resp.agent_previews[0].agent_id #=> String
|
1207
|
+
# resp.agent_previews[0].auto_scaling_group #=> String
|
1208
|
+
# resp.next_token #=> String
|
1209
|
+
#
|
1210
|
+
# @overload preview_agents(params = {})
|
1211
|
+
# @param [Hash] params ({})
|
1212
|
+
def preview_agents(params = {}, options = {})
|
1213
|
+
req = build_request(:preview_agents, params)
|
1214
|
+
req.send_request(options)
|
1215
|
+
end
|
1082
1216
|
|
1083
|
-
|
1084
|
-
|
1085
|
-
|
1086
|
-
|
1087
|
-
|
1088
|
-
|
1089
|
-
|
1090
|
-
|
1091
|
-
|
1092
|
-
|
1093
|
-
|
1094
|
-
|
1095
|
-
|
1096
|
-
|
1097
|
-
|
1098
|
-
|
1099
|
-
|
1100
|
-
|
1101
|
-
|
1102
|
-
|
1103
|
-
|
1104
|
-
|
1105
|
-
|
1106
|
-
# @overload remove_attributes_from_findings(params = {})
|
1107
|
-
# @param [Hash] params ({})
|
1108
|
-
def remove_attributes_from_findings(params = {}, options = {})
|
1109
|
-
req = build_request(:remove_attributes_from_findings, params)
|
1110
|
-
req.send_request(options)
|
1111
|
-
end
|
1217
|
+
# Registers the IAM role that Amazon Inspector uses to list your EC2
|
1218
|
+
# instances at the start of the assessment run or when you call the
|
1219
|
+
# PreviewAgents action.
|
1220
|
+
#
|
1221
|
+
# @option params [required, String] :role_arn
|
1222
|
+
# The ARN of the IAM role that Amazon Inspector uses to list your EC2
|
1223
|
+
# instances during the assessment run or when you call the PreviewAgents
|
1224
|
+
# action.
|
1225
|
+
#
|
1226
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1227
|
+
#
|
1228
|
+
# @example Request syntax with placeholder values
|
1229
|
+
#
|
1230
|
+
# resp = client.register_cross_account_access_role({
|
1231
|
+
# role_arn: "Arn", # required
|
1232
|
+
# })
|
1233
|
+
#
|
1234
|
+
# @overload register_cross_account_access_role(params = {})
|
1235
|
+
# @param [Hash] params ({})
|
1236
|
+
def register_cross_account_access_role(params = {}, options = {})
|
1237
|
+
req = build_request(:register_cross_account_access_role, params)
|
1238
|
+
req.send_request(options)
|
1239
|
+
end
|
1112
1240
|
|
1113
|
-
|
1114
|
-
|
1115
|
-
|
1116
|
-
|
1117
|
-
|
1118
|
-
|
1119
|
-
|
1120
|
-
|
1121
|
-
|
1122
|
-
|
1123
|
-
|
1124
|
-
|
1125
|
-
|
1126
|
-
|
1127
|
-
|
1128
|
-
|
1129
|
-
|
1130
|
-
|
1131
|
-
|
1132
|
-
|
1133
|
-
|
1134
|
-
|
1135
|
-
|
1136
|
-
|
1137
|
-
|
1241
|
+
# Removes entire attributes (key and value pairs) from the findings that
|
1242
|
+
# are specified by the ARNs of the findings where an attribute with the
|
1243
|
+
# specified key exists.
|
1244
|
+
#
|
1245
|
+
# @option params [required, Array<String>] :finding_arns
|
1246
|
+
# The ARNs that specify the findings that you want to remove attributes
|
1247
|
+
# from.
|
1248
|
+
#
|
1249
|
+
# @option params [required, Array<String>] :attribute_keys
|
1250
|
+
# The array of attribute keys that you want to remove from specified
|
1251
|
+
# findings.
|
1252
|
+
#
|
1253
|
+
# @return [Types::RemoveAttributesFromFindingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1254
|
+
#
|
1255
|
+
# * {Types::RemoveAttributesFromFindingsResponse#failed_items #failed_items} => Hash<String,Types::FailedItemDetails>
|
1256
|
+
#
|
1257
|
+
# @example Request syntax with placeholder values
|
1258
|
+
#
|
1259
|
+
# resp = client.remove_attributes_from_findings({
|
1260
|
+
# finding_arns: ["Arn"], # required
|
1261
|
+
# attribute_keys: ["AttributeKey"], # required
|
1262
|
+
# })
|
1263
|
+
#
|
1264
|
+
# @example Response structure
|
1265
|
+
#
|
1266
|
+
# resp.failed_items #=> Hash
|
1267
|
+
# resp.failed_items["Arn"].failure_code #=> String, one of "INVALID_ARN", "DUPLICATE_ARN", "ITEM_DOES_NOT_EXIST", "ACCESS_DENIED", "LIMIT_EXCEEDED", "INTERNAL_ERROR"
|
1268
|
+
# resp.failed_items["Arn"].retryable #=> Boolean
|
1269
|
+
#
|
1270
|
+
# @overload remove_attributes_from_findings(params = {})
|
1271
|
+
# @param [Hash] params ({})
|
1272
|
+
def remove_attributes_from_findings(params = {}, options = {})
|
1273
|
+
req = build_request(:remove_attributes_from_findings, params)
|
1274
|
+
req.send_request(options)
|
1275
|
+
end
|
1138
1276
|
|
1139
|
-
|
1140
|
-
|
1141
|
-
|
1142
|
-
|
1143
|
-
|
1144
|
-
|
1145
|
-
|
1146
|
-
|
1147
|
-
|
1148
|
-
|
1149
|
-
|
1150
|
-
|
1151
|
-
|
1152
|
-
|
1153
|
-
|
1154
|
-
|
1155
|
-
|
1156
|
-
|
1157
|
-
|
1158
|
-
|
1159
|
-
|
1160
|
-
|
1161
|
-
|
1162
|
-
|
1163
|
-
|
1164
|
-
|
1165
|
-
|
1166
|
-
|
1277
|
+
# Sets tags (key and value pairs) to the assessment template that is
|
1278
|
+
# specified by the ARN of the assessment template.
|
1279
|
+
#
|
1280
|
+
# @option params [required, String] :resource_arn
|
1281
|
+
# The ARN of the assessment template that you want to set tags to.
|
1282
|
+
#
|
1283
|
+
# @option params [Array<Types::Tag>] :tags
|
1284
|
+
# A collection of key and value pairs that you want to set to the
|
1285
|
+
# assessment template.
|
1286
|
+
#
|
1287
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1288
|
+
#
|
1289
|
+
# @example Request syntax with placeholder values
|
1290
|
+
#
|
1291
|
+
# resp = client.set_tags_for_resource({
|
1292
|
+
# resource_arn: "Arn", # required
|
1293
|
+
# tags: [
|
1294
|
+
# {
|
1295
|
+
# key: "TagKey", # required
|
1296
|
+
# value: "TagValue",
|
1297
|
+
# },
|
1298
|
+
# ],
|
1299
|
+
# })
|
1300
|
+
#
|
1301
|
+
# @overload set_tags_for_resource(params = {})
|
1302
|
+
# @param [Hash] params ({})
|
1303
|
+
def set_tags_for_resource(params = {}, options = {})
|
1304
|
+
req = build_request(:set_tags_for_resource, params)
|
1305
|
+
req.send_request(options)
|
1306
|
+
end
|
1167
1307
|
|
1168
|
-
|
1169
|
-
|
1170
|
-
|
1171
|
-
|
1172
|
-
|
1173
|
-
|
1174
|
-
|
1175
|
-
|
1176
|
-
|
1177
|
-
|
1178
|
-
|
1179
|
-
|
1180
|
-
|
1181
|
-
|
1182
|
-
|
1183
|
-
|
1308
|
+
# Starts the assessment run specified by the ARN of the assessment
|
1309
|
+
# template. For this API to function properly, you must not exceed the
|
1310
|
+
# limit of running up to 500 concurrent agents per AWS account.
|
1311
|
+
#
|
1312
|
+
# @option params [required, String] :assessment_template_arn
|
1313
|
+
# The ARN of the assessment template of the assessment run that you want
|
1314
|
+
# to start.
|
1315
|
+
#
|
1316
|
+
# @option params [String] :assessment_run_name
|
1317
|
+
# You can specify the name for the assessment run. The name must be
|
1318
|
+
# unique for the assessment template whose ARN is used to start the
|
1319
|
+
# assessment run.
|
1320
|
+
#
|
1321
|
+
# @return [Types::StartAssessmentRunResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1322
|
+
#
|
1323
|
+
# * {Types::StartAssessmentRunResponse#assessment_run_arn #assessment_run_arn} => String
|
1324
|
+
#
|
1325
|
+
# @example Request syntax with placeholder values
|
1326
|
+
#
|
1327
|
+
# resp = client.start_assessment_run({
|
1328
|
+
# assessment_template_arn: "Arn", # required
|
1329
|
+
# assessment_run_name: "AssessmentRunName",
|
1330
|
+
# })
|
1331
|
+
#
|
1332
|
+
# @example Response structure
|
1333
|
+
#
|
1334
|
+
# resp.assessment_run_arn #=> String
|
1335
|
+
#
|
1336
|
+
# @overload start_assessment_run(params = {})
|
1337
|
+
# @param [Hash] params ({})
|
1338
|
+
def start_assessment_run(params = {}, options = {})
|
1339
|
+
req = build_request(:start_assessment_run, params)
|
1340
|
+
req.send_request(options)
|
1341
|
+
end
|
1184
1342
|
|
1185
|
-
|
1186
|
-
|
1187
|
-
|
1188
|
-
|
1189
|
-
|
1190
|
-
|
1191
|
-
|
1192
|
-
|
1193
|
-
|
1194
|
-
|
1195
|
-
|
1196
|
-
|
1197
|
-
|
1198
|
-
|
1199
|
-
|
1200
|
-
|
1201
|
-
|
1202
|
-
|
1203
|
-
|
1204
|
-
|
1205
|
-
req = build_request(:subscribe_to_event, params)
|
1206
|
-
req.send_request(options)
|
1207
|
-
end
|
1343
|
+
# Stops the assessment run that is specified by the ARN of the
|
1344
|
+
# assessment run.
|
1345
|
+
#
|
1346
|
+
# @option params [required, String] :assessment_run_arn
|
1347
|
+
# The ARN of the assessment run that you want to stop.
|
1348
|
+
#
|
1349
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1350
|
+
#
|
1351
|
+
# @example Request syntax with placeholder values
|
1352
|
+
#
|
1353
|
+
# resp = client.stop_assessment_run({
|
1354
|
+
# assessment_run_arn: "Arn", # required
|
1355
|
+
# })
|
1356
|
+
#
|
1357
|
+
# @overload stop_assessment_run(params = {})
|
1358
|
+
# @param [Hash] params ({})
|
1359
|
+
def stop_assessment_run(params = {}, options = {})
|
1360
|
+
req = build_request(:stop_assessment_run, params)
|
1361
|
+
req.send_request(options)
|
1362
|
+
end
|
1208
1363
|
|
1209
|
-
|
1210
|
-
|
1211
|
-
|
1212
|
-
|
1213
|
-
|
1214
|
-
|
1215
|
-
|
1216
|
-
|
1217
|
-
|
1218
|
-
|
1219
|
-
|
1220
|
-
|
1221
|
-
|
1222
|
-
|
1223
|
-
|
1224
|
-
|
1225
|
-
|
1226
|
-
|
1227
|
-
|
1228
|
-
|
1229
|
-
|
1230
|
-
|
1231
|
-
|
1364
|
+
# Enables the process of sending Amazon Simple Notification Service
|
1365
|
+
# (SNS) notifications about a specified event to a specified SNS topic.
|
1366
|
+
#
|
1367
|
+
# @option params [required, String] :resource_arn
|
1368
|
+
# The ARN of the assessment template that is used during the event for
|
1369
|
+
# which you want to receive SNS notifications.
|
1370
|
+
#
|
1371
|
+
# @option params [required, String] :event
|
1372
|
+
# The event for which you want to receive SNS notifications.
|
1373
|
+
#
|
1374
|
+
# @option params [required, String] :topic_arn
|
1375
|
+
# The ARN of the SNS topic to which the SNS notifications are sent.
|
1376
|
+
#
|
1377
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1378
|
+
#
|
1379
|
+
# @example Request syntax with placeholder values
|
1380
|
+
#
|
1381
|
+
# resp = client.subscribe_to_event({
|
1382
|
+
# resource_arn: "Arn", # required
|
1383
|
+
# event: "ASSESSMENT_RUN_STARTED", # required, accepts ASSESSMENT_RUN_STARTED, ASSESSMENT_RUN_COMPLETED, ASSESSMENT_RUN_STATE_CHANGED, FINDING_REPORTED, OTHER
|
1384
|
+
# topic_arn: "Arn", # required
|
1385
|
+
# })
|
1386
|
+
#
|
1387
|
+
# @overload subscribe_to_event(params = {})
|
1388
|
+
# @param [Hash] params ({})
|
1389
|
+
def subscribe_to_event(params = {}, options = {})
|
1390
|
+
req = build_request(:subscribe_to_event, params)
|
1391
|
+
req.send_request(options)
|
1392
|
+
end
|
1232
1393
|
|
1233
|
-
|
1234
|
-
|
1235
|
-
|
1236
|
-
|
1237
|
-
|
1238
|
-
|
1239
|
-
|
1240
|
-
|
1241
|
-
|
1242
|
-
|
1243
|
-
|
1244
|
-
|
1245
|
-
|
1246
|
-
|
1247
|
-
|
1248
|
-
|
1249
|
-
|
1250
|
-
|
1251
|
-
|
1252
|
-
|
1253
|
-
|
1254
|
-
|
1255
|
-
|
1394
|
+
# Disables the process of sending Amazon Simple Notification Service
|
1395
|
+
# (SNS) notifications about a specified event to a specified SNS topic.
|
1396
|
+
#
|
1397
|
+
# @option params [required, String] :resource_arn
|
1398
|
+
# The ARN of the assessment template that is used during the event for
|
1399
|
+
# which you want to stop receiving SNS notifications.
|
1400
|
+
#
|
1401
|
+
# @option params [required, String] :event
|
1402
|
+
# The event for which you want to stop receiving SNS notifications.
|
1403
|
+
#
|
1404
|
+
# @option params [required, String] :topic_arn
|
1405
|
+
# The ARN of the SNS topic to which SNS notifications are sent.
|
1406
|
+
#
|
1407
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1408
|
+
#
|
1409
|
+
# @example Request syntax with placeholder values
|
1410
|
+
#
|
1411
|
+
# resp = client.unsubscribe_from_event({
|
1412
|
+
# resource_arn: "Arn", # required
|
1413
|
+
# event: "ASSESSMENT_RUN_STARTED", # required, accepts ASSESSMENT_RUN_STARTED, ASSESSMENT_RUN_COMPLETED, ASSESSMENT_RUN_STATE_CHANGED, FINDING_REPORTED, OTHER
|
1414
|
+
# topic_arn: "Arn", # required
|
1415
|
+
# })
|
1416
|
+
#
|
1417
|
+
# @overload unsubscribe_from_event(params = {})
|
1418
|
+
# @param [Hash] params ({})
|
1419
|
+
def unsubscribe_from_event(params = {}, options = {})
|
1420
|
+
req = build_request(:unsubscribe_from_event, params)
|
1421
|
+
req.send_request(options)
|
1422
|
+
end
|
1256
1423
|
|
1257
|
-
|
1424
|
+
# Updates the assessment target that is specified by the ARN of the
|
1425
|
+
# assessment target.
|
1426
|
+
#
|
1427
|
+
# @option params [required, String] :assessment_target_arn
|
1428
|
+
# The ARN of the assessment target that you want to update.
|
1429
|
+
#
|
1430
|
+
# @option params [required, String] :assessment_target_name
|
1431
|
+
# The name of the assessment target that you want to update.
|
1432
|
+
#
|
1433
|
+
# @option params [required, String] :resource_group_arn
|
1434
|
+
# The ARN of the resource group that is used to specify the new resource
|
1435
|
+
# group to associate with the assessment target.
|
1436
|
+
#
|
1437
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1438
|
+
#
|
1439
|
+
# @example Request syntax with placeholder values
|
1440
|
+
#
|
1441
|
+
# resp = client.update_assessment_target({
|
1442
|
+
# assessment_target_arn: "Arn", # required
|
1443
|
+
# assessment_target_name: "AssessmentTargetName", # required
|
1444
|
+
# resource_group_arn: "Arn", # required
|
1445
|
+
# })
|
1446
|
+
#
|
1447
|
+
# @overload update_assessment_target(params = {})
|
1448
|
+
# @param [Hash] params ({})
|
1449
|
+
def update_assessment_target(params = {}, options = {})
|
1450
|
+
req = build_request(:update_assessment_target, params)
|
1451
|
+
req.send_request(options)
|
1452
|
+
end
|
1258
1453
|
|
1259
|
-
|
1260
|
-
# @api private
|
1261
|
-
def build_request(operation_name, params = {})
|
1262
|
-
handlers = @handlers.for(operation_name)
|
1263
|
-
context = Seahorse::Client::RequestContext.new(
|
1264
|
-
operation_name: operation_name,
|
1265
|
-
operation: config.api.operation(operation_name),
|
1266
|
-
client: self,
|
1267
|
-
params: params,
|
1268
|
-
config: config)
|
1269
|
-
context[:gem_name] = 'aws-sdk-inspector'
|
1270
|
-
context[:gem_version] = '1.0.0.rc1'
|
1271
|
-
Seahorse::Client::Request.new(handlers, context)
|
1272
|
-
end
|
1454
|
+
# @!endgroup
|
1273
1455
|
|
1274
|
-
|
1275
|
-
|
1276
|
-
|
1277
|
-
|
1278
|
-
|
1456
|
+
# @param params ({})
|
1457
|
+
# @api private
|
1458
|
+
def build_request(operation_name, params = {})
|
1459
|
+
handlers = @handlers.for(operation_name)
|
1460
|
+
context = Seahorse::Client::RequestContext.new(
|
1461
|
+
operation_name: operation_name,
|
1462
|
+
operation: config.api.operation(operation_name),
|
1463
|
+
client: self,
|
1464
|
+
params: params,
|
1465
|
+
config: config)
|
1466
|
+
context[:gem_name] = 'aws-sdk-inspector'
|
1467
|
+
context[:gem_version] = '1.0.0.rc1'
|
1468
|
+
Seahorse::Client::Request.new(handlers, context)
|
1469
|
+
end
|
1279
1470
|
|
1280
|
-
|
1471
|
+
# @api private
|
1472
|
+
# @deprecated
|
1473
|
+
def waiter_names
|
1474
|
+
[]
|
1475
|
+
end
|
1281
1476
|
|
1282
|
-
|
1283
|
-
attr_reader :identifier
|
1477
|
+
class << self
|
1284
1478
|
|
1285
|
-
|
1286
|
-
|
1287
|
-
Errors
|
1288
|
-
end
|
1479
|
+
# @api private
|
1480
|
+
attr_reader :identifier
|
1289
1481
|
|
1482
|
+
# @api private
|
1483
|
+
def errors_module
|
1484
|
+
Errors
|
1290
1485
|
end
|
1486
|
+
|
1291
1487
|
end
|
1292
1488
|
end
|
1293
1489
|
end
|