list_app_assessments

list_app_assessments(**kwargs)

Lists the assessments for an AWS Resilience Hub application. You can use request parameters to refine the results for the response object.

See also: AWS API Documentation

Request Syntax

response = client.list_app_assessments(
    appArn='string',
    assessmentName='string',
    assessmentStatus=[
        'Pending'|'InProgress'|'Failed'|'Success',
    ],
    complianceStatus='PolicyBreached'|'PolicyMet',
    invoker='User'|'System',
    maxResults=123,
    nextToken='string',
    reverseOrder=True|False
)
Parameters
  • appArn (string) -- The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn: partition :resiliencehub: region : account :app/ app-id . For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference guide.
  • assessmentName (string) -- The name for the assessment.
  • assessmentStatus (list) --

    The current status of the assessment for the resiliency policy.

    • (string) --
  • complianceStatus (string) -- The current status of compliance for the resiliency policy.
  • invoker (string) -- Specifies the entity that invoked a specific assessment, either a User or the System .
  • maxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
  • nextToken (string) -- Null, or the token from a previous call to get the next set of results.
  • reverseOrder (boolean) -- The default is to sort by ascending startTime . To sort by descending startTime , set reverseOrder to true .
Return type

dict

Returns

Response Syntax

{
    'assessmentSummaries': [
        {
            'appArn': 'string',
            'appVersion': 'string',
            'assessmentArn': 'string',
            'assessmentName': 'string',
            'assessmentStatus': 'Pending'|'InProgress'|'Failed'|'Success',
            'complianceStatus': 'PolicyBreached'|'PolicyMet',
            'cost': {
                'amount': 123.0,
                'currency': 'string',
                'frequency': 'Hourly'|'Daily'|'Monthly'|'Yearly'
            },
            'endTime': datetime(2015, 1, 1),
            'invoker': 'User'|'System',
            'message': 'string',
            'resiliencyScore': 123.0,
            'startTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • assessmentSummaries (list) --

      The summaries for the specified assessments, returned as an object. This object includes application versions, associated Amazon Resource Numbers (ARNs), cost, messages, resiliency scores, and more.

      • (dict) --

        Defines an application assessment summary.

        • appArn (string) --

          The Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn: partition :resiliencehub: region : account :app/ app-id . For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference guide.

        • appVersion (string) --

          The version of the application.

        • assessmentArn (string) --

          The Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn: partition :resiliencehub: region : account :app-assessment/ app-id . For more information about ARNs, see Amazon Resource Names (ARNs) in the AWS General Reference guide.

        • assessmentName (string) --

          The name of the assessment.

        • assessmentStatus (string) --

          The current status of the assessment for the resiliency policy.

        • complianceStatus (string) --

          The current status of compliance for the resiliency policy.

        • cost (dict) --

          The cost for the application.

          • amount (float) --

            The cost amount.

          • currency (string) --

            The cost currency, for example USD .

          • frequency (string) --

            The cost frequency.

        • endTime (datetime) --

          The end time for the action.

        • invoker (string) --

          The entity that invoked the assessment.

        • message (string) --

          The message from the assessment run.

        • resiliencyScore (float) --

          The current resiliency score for the application.

        • startTime (datetime) --

          The starting time for the action.

    • nextToken (string) --

      The token for the next set of results, or null if there are no more results.

Exceptions

  • ResilienceHub.Client.exceptions.InternalServerException
  • ResilienceHub.Client.exceptions.ResourceNotFoundException
  • ResilienceHub.Client.exceptions.ThrottlingException
  • ResilienceHub.Client.exceptions.ValidationException
  • ResilienceHub.Client.exceptions.AccessDeniedException