Backup / Client / update_restore_testing_plan

update_restore_testing_plan

Backup.Client.update_restore_testing_plan(**kwargs)

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(
    RestoreTestingPlan={
        'RecoveryPointSelection': {
            'Algorithm': 'LATEST_WITHIN_WINDOW'|'RANDOM_WITHIN_WINDOW',
            'ExcludeVaults': [
                'string',
            ],
            'IncludeVaults': [
                'string',
            ],
            'RecoveryPointTypes': [
                'CONTINUOUS'|'SNAPSHOT',
            ],
            'SelectionWindowDays': 123
        },
        'ScheduleExpression': 'string',
        'ScheduleExpressionTimezone': 'string',
        'StartWindowHours': 123
    },
    RestoreTestingPlanName='string'
)

Parameters:

• RestoreTestingPlan (dict) –

  [REQUIRED]

  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.

      Include SNAPSHOT to restore only snapshot recovery points; include CONTINUOUS to restore continuous recovery points (point in time restore / PITR); use both to restore either a snapshot or a continuous recovery point. The recovery point will be determined by the value for Algorithm.

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

  [REQUIRED]

  The name of the restore testing plan name.

Return type:

dict

Returns:

Response Syntax

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

Response Structure

• (dict) –

  • CreationTime (datetime) –

    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) –

    The time the update completed for the restore testing plan.

Exceptions

• Backup.Client.exceptions.ConflictException

• Backup.Client.exceptions.InvalidParameterValueException

• Backup.Client.exceptions.MissingParameterValueException

• Backup.Client.exceptions.ResourceNotFoundException

• Backup.Client.exceptions.ServiceUnavailableException