{ "version":"2.0", "metadata":{ "apiVersion":"2015-08-18", "endpointPrefix":"inspector", "jsonVersion":"1.1", "protocol":"json", "serviceFullName":"Amazon Inspector", "serviceId":"Inspector", "signatureVersion":"v4", "targetPrefix":"InspectorService" }, "operations":{ "AddAttributesToFindings":{ "name":"AddAttributesToFindings", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"AddAttributesToFindingsRequest"}, "output":{"shape":"AddAttributesToFindingsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Assigns attributes (key and value pair) to the findings specified by the findings' ARNs.

" }, "AttachAssessmentAndRulesPackage":{ "name":"AttachAssessmentAndRulesPackage", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"AttachAssessmentAndRulesPackageRequest"}, "output":{"shape":"AttachAssessmentAndRulesPackageResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Attaches the rules package specified by the rules package ARN to the assessment specified by the assessment ARN.

" }, "CreateApplication":{ "name":"CreateApplication", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"CreateApplicationRequest"}, "output":{"shape":"CreateApplicationResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Creates a new application using the resource group ARN generated by CreateResourceGroup. You can create up to 50 applications per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see Inspector Applications.

" }, "CreateAssessment":{ "name":"CreateAssessment", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"CreateAssessmentRequest"}, "output":{"shape":"CreateAssessmentResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Creates an assessment for the application specified by the application ARN. You can create up to 500 assessments per AWS account.

" }, "CreateResourceGroup":{ "name":"CreateResourceGroup", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"CreateResourceGroupRequest"}, "output":{"shape":"CreateResourceGroupResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"} ], "documentation":"

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 Inspector application. The created resource group is then used to create an Inspector application.

" }, "DeleteApplication":{ "name":"DeleteApplication", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DeleteApplicationRequest"}, "output":{"shape":"DeleteApplicationResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"OperationInProgressException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Deletes the application specified by the application ARN.

" }, "DeleteAssessment":{ "name":"DeleteAssessment", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DeleteAssessmentRequest"}, "output":{"shape":"DeleteAssessmentResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"OperationInProgressException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Deletes the assessment specified by the assessment ARN.

" }, "DeleteRun":{ "name":"DeleteRun", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DeleteRunRequest"}, "output":{"shape":"DeleteRunResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Deletes the assessment run specified by the run ARN.

" }, "DescribeApplication":{ "name":"DescribeApplication", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DescribeApplicationRequest"}, "output":{"shape":"DescribeApplicationResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Describes the application specified by the application ARN.

" }, "DescribeAssessment":{ "name":"DescribeAssessment", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DescribeAssessmentRequest"}, "output":{"shape":"DescribeAssessmentResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Describes the assessment specified by the assessment ARN.

" }, "DescribeCrossAccountAccessRole":{ "name":"DescribeCrossAccountAccessRole", "http":{ "method":"POST", "requestUri":"/" }, "output":{"shape":"DescribeCrossAccountAccessRoleResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Describes the IAM role that enables Inspector to access your AWS account.

" }, "DescribeFinding":{ "name":"DescribeFinding", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DescribeFindingRequest"}, "output":{"shape":"DescribeFindingResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Describes the finding specified by the finding ARN.

" }, "DescribeResourceGroup":{ "name":"DescribeResourceGroup", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DescribeResourceGroupRequest"}, "output":{"shape":"DescribeResourceGroupResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Describes the resource group specified by the resource group ARN.

" }, "DescribeRulesPackage":{ "name":"DescribeRulesPackage", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DescribeRulesPackageRequest"}, "output":{"shape":"DescribeRulesPackageResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Describes the rules package specified by the rules package ARN.

" }, "DescribeRun":{ "name":"DescribeRun", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DescribeRunRequest"}, "output":{"shape":"DescribeRunResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Describes the assessment run specified by the run ARN.

" }, "DetachAssessmentAndRulesPackage":{ "name":"DetachAssessmentAndRulesPackage", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"DetachAssessmentAndRulesPackageRequest"}, "output":{"shape":"DetachAssessmentAndRulesPackageResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Detaches the rules package specified by the rules package ARN from the assessment specified by the assessment ARN.

" }, "GetAssessmentTelemetry":{ "name":"GetAssessmentTelemetry", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"GetAssessmentTelemetryRequest"}, "output":{"shape":"GetAssessmentTelemetryResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Returns the metadata about the telemetry (application behavioral data) for the assessment specified by the assessment ARN.

" }, "ListApplications":{ "name":"ListApplications", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListApplicationsRequest"}, "output":{"shape":"ListApplicationsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Lists the ARNs of the applications within this AWS account. For more information about applications, see Inspector Applications.

" }, "ListAssessmentAgents":{ "name":"ListAssessmentAgents", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListAssessmentAgentsRequest"}, "output":{"shape":"ListAssessmentAgentsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists the agents of the assessment specified by the assessment ARN.

" }, "ListAssessments":{ "name":"ListAssessments", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListAssessmentsRequest"}, "output":{"shape":"ListAssessmentsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists the assessments corresponding to applications specified by the applications' ARNs.

" }, "ListAttachedAssessments":{ "name":"ListAttachedAssessments", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListAttachedAssessmentsRequest"}, "output":{"shape":"ListAttachedAssessmentsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists the assessments attached to the rules package specified by the rules package ARN.

" }, "ListAttachedRulesPackages":{ "name":"ListAttachedRulesPackages", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListAttachedRulesPackagesRequest"}, "output":{"shape":"ListAttachedRulesPackagesResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists the rules packages attached to the assessment specified by the assessment ARN.

" }, "ListFindings":{ "name":"ListFindings", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListFindingsRequest"}, "output":{"shape":"ListFindingsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists findings generated by the assessment run specified by the run ARNs.

" }, "ListRulesPackages":{ "name":"ListRulesPackages", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListRulesPackagesRequest"}, "output":{"shape":"ListRulesPackagesResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"} ], "documentation":"

Lists all available Inspector rules packages.

" }, "ListRuns":{ "name":"ListRuns", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListRunsRequest"}, "output":{"shape":"ListRunsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists the assessment runs associated with the assessments specified by the assessment ARNs.

" }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Lists all tags associated with a resource.

" }, "LocalizeText":{ "name":"LocalizeText", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"LocalizeTextRequest"}, "output":{"shape":"LocalizeTextResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Translates a textual identifier into a user-readable text in a specified locale.

" }, "PreviewAgentsForResourceGroup":{ "name":"PreviewAgentsForResourceGroup", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"PreviewAgentsForResourceGroupRequest"}, "output":{"shape":"PreviewAgentsForResourceGroupResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"}, {"shape":"InvalidCrossAccountRoleException"} ], "documentation":"

Previews the agents installed on the EC2 instances that are included in the application created with the specified resource group.

" }, "RegisterCrossAccountAccessRole":{ "name":"RegisterCrossAccountAccessRole", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"RegisterCrossAccountAccessRoleRequest"}, "output":{"shape":"RegisterCrossAccountAccessRoleResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"InvalidCrossAccountRoleException"} ], "documentation":"

