5.0.0 • Published 6 years ago
@datafire/amazonaws_inspector v5.0.0
@datafire/amazonaws_inspector
Client library for Amazon Inspector
Installation and Usage
npm install --save @datafire/amazonaws_inspector
let amazonaws_inspector = require('@datafire/amazonaws_inspector').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_inspector.AddAttributesToFindings({
"findingArns": [],
"attributes": []
}).then(data => {
console.log(data);
});
Description
Amazon Inspector Amazon Inspector enables you to analyze the behavior of your AWS resources and to identify potential security issues. For more information, see Amazon Inspector User Guide.
Actions
AddAttributesToFindings
amazonaws_inspector.AddAttributesToFindings({
"findingArns": [],
"attributes": []
}, context)
Input
- input
object
- attributes required UserAttributeList
- findingArns required AddRemoveAttributesFindingArnList
Output
CreateAssessmentTarget
amazonaws_inspector.CreateAssessmentTarget({
"assessmentTargetName": "",
"resourceGroupArn": ""
}, context)
Input
- input
object
- assessmentTargetName required AssessmentTargetName
- resourceGroupArn required Arn
Output
CreateAssessmentTemplate
amazonaws_inspector.CreateAssessmentTemplate({
"assessmentTargetArn": "",
"assessmentTemplateName": "",
"durationInSeconds": 0,
"rulesPackageArns": []
}, context)
Input
- input
object
- assessmentTargetArn required Arn
- assessmentTemplateName required AssessmentTemplateName
- durationInSeconds required AssessmentRunDuration
- rulesPackageArns required AssessmentTemplateRulesPackageArnList
- userAttributesForFindings UserAttributeList
Output
CreateResourceGroup
amazonaws_inspector.CreateResourceGroup({
"resourceGroupTags": []
}, context)
Input
- input
object
- resourceGroupTags required ResourceGroupTags
Output
- output CreateResourceGroupResponse
DeleteAssessmentRun
amazonaws_inspector.DeleteAssessmentRun({
"assessmentRunArn": ""
}, context)
Input
- input
object
- assessmentRunArn required Arn
Output
Output schema unknown
DeleteAssessmentTarget
amazonaws_inspector.DeleteAssessmentTarget({
"assessmentTargetArn": ""
}, context)
Input
- input
object
- assessmentTargetArn required Arn
Output
Output schema unknown
DeleteAssessmentTemplate
amazonaws_inspector.DeleteAssessmentTemplate({
"assessmentTemplateArn": ""
}, context)
Input
- input
object
- assessmentTemplateArn required Arn
Output
Output schema unknown
DescribeAssessmentRuns
amazonaws_inspector.DescribeAssessmentRuns({
"assessmentRunArns": []
}, context)
Input
- input
object
- assessmentRunArns required BatchDescribeArnList
Output
DescribeAssessmentTargets
amazonaws_inspector.DescribeAssessmentTargets({
"assessmentTargetArns": []
}, context)
Input
- input
object
- assessmentTargetArns required BatchDescribeArnList
Output
DescribeAssessmentTemplates
amazonaws_inspector.DescribeAssessmentTemplates({
"assessmentTemplateArns": []
}, context)
Input
- input
object
- assessmentTemplateArns required BatchDescribeArnList
Output
DescribeCrossAccountAccessRole
amazonaws_inspector.DescribeCrossAccountAccessRole({}, context)
Input
- input
object
Output
DescribeFindings
amazonaws_inspector.DescribeFindings({
"findingArns": []
}, context)
Input
- input
object
- findingArns required BatchDescribeArnList
- locale Locale
Output
- output DescribeFindingsResponse
DescribeResourceGroups
amazonaws_inspector.DescribeResourceGroups({
"resourceGroupArns": []
}, context)
Input
- input
object
- resourceGroupArns required BatchDescribeArnList
Output
DescribeRulesPackages
amazonaws_inspector.DescribeRulesPackages({
"rulesPackageArns": []
}, context)
Input
- input
object
- locale Locale
- rulesPackageArns required BatchDescribeArnList
Output
GetAssessmentReport
amazonaws_inspector.GetAssessmentReport({
"assessmentRunArn": "",
"reportFileFormat": "",
"reportType": ""
}, context)
Input
- input
object
- assessmentRunArn required Arn
- reportFileFormat required ReportFileFormat
- reportType required ReportType
Output
- output GetAssessmentReportResponse
GetTelemetryMetadata
amazonaws_inspector.GetTelemetryMetadata({
"assessmentRunArn": ""
}, context)
Input
- input
object
- assessmentRunArn required Arn
Output
- output GetTelemetryMetadataResponse
ListAssessmentRunAgents
amazonaws_inspector.ListAssessmentRunAgents({
"assessmentRunArn": ""
}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- assessmentRunArn required Arn
- filter AgentFilter
- maxResults ListMaxResults
- nextToken PaginationToken
- maxResults
Output
ListAssessmentRuns
amazonaws_inspector.ListAssessmentRuns({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- assessmentTemplateArns ListParentArnList
- filter AssessmentRunFilter
- maxResults ListMaxResults
- nextToken PaginationToken
- maxResults
Output
- output ListAssessmentRunsResponse
ListAssessmentTargets
amazonaws_inspector.ListAssessmentTargets({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- filter AssessmentTargetFilter
- maxResults ListMaxResults
- nextToken PaginationToken
- maxResults
Output
ListAssessmentTemplates
amazonaws_inspector.ListAssessmentTemplates({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- assessmentTargetArns ListParentArnList
- filter AssessmentTemplateFilter
- maxResults ListMaxResults
- nextToken PaginationToken
- maxResults
Output
ListEventSubscriptions
amazonaws_inspector.ListEventSubscriptions({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- maxResults ListEventSubscriptionsMaxResults
- nextToken PaginationToken
- resourceArn Arn
- maxResults
Output
ListFindings
amazonaws_inspector.ListFindings({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- assessmentRunArns ListParentArnList
- filter FindingFilter
- maxResults ListMaxResults
- nextToken PaginationToken
- maxResults
Output
- output ListFindingsResponse
ListRulesPackages
amazonaws_inspector.ListRulesPackages({}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- maxResults ListMaxResults
- nextToken PaginationToken
- maxResults
Output
- output ListRulesPackagesResponse
ListTagsForResource
amazonaws_inspector.ListTagsForResource({
"resourceArn": ""
}, context)
Input
- input
object
- resourceArn required Arn
Output
- output ListTagsForResourceResponse
PreviewAgents
amazonaws_inspector.PreviewAgents({
"previewAgentsArn": ""
}, context)
Input
- input
object
- maxResults
string
- nextToken
string
- maxResults PreviewAgentsMaxResults
- nextToken PaginationToken
- previewAgentsArn required Arn
- maxResults
Output
- output PreviewAgentsResponse
RegisterCrossAccountAccessRole
amazonaws_inspector.RegisterCrossAccountAccessRole({
"roleArn": ""
}, context)
Input
- input
object
- roleArn required Arn
Output
Output schema unknown
RemoveAttributesFromFindings
amazonaws_inspector.RemoveAttributesFromFindings({
"findingArns": [],
"attributeKeys": []
}, context)
Input
- input
object
- attributeKeys required UserAttributeKeyList
- findingArns required AddRemoveAttributesFindingArnList
Output
SetTagsForResource
amazonaws_inspector.SetTagsForResource({
"resourceArn": ""
}, context)
Input
Output
Output schema unknown
StartAssessmentRun
amazonaws_inspector.StartAssessmentRun({
"assessmentTemplateArn": ""
}, context)
Input
- input
object
- assessmentRunName AssessmentRunName
- assessmentTemplateArn required Arn
Output
- output StartAssessmentRunResponse
StopAssessmentRun
amazonaws_inspector.StopAssessmentRun({
"assessmentRunArn": ""
}, context)
Input
- input
object
- assessmentRunArn required Arn
- stopAction StopAction
Output
Output schema unknown
SubscribeToEvent
amazonaws_inspector.SubscribeToEvent({
"resourceArn": "",
"event": "",
"topicArn": ""
}, context)
Input
- input
object
- event required InspectorEvent
- resourceArn required Arn
- topicArn required Arn
Output
Output schema unknown
UnsubscribeFromEvent
amazonaws_inspector.UnsubscribeFromEvent({
"resourceArn": "",
"event": "",
"topicArn": ""
}, context)
Input
- input
object
- event required InspectorEvent
- resourceArn required Arn
- topicArn required Arn
Output
Output schema unknown
UpdateAssessmentTarget
amazonaws_inspector.UpdateAssessmentTarget({
"assessmentTargetArn": "",
"assessmentTargetName": "",
"resourceGroupArn": ""
}, context)
Input
- input
object
- assessmentTargetArn required Arn
- assessmentTargetName required AssessmentTargetName
- resourceGroupArn required Arn
Output
Output schema unknown
Definitions
AccessDeniedErrorCode
- AccessDeniedErrorCode
string
(values: ACCESS_DENIED_TO_ASSESSMENT_TARGET, ACCESS_DENIED_TO_ASSESSMENT_TEMPLATE, ACCESS_DENIED_TO_ASSESSMENT_RUN, ACCESS_DENIED_TO_FINDING, ACCESS_DENIED_TO_RESOURCE_GROUP, ACCESS_DENIED_TO_RULES_PACKAGE, ACCESS_DENIED_TO_SNS_TOPIC, ACCESS_DENIED_TO_IAM_ROLE)
AccessDeniedException
- AccessDeniedException
object
: You do not have required permissions to access the requested resource.- canRetry required Bool
- errorCode required AccessDeniedErrorCode
- message required ErrorMessage
AddAttributesToFindingsRequest
- AddAttributesToFindingsRequest
object
- attributes required UserAttributeList
- findingArns required AddRemoveAttributesFindingArnList
AddAttributesToFindingsResponse
- AddAttributesToFindingsResponse
object
- failedItems required FailedItems
AddRemoveAttributesFindingArnList
- AddRemoveAttributesFindingArnList
array
- items Arn
AgentAlreadyRunningAssessment
- AgentAlreadyRunningAssessment
object
: Used in the exception error that is thrown if you start an assessment run for an assessment target that includes an EC2 instance that is already participating in another started assessment run.
AgentAlreadyRunningAssessmentList
- AgentAlreadyRunningAssessmentList
array
AgentFilter
- AgentFilter
object
: Contains information about an Amazon Inspector agent. This data type is used as a request parameter in the ListAssessmentRunAgents action.- agentHealthCodes required AgentHealthCodeList
- agentHealths required AgentHealthList
AgentHealth
- AgentHealth
string
(values: HEALTHY, UNHEALTHY, UNKNOWN)
AgentHealthCode
- AgentHealthCode
string
(values: IDLE, RUNNING, SHUTDOWN, UNHEALTHY, THROTTLED, UNKNOWN)
AgentHealthCodeList
- AgentHealthCodeList
array
- items AgentHealthCode
AgentHealthList
- AgentHealthList
array
- items AgentHealth
AgentId
- AgentId
string
AgentIdList
- AgentIdList
array
- items AgentId
AgentPreview
- AgentPreview
object
: Used as a response element in the PreviewAgents action.- agentHealth AgentHealth
- agentId required AgentId
- agentVersion AgentVersion
- autoScalingGroup AutoScalingGroup
- hostname Hostname
- ipv4Address Ipv4Address
- kernelVersion KernelVersion
- operatingSystem OperatingSystem
AgentPreviewList
- AgentPreviewList
array
- items AgentPreview
AgentVersion
- AgentVersion
string
AgentsAlreadyRunningAssessmentException
- AgentsAlreadyRunningAssessmentException
object
: You started an assessment run, but one of the instances is already participating in another assessment run.- agents required AgentAlreadyRunningAssessmentList
- agentsTruncated required Bool
- canRetry required Bool
- message required ErrorMessage
AmiId
- AmiId
string
Arn
- Arn
string
ArnCount
- ArnCount
integer
AssessmentRulesPackageArnList
- AssessmentRulesPackageArnList
array
- items Arn
AssessmentRun
- AssessmentRun
object
: A snapshot of an Amazon Inspector assessment run that contains the findings of the assessment run . Used as the response element in the DescribeAssessmentRuns action.- arn required Arn
- assessmentTemplateArn required Arn
- completedAt Timestamp
- createdAt required Timestamp
- dataCollected required Bool
- durationInSeconds required AssessmentRunDuration
- findingCounts required AssessmentRunFindingCounts
- name required AssessmentRunName
- notifications required AssessmentRunNotificationList
- rulesPackageArns required AssessmentRulesPackageArnList
- startedAt Timestamp
- state required AssessmentRunState
- stateChangedAt required Timestamp
- stateChanges required AssessmentRunStateChangeList
- userAttributesForFindings required UserAttributeList
AssessmentRunAgent
- AssessmentRunAgent
object
: Contains information about an Amazon Inspector agent. This data type is used as a response element in the ListAssessmentRunAgents action.- agentHealth required AgentHealth
- agentHealthCode required AgentHealthCode
- agentHealthDetails Message
- agentId required AgentId
- assessmentRunArn required Arn
- autoScalingGroup AutoScalingGroup
- telemetryMetadata required TelemetryMetadataList
AssessmentRunAgentList
- AssessmentRunAgentList
array
- items AssessmentRunAgent
AssessmentRunDuration
- AssessmentRunDuration
integer
AssessmentRunFilter
- AssessmentRunFilter
object
: Used as the request parameter in the ListAssessmentRuns action.- completionTimeRange TimestampRange
- durationRange DurationRange
- namePattern NamePattern
- rulesPackageArns FilterRulesPackageArnList
- startTimeRange TimestampRange
- stateChangeTimeRange TimestampRange
- states AssessmentRunStateList
AssessmentRunFindingCounts
- AssessmentRunFindingCounts
array
- items
object
- key Severity
- value FindingCount
- items
AssessmentRunInProgressArnList
- AssessmentRunInProgressArnList
array
- items Arn
AssessmentRunInProgressException
- AssessmentRunInProgressException
object
: You cannot perform a specified action if an assessment run is currently in progress.- assessmentRunArns required AssessmentRunInProgressArnList
- assessmentRunArnsTruncated required Bool
- canRetry required Bool
- message required ErrorMessage
AssessmentRunList
- AssessmentRunList
array
- items AssessmentRun
AssessmentRunName
- AssessmentRunName
string
AssessmentRunNotification
- AssessmentRunNotification
object
: Used as one of the elements of the AssessmentRun data type.- date required Timestamp
- error required Bool
- event required InspectorEvent
- message Message
- snsPublishStatusCode AssessmentRunNotificationSnsStatusCode
- snsTopicArn Arn
AssessmentRunNotificationList
- AssessmentRunNotificationList
array
AssessmentRunNotificationSnsStatusCode
- AssessmentRunNotificationSnsStatusCode
string
(values: SUCCESS, TOPIC_DOES_NOT_EXIST, ACCESS_DENIED, INTERNAL_ERROR)
AssessmentRunState
- AssessmentRunState
string
(values: 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)
AssessmentRunStateChange
- AssessmentRunStateChange
object
: Used as one of the elements of the AssessmentRun data type.- state required AssessmentRunState
- stateChangedAt required Timestamp
AssessmentRunStateChangeList
- AssessmentRunStateChangeList
array
- items AssessmentRunStateChange
AssessmentRunStateList
- AssessmentRunStateList
array
- items AssessmentRunState
AssessmentTarget
- AssessmentTarget
object
: Contains information about an Amazon Inspector application. This data type is used as the response element in the DescribeAssessmentTargets action.- arn required Arn
- createdAt required Timestamp
- name required AssessmentTargetName
- resourceGroupArn required Arn
- updatedAt required Timestamp
AssessmentTargetFilter
- AssessmentTargetFilter
object
: Used as the request parameter in the ListAssessmentTargets action.- assessmentTargetNamePattern NamePattern
AssessmentTargetList
- AssessmentTargetList
array
- items AssessmentTarget
AssessmentTargetName
- AssessmentTargetName
string
AssessmentTemplate
- AssessmentTemplate
object
: Contains information about an Amazon Inspector assessment template. This data type is used as the response element in the DescribeAssessmentTemplates action.- arn required Arn
- assessmentRunCount required ArnCount
- assessmentTargetArn required Arn
- createdAt required Timestamp
- durationInSeconds required AssessmentRunDuration
- lastAssessmentRunArn Arn
- name required AssessmentTemplateName
- rulesPackageArns required AssessmentTemplateRulesPackageArnList
- userAttributesForFindings required UserAttributeList
AssessmentTemplateFilter
- AssessmentTemplateFilter
object
: Used as the request parameter in the ListAssessmentTemplates action.- durationRange DurationRange
- namePattern NamePattern
- rulesPackageArns FilterRulesPackageArnList
AssessmentTemplateList
- AssessmentTemplateList
array
- items AssessmentTemplate
AssessmentTemplateName
- AssessmentTemplateName
string
AssessmentTemplateRulesPackageArnList
- AssessmentTemplateRulesPackageArnList
array
- items Arn
AssetAttributes
- AssetAttributes
object
: A collection of attributes of the host from which the finding is generated.- agentId AgentId
- amiId AmiId
- autoScalingGroup AutoScalingGroup
- hostname Hostname
- ipv4Addresses Ipv4AddressList
- schemaVersion required NumericVersion
AssetType
- AssetType
string
(values: ec2-instance)
Attribute
- Attribute
object
: This data type is used as a request parameter in the AddAttributesToFindings and CreateAssessmentTemplate actions.- key required AttributeKey
- value AttributeValue
AttributeKey
- AttributeKey
string
AttributeList
- AttributeList
array
- items Attribute
AttributeValue
- AttributeValue
string
AutoScalingGroup
- AutoScalingGroup
string
AutoScalingGroupList
- AutoScalingGroupList
array
- items AutoScalingGroup
BatchDescribeArnList
- BatchDescribeArnList
array
- items Arn
Bool
- Bool
boolean
CreateAssessmentTargetRequest
- CreateAssessmentTargetRequest
object
- assessmentTargetName required AssessmentTargetName
- resourceGroupArn required Arn
CreateAssessmentTargetResponse
- CreateAssessmentTargetResponse
object
- assessmentTargetArn required Arn
CreateAssessmentTemplateRequest
- CreateAssessmentTemplateRequest
object
- assessmentTargetArn required Arn
- assessmentTemplateName required AssessmentTemplateName
- durationInSeconds required AssessmentRunDuration
- rulesPackageArns required AssessmentTemplateRulesPackageArnList
- userAttributesForFindings UserAttributeList
CreateAssessmentTemplateResponse
- CreateAssessmentTemplateResponse
object
- assessmentTemplateArn required Arn
CreateResourceGroupRequest
- CreateResourceGroupRequest
object
- resourceGroupTags required ResourceGroupTags
CreateResourceGroupResponse
- CreateResourceGroupResponse
object
- resourceGroupArn required Arn
DeleteAssessmentRunRequest
- DeleteAssessmentRunRequest
object
- assessmentRunArn required Arn
DeleteAssessmentTargetRequest
- DeleteAssessmentTargetRequest
object
- assessmentTargetArn required Arn
DeleteAssessmentTemplateRequest
- DeleteAssessmentTemplateRequest
object
- assessmentTemplateArn required Arn
DescribeAssessmentRunsRequest
- DescribeAssessmentRunsRequest
object
- assessmentRunArns required BatchDescribeArnList
DescribeAssessmentRunsResponse
- DescribeAssessmentRunsResponse
object
- assessmentRuns required AssessmentRunList
- failedItems required FailedItems
DescribeAssessmentTargetsRequest
- DescribeAssessmentTargetsRequest
object
- assessmentTargetArns required BatchDescribeArnList
DescribeAssessmentTargetsResponse
- DescribeAssessmentTargetsResponse
object
- assessmentTargets required AssessmentTargetList
- failedItems required FailedItems
DescribeAssessmentTemplatesRequest
- DescribeAssessmentTemplatesRequest
object
- assessmentTemplateArns required BatchDescribeArnList
DescribeAssessmentTemplatesResponse
- DescribeAssessmentTemplatesResponse
object
- assessmentTemplates required AssessmentTemplateList
- failedItems required FailedItems
DescribeCrossAccountAccessRoleResponse
- DescribeCrossAccountAccessRoleResponse
object
DescribeFindingsRequest
- DescribeFindingsRequest
object
- findingArns required BatchDescribeArnList
- locale Locale
DescribeFindingsResponse
- DescribeFindingsResponse
object
- failedItems required FailedItems
- findings required FindingList
DescribeResourceGroupsRequest
- DescribeResourceGroupsRequest
object
- resourceGroupArns required BatchDescribeArnList
DescribeResourceGroupsResponse
- DescribeResourceGroupsResponse
object
- failedItems required FailedItems
- resourceGroups required ResourceGroupList
DescribeRulesPackagesRequest
- DescribeRulesPackagesRequest
object
- locale Locale
- rulesPackageArns required BatchDescribeArnList
DescribeRulesPackagesResponse
- DescribeRulesPackagesResponse
object
- failedItems required FailedItems
- rulesPackages required RulesPackageList
DurationRange
- DurationRange
object
: This data type is used in the AssessmentTemplateFilter data type.- maxSeconds AssessmentRunDuration
- minSeconds AssessmentRunDuration
ErrorMessage
- ErrorMessage
string
EventSubscription
- EventSubscription
object
: This data type is used in the Subscription data type.- event required InspectorEvent
- subscribedAt required Timestamp
EventSubscriptionList
- EventSubscriptionList
array
- items EventSubscription
FailedItemDetails
- FailedItemDetails
object
: Includes details about the failed items.- failureCode required FailedItemErrorCode
- retryable required Bool
FailedItemErrorCode
- FailedItemErrorCode
string
(values: INVALID_ARN, DUPLICATE_ARN, ITEM_DOES_NOT_EXIST, ACCESS_DENIED, LIMIT_EXCEEDED, INTERNAL_ERROR)
FailedItems
- FailedItems
array
- items
object
- key Arn
- value FailedItemDetails
- items
FilterRulesPackageArnList
- FilterRulesPackageArnList
array
- items Arn
Finding
- Finding
object
: Contains information about an Amazon Inspector finding. This data type is used as the response element in the DescribeFindings action.- arn required Arn
- assetAttributes AssetAttributes
- assetType AssetType
- attributes required AttributeList
- confidence IocConfidence
- createdAt required Timestamp
- description Text
- id FindingId
- indicatorOfCompromise Bool
- numericSeverity NumericSeverity
- recommendation Text
- schemaVersion NumericVersion
- service ServiceName
- serviceAttributes InspectorServiceAttributes
- severity Severity
- title Text
- updatedAt required Timestamp
- userAttributes required UserAttributeList
FindingCount
- FindingCount
integer
FindingFilter
- FindingFilter
object
: This data type is used as a request parameter in the ListFindings action.- agentIds AgentIdList
- attributes AttributeList
- autoScalingGroups AutoScalingGroupList
- creationTimeRange TimestampRange
- ruleNames RuleNameList
- rulesPackageArns FilterRulesPackageArnList
- severities SeverityList
- userAttributes AttributeList
FindingId
- FindingId
string
FindingList
- FindingList
array
- items Finding
GetAssessmentReportRequest
- GetAssessmentReportRequest
object
- assessmentRunArn required Arn
- reportFileFormat required ReportFileFormat
- reportType required ReportType
GetAssessmentReportResponse
- GetAssessmentReportResponse
object
- status required ReportStatus
- url Url
GetTelemetryMetadataRequest
- GetTelemetryMetadataRequest
object
- assessmentRunArn required Arn
GetTelemetryMetadataResponse
- GetTelemetryMetadataResponse
object
- telemetryMetadata required TelemetryMetadataList
Hostname
- Hostname
string
InspectorEvent
- InspectorEvent
string
(values: ASSESSMENT_RUN_STARTED, ASSESSMENT_RUN_COMPLETED, ASSESSMENT_RUN_STATE_CHANGED, FINDING_REPORTED, OTHER)
InspectorServiceAttributes
- InspectorServiceAttributes
object
: This data type is used in the Finding data type.- assessmentRunArn Arn
- rulesPackageArn Arn
- schemaVersion required NumericVersion
InternalException
- InternalException
object
: Internal server error.- canRetry required Bool
- message required ErrorMessage
InvalidCrossAccountRoleErrorCode
- InvalidCrossAccountRoleErrorCode
string
(values: ROLE_DOES_NOT_EXIST_OR_INVALID_TRUST_RELATIONSHIP, ROLE_DOES_NOT_HAVE_CORRECT_POLICY)
InvalidCrossAccountRoleException
- InvalidCrossAccountRoleException
object
: Amazon Inspector cannot assume the cross-account role that it needs to list your EC2 instances during the assessment run.- canRetry required Bool
- errorCode required InvalidCrossAccountRoleErrorCode
- message required ErrorMessage
InvalidInputErrorCode
- InvalidInputErrorCode
string
(values: INVALID_ASSESSMENT_TARGET_ARN, INVALID_ASSESSMENT_TEMPLATE_ARN, INVALID_ASSESSMENT_RUN_ARN, INVALID_FINDING_ARN, INVALID_RESOURCE_GROUP_ARN, INVALID_RULES_PACKAGE_ARN, INVALID_RESOURCE_ARN, INVALID_SNS_TOPIC_ARN, INVALID_IAM_ROLE_ARN, INVALID_ASSESSMENT_TARGET_NAME, INVALID_ASSESSMENT_TARGET_NAME_PATTERN, INVALID_ASSESSMENT_TEMPLATE_NAME, INVALID_ASSESSMENT_TEMPLATE_NAME_PATTERN, INVALID_ASSESSMENT_TEMPLATE_DURATION, INVALID_ASSESSMENT_TEMPLATE_DURATION_RANGE, INVALID_ASSESSMENT_RUN_DURATION_RANGE, INVALID_ASSESSMENT_RUN_START_TIME_RANGE, INVALID_ASSESSMENT_RUN_COMPLETION_TIME_RANGE, INVALID_ASSESSMENT_RUN_STATE_CHANGE_TIME_RANGE, INVALID_ASSESSMENT_RUN_STATE, INVALID_TAG, INVALID_TAG_KEY, INVALID_TAG_VALUE, INVALID_RESOURCE_GROUP_TAG_KEY, INVALID_RESOURCE_GROUP_TAG_VALUE, INVALID_ATTRIBUTE, INVALID_USER_ATTRIBUTE, INVALID_USER_ATTRIBUTE_KEY, INVALID_USER_ATTRIBUTE_VALUE, INVALID_PAGINATION_TOKEN, INVALID_MAX_RESULTS, INVALID_AGENT_ID, INVALID_AUTO_SCALING_GROUP, INVALID_RULE_NAME, INVALID_SEVERITY, INVALID_LOCALE, INVALID_EVENT, ASSESSMENT_TARGET_NAME_ALREADY_TAKEN, ASSESSMENT_TEMPLATE_NAME_ALREADY_TAKEN, INVALID_NUMBER_OF_ASSESSMENT_TARGET_ARNS, INVALID_NUMBER_OF_ASSESSMENT_TEMPLATE_ARNS, INVALID_NUMBER_OF_ASSESSMENT_RUN_ARNS, INVALID_NUMBER_OF_FINDING_ARNS, INVALID_NUMBER_OF_RESOURCE_GROUP_ARNS, INVALID_NUMBER_OF_RULES_PACKAGE_ARNS, INVALID_NUMBER_OF_ASSESSMENT_RUN_STATES, INVALID_NUMBER_OF_TAGS, INVALID_NUMBER_OF_RESOURCE_GROUP_TAGS, INVALID_NUMBER_OF_ATTRIBUTES, INVALID_NUMBER_OF_USER_ATTRIBUTES, INVALID_NUMBER_OF_AGENT_IDS, INVALID_NUMBER_OF_AUTO_SCALING_GROUPS, INVALID_NUMBER_OF_RULE_NAMES, INVALID_NUMBER_OF_SEVERITIES)
InvalidInputException
- InvalidInputException
object
: The request was rejected because an invalid or out-of-range value was supplied for an input parameter.- canRetry required Bool
- errorCode required InvalidInputErrorCode
- message required ErrorMessage
IocConfidence
- IocConfidence
integer
Ipv4Address
- Ipv4Address
string
Ipv4AddressList
- Ipv4AddressList
array
- items Ipv4Address
KernelVersion
- KernelVersion
string
LimitExceededErrorCode
- LimitExceededErrorCode
string
(values: ASSESSMENT_TARGET_LIMIT_EXCEEDED, ASSESSMENT_TEMPLATE_LIMIT_EXCEEDED, ASSESSMENT_RUN_LIMIT_EXCEEDED, RESOURCE_GROUP_LIMIT_EXCEEDED, EVENT_SUBSCRIPTION_LIMIT_EXCEEDED)
LimitExceededException
- LimitExceededException
object
: The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.- canRetry required Bool
- errorCode required LimitExceededErrorCode
- message required ErrorMessage
ListAssessmentRunAgentsRequest
- ListAssessmentRunAgentsRequest
object
- assessmentRunArn required Arn
- filter AgentFilter
- maxResults ListMaxResults
- nextToken PaginationToken
ListAssessmentRunAgentsResponse
- ListAssessmentRunAgentsResponse
object
- assessmentRunAgents required AssessmentRunAgentList
- nextToken PaginationToken
ListAssessmentRunsRequest
- ListAssessmentRunsRequest
object
- assessmentTemplateArns ListParentArnList
- filter AssessmentRunFilter
- maxResults ListMaxResults
- nextToken PaginationToken
ListAssessmentRunsResponse
- ListAssessmentRunsResponse
object
- assessmentRunArns required ListReturnedArnList
- nextToken PaginationToken
ListAssessmentTargetsRequest
- ListAssessmentTargetsRequest
object
- filter AssessmentTargetFilter
- maxResults ListMaxResults
- nextToken PaginationToken
ListAssessmentTargetsResponse
- ListAssessmentTargetsResponse
object
- assessmentTargetArns required ListReturnedArnList
- nextToken PaginationToken
ListAssessmentTemplatesRequest
- ListAssessmentTemplatesRequest
object
- assessmentTargetArns ListParentArnList
- filter AssessmentTemplateFilter
- maxResults ListMaxResults
- nextToken PaginationToken
ListAssessmentTemplatesResponse
- ListAssessmentTemplatesResponse
object
- assessmentTemplateArns required ListReturnedArnList
- nextToken PaginationToken
ListEventSubscriptionsMaxResults
- ListEventSubscriptionsMaxResults
integer
ListEventSubscriptionsRequest
- ListEventSubscriptionsRequest
object
- maxResults ListEventSubscriptionsMaxResults
- nextToken PaginationToken
- resourceArn Arn
ListEventSubscriptionsResponse
- ListEventSubscriptionsResponse
object
- nextToken PaginationToken
- subscriptions required SubscriptionList
ListFindingsRequest
- ListFindingsRequest
object
- assessmentRunArns ListParentArnList
- filter FindingFilter
- maxResults ListMaxResults
- nextToken PaginationToken
ListFindingsResponse
- ListFindingsResponse
object
- findingArns required ListReturnedArnList
- nextToken PaginationToken
ListMaxResults
- ListMaxResults
integer
ListParentArnList
- ListParentArnList
array
- items Arn
ListReturnedArnList
- ListReturnedArnList
array
- items Arn
ListRulesPackagesRequest
- ListRulesPackagesRequest
object
- maxResults ListMaxResults
- nextToken PaginationToken
ListRulesPackagesResponse
- ListRulesPackagesResponse
object
- nextToken PaginationToken
- rulesPackageArns required ListReturnedArnList
ListTagsForResourceRequest
- ListTagsForResourceRequest
object
- resourceArn required Arn
ListTagsForResourceResponse
- ListTagsForResourceResponse
object
- tags required TagList
Locale
- Locale
string
(values: EN_US)
Long
- Long
integer
Message
- Message
string
MessageType
- MessageType
string
NamePattern
- NamePattern
string
NoSuchEntityErrorCode
- NoSuchEntityErrorCode
string
(values: ASSESSMENT_TARGET_DOES_NOT_EXIST, ASSESSMENT_TEMPLATE_DOES_NOT_EXIST, ASSESSMENT_RUN_DOES_NOT_EXIST, FINDING_DOES_NOT_EXIST, RESOURCE_GROUP_DOES_NOT_EXIST, RULES_PACKAGE_DOES_NOT_EXIST, SNS_TOPIC_DOES_NOT_EXIST, IAM_ROLE_DOES_NOT_EXIST)
NoSuchEntityException
- NoSuchEntityException
object
: The request was rejected because it referenced an entity that does not exist. The error code describes the entity.- canRetry required Bool
- errorCode required NoSuchEntityErrorCode
- message required ErrorMessage
NumericSeverity
- NumericSeverity
number
NumericVersion
- NumericVersion
integer
OperatingSystem
- OperatingSystem
string
PaginationToken
- PaginationToken
string
PreviewAgentsMaxResults
- PreviewAgentsMaxResults
integer
PreviewAgentsRequest
- PreviewAgentsRequest
object
- maxResults PreviewAgentsMaxResults
- nextToken PaginationToken
- previewAgentsArn required Arn
PreviewAgentsResponse
- PreviewAgentsResponse
object
- agentPreviews required AgentPreviewList
- nextToken PaginationToken
ProviderName
- ProviderName
string
RegisterCrossAccountAccessRoleRequest
- RegisterCrossAccountAccessRoleRequest
object
- roleArn required Arn
RemoveAttributesFromFindingsRequest
- RemoveAttributesFromFindingsRequest
object
- attributeKeys required UserAttributeKeyList
- findingArns required AddRemoveAttributesFindingArnList
RemoveAttributesFromFindingsResponse
- RemoveAttributesFromFindingsResponse
object
- failedItems required FailedItems
ReportFileFormat
- ReportFileFormat
string
(values: HTML, PDF)
ReportStatus
- ReportStatus
string
(values: WORK_IN_PROGRESS, FAILED, COMPLETED)
ReportType
- ReportType
string
(values: FINDING, FULL)
ResourceGroup
- ResourceGroup
object
: Contains information about a resource group. The resource group defines a set of tags that, when queried, identify the AWS resources that make up the assessment target. This data type is used as the response element in the DescribeResourceGroups action.- arn required Arn
- createdAt required Timestamp
- tags required ResourceGroupTags
ResourceGroupList
- ResourceGroupList
array
- items ResourceGroup
ResourceGroupTag
- ResourceGroupTag
object
: This data type is used as one of the elements of the ResourceGroup data type.
ResourceGroupTags
- ResourceGroupTags
array
- items ResourceGroupTag
RuleName
- RuleName
string
RuleNameList
- RuleNameList
array
- items RuleName
RulesPackage
- RulesPackage
object
: Contains information about an Amazon Inspector rules package. This data type is used as the response element in the DescribeRulesPackages action.- arn required Arn
- description Text
- name required RulesPackageName
- provider required ProviderName
- version required Version
RulesPackageList
- RulesPackageList
array
- items RulesPackage
RulesPackageName
- RulesPackageName
string
ServiceName
- ServiceName
string
SetTagsForResourceRequest
Severity
- Severity
string
(values: Low, Medium, High, Informational, Undefined)
SeverityList
- SeverityList
array
- items Severity
StartAssessmentRunRequest
- StartAssessmentRunRequest
object
- assessmentRunName AssessmentRunName
- assessmentTemplateArn required Arn
StartAssessmentRunResponse
- StartAssessmentRunResponse
object
- assessmentRunArn required Arn
StopAction
- StopAction
string
(values: START_EVALUATION, SKIP_EVALUATION)
StopAssessmentRunRequest
- StopAssessmentRunRequest
object
- assessmentRunArn required Arn
- stopAction StopAction
SubscribeToEventRequest
- SubscribeToEventRequest
object
- event required InspectorEvent
- resourceArn required Arn
- topicArn required Arn
Subscription
- Subscription
object
: This data type is used as a response element in the ListEventSubscriptions action.- eventSubscriptions required EventSubscriptionList
- resourceArn required Arn
- topicArn required Arn
SubscriptionList
- SubscriptionList
array
- items Subscription
Tag
- Tag
object
: 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
- TagKey
string
TagList
- TagList
array
- items Tag
TagValue
- TagValue
string
TelemetryMetadata
- TelemetryMetadata
object
: The metadata about the Amazon Inspector application data metrics collected by the agent. This data type is used as the response element in the GetTelemetryMetadata action.- count required Long
- dataSize Long
- messageType required MessageType
TelemetryMetadataList
- TelemetryMetadataList
array
- items TelemetryMetadata
Text
- Text
string
Timestamp
- Timestamp
string
TimestampRange
- TimestampRange
object
: This data type is used in the AssessmentRunFilter data type.
UnsubscribeFromEventRequest
- UnsubscribeFromEventRequest
object
- event required InspectorEvent
- resourceArn required Arn
- topicArn required Arn
UnsupportedFeatureException
- UnsupportedFeatureException
object
: Used by the GetAssessmentReport API. The request was rejected because you tried to generate a report for an assessment run that existed before reporting was supported in Amazon Inspector. You can only generate reports for assessment runs that took place or will take place after generating reports in Amazon Inspector became available.- canRetry required Bool
- message required ErrorMessage
UpdateAssessmentTargetRequest
- UpdateAssessmentTargetRequest
object
- assessmentTargetArn required Arn
- assessmentTargetName required AssessmentTargetName
- resourceGroupArn required Arn
Url
- Url
string
UserAttributeKeyList
- UserAttributeKeyList
array
- items AttributeKey
UserAttributeList
- UserAttributeList
array
- items Attribute
Version
- Version
string