describe_assessment_runs

Inspector.Client.describe_assessment_runs(**kwargs)

Describes the assessment runs that are specified by the ARNs of the assessment runs.

See also: AWS API Documentation

Request Syntax

response = client.describe_assessment_runs(
    assessmentRunArns=[
        'string',
    ]
)
Parameters
assessmentRunArns (list) --

[REQUIRED]

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

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'assessmentRuns': [
        {
            'arn': 'string',
            'name': 'string',
            'assessmentTemplateArn': 'string',
            'state': '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',
            'durationInSeconds': 123,
            'rulesPackageArns': [
                'string',
            ],
            'userAttributesForFindings': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            'createdAt': datetime(2015, 1, 1),
            'startedAt': datetime(2015, 1, 1),
            'completedAt': datetime(2015, 1, 1),
            'stateChangedAt': datetime(2015, 1, 1),
            'dataCollected': True|False,
            'stateChanges': [
                {
                    'stateChangedAt': datetime(2015, 1, 1),
                    'state': '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'
                },
            ],
            'notifications': [
                {
                    'date': datetime(2015, 1, 1),
                    'event': 'ASSESSMENT_RUN_STARTED'|'ASSESSMENT_RUN_COMPLETED'|'ASSESSMENT_RUN_STATE_CHANGED'|'FINDING_REPORTED'|'OTHER',
                    'message': 'string',
                    'error': True|False,
                    'snsTopicArn': 'string',
                    'snsPublishStatusCode': 'SUCCESS'|'TOPIC_DOES_NOT_EXIST'|'ACCESS_DENIED'|'INTERNAL_ERROR'
                },
            ],
            'findingCounts': {
                'string': 123
            }
        },
    ],
    'failedItems': {
        'string': {
            'failureCode': 'INVALID_ARN'|'DUPLICATE_ARN'|'ITEM_DOES_NOT_EXIST'|'ACCESS_DENIED'|'LIMIT_EXCEEDED'|'INTERNAL_ERROR',
            'retryable': True|False
        }
    }
}

Response Structure

  • (dict) --
    • assessmentRuns (list) --

      Information about the assessment run.

      • (dict) --

        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.

          • (dict) --

            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 (datetime) --

          The time when StartAssessmentRun was called.

        • startedAt (datetime) --

          The time when StartAssessmentRun was called.

        • completedAt (datetime) --

          The assessment run completion time that corresponds to the rules packages evaluation completion time or failure.

        • stateChangedAt (datetime) --

          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.

          • (dict) --

            Used as one of the elements of the AssessmentRun data type.

            • stateChangedAt (datetime) --

              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.

          • (dict) --

            Used as one of the elements of the AssessmentRun data type.

            • date (datetime) --

              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 (dict) --

          Provides a total count of generated findings per severity.

          • (string) --
            • (integer) --
    • failedItems (dict) --

      Assessment run details that cannot be described. An error code is provided for each failed item.

      • (string) --
        • (dict) --

          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.

Exceptions

  • Inspector.Client.exceptions.InternalException
  • Inspector.Client.exceptions.InvalidInputException

Examples

Describes the assessment runs that are specified by the ARNs of the assessment runs.

response = client.describe_assessment_runs(
    assessmentRunArns=[
        'arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE',
    ],
)

print(response)

Expected Output:

{
    'assessmentRuns': [
        {
            'name': 'Run 1 for ExampleAssessmentTemplate',
            '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': datetime(2016, 3, 22, 20, 58, 21, 1, 82, 0),
            'createdAt': datetime(2016, 3, 22, 20, 56, 10, 1, 82, 0),
            'dataCollected': True,
            'durationInSeconds': 3600,
            'findingCounts': {
                'High': 14,
                'Informational': 0,
                'Low': 0,
                'Medium': 2,
                'Undefined': 0,
            },
            'notifications': [
            ],
            'rulesPackageArns': [
                'arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP',
            ],
            'startedAt': datetime(2016, 3, 22, 20, 56, 10, 1, 82, 0),
            'state': 'COMPLETED',
            'stateChangedAt': datetime(2016, 3, 22, 20, 58, 21, 1, 82, 0),
            'stateChanges': [
                {
                    'state': 'CREATED',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 56, 10, 1, 82, 0),
                },
                {
                    'state': 'START_DATA_COLLECTION_PENDING',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 56, 10, 1, 82, 0),
                },
                {
                    'state': 'START_DATA_COLLECTION_IN_PROGRESS',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 56, 10, 1, 82, 0),
                },
                {
                    'state': 'COLLECTING_DATA',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 56, 10, 1, 82, 0),
                },
                {
                    'state': 'STOP_DATA_COLLECTION_PENDING',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 57, 19, 1, 82, 0),
                },
                {
                    'state': 'DATA_COLLECTED',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 58, 19, 1, 82, 0),
                },
                {
                    'state': 'EVALUATING_RULES',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 58, 20, 1, 82, 0),
                },
                {
                    'state': 'COMPLETED',
                    'stateChangedAt': datetime(2016, 3, 22, 20, 58, 21, 1, 82, 0),
                },
            ],
            'userAttributesForFindings': [
            ],
        },
    ],
    'failedItems': {
    },
    'ResponseMetadata': {
        '...': '...',
    },
}