ListRecoveryPointsByBackupVault - 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.

ListRecoveryPointsByBackupVault

Devuelve información detallada sobre los puntos de recuperación almacenados en un almacén de copias de seguridad.

Sintaxis de la solicitud

GET /backup-vaults/backupVaultName/recovery-points/?backupPlanId=ByBackupPlanId&backupVaultAccountId=BackupVaultAccountId&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentRecoveryPointArn=ByParentRecoveryPointArn&resourceArn=ByResourceArn&resourceType=ByResourceType HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

BackupVaultAccountId

Este parámetro ordenará la lista de puntos de recuperación por ID de cuenta.

Patrón: ^[0-9]{12}$

backupVaultName

El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de AWS donde se crearon. Constan de letras minúsculas, números y guiones.

nota

Es posible que el nombre del almacén de copias de seguridad no esté disponible cuando un servicio compatible cree la copia de seguridad.

Patrón: ^[a-zA-Z0-9\-\_]{2,50}$

Obligatorio: sí

ByBackupPlanId

Devuelve solo los puntos de recuperación que coinciden con el identificador del plan de copia de seguridad especificado.

ByCreatedAfter

Devuelve solo los puntos de recuperación que se crearon después de la marca de tiempo especificada.

ByCreatedBefore

Devuelve solo los puntos de recuperación que se crearon antes de la marca de tiempo especificada.

ByParentRecoveryPointArn

Devuelve solo los puntos de recuperación que coinciden con el nombre de recurso de Amazon (ARN) del punto de recuperación principal (compuesto) especificado.

ByResourceArn

Devuelve solo los puntos de recuperación que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado.

ByResourceType

Devuelve solo los puntos de recuperación que coinciden con el tipo o los tipos de recurso especificados.

  • Aurora para Amazon Aurora

  • CloudFormationpara AWS CloudFormation

  • DocumentDB para Amazon DocumentDB (con compatibilidad con MongoDB)

  • DynamoDB para Amazon DynamoDB

  • EBS para Amazon Elastic Block Store (EBS)

  • EC2 para Amazon Elastic Compute Cloud

  • EFS para Amazon Elastic File System

  • FSx para Amazon FSx

  • Neptune para Amazon Neptune

  • RDS para Amazon Relational Database Service

  • Redshift para Amazon Redshift

  • S3para Amazon Simple Storage Service (Amazon S3)

  • SAP HANA on Amazon EC2para bases de datos SAP HANA en instancias de Amazon Elastic Compute Cloud

  • Storage Gatewaypara AWS Storage Gateway

  • Timestream para Amazon Timestream

  • VirtualMachinepara máquinas virtuales VMware

Patrón: ^[a-zA-Z0-9\-\_\.]{1,50}$

MaxResults

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

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.

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": [ 
      { 
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CalculatedLifecycle": { 
            "DeleteAt": number,
            "MoveToColdStorageAt": number
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IamRoleArn": "string",
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "LastRestoreTime": number,
         "Lifecycle": { 
            "DeleteAfterDays": number,
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "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 guardados en un almacén de copias de seguridad.

Tipo: matriz de objetos RecoveryPointByBackupVault

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: