ResilienceHub / Client / list_alarm_recommendations

list_alarm_recommendations#

ResilienceHub.Client.list_alarm_recommendations(**kwargs)#

Lists the alarm recommendations for an Resilience Hub application.

See also: AWS API Documentation

Request Syntax

response = client.list_alarm_recommendations(
    assessmentArn='string',
    maxResults=123,
    nextToken='string'
)
Parameters:

  • assessmentArn (string) –

    [REQUIRED]

    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 Amazon Web Services General Reference guide.

  • maxResults (integer) – 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.

Return type:

dict

Returns:

Response Syntax

{
    'alarmRecommendations': [
        {
            'appComponentName': 'string',
            'appComponentNames': [
                'string',
            ],
            'description': 'string',
            'items': [
                {
                    'alreadyImplemented': True|False,
                    'discoveredAlarm': {
                        'alarmArn': 'string',
                        'source': 'string'
                    },
                    'excludeReason': 'AlreadyImplemented'|'NotRelevant'|'ComplexityOfImplementation',
                    'excluded': True|False,
                    'latestDiscoveredExperiment': {
                        'experimentArn': 'string',
                        'experimentTemplateId': 'string'
                    },
                    'resourceId': 'string',
                    'targetAccountId': 'string',
                    'targetRegion': 'string'
                },
            ],
            'name': 'string',
            'prerequisite': 'string',
            'recommendationId': 'string',
            'recommendationStatus': 'Implemented'|'Inactive'|'NotImplemented'|'Excluded',
            'referenceId': 'string',
            'type': 'Metric'|'Composite'|'Canary'|'Logs'|'Event'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • alarmRecommendations (list) –

      The alarm recommendations for an Resilience Hub application, returned as an object. This object includes Application Component names, descriptions, information about whether a recommendation has already been implemented or not, prerequisites, and more.

      • (dict) –

        Defines a recommendation for a CloudWatch alarm.

        • appComponentName (string) –

          Application Component name for the CloudWatch alarm recommendation. This name is saved as the first item in the appComponentNames list.

        • appComponentNames (list) –

          List of Application Component names for the CloudWatch alarm recommendation.

          • (string) –

        • description (string) –

          Description of the alarm recommendation.

        • items (list) –

          List of CloudWatch alarm recommendations.

          • (dict) –

            Defines a recommendation.

            • alreadyImplemented (boolean) –

              Specifies if the recommendation has already been implemented.

            • discoveredAlarm (dict) –

              Indicates the previously implemented Amazon CloudWatch alarm discovered by Resilience Hub.

              • alarmArn (string) –

                Amazon Resource Name (ARN) of the Amazon CloudWatch alarm.

              • source (string) –

                Indicates the source of the Amazon CloudWatch alarm. That is, it indicates if the alarm was created using Resilience Hub recommendation ( AwsResilienceHub), or if you had created the alarm in Amazon CloudWatch ( Customer).

            • excludeReason (string) –

              Indicates the reason for excluding an operational recommendation.

            • excluded (boolean) –

              Indicates if an operational recommendation item is excluded.

            • latestDiscoveredExperiment (dict) –

              Indicates the experiment created in FIS that was discovered by Resilience Hub, which matches the recommendation.

              • experimentArn (string) –

                Amazon Resource Name (ARN) of the FIS experiment.

              • experimentTemplateId (string) –

                Identifier of the FIS experiment template.

            • resourceId (string) –

              Identifier of the resource.

            • targetAccountId (string) –

              Identifier of the target account.

            • targetRegion (string) –

              The target region.

        • name (string) –

          Name of the alarm recommendation.

        • prerequisite (string) –

          The prerequisite for the alarm recommendation.

        • recommendationId (string) –

          Identifier of the alarm recommendation.

        • recommendationStatus (string) –

          Status of the recommended Amazon CloudWatch alarm.

        • referenceId (string) –

          Reference identifier of the alarm recommendation.

        • type (string) –

          Type of alarm recommendation.

    • nextToken (string) –

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

Exceptions