describe-assessment-runs¶
Description¶
Describes the assessment runs that are specified by the ARNs of the assessment runs.
See also: AWS API Documentation
See 'aws help' for descriptions of global parameters.
Synopsis¶
describe-assessment-runs
--assessment-run-arns <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
Options¶
--assessment-run-arns (list)
The ARN that specifies the assessment run that you want to describe.
Syntax:
"string" "string" ...
--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.
--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.
See 'aws help' for descriptions of global parameters.
Examples¶
To describe assessment runs
The following describe-assessment-run command describes an assessment run with the ARN of arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE:
aws inspector describe-assessment-runs --assessment-run-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE
Output:
{
"assessmentRuns": [
{
"arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
"assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw",
"completedAt": 1458680301.4,
"createdAt": 1458680170.035,
"dataCollected": true,
"durationInSeconds": 3600,
"name": "Run 1 for ExampleAssessmentTemplate",
"notifications": [],
"rulesPackageArns": [
"arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP"
],
"startedAt": 1458680170.161,
"state": "COMPLETED",
"stateChangedAt": 1458680301.4,
"stateChanges": [
{
"state": "CREATED",
"stateChangedAt": 1458680170.035
},
{
"state": "START_DATA_COLLECTION_PENDING",
"stateChangedAt": 1458680170.065
},
{
"state": "START_DATA_COLLECTION_IN_PROGRESS",
"stateChangedAt": 1458680170.096
},
{
"state": "COLLECTING_DATA",
"stateChangedAt": 1458680170.161
},
{
"state": "STOP_DATA_COLLECTION_PENDING",
"stateChangedAt": 1458680239.883
},
{
"state": "DATA_COLLECTED",
"stateChangedAt": 1458680299.847
},
{
"state": "EVALUATING_RULES",
"stateChangedAt": 1458680300.099
},
{
"state": "COMPLETED",
"stateChangedAt": 1458680301.4
}
],
"userAttributesForFindings": []
}
],
"failedItems": {}
}
For more information, see Amazon Inspector Assessment Templates and Assessment Runs in the Amazon Inspector guide.
Output¶
assessmentRuns -> (list)
Information about the assessment run.
(structure)
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 -> (string)
The ARN of the assessment run.name -> (string)
The auto-generated name for the assessment run.assessmentTemplateArn -> (string)
The ARN of the assessment template that is associated with the assessment run.state -> (string)
The state of the assessment run.durationInSeconds -> (integer)
The duration of the assessment run.rulesPackageArns -> (list)
The rules packages selected for the assessment run.
(string)
userAttributesForFindings -> (list)
The user-defined attributes that are assigned to every generated finding.
(structure)
This data type is used as a request parameter in the AddAttributesToFindings and CreateAssessmentTemplate actions.
key -> (string)
The attribute key.value -> (string)
The value assigned to the attribute key.createdAt -> (timestamp)
The time when StartAssessmentRun was called.startedAt -> (timestamp)
The time when StartAssessmentRun was called.completedAt -> (timestamp)
The assessment run completion time that corresponds to the rules packages evaluation completion time or failure.stateChangedAt -> (timestamp)
The last time when the assessment run's state changed.dataCollected -> (boolean)
A Boolean value (true or false) that specifies whether the process of collecting data from the agents is completed.stateChanges -> (list)
A list of the assessment run state changes.
(structure)
Used as one of the elements of the AssessmentRun data type.
stateChangedAt -> (timestamp)
The last time the assessment run state changed.state -> (string)
The assessment run state.notifications -> (list)
A list of notifications for the event subscriptions. A notification about a particular generated finding is added to this list only once.
(structure)
Used as one of the elements of the AssessmentRun data type.
date -> (timestamp)
The date of the notification.event -> (string)
The event for which a notification is sent.message -> (string)
The message included in the notification.error -> (boolean)
The Boolean value that specifies whether the notification represents an error.snsTopicArn -> (string)
The SNS topic to which the SNS notification is sent.snsPublishStatusCode -> (string)
The status code of the SNS notification.findingCounts -> (map)
Provides a total count of generated findings per severity.
key -> (string)
value -> (integer)
failedItems -> (map)
Assessment run details that cannot be described. An error code is provided for each failed item.
key -> (string)
value -> (structure)
Includes details about the failed items.
failureCode -> (string)
The status code of a failed item.retryable -> (boolean)
Indicates whether you can immediately retry a request for this item for a specified resource.