Register the role that Inspector uses to list your EC2 instances during the assessment.

" }, "RemoveAttributesFromFindings":{ "name":"RemoveAttributesFromFindings", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"RemoveAttributesFromFindingsRequest"}, "output":{"shape":"RemoveAttributesFromFindingsResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Removes the entire attribute (key and value pair) from the findings specified by the finding ARNs where an attribute with the specified key exists.

" }, "RunAssessment":{ "name":"RunAssessment", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"RunAssessmentRequest"}, "output":{"shape":"RunAssessmentResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Starts the analysis of the application’s behavior against selected rule packages for the assessment specified by the assessment ARN.

" }, "SetTagsForResource":{ "name":"SetTagsForResource", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"SetTagsForResourceRequest"}, "output":{"shape":"SetTagsForResourceResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Sets tags (key and value pairs) to the assessment specified by the assessment ARN.

" }, "StartDataCollection":{ "name":"StartDataCollection", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"StartDataCollectionRequest"}, "output":{"shape":"StartDataCollectionResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"}, {"shape":"InvalidCrossAccountRoleException"} ], "documentation":"

Starts data collection for the assessment specified by the assessment ARN. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.

" }, "StopDataCollection":{ "name":"StopDataCollection", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"StopDataCollectionRequest"}, "output":{"shape":"StopDataCollectionResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Stop data collection for the assessment specified by the assessment ARN.

" }, "UpdateApplication":{ "name":"UpdateApplication", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"UpdateApplicationRequest"}, "output":{"shape":"UpdateApplicationResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Updates application specified by the application ARN.

" }, "UpdateAssessment":{ "name":"UpdateAssessment", "http":{ "method":"POST", "requestUri":"/" }, "input":{"shape":"UpdateAssessmentRequest"}, "output":{"shape":"UpdateAssessmentResponse"}, "errors":[ {"shape":"InternalException"}, {"shape":"InvalidInputException"}, {"shape":"AccessDeniedException"}, {"shape":"NoSuchEntityException"} ], "documentation":"

Updates the assessment specified by the assessment ARN.

" } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "members":{ }, "exception":true }, "AddAttributesToFindingsRequest":{ "type":"structure", "required":[ "findingArns", "attributes" ], "members":{ "findingArns":{ "shape":"ArnList", "documentation":"

The ARNs specifying the findings that you want to assign attributes to.

" }, "attributes":{ "shape":"AttributeList", "documentation":"

The array of attributes that you want to assign to specified findings.

