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 recurso Amazon Resource Name (ARN).
nota
En el caso de Amazon EFS y AmazonEC2, 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
URIParámetros de solicitud
La solicitud utiliza los siguientes URI parámetros.
- ManagedByAWSBackupOnly
-
Este atributo filtra los puntos de recuperación en función de la propiedad.
Si se establece en
TRUE
, la respuesta contendrá los puntos de recuperación asociados a los recursos seleccionados gestionados por AWS Backup.Si se establece en
FALSE
, 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
-
Y ARN que identifique un recurso de forma única. El formato 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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- 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 EFS los puntos EC2 de recuperación de Amazon y Amazon 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.
HTTPCódigo de estado: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
No existe un recurso necesario para la acción.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
HTTPCódigo de estado: 500
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: