AWS Backup

2024/03/15 - AWS Backup - 1 updated api methods

Changes  This release introduces a boolean attribute ManagedByAWSBackupOnly as part of ListRecoveryPointsByResource api to filter the recovery points based on ownership. This attribute can be used to filter out the recovery points protected by AWSBackup.

ListRecoveryPointsByResource (updated) Link ΒΆ
Changes (request, response)
Request
{'ManagedByAWSBackupOnly': 'boolean'}
Response
{'RecoveryPoints': {'VaultType': 'BACKUP_VAULT | '
                                 'LOGICALLY_AIR_GAPPED_BACKUP_VAULT'}}

Returns detailed information about all 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

client.list_recovery_points_by_resource(
    ResourceArn='string',
    NextToken='string',
    MaxResults=123,
    ManagedByAWSBackupOnly=True|False
)
type ResourceArn

string

param ResourceArn

[REQUIRED]

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

type NextToken

string

param NextToken

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.

type MaxResults

integer

param MaxResults

The maximum number of items to be returned.

Note

Amazon RDS requires a value of at least 20.

type ManagedByAWSBackupOnly

boolean

param ManagedByAWSBackupOnly

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

rtype

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 reason of the recovery point deletion failure.

        • 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. They consist of lowercase letters, numbers, and hyphens.

        • IsParent (boolean) --

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

        • ParentRecoveryPointArn (string) --

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

        • ResourceName (string) --

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

        • VaultType (string) --

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