ListRecoveryPointsByResource - AWS Backup
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ListRecoveryPointsByResource

La información sobre los puntos de recuperación del tipo especificado por un Amazon Resource Name (ARN) de un recurso.

nota

Para Amazon EFS y Amazon EC2, esta acción solo muestra los puntos de recuperación creados por AWS Backup.

Sintaxis de la solicitud

GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

ManagedByAWSBackupOnly

Este atributo filtra los puntos de recuperación en función de su propiedad.

Si se establece enTRUE, la respuesta contendrá los puntos de recuperación asociados a los recursos seleccionados gestionados por AWS Backup.

Si se establece enFALSE, la respuesta contendrá todos los puntos de recuperación asociados al recurso seleccionado.

Tipo: Booleano

MaxResults

Número máximo de elementos que se van a devolver.

nota

Amazon RDS requiere un valor mínimo de 20.

Rango válido: valor mínimo de 1. Valor máximo de 1000.

NextToken

El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el número de elementos MaxResults, NextToken permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

resourceArn

Un ARN que identifica de forma única a un recurso. El formato del ARN depende del tipo de recurso.

Obligatorio: sí

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

NextToken

El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el número de elementos MaxResults, NextToken permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

Tipo: cadena

RecoveryPoints

Una matriz de objetos que contiene información detallada sobre los puntos de recuperación del tipo de recurso especificado.

nota

Solo se devuelven los puntos de recuperación de Amazon EFS y Amazon EC2. BackupVaultName

Tipo: matriz de objetos RecoveryPointByResource

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

InvalidParameterValueException

Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.

Código de estado HTTP: 400

MissingParameterValueException

Indica que falta un parámetro obligatorio.

Código de estado HTTP: 400

ResourceNotFoundException

No existe un recurso necesario para la acción.

Código de estado HTTP: 400

ServiceUnavailableException

La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.

Código de estado HTTP: 500

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: