Skip to main content

recovery_points_by_legal_holds

Creates, updates, deletes, gets or lists a recovery_points_by_legal_holds resource.

Overview

Namerecovery_points_by_legal_holds
TypeResource
Idaws.backup.recovery_points_by_legal_holds

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
backup_vault_namestringThe name of the backup vault (the logical container in which backups are stored). (pattern: <code>^[a-zA-Z0-9-_]{2,50}$</code>)
recovery_point_arnstringThe Amazon Resource Name (ARN) of the parent (composite) recovery point.
resource_arnstringThe Amazon Resource Name (ARN) that uniquely identifies a saved resource.
resource_typestringThe Amazon Web Services resource type that is saved as a recovery point. (pattern: <code>^[a-zA-Z0-9-_.]{1,50}$</code>)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_recovery_points_by_legal_holdselectlegal_hold_id, regionnextToken, maxResultsThis action returns recovery point ARNs (Amazon Resource Names) of the specified legal hold.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of resource list items to be returned.
nextTokenstringThe next item following a partial list of returned resources. For example, if a request is made to return MaxResults number of resources, NextToken allows you to return more items in your list starting at the location pointed to by the next token.

SELECT examples

This action returns recovery point ARNs (Amazon Resource Names) of the specified legal hold.

SELECT
backup_vault_name,
recovery_point_arn,
resource_arn,
resource_type
FROM aws.backup.recovery_points_by_legal_holds
WHERE legal_hold_id = '{{ legal_hold_id }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;