UNPKG

80.7 kBTypeScriptView Raw
1import {Request} from '../lib/request';
2import {Response} from '../lib/response';
3import {AWSError} from '../lib/error';
4import {Service} from '../lib/service';
5import {ServiceConfigurationOptions} from '../lib/service';
6import {ConfigBase as Config} from '../lib/config';
7interface Blob {}
8declare class Inspector extends Service {
9 /**
10 * Constructs a service object. This object has one method for each API operation.
11 */
12 constructor(options?: Inspector.Types.ClientConfiguration)
13 config: Config & Inspector.Types.ClientConfiguration;
14 /**
15 * Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings.
16 */
17 addAttributesToFindings(params: Inspector.Types.AddAttributesToFindingsRequest, callback?: (err: AWSError, data: Inspector.Types.AddAttributesToFindingsResponse) => void): Request<Inspector.Types.AddAttributesToFindingsResponse, AWSError>;
18 /**
19 * Assigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings.
20 */
21 addAttributesToFindings(callback?: (err: AWSError, data: Inspector.Types.AddAttributesToFindingsResponse) => void): Request<Inspector.Types.AddAttributesToFindingsResponse, AWSError>;
22 /**
23 * Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target. If the service-linked role isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see Amazon Inspector Assessment Targets.
24 */
25 createAssessmentTarget(params: Inspector.Types.CreateAssessmentTargetRequest, callback?: (err: AWSError, data: Inspector.Types.CreateAssessmentTargetResponse) => void): Request<Inspector.Types.CreateAssessmentTargetResponse, AWSError>;
26 /**
27 * Creates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target. If the service-linked role isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see Amazon Inspector Assessment Targets.
28 */
29 createAssessmentTarget(callback?: (err: AWSError, data: Inspector.Types.CreateAssessmentTargetResponse) => void): Request<Inspector.Types.CreateAssessmentTargetResponse, AWSError>;
30 /**
31 * Creates an assessment template for the assessment target that is specified by the ARN of the assessment target. If the service-linked role isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments.
32 */
33 createAssessmentTemplate(params: Inspector.Types.CreateAssessmentTemplateRequest, callback?: (err: AWSError, data: Inspector.Types.CreateAssessmentTemplateResponse) => void): Request<Inspector.Types.CreateAssessmentTemplateResponse, AWSError>;
34 /**
35 * Creates an assessment template for the assessment target that is specified by the ARN of the assessment target. If the service-linked role isn’t already registered, this action also creates and registers a service-linked role to grant Amazon Inspector access to AWS Services needed to perform security assessments.
36 */
37 createAssessmentTemplate(callback?: (err: AWSError, data: Inspector.Types.CreateAssessmentTemplateResponse) => void): Request<Inspector.Types.CreateAssessmentTemplateResponse, AWSError>;
38 /**
39 * Starts the generation of an exclusions preview for the specified assessment template. The exclusions preview lists the potential exclusions (ExclusionPreview) that Inspector can detect before it runs the assessment.
40 */
41 createExclusionsPreview(params: Inspector.Types.CreateExclusionsPreviewRequest, callback?: (err: AWSError, data: Inspector.Types.CreateExclusionsPreviewResponse) => void): Request<Inspector.Types.CreateExclusionsPreviewResponse, AWSError>;
42 /**
43 * Starts the generation of an exclusions preview for the specified assessment template. The exclusions preview lists the potential exclusions (ExclusionPreview) that Inspector can detect before it runs the assessment.
44 */
45 createExclusionsPreview(callback?: (err: AWSError, data: Inspector.Types.CreateExclusionsPreviewResponse) => void): Request<Inspector.Types.CreateExclusionsPreviewResponse, AWSError>;
46 /**
47 * Creates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Amazon Inspector assessment target. The created resource group is then used to create an Amazon Inspector assessment target. For more information, see CreateAssessmentTarget.
48 */
49 createResourceGroup(params: Inspector.Types.CreateResourceGroupRequest, callback?: (err: AWSError, data: Inspector.Types.CreateResourceGroupResponse) => void): Request<Inspector.Types.CreateResourceGroupResponse, AWSError>;
50 /**
51 * Creates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Amazon Inspector assessment target. The created resource group is then used to create an Amazon Inspector assessment target. For more information, see CreateAssessmentTarget.
52 */
53 createResourceGroup(callback?: (err: AWSError, data: Inspector.Types.CreateResourceGroupResponse) => void): Request<Inspector.Types.CreateResourceGroupResponse, AWSError>;
54 /**
55 * Deletes the assessment run that is specified by the ARN of the assessment run.
56 */
57 deleteAssessmentRun(params: Inspector.Types.DeleteAssessmentRunRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
58 /**
59 * Deletes the assessment run that is specified by the ARN of the assessment run.
60 */
61 deleteAssessmentRun(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
62 /**
63 * Deletes the assessment target that is specified by the ARN of the assessment target.
64 */
65 deleteAssessmentTarget(params: Inspector.Types.DeleteAssessmentTargetRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
66 /**
67 * Deletes the assessment target that is specified by the ARN of the assessment target.
68 */
69 deleteAssessmentTarget(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
70 /**
71 * Deletes the assessment template that is specified by the ARN of the assessment template.
72 */
73 deleteAssessmentTemplate(params: Inspector.Types.DeleteAssessmentTemplateRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
74 /**
75 * Deletes the assessment template that is specified by the ARN of the assessment template.
76 */
77 deleteAssessmentTemplate(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
78 /**
79 * Describes the assessment runs that are specified by the ARNs of the assessment runs.
80 */
81 describeAssessmentRuns(params: Inspector.Types.DescribeAssessmentRunsRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeAssessmentRunsResponse) => void): Request<Inspector.Types.DescribeAssessmentRunsResponse, AWSError>;
82 /**
83 * Describes the assessment runs that are specified by the ARNs of the assessment runs.
84 */
85 describeAssessmentRuns(callback?: (err: AWSError, data: Inspector.Types.DescribeAssessmentRunsResponse) => void): Request<Inspector.Types.DescribeAssessmentRunsResponse, AWSError>;
86 /**
87 * Describes the assessment targets that are specified by the ARNs of the assessment targets.
88 */
89 describeAssessmentTargets(params: Inspector.Types.DescribeAssessmentTargetsRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeAssessmentTargetsResponse) => void): Request<Inspector.Types.DescribeAssessmentTargetsResponse, AWSError>;
90 /**
91 * Describes the assessment targets that are specified by the ARNs of the assessment targets.
92 */
93 describeAssessmentTargets(callback?: (err: AWSError, data: Inspector.Types.DescribeAssessmentTargetsResponse) => void): Request<Inspector.Types.DescribeAssessmentTargetsResponse, AWSError>;
94 /**
95 * Describes the assessment templates that are specified by the ARNs of the assessment templates.
96 */
97 describeAssessmentTemplates(params: Inspector.Types.DescribeAssessmentTemplatesRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeAssessmentTemplatesResponse) => void): Request<Inspector.Types.DescribeAssessmentTemplatesResponse, AWSError>;
98 /**
99 * Describes the assessment templates that are specified by the ARNs of the assessment templates.
100 */
101 describeAssessmentTemplates(callback?: (err: AWSError, data: Inspector.Types.DescribeAssessmentTemplatesResponse) => void): Request<Inspector.Types.DescribeAssessmentTemplatesResponse, AWSError>;
102 /**
103 * Describes the IAM role that enables Amazon Inspector to access your AWS account.
104 */
105 describeCrossAccountAccessRole(callback?: (err: AWSError, data: Inspector.Types.DescribeCrossAccountAccessRoleResponse) => void): Request<Inspector.Types.DescribeCrossAccountAccessRoleResponse, AWSError>;
106 /**
107 * Describes the exclusions that are specified by the exclusions' ARNs.
108 */
109 describeExclusions(params: Inspector.Types.DescribeExclusionsRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeExclusionsResponse) => void): Request<Inspector.Types.DescribeExclusionsResponse, AWSError>;
110 /**
111 * Describes the exclusions that are specified by the exclusions' ARNs.
112 */
113 describeExclusions(callback?: (err: AWSError, data: Inspector.Types.DescribeExclusionsResponse) => void): Request<Inspector.Types.DescribeExclusionsResponse, AWSError>;
114 /**
115 * Describes the findings that are specified by the ARNs of the findings.
116 */
117 describeFindings(params: Inspector.Types.DescribeFindingsRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeFindingsResponse) => void): Request<Inspector.Types.DescribeFindingsResponse, AWSError>;
118 /**
119 * Describes the findings that are specified by the ARNs of the findings.
120 */
121 describeFindings(callback?: (err: AWSError, data: Inspector.Types.DescribeFindingsResponse) => void): Request<Inspector.Types.DescribeFindingsResponse, AWSError>;
122 /**
123 * Describes the resource groups that are specified by the ARNs of the resource groups.
124 */
125 describeResourceGroups(params: Inspector.Types.DescribeResourceGroupsRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeResourceGroupsResponse) => void): Request<Inspector.Types.DescribeResourceGroupsResponse, AWSError>;
126 /**
127 * Describes the resource groups that are specified by the ARNs of the resource groups.
128 */
129 describeResourceGroups(callback?: (err: AWSError, data: Inspector.Types.DescribeResourceGroupsResponse) => void): Request<Inspector.Types.DescribeResourceGroupsResponse, AWSError>;
130 /**
131 * Describes the rules packages that are specified by the ARNs of the rules packages.
132 */
133 describeRulesPackages(params: Inspector.Types.DescribeRulesPackagesRequest, callback?: (err: AWSError, data: Inspector.Types.DescribeRulesPackagesResponse) => void): Request<Inspector.Types.DescribeRulesPackagesResponse, AWSError>;
134 /**
135 * Describes the rules packages that are specified by the ARNs of the rules packages.
136 */
137 describeRulesPackages(callback?: (err: AWSError, data: Inspector.Types.DescribeRulesPackagesResponse) => void): Request<Inspector.Types.DescribeRulesPackagesResponse, AWSError>;
138 /**
139 * Produces an assessment report that includes detailed and comprehensive results of a specified assessment run.
140 */
141 getAssessmentReport(params: Inspector.Types.GetAssessmentReportRequest, callback?: (err: AWSError, data: Inspector.Types.GetAssessmentReportResponse) => void): Request<Inspector.Types.GetAssessmentReportResponse, AWSError>;
142 /**
143 * Produces an assessment report that includes detailed and comprehensive results of a specified assessment run.
144 */
145 getAssessmentReport(callback?: (err: AWSError, data: Inspector.Types.GetAssessmentReportResponse) => void): Request<Inspector.Types.GetAssessmentReportResponse, AWSError>;
146 /**
147 * Retrieves the exclusions preview (a list of ExclusionPreview objects) specified by the preview token. You can obtain the preview token by running the CreateExclusionsPreview API.
148 */
149 getExclusionsPreview(params: Inspector.Types.GetExclusionsPreviewRequest, callback?: (err: AWSError, data: Inspector.Types.GetExclusionsPreviewResponse) => void): Request<Inspector.Types.GetExclusionsPreviewResponse, AWSError>;
150 /**
151 * Retrieves the exclusions preview (a list of ExclusionPreview objects) specified by the preview token. You can obtain the preview token by running the CreateExclusionsPreview API.
152 */
153 getExclusionsPreview(callback?: (err: AWSError, data: Inspector.Types.GetExclusionsPreviewResponse) => void): Request<Inspector.Types.GetExclusionsPreviewResponse, AWSError>;
154 /**
155 * Information about the data that is collected for the specified assessment run.
156 */
157 getTelemetryMetadata(params: Inspector.Types.GetTelemetryMetadataRequest, callback?: (err: AWSError, data: Inspector.Types.GetTelemetryMetadataResponse) => void): Request<Inspector.Types.GetTelemetryMetadataResponse, AWSError>;
158 /**
159 * Information about the data that is collected for the specified assessment run.
160 */
161 getTelemetryMetadata(callback?: (err: AWSError, data: Inspector.Types.GetTelemetryMetadataResponse) => void): Request<Inspector.Types.GetTelemetryMetadataResponse, AWSError>;
162 /**
163 * Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.
164 */
165 listAssessmentRunAgents(params: Inspector.Types.ListAssessmentRunAgentsRequest, callback?: (err: AWSError, data: Inspector.Types.ListAssessmentRunAgentsResponse) => void): Request<Inspector.Types.ListAssessmentRunAgentsResponse, AWSError>;
166 /**
167 * Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.
168 */
169 listAssessmentRunAgents(callback?: (err: AWSError, data: Inspector.Types.ListAssessmentRunAgentsResponse) => void): Request<Inspector.Types.ListAssessmentRunAgentsResponse, AWSError>;
170 /**
171 * Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.
172 */
173 listAssessmentRuns(params: Inspector.Types.ListAssessmentRunsRequest, callback?: (err: AWSError, data: Inspector.Types.ListAssessmentRunsResponse) => void): Request<Inspector.Types.ListAssessmentRunsResponse, AWSError>;
174 /**
175 * Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.
176 */
177 listAssessmentRuns(callback?: (err: AWSError, data: Inspector.Types.ListAssessmentRunsResponse) => void): Request<Inspector.Types.ListAssessmentRunsResponse, AWSError>;
178 /**
179 * Lists the ARNs of the assessment targets within this AWS account. For more information about assessment targets, see Amazon Inspector Assessment Targets.
180 */
181 listAssessmentTargets(params: Inspector.Types.ListAssessmentTargetsRequest, callback?: (err: AWSError, data: Inspector.Types.ListAssessmentTargetsResponse) => void): Request<Inspector.Types.ListAssessmentTargetsResponse, AWSError>;
182 /**
183 * Lists the ARNs of the assessment targets within this AWS account. For more information about assessment targets, see Amazon Inspector Assessment Targets.
184 */
185 listAssessmentTargets(callback?: (err: AWSError, data: Inspector.Types.ListAssessmentTargetsResponse) => void): Request<Inspector.Types.ListAssessmentTargetsResponse, AWSError>;
186 /**
187 * Lists the assessment templates that correspond to the assessment targets that are specified by the ARNs of the assessment targets.
188 */
189 listAssessmentTemplates(params: Inspector.Types.ListAssessmentTemplatesRequest, callback?: (err: AWSError, data: Inspector.Types.ListAssessmentTemplatesResponse) => void): Request<Inspector.Types.ListAssessmentTemplatesResponse, AWSError>;
190 /**
191 * Lists the assessment templates that correspond to the assessment targets that are specified by the ARNs of the assessment targets.
192 */
193 listAssessmentTemplates(callback?: (err: AWSError, data: Inspector.Types.ListAssessmentTemplatesResponse) => void): Request<Inspector.Types.ListAssessmentTemplatesResponse, AWSError>;
194 /**
195 * Lists all the event subscriptions for the assessment template that is specified by the ARN of the assessment template. For more information, see SubscribeToEvent and UnsubscribeFromEvent.
196 */
197 listEventSubscriptions(params: Inspector.Types.ListEventSubscriptionsRequest, callback?: (err: AWSError, data: Inspector.Types.ListEventSubscriptionsResponse) => void): Request<Inspector.Types.ListEventSubscriptionsResponse, AWSError>;
198 /**
199 * Lists all the event subscriptions for the assessment template that is specified by the ARN of the assessment template. For more information, see SubscribeToEvent and UnsubscribeFromEvent.
200 */
201 listEventSubscriptions(callback?: (err: AWSError, data: Inspector.Types.ListEventSubscriptionsResponse) => void): Request<Inspector.Types.ListEventSubscriptionsResponse, AWSError>;
202 /**
203 * List exclusions that are generated by the assessment run.
204 */
205 listExclusions(params: Inspector.Types.ListExclusionsRequest, callback?: (err: AWSError, data: Inspector.Types.ListExclusionsResponse) => void): Request<Inspector.Types.ListExclusionsResponse, AWSError>;
206 /**
207 * List exclusions that are generated by the assessment run.
208 */
209 listExclusions(callback?: (err: AWSError, data: Inspector.Types.ListExclusionsResponse) => void): Request<Inspector.Types.ListExclusionsResponse, AWSError>;
210 /**
211 * Lists findings that are generated by the assessment runs that are specified by the ARNs of the assessment runs.
212 */
213 listFindings(params: Inspector.Types.ListFindingsRequest, callback?: (err: AWSError, data: Inspector.Types.ListFindingsResponse) => void): Request<Inspector.Types.ListFindingsResponse, AWSError>;
214 /**
215 * Lists findings that are generated by the assessment runs that are specified by the ARNs of the assessment runs.
216 */
217 listFindings(callback?: (err: AWSError, data: Inspector.Types.ListFindingsResponse) => void): Request<Inspector.Types.ListFindingsResponse, AWSError>;
218 /**
219 * Lists all available Amazon Inspector rules packages.
220 */
221 listRulesPackages(params: Inspector.Types.ListRulesPackagesRequest, callback?: (err: AWSError, data: Inspector.Types.ListRulesPackagesResponse) => void): Request<Inspector.Types.ListRulesPackagesResponse, AWSError>;
222 /**
223 * Lists all available Amazon Inspector rules packages.
224 */
225 listRulesPackages(callback?: (err: AWSError, data: Inspector.Types.ListRulesPackagesResponse) => void): Request<Inspector.Types.ListRulesPackagesResponse, AWSError>;
226 /**
227 * Lists all tags associated with an assessment template.
228 */
229 listTagsForResource(params: Inspector.Types.ListTagsForResourceRequest, callback?: (err: AWSError, data: Inspector.Types.ListTagsForResourceResponse) => void): Request<Inspector.Types.ListTagsForResourceResponse, AWSError>;
230 /**
231 * Lists all tags associated with an assessment template.
232 */
233 listTagsForResource(callback?: (err: AWSError, data: Inspector.Types.ListTagsForResourceResponse) => void): Request<Inspector.Types.ListTagsForResourceResponse, AWSError>;
234 /**
235 * Previews the agents installed on the EC2 instances that are part of the specified assessment target.
236 */
237 previewAgents(params: Inspector.Types.PreviewAgentsRequest, callback?: (err: AWSError, data: Inspector.Types.PreviewAgentsResponse) => void): Request<Inspector.Types.PreviewAgentsResponse, AWSError>;
238 /**
239 * Previews the agents installed on the EC2 instances that are part of the specified assessment target.
240 */
241 previewAgents(callback?: (err: AWSError, data: Inspector.Types.PreviewAgentsResponse) => void): Request<Inspector.Types.PreviewAgentsResponse, AWSError>;
242 /**
243 * Registers the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments.
244 */
245 registerCrossAccountAccessRole(params: Inspector.Types.RegisterCrossAccountAccessRoleRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
246 /**
247 * Registers the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments.
248 */
249 registerCrossAccountAccessRole(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
250 /**
251 * Removes entire attributes (key and value pairs) from the findings that are specified by the ARNs of the findings where an attribute with the specified key exists.
252 */
253 removeAttributesFromFindings(params: Inspector.Types.RemoveAttributesFromFindingsRequest, callback?: (err: AWSError, data: Inspector.Types.RemoveAttributesFromFindingsResponse) => void): Request<Inspector.Types.RemoveAttributesFromFindingsResponse, AWSError>;
254 /**
255 * Removes entire attributes (key and value pairs) from the findings that are specified by the ARNs of the findings where an attribute with the specified key exists.
256 */
257 removeAttributesFromFindings(callback?: (err: AWSError, data: Inspector.Types.RemoveAttributesFromFindingsResponse) => void): Request<Inspector.Types.RemoveAttributesFromFindingsResponse, AWSError>;
258 /**
259 * Sets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment template.
260 */
261 setTagsForResource(params: Inspector.Types.SetTagsForResourceRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
262 /**
263 * Sets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment template.
264 */
265 setTagsForResource(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
266 /**
267 * Starts the assessment run specified by the ARN of the assessment template. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.
268 */
269 startAssessmentRun(params: Inspector.Types.StartAssessmentRunRequest, callback?: (err: AWSError, data: Inspector.Types.StartAssessmentRunResponse) => void): Request<Inspector.Types.StartAssessmentRunResponse, AWSError>;
270 /**
271 * Starts the assessment run specified by the ARN of the assessment template. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.
272 */
273 startAssessmentRun(callback?: (err: AWSError, data: Inspector.Types.StartAssessmentRunResponse) => void): Request<Inspector.Types.StartAssessmentRunResponse, AWSError>;
274 /**
275 * Stops the assessment run that is specified by the ARN of the assessment run.
276 */
277 stopAssessmentRun(params: Inspector.Types.StopAssessmentRunRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
278 /**
279 * Stops the assessment run that is specified by the ARN of the assessment run.
280 */
281 stopAssessmentRun(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
282 /**
283 * Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.
284 */
285 subscribeToEvent(params: Inspector.Types.SubscribeToEventRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
286 /**
287 * Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.
288 */
289 subscribeToEvent(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
290 /**
291 * Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.
292 */
293 unsubscribeFromEvent(params: Inspector.Types.UnsubscribeFromEventRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
294 /**
295 * Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic.
296 */
297 unsubscribeFromEvent(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
298 /**
299 * Updates the assessment target that is specified by the ARN of the assessment target. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.
300 */
301 updateAssessmentTarget(params: Inspector.Types.UpdateAssessmentTargetRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
302 /**
303 * Updates the assessment target that is specified by the ARN of the assessment target. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.
304 */
305 updateAssessmentTarget(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
306}
307declare namespace Inspector {
308 export interface AddAttributesToFindingsRequest {
309 /**
310 * The ARNs that specify the findings that you want to assign attributes to.
311 */
312 findingArns: AddRemoveAttributesFindingArnList;
313 /**
314 * The array of attributes that you want to assign to specified findings.
315 */
316 attributes: UserAttributeList;
317 }
318 export interface AddAttributesToFindingsResponse {
319 /**
320 * Attribute details that cannot be described. An error code is provided for each failed item.
321 */
322 failedItems: FailedItems;
323 }
324 export type AddRemoveAttributesFindingArnList = Arn[];
325 export interface AgentFilter {
326 /**
327 * The current health state of the agent. Values can be set to HEALTHY or UNHEALTHY.
328 */
329 agentHealths: AgentHealthList;
330 /**
331 * The detailed health state of the agent. Values can be set to IDLE, RUNNING, SHUTDOWN, UNHEALTHY, THROTTLED, and UNKNOWN.
332 */
333 agentHealthCodes: AgentHealthCodeList;
334 }
335 export type AgentHealth = "HEALTHY"|"UNHEALTHY"|"UNKNOWN"|string;
336 export type AgentHealthCode = "IDLE"|"RUNNING"|"SHUTDOWN"|"UNHEALTHY"|"THROTTLED"|"UNKNOWN"|string;
337 export type AgentHealthCodeList = AgentHealthCode[];
338 export type AgentHealthList = AgentHealth[];
339 export type AgentId = string;
340 export type AgentIdList = AgentId[];
341 export interface AgentPreview {
342 /**
343 * The hostname of the EC2 instance on which the Amazon Inspector Agent is installed.
344 */
345 hostname?: Hostname;
346 /**
347 * The ID of the EC2 instance where the agent is installed.
348 */
349 agentId: AgentId;
350 /**
351 * The Auto Scaling group for the EC2 instance where the agent is installed.
352 */
353 autoScalingGroup?: AutoScalingGroup;
354 /**
355 * The health status of the Amazon Inspector Agent.
356 */
357 agentHealth?: AgentHealth;
358 /**
359 * The version of the Amazon Inspector Agent.
360 */
361 agentVersion?: AgentVersion;
362 /**
363 * The operating system running on the EC2 instance on which the Amazon Inspector Agent is installed.
364 */
365 operatingSystem?: OperatingSystem;
366 /**
367 * The kernel version of the operating system running on the EC2 instance on which the Amazon Inspector Agent is installed.
368 */
369 kernelVersion?: KernelVersion;
370 /**
371 * The IP address of the EC2 instance on which the Amazon Inspector Agent is installed.
372 */
373 ipv4Address?: Ipv4Address;
374 }
375 export type AgentPreviewList = AgentPreview[];
376 export type AgentVersion = string;
377 export type AmiId = string;
378 export type Arn = string;
379 export type ArnCount = number;
380 export type AssessmentRulesPackageArnList = Arn[];
381 export interface AssessmentRun {
382 /**
383 * The ARN of the assessment run.
384 */
385 arn: Arn;
386 /**
387 * The auto-generated name for the assessment run.
388 */
389 name: AssessmentRunName;
390 /**
391 * The ARN of the assessment template that is associated with the assessment run.
392 */
393 assessmentTemplateArn: Arn;
394 /**
395 * The state of the assessment run.
396 */
397 state: AssessmentRunState;
398 /**
399 * The duration of the assessment run.
400 */
401 durationInSeconds: AssessmentRunDuration;
402 /**
403 * The rules packages selected for the assessment run.
404 */
405 rulesPackageArns: AssessmentRulesPackageArnList;
406 /**
407 * The user-defined attributes that are assigned to every generated finding.
408 */
409 userAttributesForFindings: UserAttributeList;
410 /**
411 * The time when StartAssessmentRun was called.
412 */
413 createdAt: Timestamp;
414 /**
415 * The time when StartAssessmentRun was called.
416 */
417 startedAt?: Timestamp;
418 /**
419 * The assessment run completion time that corresponds to the rules packages evaluation completion time or failure.
420 */
421 completedAt?: Timestamp;
422 /**
423 * The last time when the assessment run's state changed.
424 */
425 stateChangedAt: Timestamp;
426 /**
427 * A Boolean value (true or false) that specifies whether the process of collecting data from the agents is completed.
428 */
429 dataCollected: Bool;
430 /**
431 * A list of the assessment run state changes.
432 */
433 stateChanges: AssessmentRunStateChangeList;
434 /**
435 * A list of notifications for the event subscriptions. A notification about a particular generated finding is added to this list only once.
436 */
437 notifications: AssessmentRunNotificationList;
438 /**
439 * Provides a total count of generated findings per severity.
440 */
441 findingCounts: AssessmentRunFindingCounts;
442 }
443 export interface AssessmentRunAgent {
444 /**
445 * The AWS account of the EC2 instance where the agent is installed.
446 */
447 agentId: AgentId;
448 /**
449 * The ARN of the assessment run that is associated with the agent.
450 */
451 assessmentRunArn: Arn;
452 /**
453 * The current health state of the agent.
454 */
455 agentHealth: AgentHealth;
456 /**
457 * The detailed health state of the agent.
458 */
459 agentHealthCode: AgentHealthCode;
460 /**
461 * The description for the agent health code.
462 */
463 agentHealthDetails?: Message;
464 /**
465 * The Auto Scaling group of the EC2 instance that is specified by the agent ID.
466 */
467 autoScalingGroup?: AutoScalingGroup;
468 /**
469 * The Amazon Inspector application data metrics that are collected by the agent.
470 */
471 telemetryMetadata: TelemetryMetadataList;
472 }
473 export type AssessmentRunAgentList = AssessmentRunAgent[];
474 export type AssessmentRunDuration = number;
475 export interface AssessmentRunFilter {
476 /**
477 * For a record to match a filter, an explicit value or a string containing a wildcard that is specified for this data type property must match the value of the assessmentRunName property of the AssessmentRun data type.
478 */
479 namePattern?: NamePattern;
480 /**
481 * For a record to match a filter, one of the values specified for this data type property must be the exact match of the value of the assessmentRunState property of the AssessmentRun data type.
482 */
483 states?: AssessmentRunStateList;
484 /**
485 * For a record to match a filter, the value that is specified for this data type property must inclusively match any value between the specified minimum and maximum values of the durationInSeconds property of the AssessmentRun data type.
486 */
487 durationRange?: DurationRange;
488 /**
489 * For a record to match a filter, the value that is specified for this data type property must be contained in the list of values of the rulesPackages property of the AssessmentRun data type.
490 */
491 rulesPackageArns?: FilterRulesPackageArnList;
492 /**
493 * For a record to match a filter, the value that is specified for this data type property must inclusively match any value between the specified minimum and maximum values of the startTime property of the AssessmentRun data type.
494 */
495 startTimeRange?: TimestampRange;
496 /**
497 * For a record to match a filter, the value that is specified for this data type property must inclusively match any value between the specified minimum and maximum values of the completedAt property of the AssessmentRun data type.
498 */
499 completionTimeRange?: TimestampRange;
500 /**
501 * For a record to match a filter, the value that is specified for this data type property must match the stateChangedAt property of the AssessmentRun data type.
502 */
503 stateChangeTimeRange?: TimestampRange;
504 }
505 export type AssessmentRunFindingCounts = {[key: string]: FindingCount};
506 export type AssessmentRunList = AssessmentRun[];
507 export type AssessmentRunName = string;
508 export interface AssessmentRunNotification {
509 /**
510 * The date of the notification.
511 */
512 date: Timestamp;
513 /**
514 * The event for which a notification is sent.
515 */
516 event: InspectorEvent;
517 /**
518 * The message included in the notification.
519 */
520 message?: Message;
521 /**
522 * The Boolean value that specifies whether the notification represents an error.
523 */
524 error: Bool;
525 /**
526 * The SNS topic to which the SNS notification is sent.
527 */
528 snsTopicArn?: Arn;
529 /**
530 * The status code of the SNS notification.
531 */
532 snsPublishStatusCode?: AssessmentRunNotificationSnsStatusCode;
533 }
534 export type AssessmentRunNotificationList = AssessmentRunNotification[];
535 export type AssessmentRunNotificationSnsStatusCode = "SUCCESS"|"TOPIC_DOES_NOT_EXIST"|"ACCESS_DENIED"|"INTERNAL_ERROR"|string;
536 export type AssessmentRunState = "CREATED"|"START_DATA_COLLECTION_PENDING"|"START_DATA_COLLECTION_IN_PROGRESS"|"COLLECTING_DATA"|"STOP_DATA_COLLECTION_PENDING"|"DATA_COLLECTED"|"START_EVALUATING_RULES_PENDING"|"EVALUATING_RULES"|"FAILED"|"ERROR"|"COMPLETED"|"COMPLETED_WITH_ERRORS"|"CANCELED"|string;
537 export interface AssessmentRunStateChange {
538 /**
539 * The last time the assessment run state changed.
540 */
541 stateChangedAt: Timestamp;
542 /**
543 * The assessment run state.
544 */
545 state: AssessmentRunState;
546 }
547 export type AssessmentRunStateChangeList = AssessmentRunStateChange[];
548 export type AssessmentRunStateList = AssessmentRunState[];
549 export interface AssessmentTarget {
550 /**
551 * The ARN that specifies the Amazon Inspector assessment target.
552 */
553 arn: Arn;
554 /**
555 * The name of the Amazon Inspector assessment target.
556 */
557 name: AssessmentTargetName;
558 /**
559 * The ARN that specifies the resource group that is associated with the assessment target.
560 */
561 resourceGroupArn?: Arn;
562 /**
563 * The time at which the assessment target is created.
564 */
565 createdAt: Timestamp;
566 /**
567 * The time at which UpdateAssessmentTarget is called.
568 */
569 updatedAt: Timestamp;
570 }
571 export interface AssessmentTargetFilter {
572 /**
573 * For a record to match a filter, an explicit value or a string that contains a wildcard that is specified for this data type property must match the value of the assessmentTargetName property of the AssessmentTarget data type.
574 */
575 assessmentTargetNamePattern?: NamePattern;
576 }
577 export type AssessmentTargetList = AssessmentTarget[];
578 export type AssessmentTargetName = string;
579 export interface AssessmentTemplate {
580 /**
581 * The ARN of the assessment template.
582 */
583 arn: Arn;
584 /**
585 * The name of the assessment template.
586 */
587 name: AssessmentTemplateName;
588 /**
589 * The ARN of the assessment target that corresponds to this assessment template.
590 */
591 assessmentTargetArn: Arn;
592 /**
593 * The duration in seconds specified for this assessment template. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).
594 */
595 durationInSeconds: AssessmentRunDuration;
596 /**
597 * The rules packages that are specified for this assessment template.
598 */
599 rulesPackageArns: AssessmentTemplateRulesPackageArnList;
600 /**
601 * The user-defined attributes that are assigned to every generated finding from the assessment run that uses this assessment template.
602 */
603 userAttributesForFindings: UserAttributeList;
604 /**
605 * The Amazon Resource Name (ARN) of the most recent assessment run associated with this assessment template. This value exists only when the value of assessmentRunCount is greaterpa than zero.
606 */
607 lastAssessmentRunArn?: Arn;
608 /**
609 * The number of existing assessment runs associated with this assessment template. This value can be zero or a positive integer.
610 */
611 assessmentRunCount: ArnCount;
612 /**
613 * The time at which the assessment template is created.
614 */
615 createdAt: Timestamp;
616 }
617 export interface AssessmentTemplateFilter {
618 /**
619 * For a record to match a filter, an explicit value or a string that contains a wildcard that is specified for this data type property must match the value of the assessmentTemplateName property of the AssessmentTemplate data type.
620 */
621 namePattern?: NamePattern;
622 /**
623 * For a record to match a filter, the value specified for this data type property must inclusively match any value between the specified minimum and maximum values of the durationInSeconds property of the AssessmentTemplate data type.
624 */
625 durationRange?: DurationRange;
626 /**
627 * For a record to match a filter, the values that are specified for this data type property must be contained in the list of values of the rulesPackageArns property of the AssessmentTemplate data type.
628 */
629 rulesPackageArns?: FilterRulesPackageArnList;
630 }
631 export type AssessmentTemplateList = AssessmentTemplate[];
632 export type AssessmentTemplateName = string;
633 export type AssessmentTemplateRulesPackageArnList = Arn[];
634 export interface AssetAttributes {
635 /**
636 * The schema version of this data type.
637 */
638 schemaVersion: NumericVersion;
639 /**
640 * The ID of the agent that is installed on the EC2 instance where the finding is generated.
641 */
642 agentId?: AgentId;
643 /**
644 * The Auto Scaling group of the EC2 instance where the finding is generated.
645 */
646 autoScalingGroup?: AutoScalingGroup;
647 /**
648 * The ID of the Amazon Machine Image (AMI) that is installed on the EC2 instance where the finding is generated.
649 */
650 amiId?: AmiId;
651 /**
652 * The hostname of the EC2 instance where the finding is generated.
653 */
654 hostname?: Hostname;
655 /**
656 * The list of IP v4 addresses of the EC2 instance where the finding is generated.
657 */
658 ipv4Addresses?: Ipv4AddressList;
659 /**
660 * The tags related to the EC2 instance where the finding is generated.
661 */
662 tags?: Tags;
663 /**
664 * An array of the network interfaces interacting with the EC2 instance where the finding is generated.
665 */
666 networkInterfaces?: NetworkInterfaces;
667 }
668 export type AssetType = "ec2-instance"|string;
669 export interface Attribute {
670 /**
671 * The attribute key.
672 */
673 key: AttributeKey;
674 /**
675 * The value assigned to the attribute key.
676 */
677 value?: AttributeValue;
678 }
679 export type AttributeKey = string;
680 export type AttributeList = Attribute[];
681 export type AttributeValue = string;
682 export type AutoScalingGroup = string;
683 export type AutoScalingGroupList = AutoScalingGroup[];
684 export type BatchDescribeArnList = Arn[];
685 export type BatchDescribeExclusionsArnList = Arn[];
686 export type Bool = boolean;
687 export interface CreateAssessmentTargetRequest {
688 /**
689 * The user-defined name that identifies the assessment target that you want to create. The name must be unique within the AWS account.
690 */
691 assessmentTargetName: AssessmentTargetName;
692 /**
693 * The ARN that specifies the resource group that is used to create the assessment target. If resourceGroupArn is not specified, all EC2 instances in the current AWS account and region are included in the assessment target.
694 */
695 resourceGroupArn?: Arn;
696 }
697 export interface CreateAssessmentTargetResponse {
698 /**
699 * The ARN that specifies the assessment target that is created.
700 */
701 assessmentTargetArn: Arn;
702 }
703 export interface CreateAssessmentTemplateRequest {
704 /**
705 * The ARN that specifies the assessment target for which you want to create the assessment template.
706 */
707 assessmentTargetArn: Arn;
708 /**
709 * The user-defined name that identifies the assessment template that you want to create. You can create several assessment templates for an assessment target. The names of the assessment templates that correspond to a particular assessment target must be unique.
710 */
711 assessmentTemplateName: AssessmentTemplateName;
712 /**
713 * The duration of the assessment run in seconds.
714 */
715 durationInSeconds: AssessmentRunDuration;
716 /**
717 * The ARNs that specify the rules packages that you want to attach to the assessment template.
718 */
719 rulesPackageArns: AssessmentTemplateRulesPackageArnList;
720 /**
721 * The user-defined attributes that are assigned to every finding that is generated by the assessment run that uses this assessment template. An attribute is a key and value pair (an Attribute object). Within an assessment template, each key must be unique.
722 */
723 userAttributesForFindings?: UserAttributeList;
724 }
725 export interface CreateAssessmentTemplateResponse {
726 /**
727 * The ARN that specifies the assessment template that is created.
728 */
729 assessmentTemplateArn: Arn;
730 }
731 export interface CreateExclusionsPreviewRequest {
732 /**
733 * The ARN that specifies the assessment template for which you want to create an exclusions preview.
734 */
735 assessmentTemplateArn: Arn;
736 }
737 export interface CreateExclusionsPreviewResponse {
738 /**
739 * Specifies the unique identifier of the requested exclusions preview. You can use the unique identifier to retrieve the exclusions preview when running the GetExclusionsPreview API.
740 */
741 previewToken: UUID;
742 }
743 export interface CreateResourceGroupRequest {
744 /**
745 * A collection of keys and an array of possible values, '[{"key":"key1","values":["Value1","Value2"]},{"key":"Key2","values":["Value3"]}]'. For example,'[{"key":"Name","values":["TestEC2Instance"]}]'.
746 */
747 resourceGroupTags: ResourceGroupTags;
748 }
749 export interface CreateResourceGroupResponse {
750 /**
751 * The ARN that specifies the resource group that is created.
752 */
753 resourceGroupArn: Arn;
754 }
755 export interface DeleteAssessmentRunRequest {
756 /**
757 * The ARN that specifies the assessment run that you want to delete.
758 */
759 assessmentRunArn: Arn;
760 }
761 export interface DeleteAssessmentTargetRequest {
762 /**
763 * The ARN that specifies the assessment target that you want to delete.
764 */
765 assessmentTargetArn: Arn;
766 }
767 export interface DeleteAssessmentTemplateRequest {
768 /**
769 * The ARN that specifies the assessment template that you want to delete.
770 */
771 assessmentTemplateArn: Arn;
772 }
773 export interface DescribeAssessmentRunsRequest {
774 /**
775 * The ARN that specifies the assessment run that you want to describe.
776 */
777 assessmentRunArns: BatchDescribeArnList;
778 }
779 export interface DescribeAssessmentRunsResponse {
780 /**
781 * Information about the assessment run.
782 */
783 assessmentRuns: AssessmentRunList;
784 /**
785 * Assessment run details that cannot be described. An error code is provided for each failed item.
786 */
787 failedItems: FailedItems;
788 }
789 export interface DescribeAssessmentTargetsRequest {
790 /**
791 * The ARNs that specifies the assessment targets that you want to describe.
792 */
793 assessmentTargetArns: BatchDescribeArnList;
794 }
795 export interface DescribeAssessmentTargetsResponse {
796 /**
797 * Information about the assessment targets.
798 */
799 assessmentTargets: AssessmentTargetList;
800 /**
801 * Assessment target details that cannot be described. An error code is provided for each failed item.
802 */
803 failedItems: FailedItems;
804 }
805 export interface DescribeAssessmentTemplatesRequest {
806 assessmentTemplateArns: BatchDescribeArnList;
807 }
808 export interface DescribeAssessmentTemplatesResponse {
809 /**
810 * Information about the assessment templates.
811 */
812 assessmentTemplates: AssessmentTemplateList;
813 /**
814 * Assessment template details that cannot be described. An error code is provided for each failed item.
815 */
816 failedItems: FailedItems;
817 }
818 export interface DescribeCrossAccountAccessRoleResponse {
819 /**
820 * The ARN that specifies the IAM role that Amazon Inspector uses to access your AWS account.
821 */
822 roleArn: Arn;
823 /**
824 * A Boolean value that specifies whether the IAM role has the necessary policies attached to enable Amazon Inspector to access your AWS account.
825 */
826 valid: Bool;
827 /**
828 * The date when the cross-account access role was registered.
829 */
830 registeredAt: Timestamp;
831 }
832 export interface DescribeExclusionsRequest {
833 /**
834 * The list of ARNs that specify the exclusions that you want to describe.
835 */
836 exclusionArns: BatchDescribeExclusionsArnList;
837 /**
838 * The locale into which you want to translate the exclusion's title, description, and recommendation.
839 */
840 locale?: Locale;
841 }
842 export interface DescribeExclusionsResponse {
843 /**
844 * Information about the exclusions.
845 */
846 exclusions: ExclusionMap;
847 /**
848 * Exclusion details that cannot be described. An error code is provided for each failed item.
849 */
850 failedItems: FailedItems;
851 }
852 export interface DescribeFindingsRequest {
853 /**
854 * The ARN that specifies the finding that you want to describe.
855 */
856 findingArns: BatchDescribeArnList;
857 /**
858 * The locale into which you want to translate a finding description, recommendation, and the short description that identifies the finding.
859 */
860 locale?: Locale;
861 }
862 export interface DescribeFindingsResponse {
863 /**
864 * Information about the finding.
865 */
866 findings: FindingList;
867 /**
868 * Finding details that cannot be described. An error code is provided for each failed item.
869 */
870 failedItems: FailedItems;
871 }
872 export interface DescribeResourceGroupsRequest {
873 /**
874 * The ARN that specifies the resource group that you want to describe.
875 */
876 resourceGroupArns: BatchDescribeArnList;
877 }
878 export interface DescribeResourceGroupsResponse {
879 /**
880 * Information about a resource group.
881 */
882 resourceGroups: ResourceGroupList;
883 /**
884 * Resource group details that cannot be described. An error code is provided for each failed item.
885 */
886 failedItems: FailedItems;
887 }
888 export interface DescribeRulesPackagesRequest {
889 /**
890 * The ARN that specifies the rules package that you want to describe.
891 */
892 rulesPackageArns: BatchDescribeArnList;
893 /**
894 * The locale that you want to translate a rules package description into.
895 */
896 locale?: Locale;
897 }
898 export interface DescribeRulesPackagesResponse {
899 /**
900 * Information about the rules package.
901 */
902 rulesPackages: RulesPackageList;
903 /**
904 * Rules package details that cannot be described. An error code is provided for each failed item.
905 */
906 failedItems: FailedItems;
907 }
908 export interface DurationRange {
909 /**
910 * The minimum value of the duration range. Must be greater than zero.
911 */
912 minSeconds?: AssessmentRunDuration;
913 /**
914 * The maximum value of the duration range. Must be less than or equal to 604800 seconds (1 week).
915 */
916 maxSeconds?: AssessmentRunDuration;
917 }
918 export interface EventSubscription {
919 /**
920 * The event for which Amazon Simple Notification Service (SNS) notifications are sent.
921 */
922 event: InspectorEvent;
923 /**
924 * The time at which SubscribeToEvent is called.
925 */
926 subscribedAt: Timestamp;
927 }
928 export type EventSubscriptionList = EventSubscription[];
929 export interface Exclusion {
930 /**
931 * The ARN that specifies the exclusion.
932 */
933 arn: Arn;
934 /**
935 * The name of the exclusion.
936 */
937 title: Text;
938 /**
939 * The description of the exclusion.
940 */
941 description: Text;
942 /**
943 * The recommendation for the exclusion.
944 */
945 recommendation: Text;
946 /**
947 * The AWS resources for which the exclusion pertains.
948 */
949 scopes: ScopeList;
950 /**
951 * The system-defined attributes for the exclusion.
952 */
953 attributes?: AttributeList;
954 }
955 export type ExclusionMap = {[key: string]: Exclusion};
956 export interface ExclusionPreview {
957 /**
958 * The name of the exclusion preview.
959 */
960 title: Text;
961 /**
962 * The description of the exclusion preview.
963 */
964 description: Text;
965 /**
966 * The recommendation for the exclusion preview.
967 */
968 recommendation: Text;
969 /**
970 * The AWS resources for which the exclusion preview pertains.
971 */
972 scopes: ScopeList;
973 /**
974 * The system-defined attributes for the exclusion preview.
975 */
976 attributes?: AttributeList;
977 }
978 export type ExclusionPreviewList = ExclusionPreview[];
979 export interface FailedItemDetails {
980 /**
981 * The status code of a failed item.
982 */
983 failureCode: FailedItemErrorCode;
984 /**
985 * Indicates whether you can immediately retry a request for this item for a specified resource.
986 */
987 retryable: Bool;
988 }
989 export type FailedItemErrorCode = "INVALID_ARN"|"DUPLICATE_ARN"|"ITEM_DOES_NOT_EXIST"|"ACCESS_DENIED"|"LIMIT_EXCEEDED"|"INTERNAL_ERROR"|string;
990 export type FailedItems = {[key: string]: FailedItemDetails};
991 export type FilterRulesPackageArnList = Arn[];
992 export interface Finding {
993 /**
994 * The ARN that specifies the finding.
995 */
996 arn: Arn;
997 /**
998 * The schema version of this data type.
999 */
1000 schemaVersion?: NumericVersion;
1001 /**
1002 * The data element is set to "Inspector".
1003 */
1004 service?: ServiceName;
1005 /**
1006 * This data type is used in the Finding data type.
1007 */
1008 serviceAttributes?: InspectorServiceAttributes;
1009 /**
1010 * The type of the host from which the finding is generated.
1011 */
1012 assetType?: AssetType;
1013 /**
1014 * A collection of attributes of the host from which the finding is generated.
1015 */
1016 assetAttributes?: AssetAttributes;
1017 /**
1018 * The ID of the finding.
1019 */
1020 id?: FindingId;
1021 /**
1022 * The name of the finding.
1023 */
1024 title?: Text;
1025 /**
1026 * The description of the finding.
1027 */
1028 description?: Text;
1029 /**
1030 * The recommendation for the finding.
1031 */
1032 recommendation?: Text;
1033 /**
1034 * The finding severity. Values can be set to High, Medium, Low, and Informational.
1035 */
1036 severity?: Severity;
1037 /**
1038 * The numeric value of the finding severity.
1039 */
1040 numericSeverity?: NumericSeverity;
1041 /**
1042 * This data element is currently not used.
1043 */
1044 confidence?: IocConfidence;
1045 /**
1046 * This data element is currently not used.
1047 */
1048 indicatorOfCompromise?: Bool;
1049 /**
1050 * The system-defined attributes for the finding.
1051 */
1052 attributes: AttributeList;
1053 /**
1054 * The user-defined attributes that are assigned to the finding.
1055 */
1056 userAttributes: UserAttributeList;
1057 /**
1058 * The time when the finding was generated.
1059 */
1060 createdAt: Timestamp;
1061 /**
1062 * The time when AddAttributesToFindings is called.
1063 */
1064 updatedAt: Timestamp;
1065 }
1066 export type FindingCount = number;
1067 export interface FindingFilter {
1068 /**
1069 * For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the agentId property of the Finding data type.
1070 */
1071 agentIds?: AgentIdList;
1072 /**
1073 * For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the autoScalingGroup property of the Finding data type.
1074 */
1075 autoScalingGroups?: AutoScalingGroupList;
1076 /**
1077 * For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the ruleName property of the Finding data type.
1078 */
1079 ruleNames?: RuleNameList;
1080 /**
1081 * For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the severity property of the Finding data type.
1082 */
1083 severities?: SeverityList;
1084 /**
1085 * For a record to match a filter, one of the values that is specified for this data type property must be the exact match of the value of the rulesPackageArn property of the Finding data type.
1086 */
1087 rulesPackageArns?: FilterRulesPackageArnList;
1088 /**
1089 * For a record to match a filter, the list of values that are specified for this data type property must be contained in the list of values of the attributes property of the Finding data type.
1090 */
1091 attributes?: AttributeList;
1092 /**
1093 * For a record to match a filter, the value that is specified for this data type property must be contained in the list of values of the userAttributes property of the Finding data type.
1094 */
1095 userAttributes?: AttributeList;
1096 /**
1097 * The time range during which the finding is generated.
1098 */
1099 creationTimeRange?: TimestampRange;
1100 }
1101 export type FindingId = string;
1102 export type FindingList = Finding[];
1103 export interface GetAssessmentReportRequest {
1104 /**
1105 * The ARN that specifies the assessment run for which you want to generate a report.
1106 */
1107 assessmentRunArn: Arn;
1108 /**
1109 * Specifies the file format (html or pdf) of the assessment report that you want to generate.
1110 */
1111 reportFileFormat: ReportFileFormat;
1112 /**
1113 * Specifies the type of the assessment report that you want to generate. There are two types of assessment reports: a finding report and a full report. For more information, see Assessment Reports.
1114 */
1115 reportType: ReportType;
1116 }
1117 export interface GetAssessmentReportResponse {
1118 /**
1119 * Specifies the status of the request to generate an assessment report.
1120 */
1121 status: ReportStatus;
1122 /**
1123 * Specifies the URL where you can find the generated assessment report. This parameter is only returned if the report is successfully generated.
1124 */
1125 url?: Url;
1126 }
1127 export interface GetExclusionsPreviewRequest {
1128 /**
1129 * The ARN that specifies the assessment template for which the exclusions preview was requested.
1130 */
1131 assessmentTemplateArn: Arn;
1132 /**
1133 * The unique identifier associated of the exclusions preview.
1134 */
1135 previewToken: UUID;
1136 /**
1137 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the GetExclusionsPreviewRequest action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.
1138 */
1139 nextToken?: PaginationToken;
1140 /**
1141 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 100. The maximum value is 500.
1142 */
1143 maxResults?: ListMaxResults;
1144 /**
1145 * The locale into which you want to translate the exclusion's title, description, and recommendation.
1146 */
1147 locale?: Locale;
1148 }
1149 export interface GetExclusionsPreviewResponse {
1150 /**
1151 * Specifies the status of the request to generate an exclusions preview.
1152 */
1153 previewStatus: PreviewStatus;
1154 /**
1155 * Information about the exclusions included in the preview.
1156 */
1157 exclusionPreviews?: ExclusionPreviewList;
1158 /**
1159 * When a response is generated, if there is more data to be listed, this parameters is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1160 */
1161 nextToken?: PaginationToken;
1162 }
1163 export interface GetTelemetryMetadataRequest {
1164 /**
1165 * The ARN that specifies the assessment run that has the telemetry data that you want to obtain.
1166 */
1167 assessmentRunArn: Arn;
1168 }
1169 export interface GetTelemetryMetadataResponse {
1170 /**
1171 * Telemetry details.
1172 */
1173 telemetryMetadata: TelemetryMetadataList;
1174 }
1175 export type Hostname = string;
1176 export type InspectorEvent = "ASSESSMENT_RUN_STARTED"|"ASSESSMENT_RUN_COMPLETED"|"ASSESSMENT_RUN_STATE_CHANGED"|"FINDING_REPORTED"|"OTHER"|string;
1177 export interface InspectorServiceAttributes {
1178 /**
1179 * The schema version of this data type.
1180 */
1181 schemaVersion: NumericVersion;
1182 /**
1183 * The ARN of the assessment run during which the finding is generated.
1184 */
1185 assessmentRunArn?: Arn;
1186 /**
1187 * The ARN of the rules package that is used to generate the finding.
1188 */
1189 rulesPackageArn?: Arn;
1190 }
1191 export type IocConfidence = number;
1192 export type Ipv4Address = string;
1193 export type Ipv4AddressList = Ipv4Address[];
1194 export type Ipv6Addresses = Text[];
1195 export type KernelVersion = string;
1196 export interface ListAssessmentRunAgentsRequest {
1197 /**
1198 * The ARN that specifies the assessment run whose agents you want to list.
1199 */
1200 assessmentRunArn: Arn;
1201 /**
1202 * You can use this parameter to specify a subset of data to be included in the action's response. For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.
1203 */
1204 filter?: AgentFilter;
1205 /**
1206 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentRunAgents action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1207 */
1208 nextToken?: PaginationToken;
1209 /**
1210 * You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 10. The maximum value is 500.
1211 */
1212 maxResults?: ListMaxResults;
1213 }
1214 export interface ListAssessmentRunAgentsResponse {
1215 /**
1216 * A list of ARNs that specifies the agents returned by the action.
1217 */
1218 assessmentRunAgents: AssessmentRunAgentList;
1219 /**
1220 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1221 */
1222 nextToken?: PaginationToken;
1223 }
1224 export interface ListAssessmentRunsRequest {
1225 /**
1226 * The ARNs that specify the assessment templates whose assessment runs you want to list.
1227 */
1228 assessmentTemplateArns?: ListParentArnList;
1229 /**
1230 * You can use this parameter to specify a subset of data to be included in the action's response. For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.
1231 */
1232 filter?: AssessmentRunFilter;
1233 /**
1234 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentRuns action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1235 */
1236 nextToken?: PaginationToken;
1237 /**
1238 * You can use this parameter to indicate the maximum number of items that you want in the response. The default value is 10. The maximum value is 500.
1239 */
1240 maxResults?: ListMaxResults;
1241 }
1242 export interface ListAssessmentRunsResponse {
1243 /**
1244 * A list of ARNs that specifies the assessment runs that are returned by the action.
1245 */
1246 assessmentRunArns: ListReturnedArnList;
1247 /**
1248 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1249 */
1250 nextToken?: PaginationToken;
1251 }
1252 export interface ListAssessmentTargetsRequest {
1253 /**
1254 * You can use this parameter to specify a subset of data to be included in the action's response. For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.
1255 */
1256 filter?: AssessmentTargetFilter;
1257 /**
1258 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentTargets action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1259 */
1260 nextToken?: PaginationToken;
1261 /**
1262 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.
1263 */
1264 maxResults?: ListMaxResults;
1265 }
1266 export interface ListAssessmentTargetsResponse {
1267 /**
1268 * A list of ARNs that specifies the assessment targets that are returned by the action.
1269 */
1270 assessmentTargetArns: ListReturnedArnList;
1271 /**
1272 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1273 */
1274 nextToken?: PaginationToken;
1275 }
1276 export interface ListAssessmentTemplatesRequest {
1277 /**
1278 * A list of ARNs that specifies the assessment targets whose assessment templates you want to list.
1279 */
1280 assessmentTargetArns?: ListParentArnList;
1281 /**
1282 * You can use this parameter to specify a subset of data to be included in the action's response. For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.
1283 */
1284 filter?: AssessmentTemplateFilter;
1285 /**
1286 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListAssessmentTemplates action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1287 */
1288 nextToken?: PaginationToken;
1289 /**
1290 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.
1291 */
1292 maxResults?: ListMaxResults;
1293 }
1294 export interface ListAssessmentTemplatesResponse {
1295 /**
1296 * A list of ARNs that specifies the assessment templates returned by the action.
1297 */
1298 assessmentTemplateArns: ListReturnedArnList;
1299 /**
1300 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1301 */
1302 nextToken?: PaginationToken;
1303 }
1304 export type ListEventSubscriptionsMaxResults = number;
1305 export interface ListEventSubscriptionsRequest {
1306 /**
1307 * The ARN of the assessment template for which you want to list the existing event subscriptions.
1308 */
1309 resourceArn?: Arn;
1310 /**
1311 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListEventSubscriptions action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1312 */
1313 nextToken?: PaginationToken;
1314 /**
1315 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.
1316 */
1317 maxResults?: ListEventSubscriptionsMaxResults;
1318 }
1319 export interface ListEventSubscriptionsResponse {
1320 /**
1321 * Details of the returned event subscriptions.
1322 */
1323 subscriptions: SubscriptionList;
1324 /**
1325 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1326 */
1327 nextToken?: PaginationToken;
1328 }
1329 export interface ListExclusionsRequest {
1330 /**
1331 * The ARN of the assessment run that generated the exclusions that you want to list.
1332 */
1333 assessmentRunArn: Arn;
1334 /**
1335 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListExclusionsRequest action. Subsequent calls to the action fill nextToken in the request with the value of nextToken from the previous response to continue listing data.
1336 */
1337 nextToken?: PaginationToken;
1338 /**
1339 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 100. The maximum value is 500.
1340 */
1341 maxResults?: ListMaxResults;
1342 }
1343 export interface ListExclusionsResponse {
1344 /**
1345 * A list of exclusions' ARNs returned by the action.
1346 */
1347 exclusionArns: ListReturnedArnList;
1348 /**
1349 * When a response is generated, if there is more data to be listed, this parameters is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1350 */
1351 nextToken?: PaginationToken;
1352 }
1353 export interface ListFindingsRequest {
1354 /**
1355 * The ARNs of the assessment runs that generate the findings that you want to list.
1356 */
1357 assessmentRunArns?: ListParentArnList;
1358 /**
1359 * You can use this parameter to specify a subset of data to be included in the action's response. For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.
1360 */
1361 filter?: FindingFilter;
1362 /**
1363 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListFindings action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1364 */
1365 nextToken?: PaginationToken;
1366 /**
1367 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.
1368 */
1369 maxResults?: ListMaxResults;
1370 }
1371 export interface ListFindingsResponse {
1372 /**
1373 * A list of ARNs that specifies the findings returned by the action.
1374 */
1375 findingArns: ListReturnedArnList;
1376 /**
1377 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1378 */
1379 nextToken?: PaginationToken;
1380 }
1381 export type ListMaxResults = number;
1382 export type ListParentArnList = Arn[];
1383 export type ListReturnedArnList = Arn[];
1384 export interface ListRulesPackagesRequest {
1385 /**
1386 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the ListRulesPackages action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1387 */
1388 nextToken?: PaginationToken;
1389 /**
1390 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.
1391 */
1392 maxResults?: ListMaxResults;
1393 }
1394 export interface ListRulesPackagesResponse {
1395 /**
1396 * The list of ARNs that specifies the rules packages returned by the action.
1397 */
1398 rulesPackageArns: ListReturnedArnList;
1399 /**
1400 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1401 */
1402 nextToken?: PaginationToken;
1403 }
1404 export interface ListTagsForResourceRequest {
1405 /**
1406 * The ARN that specifies the assessment template whose tags you want to list.
1407 */
1408 resourceArn: Arn;
1409 }
1410 export interface ListTagsForResourceResponse {
1411 /**
1412 * A collection of key and value pairs.
1413 */
1414 tags: TagList;
1415 }
1416 export type Locale = "EN_US"|string;
1417 export type Long = number;
1418 export type Message = string;
1419 export type MessageType = string;
1420 export type NamePattern = string;
1421 export interface NetworkInterface {
1422 /**
1423 * The ID of the network interface.
1424 */
1425 networkInterfaceId?: Text;
1426 /**
1427 * The ID of a subnet associated with the network interface.
1428 */
1429 subnetId?: Text;
1430 /**
1431 * The ID of a VPC associated with the network interface.
1432 */
1433 vpcId?: Text;
1434 /**
1435 * The name of a private DNS associated with the network interface.
1436 */
1437 privateDnsName?: Text;
1438 /**
1439 * The private IP address associated with the network interface.
1440 */
1441 privateIpAddress?: Text;
1442 /**
1443 * A list of the private IP addresses associated with the network interface. Includes the privateDnsName and privateIpAddress.
1444 */
1445 privateIpAddresses?: PrivateIpAddresses;
1446 /**
1447 * The name of a public DNS associated with the network interface.
1448 */
1449 publicDnsName?: Text;
1450 /**
1451 * The public IP address from which the network interface is reachable.
1452 */
1453 publicIp?: Text;
1454 /**
1455 * The IP addresses associated with the network interface.
1456 */
1457 ipv6Addresses?: Ipv6Addresses;
1458 /**
1459 * A list of the security groups associated with the network interface. Includes the groupId and groupName.
1460 */
1461 securityGroups?: SecurityGroups;
1462 }
1463 export type NetworkInterfaces = NetworkInterface[];
1464 export type NumericSeverity = number;
1465 export type NumericVersion = number;
1466 export type OperatingSystem = string;
1467 export type PaginationToken = string;
1468 export type PreviewAgentsMaxResults = number;
1469 export interface PreviewAgentsRequest {
1470 /**
1471 * The ARN of the assessment target whose agents you want to preview.
1472 */
1473 previewAgentsArn: Arn;
1474 /**
1475 * You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the PreviewAgents action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from the previous response to continue listing data.
1476 */
1477 nextToken?: PaginationToken;
1478 /**
1479 * You can use this parameter to indicate the maximum number of items you want in the response. The default value is 10. The maximum value is 500.
1480 */
1481 maxResults?: PreviewAgentsMaxResults;
1482 }
1483 export interface PreviewAgentsResponse {
1484 /**
1485 * The resulting list of agents.
1486 */
1487 agentPreviews: AgentPreviewList;
1488 /**
1489 * When a response is generated, if there is more data to be listed, this parameter is present in the response and contains the value to use for the nextToken parameter in a subsequent pagination request. If there is no more data to be listed, this parameter is set to null.
1490 */
1491 nextToken?: PaginationToken;
1492 }
1493 export type PreviewStatus = "WORK_IN_PROGRESS"|"COMPLETED"|string;
1494 export interface PrivateIp {
1495 /**
1496 * The DNS name of the private IP address.
1497 */
1498 privateDnsName?: Text;
1499 /**
1500 * The full IP address of the network inteface.
1501 */
1502 privateIpAddress?: Text;
1503 }
1504 export type PrivateIpAddresses = PrivateIp[];
1505 export type ProviderName = string;
1506 export interface RegisterCrossAccountAccessRoleRequest {
1507 /**
1508 * The ARN of the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments.
1509 */
1510 roleArn: Arn;
1511 }
1512 export interface RemoveAttributesFromFindingsRequest {
1513 /**
1514 * The ARNs that specify the findings that you want to remove attributes from.
1515 */
1516 findingArns: AddRemoveAttributesFindingArnList;
1517 /**
1518 * The array of attribute keys that you want to remove from specified findings.
1519 */
1520 attributeKeys: UserAttributeKeyList;
1521 }
1522 export interface RemoveAttributesFromFindingsResponse {
1523 /**
1524 * Attributes details that cannot be described. An error code is provided for each failed item.
1525 */
1526 failedItems: FailedItems;
1527 }
1528 export type ReportFileFormat = "HTML"|"PDF"|string;
1529 export type ReportStatus = "WORK_IN_PROGRESS"|"FAILED"|"COMPLETED"|string;
1530 export type ReportType = "FINDING"|"FULL"|string;
1531 export interface ResourceGroup {
1532 /**
1533 * The ARN of the resource group.
1534 */
1535 arn: Arn;
1536 /**
1537 * The tags (key and value pairs) of the resource group. This data type property is used in the CreateResourceGroup action.
1538 */
1539 tags: ResourceGroupTags;
1540 /**
1541 * The time at which resource group is created.
1542 */
1543 createdAt: Timestamp;
1544 }
1545 export type ResourceGroupList = ResourceGroup[];
1546 export interface ResourceGroupTag {
1547 /**
1548 * A tag key.
1549 */
1550 key: TagKey;
1551 /**
1552 * The value assigned to a tag key.
1553 */
1554 value?: TagValue;
1555 }
1556 export type ResourceGroupTags = ResourceGroupTag[];
1557 export type RuleName = string;
1558 export type RuleNameList = RuleName[];
1559 export interface RulesPackage {
1560 /**
1561 * The ARN of the rules package.
1562 */
1563 arn: Arn;
1564 /**
1565 * The name of the rules package.
1566 */
1567 name: RulesPackageName;
1568 /**
1569 * The version ID of the rules package.
1570 */
1571 version: Version;
1572 /**
1573 * The provider of the rules package.
1574 */
1575 provider: ProviderName;
1576 /**
1577 * The description of the rules package.
1578 */
1579 description?: Text;
1580 }
1581 export type RulesPackageList = RulesPackage[];
1582 export type RulesPackageName = string;
1583 export interface Scope {
1584 /**
1585 * The type of the scope.
1586 */
1587 key?: ScopeType;
1588 /**
1589 * The resource identifier for the specified scope type.
1590 */
1591 value?: ScopeValue;
1592 }
1593 export type ScopeList = Scope[];
1594 export type ScopeType = "INSTANCE_ID"|"RULES_PACKAGE_ARN"|string;
1595 export type ScopeValue = string;
1596 export interface SecurityGroup {
1597 /**
1598 * The name of the security group.
1599 */
1600 groupName?: Text;
1601 /**
1602 * The ID of the security group.
1603 */
1604 groupId?: Text;
1605 }
1606 export type SecurityGroups = SecurityGroup[];
1607 export type ServiceName = string;
1608 export interface SetTagsForResourceRequest {
1609 /**
1610 * The ARN of the assessment template that you want to set tags to.
1611 */
1612 resourceArn: Arn;
1613 /**
1614 * A collection of key and value pairs that you want to set to the assessment template.
1615 */
1616 tags?: TagList;
1617 }
1618 export type Severity = "Low"|"Medium"|"High"|"Informational"|"Undefined"|string;
1619 export type SeverityList = Severity[];
1620 export interface StartAssessmentRunRequest {
1621 /**
1622 * The ARN of the assessment template of the assessment run that you want to start.
1623 */
1624 assessmentTemplateArn: Arn;
1625 /**
1626 * You can specify the name for the assessment run. The name must be unique for the assessment template whose ARN is used to start the assessment run.
1627 */
1628 assessmentRunName?: AssessmentRunName;
1629 }
1630 export interface StartAssessmentRunResponse {
1631 /**
1632 * The ARN of the assessment run that has been started.
1633 */
1634 assessmentRunArn: Arn;
1635 }
1636 export type StopAction = "START_EVALUATION"|"SKIP_EVALUATION"|string;
1637 export interface StopAssessmentRunRequest {
1638 /**
1639 * The ARN of the assessment run that you want to stop.
1640 */
1641 assessmentRunArn: Arn;
1642 /**
1643 * An input option that can be set to either START_EVALUATION or SKIP_EVALUATION. START_EVALUATION (the default value), stops the AWS agent from collecting data and begins the results evaluation and the findings generation process. SKIP_EVALUATION cancels the assessment run immediately, after which no findings are generated.
1644 */
1645 stopAction?: StopAction;
1646 }
1647 export interface SubscribeToEventRequest {
1648 /**
1649 * The ARN of the assessment template that is used during the event for which you want to receive SNS notifications.
1650 */
1651 resourceArn: Arn;
1652 /**
1653 * The event for which you want to receive SNS notifications.
1654 */
1655 event: InspectorEvent;
1656 /**
1657 * The ARN of the SNS topic to which the SNS notifications are sent.
1658 */
1659 topicArn: Arn;
1660 }
1661 export interface Subscription {
1662 /**
1663 * The ARN of the assessment template that is used during the event for which the SNS notification is sent.
1664 */
1665 resourceArn: Arn;
1666 /**
1667 * The ARN of the Amazon Simple Notification Service (SNS) topic to which the SNS notifications are sent.
1668 */
1669 topicArn: Arn;
1670 /**
1671 * The list of existing event subscriptions.
1672 */
1673 eventSubscriptions: EventSubscriptionList;
1674 }
1675 export type SubscriptionList = Subscription[];
1676 export interface Tag {
1677 /**
1678 * A tag key.
1679 */
1680 key: TagKey;
1681 /**
1682 * A value assigned to a tag key.
1683 */
1684 value?: TagValue;
1685 }
1686 export type TagKey = string;
1687 export type TagList = Tag[];
1688 export type TagValue = string;
1689 export type Tags = Tag[];
1690 export interface TelemetryMetadata {
1691 /**
1692 * A specific type of behavioral data that is collected by the agent.
1693 */
1694 messageType: MessageType;
1695 /**
1696 * The count of messages that the agent sends to the Amazon Inspector service.
1697 */
1698 count: Long;
1699 /**
1700 * The data size of messages that the agent sends to the Amazon Inspector service.
1701 */
1702 dataSize?: Long;
1703 }
1704 export type TelemetryMetadataList = TelemetryMetadata[];
1705 export type Text = string;
1706 export type Timestamp = Date;
1707 export interface TimestampRange {
1708 /**
1709 * The minimum value of the timestamp range.
1710 */
1711 beginDate?: Timestamp;
1712 /**
1713 * The maximum value of the timestamp range.
1714 */
1715 endDate?: Timestamp;
1716 }
1717 export type UUID = string;
1718 export interface UnsubscribeFromEventRequest {
1719 /**
1720 * The ARN of the assessment template that is used during the event for which you want to stop receiving SNS notifications.
1721 */
1722 resourceArn: Arn;
1723 /**
1724 * The event for which you want to stop receiving SNS notifications.
1725 */
1726 event: InspectorEvent;
1727 /**
1728 * The ARN of the SNS topic to which SNS notifications are sent.
1729 */
1730 topicArn: Arn;
1731 }
1732 export interface UpdateAssessmentTargetRequest {
1733 /**
1734 * The ARN of the assessment target that you want to update.
1735 */
1736 assessmentTargetArn: Arn;
1737 /**
1738 * The name of the assessment target that you want to update.
1739 */
1740 assessmentTargetName: AssessmentTargetName;
1741 /**
1742 * The ARN of the resource group that is used to specify the new resource group to associate with the assessment target.
1743 */
1744 resourceGroupArn?: Arn;
1745 }
1746 export type Url = string;
1747 export type UserAttributeKeyList = AttributeKey[];
1748 export type UserAttributeList = Attribute[];
1749 export type Version = string;
1750 /**
1751 * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
1752 */
1753 export type apiVersion = "2015-08-18"|"2016-02-16"|"latest"|string;
1754 export interface ClientApiVersions {
1755 /**
1756 * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
1757 */
1758 apiVersion?: apiVersion;
1759 }
1760 export type ClientConfiguration = ServiceConfigurationOptions & ClientApiVersions;
1761 /**
1762 * Contains interfaces for use with the Inspector client.
1763 */
1764 export import Types = Inspector;
1765}
1766export = Inspector;