Backup / Client / update_restore_testing_plan



This request will send changes to your specified restore testing plan. RestoreTestingPlanName cannot be updated after it is created.

RecoveryPointSelection can contain:

  • Algorithm

  • ExcludeVaults

  • IncludeVaults

  • RecoveryPointTypes

  • SelectionWindowDays

See also: AWS API Documentation

Request Syntax

response = client.update_restore_testing_plan(
        'RecoveryPointSelection': {
            'ExcludeVaults': [
            'IncludeVaults': [
            'RecoveryPointTypes': [
            'SelectionWindowDays': 123
        'ScheduleExpression': 'string',
        'ScheduleExpressionTimezone': 'string',
        'StartWindowHours': 123
  • RestoreTestingPlan (dict) –


    Specifies the body of a restore testing plan.

    • RecoveryPointSelection (dict) –

      Required: Algorithm; RecoveryPointTypes; IncludeVaults (one or more).

      Optional: SelectionWindowDays (‘30’ if not specified); ExcludeVaults (defaults to empty list if not listed).

      • Algorithm (string) –

        Acceptable values include “LATEST_WITHIN_WINDOW” or “RANDOM_WITHIN_WINDOW”

      • ExcludeVaults (list) –

        Accepted values include specific ARNs or list of selectors. Defaults to empty list if not listed.

        • (string) –

      • IncludeVaults (list) –

        Accepted values include wildcard [“*”] or by specific ARNs or ARN wilcard replacement [“arn:aws:backup:us-west-2:123456789012:backup-vault:asdf”, …] [“arn:aws:backup:::backup-vault:asdf-*”, …]

        • (string) –

      • RecoveryPointTypes (list) –

        These are the types of recovery points.

        • (string) –

      • SelectionWindowDays (integer) –

        Accepted values are integers from 1 to 365.

    • ScheduleExpression (string) –

      A CRON expression in specified timezone when a restore testing plan is executed.

    • ScheduleExpressionTimezone (string) –

      Optional. This is the timezone in which the schedule expression is set. By default, ScheduleExpressions are in UTC. You can modify this to a specified timezone.

    • StartWindowHours (integer) –

      Defaults to 24 hours.

      A value in hours after a restore test is scheduled before a job will be canceled if it doesn’t start successfully. This value is optional. If this value is included, this parameter has a maximum value of 168 hours (one week).

  • RestoreTestingPlanName (string) –


    This is the restore testing plan name you wish to update.

Return type:



Response Syntax

    'CreationTime': datetime(2015, 1, 1),
    'RestoreTestingPlanArn': 'string',
    'RestoreTestingPlanName': 'string',
    'UpdateTime': datetime(2015, 1, 1)

Response Structure

  • (dict) –

    • CreationTime (datetime) –

      This is the time the resource testing plan was created.

    • RestoreTestingPlanArn (string) –

      Unique ARN (Amazon Resource Name) of the restore testing plan.

    • RestoreTestingPlanName (string) –

      The name cannot be changed after creation. The name consists of only alphanumeric characters and underscores. Maximum length is 50.

    • UpdateTime (datetime) –

      This is the time the update completed for the restore testing plan.