Backup / Client / list_recovery_points_by_resource

list_recovery_points_by_resource#

Backup.Client.list_recovery_points_by_resource(**kwargs)#

The information about the recovery points of the type specified by a resource Amazon Resource Name (ARN).

Note

For Amazon EFS and Amazon EC2, this action only lists recovery points created by Backup.

See also: AWS API Documentation

Request Syntax

response = client.list_recovery_points_by_resource(
    ResourceArn='string',
    NextToken='string',
    MaxResults=123,
    ManagedByAWSBackupOnly=True|False
)
Parameters:
  • ResourceArn (string) –

    [REQUIRED]

    An ARN that uniquely identifies a resource. The format of the ARN depends on the resource type.

  • NextToken (string) – The next item following a partial list of returned items. For example, if a request is made to return MaxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

  • MaxResults (integer) –

    The maximum number of items to be returned.

    Note

    Amazon RDS requires a value of at least 20.

  • ManagedByAWSBackupOnly (boolean) –

    This attribute filters recovery points based on ownership.

    If this is set to TRUE, the response will contain recovery points associated with the selected resources that are managed by Backup.

    If this is set to FALSE, the response will contain all recovery points associated with the selected resource.

    Type: Boolean

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'RecoveryPoints': [
        {
            'RecoveryPointArn': 'string',
            'CreationDate': datetime(2015, 1, 1),
            'Status': 'COMPLETED'|'PARTIAL'|'DELETING'|'EXPIRED',
            'StatusMessage': 'string',
            'EncryptionKeyArn': 'string',
            'BackupSizeBytes': 123,
            'BackupVaultName': 'string',
            'IsParent': True|False,
            'ParentRecoveryPointArn': 'string',
            'ResourceName': 'string',
            'VaultType': 'BACKUP_VAULT'|'LOGICALLY_AIR_GAPPED_BACKUP_VAULT'
        },
    ]
}

Response Structure

  • (dict) –

    • NextToken (string) –

      The next item following a partial list of returned items. For example, if a request is made to return MaxResults number of items, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

    • RecoveryPoints (list) –

      An array of objects that contain detailed information about recovery points of the specified resource type.

      Note

      Only Amazon EFS and Amazon EC2 recovery points return BackupVaultName.

      • (dict) –

        Contains detailed information about a saved recovery point.

        • RecoveryPointArn (string) –

          An Amazon Resource Name (ARN) that uniquely identifies a recovery point; for example, arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

        • CreationDate (datetime) –

          The date and time a recovery point is created, in Unix format and Coordinated Universal Time (UTC). The value of CreationDate is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.

        • Status (string) –

          A status code specifying the state of the recovery point.

        • StatusMessage (string) –

          A message explaining the current status of the recovery point.

        • EncryptionKeyArn (string) –

          The server-side encryption key that is used to protect your backups; for example, arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

        • BackupSizeBytes (integer) –

          The size, in bytes, of a backup.

        • BackupVaultName (string) –

          The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the Amazon Web Services Region where they are created.

        • IsParent (boolean) –

          This is a boolean value indicating this is a parent (composite) recovery point.

        • ParentRecoveryPointArn (string) –

          The Amazon Resource Name (ARN) of the parent (composite) recovery point.

        • ResourceName (string) –

          The non-unique name of the resource that belongs to the specified backup.

        • VaultType (string) –

          The type of vault in which the described recovery point is stored.

Exceptions

  • Backup.Client.exceptions.ResourceNotFoundException

  • Backup.Client.exceptions.InvalidParameterValueException

  • Backup.Client.exceptions.MissingParameterValueException

  • Backup.Client.exceptions.ServiceUnavailableException