" } } }, "AddAttributesToFindingsResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "Agent":{ "type":"structure", "members":{ "agentId":{ "shape":"AgentId", "documentation":"

The EC2 instance ID where the agent is installed.

" }, "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment that is associated with the agent.

" }, "agentHealth":{ "shape":"AgentHealth", "documentation":"

The current health state of the agent. Values can be set to HEALTHY or UNHEALTHY.

" }, "agentHealthCode":{ "shape":"AgentHealthCode", "documentation":"

The detailed health state of the agent. Values can be set to RUNNING, HEALTHY, UNHEALTHY, UNKNOWN, BLACKLISTED, SHUTDOWN, THROTTLED.

" }, "agentHealthDetails":{ "shape":"AgentHealthDetails", "documentation":"

The description for the agent health code.

" }, "autoScalingGroup":{ "shape":"AutoScalingGroup", "documentation":"

This data type property is currently not used.

" }, "accountId":{ "shape":"AwsAccount", "documentation":"

AWS account of the EC2 instance where the agent is installed.

" }, "telemetry":{ "shape":"TelemetryList", "documentation":"

The Inspector application data metrics collected by the agent.

" } }, "documentation":"

Contains information about an Inspector agent. This data type is used as a response element in the ListAssessmentAgents action.

" }, "AgentHealth":{"type":"string"}, "AgentHealthCode":{"type":"string"}, "AgentHealthDetails":{"type":"string"}, "AgentHealthList":{ "type":"list", "member":{"shape":"AgentHealth"} }, "AgentId":{"type":"string"}, "AgentList":{ "type":"list", "member":{"shape":"Agent"} }, "AgentPreview":{ "type":"structure", "members":{ "agentId":{ "shape":"AgentId", "documentation":"

The id of the EC2 instance where the agent is intalled.

" }, "autoScalingGroup":{ "shape":"AutoScalingGroup", "documentation":"

The autoscaling group for the EC2 instance where the agent is installed.

" } }, "documentation":"

This data type is used as a response element in the PreviewAgentsForResourceGroup action.

" }, "AgentPreviewList":{ "type":"list", "member":{"shape":"AgentPreview"} }, "AgentsFilter":{ "type":"structure", "members":{ "agentHealthList":{ "shape":"AgentHealthList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the agentHealth property of the Agent data type.

" } }, "documentation":"

This data type is used as a response element in the ListAssessmentAgents action.

" }, "Application":{ "type":"structure", "members":{ "applicationArn":{ "shape":"Arn", "documentation":"

The ARN specifying the Inspector application.

" }, "applicationName":{ "shape":"Name", "documentation":"

The name of the Inspector application.

" }, "resourceGroupArn":{ "shape":"Arn", "documentation":"

The ARN specifying the resource group that is associated with the application.

" } }, "documentation":"

Contains information about an Inspector application.

This data type is used as the response element in the DescribeApplication action.

" }, "ApplicationsFilter":{ "type":"structure", "members":{ "applicationNamePatterns":{ "shape":"NamePatternList", "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard specified for this data type property must match the value of the applicationName property of the Application data type.

" } }, "documentation":"

This data type is used as the request parameter in the ListApplications action.

" }, "Arn":{"type":"string"}, "ArnList":{ "type":"list", "member":{"shape":"Arn"} }, "Assessment":{ "type":"structure", "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment.

" }, "assessmentName":{ "shape":"Name", "documentation":"

The name of the assessment.

" }, "applicationArn":{ "shape":"Arn", "documentation":"

The ARN of the application that corresponds to this assessment.

" }, "assessmentState":{ "shape":"AssessmentState", "documentation":"

The state of the assessment. Values can be set to Created, Collecting Data, Stopping, and Completed.

" }, "failureMessage":{ "shape":"FailureMessage", "documentation":"

This data type property is not currently used.

" }, "dataCollected":{ "shape":"Bool", "documentation":"

Boolean value (true or false) specifying whether the data collection process is completed.

" }, "startTime":{ "shape":"Timestamp", "documentation":"

The assessment start time.

" }, "endTime":{ "shape":"Timestamp", "documentation":"

The assessment end time.

" }, "durationInSeconds":{ "shape":"Duration", "documentation":"

The assessment duration in seconds. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" }, "userAttributesForFindings":{ "shape":"AttributeList", "documentation":"

The user-defined attributes that are assigned to every generated finding.

" } }, "documentation":"

Contains information about an Inspector assessment.

This data type is used as the response element in the DescribeAssessment action.

" }, "AssessmentState":{"type":"string"}, "AssessmentStateList":{ "type":"list", "member":{"shape":"AssessmentState"} }, "AssessmentsFilter":{ "type":"structure", "members":{ "assessmentNamePatterns":{ "shape":"NamePatternList", "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard specified for this data type property must match the value of the assessmentName property of the Assessment data type.

" }, "assessmentStates":{ "shape":"AssessmentStateList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the assessmentState property of the Assessment data type.

" }, "dataCollected":{ "shape":"Bool", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the dataCollected property of the Assessment data type.

" }, "startTimeRange":{ "shape":"TimestampRange", "documentation":"

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 startTime property of the Assessment data type.

" }, "endTimeRange":{ "shape":"TimestampRange", "documentation":"

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 endTime property of the Assessment data type.

" }, "durationRange":{ "shape":"DurationRange", "documentation":"

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 Assessment data type.

" } }, "documentation":"

This data type is used as the request parameter in the ListAssessments and ListAttachedAssessments actions.

" }, "AttachAssessmentAndRulesPackageRequest":{ "type":"structure", "required":[ "assessmentArn", "rulesPackageArn" ], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment to which you want to attach a rules package.

" }, "rulesPackageArn":{ "shape":"Arn", "documentation":"

The ARN specifying the rules package that you want to attach to the assessment.

" } } }, "AttachAssessmentAndRulesPackageResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "Attribute":{ "type":"structure", "members":{ "key":{ "shape":"AttributeKey", "documentation":"

The attribute key.

" }, "value":{ "shape":"AttributeValue", "documentation":"

The value assigned to the attribute key.

" } }, "documentation":"

This data type is used as a response element in the AddAttributesToFindings action and a request parameter in the CreateAssessment action.

" }, "AttributeKey":{"type":"string"}, "AttributeKeyList":{ "type":"list", "member":{"shape":"AttributeKey"} }, "AttributeList":{ "type":"list", "member":{"shape":"Attribute"} }, "AttributeValue":{"type":"string"}, "AutoScalingGroup":{"type":"string"}, "AwsAccount":{"type":"string"}, "Bool":{"type":"boolean"}, "CreateApplicationRequest":{ "type":"structure", "required":[ "applicationName", "resourceGroupArn" ], "members":{ "applicationName":{ "shape":"Name", "documentation":"

The user-defined name identifying the application that you want to create. The name must be unique within the AWS account.

" }, "resourceGroupArn":{ "shape":"Arn", "documentation":"

The ARN specifying the resource group that is used to create the application.

" } } }, "CreateApplicationResponse":{ "type":"structure", "members":{ "applicationArn":{ "shape":"Arn", "documentation":"

The ARN specifying the application that is created.

" } } }, "CreateAssessmentRequest":{ "type":"structure", "required":[ "applicationArn", "assessmentName", "durationInSeconds" ], "members":{ "applicationArn":{ "shape":"Arn", "documentation":"

The ARN specifying the application for which you want to create an assessment.

" }, "assessmentName":{ "shape":"Name", "documentation":"

The user-defined name identifying the assessment that you want to create. You can create several assessments for an application. The names of the assessments corresponding to a particular application must be unique.

" }, "durationInSeconds":{ "shape":"Duration", "documentation":"

The duration of the assessment in seconds. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" }, "userAttributesForFindings":{ "shape":"AttributeList", "documentation":"

The user-defined attributes that are assigned to every finding generated by running this assessment.

" } } }, "CreateAssessmentResponse":{ "type":"structure", "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment that is created.

" } } }, "CreateResourceGroupRequest":{ "type":"structure", "required":["resourceGroupTags"], "members":{ "resourceGroupTags":{ "shape":"ResourceGroupTags", "documentation":"

A collection of keys and an array of possible values in JSON format.

For example, [{ \"key1\" : [\"Value1\",\"Value2\"]},{\"Key2\": [\"Value3\"]}]

" } } }, "CreateResourceGroupResponse":{ "type":"structure", "members":{ "resourceGroupArn":{ "shape":"Arn", "documentation":"

The ARN specifying the resource group that is created.

" } } }, "DeleteApplicationRequest":{ "type":"structure", "required":["applicationArn"], "members":{ "applicationArn":{ "shape":"Arn", "documentation":"

The ARN specifying the application that you want to delete.

" } } }, "DeleteApplicationResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "DeleteAssessmentRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment that you want to delete.

" } } }, "DeleteAssessmentResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "DeleteRunRequest":{ "type":"structure", "required":["runArn"], "members":{ "runArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment run that you want to delete.

" } } }, "DeleteRunResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "DescribeApplicationRequest":{ "type":"structure", "required":["applicationArn"], "members":{ "applicationArn":{ "shape":"Arn", "documentation":"

The ARN specifying the application that you want to describe.

" } } }, "DescribeApplicationResponse":{ "type":"structure", "members":{ "application":{ "shape":"Application", "documentation":"

Information about the application.

" } } }, "DescribeAssessmentRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment that you want to describe.

" } } }, "DescribeAssessmentResponse":{ "type":"structure", "members":{ "assessment":{ "shape":"Assessment", "documentation":"

Information about the assessment.

" } } }, "DescribeCrossAccountAccessRoleResponse":{ "type":"structure", "members":{ "roleArn":{ "shape":"Arn", "documentation":"

The ARN specifying the IAM role that Inspector uses to access your AWS account.

" }, "valid":{ "shape":"Bool", "documentation":"

A Boolean value that specifies whether the IAM role has the necessary policies attached to enable Inspector to access your AWS account.

" } } }, "DescribeFindingRequest":{ "type":"structure", "required":["findingArn"], "members":{ "findingArn":{ "shape":"Arn", "documentation":"

The ARN specifying the finding that you want to describe.

" } } }, "DescribeFindingResponse":{ "type":"structure", "members":{ "finding":{ "shape":"Finding", "documentation":"

Information about the finding.

" } } }, "DescribeResourceGroupRequest":{ "type":"structure", "required":["resourceGroupArn"], "members":{ "resourceGroupArn":{ "shape":"Arn", "documentation":"

The ARN specifying the resource group that you want to describe.

" } } }, "DescribeResourceGroupResponse":{ "type":"structure", "members":{ "resourceGroup":{ "shape":"ResourceGroup", "documentation":"

Information about the resource group.

" } } }, "DescribeRulesPackageRequest":{ "type":"structure", "required":["rulesPackageArn"], "members":{ "rulesPackageArn":{ "shape":"Arn", "documentation":"

The ARN specifying the rules package that you want to describe.

" } } }, "DescribeRulesPackageResponse":{ "type":"structure", "members":{ "rulesPackage":{ "shape":"RulesPackage", "documentation":"

Information about the rules package.

" } } }, "DescribeRunRequest":{ "type":"structure", "required":["runArn"], "members":{ "runArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment run that you want to describe.

" } } }, "DescribeRunResponse":{ "type":"structure", "members":{ "run":{ "shape":"Run", "documentation":"

Information about the assessment run.

" } } }, "DetachAssessmentAndRulesPackageRequest":{ "type":"structure", "required":[ "assessmentArn", "rulesPackageArn" ], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment from which you want to detach a rules package.

" }, "rulesPackageArn":{ "shape":"Arn", "documentation":"

The ARN specifying the rules package that you want to detach from the assessment.

" } } }, "DetachAssessmentAndRulesPackageResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "Duration":{"type":"integer"}, "DurationRange":{ "type":"structure", "members":{ "minimum":{ "shape":"Duration", "documentation":"

The minimum value of the duration range. Must be greater than zero.

" }, "maximum":{ "shape":"Duration", "documentation":"

The maximum value of the duration range. Must be less than or equal to 604800 seconds (1 week).

" } }, "documentation":"

This data type is used in the AssessmentsFilter data type.

" }, "FailureMessage":{"type":"string"}, "Finding":{ "type":"structure", "members":{ "findingArn":{ "shape":"Arn", "documentation":"

The ARN specifying the finding.

" }, "runArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment run that generated the finding.

" }, "rulesPackageArn":{ "shape":"Arn", "documentation":"

The ARN of the rules package that is used to generate the finding.

" }, "ruleName":{ "shape":"Name", "documentation":"

The rule name that is used to generate the finding.

" }, "agentId":{ "shape":"AgentId", "documentation":"

The EC2 instance ID where the agent is installed that is used during the assessment that generates the finding.

" }, "autoScalingGroup":{ "shape":"AutoScalingGroup", "documentation":"

The autoscaling group of the EC2 instance where the agent is installed that is used during the assessment that generates the finding.

" }, "severity":{ "shape":"Severity", "documentation":"

The finding severity. Values can be set to High, Medium, Low, and Informational.

" }, "finding":{ "shape":"LocalizedText", "documentation":"

A short description that identifies the finding.

" }, "description":{ "shape":"LocalizedText", "documentation":"

The description of the finding.

" }, "recommendation":{ "shape":"LocalizedText", "documentation":"

The recommendation for the finding.

" }, "attributes":{ "shape":"AttributeList", "documentation":"

The system-defined attributes for the finding.

" }, "userAttributes":{ "shape":"AttributeList", "documentation":"

The user-defined attributes that are assigned to the finding.

" } }, "documentation":"

Contains information about an Inspector finding.

This data type is used as the response element in the DescribeFinding action.

" }, "FindingsFilter":{ "type":"structure", "members":{ "rulesPackageArns":{ "shape":"ArnList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the rulesPackageArn property of the Finding data type.

" }, "ruleNames":{ "shape":"NameList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the ruleName property of the Finding data type.

" }, "severities":{ "shape":"SeverityList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the severity property of the Finding data type.

" }, "attributes":{ "shape":"AttributeList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the attributes property of the Finding data type.

" }, "userAttributes":{ "shape":"AttributeList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the userAttributes property of the Finding data type.

" } }, "documentation":"

This data type is used as a request parameter in the ListFindings action.

" }, "GetAssessmentTelemetryRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment the telemetry of which you want to obtain.

" } } }, "GetAssessmentTelemetryResponse":{ "type":"structure", "members":{ "telemetry":{ "shape":"TelemetryList", "documentation":"

Telemetry details.

" } } }, "Integer":{"type":"integer"}, "InternalException":{ "type":"structure", "members":{ }, "exception":true, "fault":true }, "InvalidCrossAccountRoleException":{ "type":"structure", "members":{ }, "exception":true }, "InvalidInputException":{ "type":"structure", "members":{ }, "exception":true }, "ListApplicationsRequest":{ "type":"structure", "members":{ "filter":{ "shape":"ApplicationsFilter", "documentation":"

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.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListApplications action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListApplicationsResponse":{ "type":"structure", "members":{ "applicationArnList":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the applications returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListAssessmentAgentsRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment whose agents you want to list.

" }, "filter":{ "shape":"AgentsFilter", "documentation":"

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.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAssessmentAgents action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListAssessmentAgentsResponse":{ "type":"structure", "members":{ "agentList":{ "shape":"AgentList", "documentation":"

A list of ARNs specifying the agents returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListAssessmentsRequest":{ "type":"structure", "members":{ "applicationArns":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the applications the assessments of which you want to list.

" }, "filter":{ "shape":"AssessmentsFilter", "documentation":"

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.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAssessments action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListAssessmentsResponse":{ "type":"structure", "members":{ "assessmentArnList":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the assessments returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListAttachedAssessmentsRequest":{ "type":"structure", "required":["rulesPackageArn"], "members":{ "rulesPackageArn":{ "shape":"Arn", "documentation":"

The ARN specifying the rules package whose assessments you want to list.

" }, "filter":{ "shape":"AssessmentsFilter", "documentation":"

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.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAttachedAssessments action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListAttachedAssessmentsResponse":{ "type":"structure", "members":{ "assessmentArnList":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the assessments returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListAttachedRulesPackagesRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN specifying the assessment whose rules packages you want to list.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListAttachedRulesPackages action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListAttachedRulesPackagesResponse":{ "type":"structure", "members":{ "rulesPackageArnList":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the rules packages returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListFindingsRequest":{ "type":"structure", "members":{ "runArns":{ "shape":"ArnList", "documentation":"

The ARNs of the assessment runs that generate the findings that you want to list.

" }, "filter":{ "shape":"FindingsFilter", "documentation":"

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.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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 previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListFindingsResponse":{ "type":"structure", "members":{ "findingArnList":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the findings returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListRulesPackagesRequest":{ "type":"structure", "members":{ "nextToken":{ "shape":"PaginationToken", "documentation":"

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 previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListRulesPackagesResponse":{ "type":"structure", "members":{ "rulesPackageArnList":{ "shape":"ArnList", "documentation":"

The list of ARNs specifying the rules packages returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListRunsRequest":{ "type":"structure", "members":{ "assessmentArns":{ "shape":"ArnList", "documentation":"

The ARNs specifying the assessments whose runs you want to list.

" }, "filter":{ "shape":"RunsFilter", "documentation":"

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.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the ListRuns action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "ListRunsResponse":{ "type":"structure", "members":{ "runArnList":{ "shape":"ArnList", "documentation":"

A list of ARNs specifying the assessment runs returned by the action.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "ListTagsForResourceRequest":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"Arn", "documentation":"

The ARN specifying the resource whose tags you want to list.

" } } }, "ListTagsForResourceResponse":{ "type":"structure", "members":{ "tagList":{ "shape":"TagList", "documentation":"

A collection of key and value pairs.

" } } }, "Locale":{"type":"string"}, "LocalizeTextRequest":{ "type":"structure", "required":[ "localizedTexts", "locale" ], "members":{ "localizedTexts":{ "shape":"LocalizedTextList", "documentation":"

A list of textual identifiers.

" }, "locale":{ "shape":"Locale", "documentation":"

The locale that you want to translate a textual identifier into.

" } } }, "LocalizeTextResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" }, "results":{ "shape":"TextList", "documentation":"

The resulting list of user-readable texts.

" } } }, "LocalizedFacility":{"type":"string"}, "LocalizedText":{ "type":"structure", "members":{ "key":{ "shape":"LocalizedTextKey", "documentation":"

The facility and id properties of the LocalizedTextKey data type.

" }, "parameters":{ "shape":"ParameterList", "documentation":"

Values for the dynamic elements of the string specified by the textual identifier.

" } }, "documentation":"

The textual identifier. This data type is used as the request parameter in the LocalizeText action.

" }, "LocalizedTextId":{"type":"string"}, "LocalizedTextKey":{ "type":"structure", "members":{ "facility":{ "shape":"LocalizedFacility", "documentation":"

The module response source of the text.

" }, "id":{ "shape":"LocalizedTextId", "documentation":"

Part of the module response source of the text.

" } }, "documentation":"

This data type is used in the LocalizedText data type.

" }, "LocalizedTextList":{ "type":"list", "member":{"shape":"LocalizedText"} }, "Long":{"type":"long"}, "Message":{"type":"string"}, "MessageType":{"type":"string"}, "MessageTypeTelemetry":{ "type":"structure", "members":{ "messageType":{ "shape":"MessageType", "documentation":"

A specific type of behavioral data that is collected by the agent.

" }, "count":{ "shape":"Long", "documentation":"

The number of times that the behavioral data is collected by the agent during an assessment.

" }, "dataSize":{ "shape":"Long", "documentation":"

The total size of the behavioral data that is collected by the agent during an assessment.

" } }, "documentation":"

This data type is used in the Telemetry data type.

This is metadata about the behavioral data collected by the Inspector agent on your EC2 instances during an assessment and passed to the Inspector service for analysis.

" }, "MessageTypeTelemetryList":{ "type":"list", "member":{"shape":"MessageTypeTelemetry"} }, "Name":{"type":"string"}, "NameList":{ "type":"list", "member":{"shape":"Name"} }, "NamePattern":{"type":"string"}, "NamePatternList":{ "type":"list", "member":{"shape":"NamePattern"} }, "NoSuchEntityException":{ "type":"structure", "members":{ }, "exception":true }, "OperationInProgressException":{ "type":"structure", "members":{ }, "exception":true }, "PaginationToken":{"type":"string"}, "Parameter":{ "type":"structure", "members":{ "name":{ "shape":"ParameterName", "documentation":"

The name of the variable that is being replaced.

" }, "value":{ "shape":"ParameterValue", "documentation":"

The value assigned to the variable that is being replaced.

" } }, "documentation":"

This data type is used in the LocalizedText data type.

" }, "ParameterList":{ "type":"list", "member":{"shape":"Parameter"} }, "ParameterName":{"type":"string"}, "ParameterValue":{"type":"string"}, "PreviewAgentsForResourceGroupRequest":{ "type":"structure", "required":["resourceGroupArn"], "members":{ "resourceGroupArn":{ "shape":"Arn", "documentation":"

The ARN of the resource group that is used to create an application.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

You can use this parameter when paginating results. Set the value of this parameter to 'null' on your first call to the PreviewAgentsForResourceGroup action. Subsequent calls to the action fill nextToken in the request with the value of NextToken from previous response to continue listing data.

" }, "maxResults":{ "shape":"Integer", "documentation":"

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.

" } } }, "PreviewAgentsForResourceGroupResponse":{ "type":"structure", "members":{ "agentPreviewList":{ "shape":"AgentPreviewList", "documentation":"

The resulting list of agents.

" }, "nextToken":{ "shape":"PaginationToken", "documentation":"

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'.

" } } }, "RegisterCrossAccountAccessRoleRequest":{ "type":"structure", "required":["roleArn"], "members":{ "roleArn":{ "shape":"Arn", "documentation":"The ARN of the IAM role that Inspector uses to list your EC2 instances during the assessment." } } }, "RegisterCrossAccountAccessRoleResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "RemoveAttributesFromFindingsRequest":{ "type":"structure", "required":[ "findingArns", "attributeKeys" ], "members":{ "findingArns":{ "shape":"ArnList", "documentation":"

The ARNs specifying the findings that you want to remove attributes from.

" }, "attributeKeys":{ "shape":"AttributeKeyList", "documentation":"

The array of attribute keys that you want to remove from specified findings.

" } } }, "RemoveAttributesFromFindingsResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "ResourceGroup":{ "type":"structure", "members":{ "resourceGroupArn":{ "shape":"Arn", "documentation":"

The ARN of the resource group.

" }, "resourceGroupTags":{ "shape":"ResourceGroupTags", "documentation":"

The tags (key and value pairs) of the resource group.

This data type property is used in the CreateResourceGroup action.

A collection of keys and an array of possible values in JSON format.

For example, [{ \"key1\" : [\"Value1\",\"Value2\"]},{\"Key2\": [\"Value3\"]}]

" } }, "documentation":"

Contains information about a resource group. The resource group defines a set of tags that, when queried, identify the AWS resources that comprise the application.

This data type is used as the response element in the DescribeResourceGroup action.

" }, "ResourceGroupTags":{"type":"string"}, "RulesPackage":{ "type":"structure", "members":{ "rulesPackageArn":{ "shape":"Arn", "documentation":"

The ARN of the rules package.

" }, "rulesPackageName":{ "shape":"Name", "documentation":"

The name of the rules package.

" }, "version":{ "shape":"Version", "documentation":"

The version id of the rules package.

" }, "provider":{ "shape":"Name", "documentation":"

The provider of the rules package.

" }, "description":{ "shape":"LocalizedText", "documentation":"

The description of the rules package.

" } }, "documentation":"

Contains information about an Inspector rules package.

This data type is used as the response element in the DescribeRulesPackage action.

" }, "Run":{ "type":"structure", "members":{ "runArn":{ "shape":"Arn", "documentation":"

The ARN of the run.

" }, "runName":{ "shape":"Name", "documentation":"

The auto-generated name for the run.

" }, "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment that is associated with the run.

" }, "runState":{ "shape":"RunState", "documentation":"

The state of the run. Values can be set to DataCollectionComplete, EvaluatingPolicies, EvaluatingPoliciesErrorCanRetry, Completed, Failed, TombStoned.

" }, "rulesPackages":{ "shape":"ArnList", "documentation":"

Rules packages selected for the run of the assessment.

" }, "creationTime":{ "shape":"Timestamp", "documentation":"

Run creation time that corresponds to the data collection completion time or failure.

" }, "completionTime":{ "shape":"Timestamp", "documentation":"

Run completion time that corresponds to the rules packages evaluation completion time or failure.

" } }, "documentation":"

A snapshot of an Inspector assessment that contains the assessment's findings.

This data type is used as the response element in the DescribeRun action.

" }, "RunAssessmentRequest":{ "type":"structure", "required":[ "assessmentArn", "runName" ], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment that you want to run.

" }, "runName":{ "shape":"Name", "documentation":"

A name specifying the run of the assessment.

" } } }, "RunAssessmentResponse":{ "type":"structure", "members":{ "runArn":{ "shape":"Arn", "documentation":"

The ARN specifying the run of the assessment.

" } } }, "RunState":{"type":"string"}, "RunStateList":{ "type":"list", "member":{"shape":"RunState"} }, "RunsFilter":{ "type":"structure", "members":{ "runNamePatterns":{ "shape":"NamePatternList", "documentation":"

For a record to match a filter, an explicit value or a string containing a wildcard specified for this data type property must match the value of the runName property of the Run data type.

" }, "runStates":{ "shape":"RunStateList", "documentation":"

For a record to match a filter, the value specified for this data type property must be the exact match of the value of the runState property of the Run data type.

" }, "rulesPackages":{ "shape":"ArnList", "documentation":"

For a record to match a filter, the value specified for this data type property must match a list of values of the rulesPackages property of the Run data type.

" }, "creationTime":{ "shape":"TimestampRange", "documentation":"

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 creationTime property of the Run data type.

" }, "completionTime":{ "shape":"TimestampRange", "documentation":"

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 completionTime property of the Run data type.

" } }, "documentation":"

This data type is used as the request parameter in the ListRuns action.

" }, "SetTagsForResourceRequest":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment that you want to set tags to.

" }, "tags":{ "shape":"TagList", "documentation":"

A collection of key and value pairs that you want to set to an assessment.

" } } }, "SetTagsForResourceResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "Severity":{"type":"string"}, "SeverityList":{ "type":"list", "member":{"shape":"Severity"} }, "StartDataCollectionRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment for which you want to start the data collection process.

" } } }, "StartDataCollectionResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "StopDataCollectionRequest":{ "type":"structure", "required":["assessmentArn"], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

The ARN of the assessment for which you want to stop the data collection process.

" } } }, "StopDataCollectionResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "Tag":{ "type":"structure", "members":{ "Key":{ "shape":"TagKey", "documentation":"

The tag key.

" }, "Value":{ "shape":"TagValue", "documentation":"

The value assigned to a tag key.

" } }, "documentation":"

A key and value pair.

This data type is used as a request parameter in the SetTagsForResource action and a response element in the ListTagsForResource action.

" }, "TagKey":{"type":"string"}, "TagList":{ "type":"list", "member":{"shape":"Tag"} }, "TagValue":{"type":"string"}, "Telemetry":{ "type":"structure", "members":{ "status":{ "shape":"TelemetryStatus", "documentation":"

The category of the individual metrics that together constitute the telemetry that Inspector received from the agent.

" }, "messageTypeTelemetries":{ "shape":"MessageTypeTelemetryList", "documentation":"

Counts of individual metrics received by Inspector from the agent.

" } }, "documentation":"

The metadata about the Inspector application data metrics collected by the agent.

This data type is used as the response element in the GetAssessmentTelemetry action.

" }, "TelemetryList":{ "type":"list", "member":{"shape":"Telemetry"} }, "TelemetryStatus":{"type":"string"}, "Text":{"type":"string"}, "TextList":{ "type":"list", "member":{"shape":"Text"} }, "Timestamp":{"type":"timestamp"}, "TimestampRange":{ "type":"structure", "members":{ "minimum":{ "shape":"Timestamp", "documentation":"

The minimum value of the timestamp range.

" }, "maximum":{ "shape":"Timestamp", "documentation":"

The maximum value of the timestamp range.

" } }, "documentation":"

This data type is used in the AssessmentsFilter and RunsFilter data types.

" }, "UpdateApplicationRequest":{ "type":"structure", "required":[ "applicationArn", "applicationName", "resourceGroupArn" ], "members":{ "applicationArn":{ "shape":"Arn", "documentation":"

Application ARN that you want to update.

" }, "applicationName":{ "shape":"Name", "documentation":"

Application name that you want to update.

" }, "resourceGroupArn":{ "shape":"Arn", "documentation":"

The resource group ARN that you want to update.

" } } }, "UpdateApplicationResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "UpdateAssessmentRequest":{ "type":"structure", "required":[ "assessmentArn", "assessmentName", "durationInSeconds" ], "members":{ "assessmentArn":{ "shape":"Arn", "documentation":"

Asessment ARN that you want to update.

" }, "assessmentName":{ "shape":"Name", "documentation":"

Assessment name that you want to update.

" }, "durationInSeconds":{ "shape":"Duration", "documentation":"

Assessment duration in seconds that you want to update. The default value is 3600 seconds (one hour). The maximum value is 86400 seconds (one day).

" } } }, "UpdateAssessmentResponse":{ "type":"structure", "members":{ "message":{ "shape":"Message", "documentation":"

Confirmation details of the action performed.

" } } }, "Version":{"type":"string"} }, "documentation":"Amazon Inspector

Amazon Inspector enables you to analyze the behavior of the applications you run in AWS and to identify potential security issues. For more information, see Amazon Inspector User Guide.

" }