AWS Resilience Hub

2022/10/20 - AWS Resilience Hub - 2 updated api methods

Changes  In this release, we are introducing support for regional optimization for AWS Resilience Hub applications. It also includes a few documentation updates to improve clarity.

ListAppComponentRecommendations (updated) Link ¶
Changes (response)
{'componentRecommendations': {'configRecommendations': {'optimizationType': {'BestRegionRecovery'}}}}

Lists the recommendations for an AWS Resilience Hub component.

See also: AWS API Documentation

Request Syntax

client.list_app_component_recommendations(
    assessmentArn='string',
    maxResults=123,
    nextToken='string'
)
type assessmentArn:

string

param assessmentArn:

[REQUIRED]

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.

type maxResults:

integer

param maxResults:

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.

type nextToken:

string

param nextToken:

Null, or the token from a previous call to get the next set of results.

rtype:

dict

returns:

Response Syntax

{
    'componentRecommendations': [
        {
            'appComponentName': 'string',
            'configRecommendations': [
                {
                    'appComponentName': 'string',
                    'compliance': {
                        'string': {
                            'achievableRpoInSecs': 123,
                            'achievableRtoInSecs': 123,
                            'complianceStatus': 'PolicyBreached'|'PolicyMet',
                            'currentRpoInSecs': 123,
                            'currentRtoInSecs': 123,
                            'message': 'string',
                            'rpoDescription': 'string',
                            'rpoReferenceId': 'string',
                            'rtoDescription': 'string',
                            'rtoReferenceId': 'string'
                        }
                    },
                    'cost': {
                        'amount': 123.0,
                        'currency': 'string',
                        'frequency': 'Hourly'|'Daily'|'Monthly'|'Yearly'
                    },
                    'description': 'string',
                    'haArchitecture': 'MultiSite'|'WarmStandby'|'PilotLight'|'BackupAndRestore'|'NoRecoveryPlan',
                    'name': 'string',
                    'optimizationType': 'LeastCost'|'LeastChange'|'BestAZRecovery'|'LeastErrors'|'BestAttainable'|'BestRegionRecovery',
                    'recommendationCompliance': {
                        'string': {
                            'expectedComplianceStatus': 'PolicyBreached'|'PolicyMet',
                            'expectedRpoDescription': 'string',
                            'expectedRpoInSecs': 123,
                            'expectedRtoDescription': 'string',
                            'expectedRtoInSecs': 123
                        }
                    },
                    'referenceId': 'string',
                    'suggestedChanges': [
                        'string',
                    ]
                },
            ],
            'recommendationStatus': 'BreachedUnattainable'|'BreachedCanMeet'|'MetCanImprove'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • componentRecommendations (list) --

      The recommendations for an Resilience Hub application component, returned as an object. This object contains component names, configuration recommendations, and recommendation statuses.

      • (dict) --

        Defines recommendations for a Resilience Hub application component, returned as an object. This object contains component names, configuration recommendations, and recommendation statuses.

        • appComponentName (string) --

          The name of the application component.

        • configRecommendations (list) --

          The list of recommendations.

          • (dict) --

            Defines a configuration recommendation.

            • appComponentName (string) --

              The application component name.

            • compliance (dict) --

              The current compliance against the resiliency policy before applying the configuration change.

              • (string) --

                • (dict) --

                  Defines the compliance against the resiliency policy for a disruption.

                  • achievableRpoInSecs (integer) --

                    The Recovery Point Objective (RPO) that is achievable, in seconds.

                  • achievableRtoInSecs (integer) --

                    The Recovery Time Objective (RTO) that is achievable, in seconds

                  • complianceStatus (string) --

                    The current status of compliance for the resiliency policy.

                  • currentRpoInSecs (integer) --

                    The current RPO, in seconds.

                  • currentRtoInSecs (integer) --

                    The current RTO, in seconds.

                  • message (string) --

                    The disruption compliance message.

                  • rpoDescription (string) --

                    The RPO description.

                  • rpoReferenceId (string) --

                    The RPO reference identifier.

                  • rtoDescription (string) --

                    The RTO description.

                  • rtoReferenceId (string) --

                    The RTO reference identifier.

            • 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.

            • description (string) --

              The optional description for an app.

            • haArchitecture (string) --

              The architecture type.

            • name (string) --

              The name of the recommendation configuration.

            • optimizationType (string) --

              The type of optimization.

            • recommendationCompliance (dict) --

              The expected compliance against the resiliency policy after applying the configuration change.

              • (string) --

                • (dict) --

                  Defines a disruption compliance recommendation.

                  • expectedComplianceStatus (string) --

                    The expected compliance status after applying the recommended configuration change.

                  • expectedRpoDescription (string) --

                    The expected Recovery Point Objective (RPO) description after applying the recommended configuration change.

                  • expectedRpoInSecs (integer) --

                    The expected RPO after applying the recommended configuration change.

                  • expectedRtoDescription (string) --

                    The expected Recovery Time Objective (RTO) description after applying the recommended configuration change.

                  • expectedRtoInSecs (integer) --

                    The expected RTO after applying the recommended configuration change.

            • referenceId (string) --

              The reference identifier for the recommendation configuration.

            • suggestedChanges (list) --

              List of the suggested configuration changes.

              • (string) --

        • recommendationStatus (string) --

          The recommendation status.

    • nextToken (string) --

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

ListApps (updated) Link ¶
Changes (response)
{'appSummaries': {'status': 'Active | Deleting'}}

Lists your Resilience Hub applications.

See also: AWS API Documentation

Request Syntax

client.list_apps(
    appArn='string',
    maxResults=123,
    name='string',
    nextToken='string'
)
type appArn:

string

param appArn:

The Amazon Resource Name (ARN) of the 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.

type maxResults:

integer

param maxResults:

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.

type name:

string

param name:

The name for the one of the listed applications.

type nextToken:

string

param nextToken:

Null, or the token from a previous call to get the next set of results.

rtype:

dict

returns:

Response Syntax

{
    'appSummaries': [
        {
            'appArn': 'string',
            'assessmentSchedule': 'Disabled'|'Daily',
            'complianceStatus': 'PolicyBreached'|'PolicyMet'|'NotAssessed'|'ChangesDetected',
            'creationTime': datetime(2015, 1, 1),
            'description': 'string',
            'name': 'string',
            'resiliencyScore': 123.0,
            'status': 'Active'|'Deleting'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • appSummaries (list) --

      Summaries for the Resilience Hub application.

      • (dict) --

        Defines an application summary.

        • appArn (string) --

          The Amazon Resource Name (ARN) of the 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.

        • assessmentSchedule (string) --

          Assessment execution schedule with 'Daily' or 'Disabled' values.

        • complianceStatus (string) --

          The current status of compliance for the resiliency policy.

        • creationTime (datetime) --

          The timestamp for when the app was created.

        • description (string) --

          The optional description for an app.

        • name (string) --

          The name of the application.

        • resiliencyScore (float) --

          The current resiliency score for the application.

        • status (string) --

          The status of the application.

    • nextToken (string) --

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