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.

# AWS BackupAPI de
<a name="api-reference"></a>

 Además de utilizar la consola, puede utilizar los tipos de datos y las acciones de la API de AWS Backup para configurar y administrar AWS Backup y sus recursos mediante programación. En esta sección se describen los tipos de datos y las acciones de AWS Backup. Contiene la referencia de la API para AWS Backup.

**AWS Backup API**
+ [Acciones de AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_Operations.html)
+ [Tipos de datos de AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_Types.html)

# Acciones
<a name="API_Operations"></a>

Las siguientes acciones cuentan con el apoyo de AWS Backup:
+  [AssociateBackupVaultMpaApprovalTeam](API_AssociateBackupVaultMpaApprovalTeam.md) 
+  [CancelLegalHold](API_CancelLegalHold.md) 
+  [CreateBackupPlan](API_CreateBackupPlan.md) 
+  [CreateBackupSelection](API_CreateBackupSelection.md) 
+  [CreateBackupVault](API_CreateBackupVault.md) 
+  [CreateFramework](API_CreateFramework.md) 
+  [CreateLegalHold](API_CreateLegalHold.md) 
+  [CreateLogicallyAirGappedBackupVault](API_CreateLogicallyAirGappedBackupVault.md) 
+  [CreateReportPlan](API_CreateReportPlan.md) 
+  [CreateRestoreAccessBackupVault](API_CreateRestoreAccessBackupVault.md) 
+  [CreateRestoreTestingPlan](API_CreateRestoreTestingPlan.md) 
+  [CreateRestoreTestingSelection](API_CreateRestoreTestingSelection.md) 
+  [CreateTieringConfiguration](API_CreateTieringConfiguration.md) 
+  [DeleteBackupPlan](API_DeleteBackupPlan.md) 
+  [DeleteBackupSelection](API_DeleteBackupSelection.md) 
+  [DeleteBackupVault](API_DeleteBackupVault.md) 
+  [DeleteBackupVaultAccessPolicy](API_DeleteBackupVaultAccessPolicy.md) 
+  [DeleteBackupVaultLockConfiguration](API_DeleteBackupVaultLockConfiguration.md) 
+  [DeleteBackupVaultNotifications](API_DeleteBackupVaultNotifications.md) 
+  [DeleteFramework](API_DeleteFramework.md) 
+  [DeleteRecoveryPoint](API_DeleteRecoveryPoint.md) 
+  [DeleteReportPlan](API_DeleteReportPlan.md) 
+  [DeleteRestoreTestingPlan](API_DeleteRestoreTestingPlan.md) 
+  [DeleteRestoreTestingSelection](API_DeleteRestoreTestingSelection.md) 
+  [DeleteTieringConfiguration](API_DeleteTieringConfiguration.md) 
+  [DescribeBackupJob](API_DescribeBackupJob.md) 
+  [DescribeBackupVault](API_DescribeBackupVault.md) 
+  [DescribeCopyJob](API_DescribeCopyJob.md) 
+  [DescribeFramework](API_DescribeFramework.md) 
+  [DescribeGlobalSettings](API_DescribeGlobalSettings.md) 
+  [DescribeProtectedResource](API_DescribeProtectedResource.md) 
+  [DescribeRecoveryPoint](API_DescribeRecoveryPoint.md) 
+  [DescribeRegionSettings](API_DescribeRegionSettings.md) 
+  [DescribeReportJob](API_DescribeReportJob.md) 
+  [DescribeReportPlan](API_DescribeReportPlan.md) 
+  [DescribeRestoreJob](API_DescribeRestoreJob.md) 
+  [DescribeScanJob](API_DescribeScanJob.md) 
+  [DisassociateBackupVaultMpaApprovalTeam](API_DisassociateBackupVaultMpaApprovalTeam.md) 
+  [DisassociateRecoveryPoint](API_DisassociateRecoveryPoint.md) 
+  [DisassociateRecoveryPointFromParent](API_DisassociateRecoveryPointFromParent.md) 
+  [ExportBackupPlanTemplate](API_ExportBackupPlanTemplate.md) 
+  [GetBackupPlan](API_GetBackupPlan.md) 
+  [GetBackupPlanFromJSON](API_GetBackupPlanFromJSON.md) 
+  [GetBackupPlanFromTemplate](API_GetBackupPlanFromTemplate.md) 
+  [GetBackupSelection](API_GetBackupSelection.md) 
+  [GetBackupVaultAccessPolicy](API_GetBackupVaultAccessPolicy.md) 
+  [GetBackupVaultNotifications](API_GetBackupVaultNotifications.md) 
+  [GetLegalHold](API_GetLegalHold.md) 
+  [GetRecoveryPointIndexDetails](API_GetRecoveryPointIndexDetails.md) 
+  [GetRecoveryPointRestoreMetadata](API_GetRecoveryPointRestoreMetadata.md) 
+  [GetRestoreJobMetadata](API_GetRestoreJobMetadata.md) 
+  [GetRestoreTestingInferredMetadata](API_GetRestoreTestingInferredMetadata.md) 
+  [GetRestoreTestingPlan](API_GetRestoreTestingPlan.md) 
+  [GetRestoreTestingSelection](API_GetRestoreTestingSelection.md) 
+  [GetSupportedResourceTypes](API_GetSupportedResourceTypes.md) 
+  [GetTieringConfiguration](API_GetTieringConfiguration.md) 
+  [ListBackupJobs](API_ListBackupJobs.md) 
+  [ListBackupJobSummaries](API_ListBackupJobSummaries.md) 
+  [ListBackupPlans](API_ListBackupPlans.md) 
+  [ListBackupPlanTemplates](API_ListBackupPlanTemplates.md) 
+  [ListBackupPlanVersions](API_ListBackupPlanVersions.md) 
+  [ListBackupSelections](API_ListBackupSelections.md) 
+  [ListBackupVaults](API_ListBackupVaults.md) 
+  [ListCopyJobs](API_ListCopyJobs.md) 
+  [ListCopyJobSummaries](API_ListCopyJobSummaries.md) 
+  [ListFrameworks](API_ListFrameworks.md) 
+  [ListIndexedRecoveryPoints](API_ListIndexedRecoveryPoints.md) 
+  [ListLegalHolds](API_ListLegalHolds.md) 
+  [ListProtectedResources](API_ListProtectedResources.md) 
+  [ListProtectedResourcesByBackupVault](API_ListProtectedResourcesByBackupVault.md) 
+  [ListRecoveryPointsByBackupVault](API_ListRecoveryPointsByBackupVault.md) 
+  [ListRecoveryPointsByLegalHold](API_ListRecoveryPointsByLegalHold.md) 
+  [ListRecoveryPointsByResource](API_ListRecoveryPointsByResource.md) 
+  [ListReportJobs](API_ListReportJobs.md) 
+  [ListReportPlans](API_ListReportPlans.md) 
+  [ListRestoreAccessBackupVaults](API_ListRestoreAccessBackupVaults.md) 
+  [ListRestoreJobs](API_ListRestoreJobs.md) 
+  [ListRestoreJobsByProtectedResource](API_ListRestoreJobsByProtectedResource.md) 
+  [ListRestoreJobSummaries](API_ListRestoreJobSummaries.md) 
+  [ListRestoreTestingPlans](API_ListRestoreTestingPlans.md) 
+  [ListRestoreTestingSelections](API_ListRestoreTestingSelections.md) 
+  [ListScanJobs](API_ListScanJobs.md) 
+  [ListScanJobSummaries](API_ListScanJobSummaries.md) 
+  [ListTags](API_ListTags.md) 
+  [ListTieringConfigurations](API_ListTieringConfigurations.md) 
+  [PutBackupVaultAccessPolicy](API_PutBackupVaultAccessPolicy.md) 
+  [PutBackupVaultLockConfiguration](API_PutBackupVaultLockConfiguration.md) 
+  [PutBackupVaultNotifications](API_PutBackupVaultNotifications.md) 
+  [PutRestoreValidationResult](API_PutRestoreValidationResult.md) 
+  [RevokeRestoreAccessBackupVault](API_RevokeRestoreAccessBackupVault.md) 
+  [StartBackupJob](API_StartBackupJob.md) 
+  [StartCopyJob](API_StartCopyJob.md) 
+  [StartReportJob](API_StartReportJob.md) 
+  [StartRestoreJob](API_StartRestoreJob.md) 
+  [StartScanJob](API_StartScanJob.md) 
+  [StopBackupJob](API_StopBackupJob.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateBackupPlan](API_UpdateBackupPlan.md) 
+  [UpdateFramework](API_UpdateFramework.md) 
+  [UpdateGlobalSettings](API_UpdateGlobalSettings.md) 
+  [UpdateRecoveryPointIndexSettings](API_UpdateRecoveryPointIndexSettings.md) 
+  [UpdateRecoveryPointLifecycle](API_UpdateRecoveryPointLifecycle.md) 
+  [UpdateRegionSettings](API_UpdateRegionSettings.md) 
+  [UpdateReportPlan](API_UpdateReportPlan.md) 
+  [UpdateRestoreTestingPlan](API_UpdateRestoreTestingPlan.md) 
+  [UpdateRestoreTestingSelection](API_UpdateRestoreTestingSelection.md) 
+  [UpdateTieringConfiguration](API_UpdateTieringConfiguration.md) 

Las siguientes acciones cuentan con el apoyo de AWS Backup gateway:
+  [AssociateGatewayToServer](API_BGW_AssociateGatewayToServer.md) 
+  [CreateGateway](API_BGW_CreateGateway.md) 
+  [DeleteGateway](API_BGW_DeleteGateway.md) 
+  [DeleteHypervisor](API_BGW_DeleteHypervisor.md) 
+  [DisassociateGatewayFromServer](API_BGW_DisassociateGatewayFromServer.md) 
+  [GetBandwidthRateLimitSchedule](API_BGW_GetBandwidthRateLimitSchedule.md) 
+  [GetGateway](API_BGW_GetGateway.md) 
+  [GetHypervisor](API_BGW_GetHypervisor.md) 
+  [GetHypervisorPropertyMappings](API_BGW_GetHypervisorPropertyMappings.md) 
+  [GetVirtualMachine](API_BGW_GetVirtualMachine.md) 
+  [ImportHypervisorConfiguration](API_BGW_ImportHypervisorConfiguration.md) 
+  [ListGateways](API_BGW_ListGateways.md) 
+  [ListHypervisors](API_BGW_ListHypervisors.md) 
+  [ListTagsForResource](API_BGW_ListTagsForResource.md) 
+  [ListVirtualMachines](API_BGW_ListVirtualMachines.md) 
+  [PutBandwidthRateLimitSchedule](API_BGW_PutBandwidthRateLimitSchedule.md) 
+  [PutHypervisorPropertyMappings](API_BGW_PutHypervisorPropertyMappings.md) 
+  [PutMaintenanceStartTime](API_BGW_PutMaintenanceStartTime.md) 
+  [StartVirtualMachinesMetadataSync](API_BGW_StartVirtualMachinesMetadataSync.md) 
+  [TagResource](API_BGW_TagResource.md) 
+  [TestHypervisorConfiguration](API_BGW_TestHypervisorConfiguration.md) 
+  [UntagResource](API_BGW_UntagResource.md) 
+  [UpdateGatewayInformation](API_BGW_UpdateGatewayInformation.md) 
+  [UpdateGatewaySoftwareNow](API_BGW_UpdateGatewaySoftwareNow.md) 
+  [UpdateHypervisor](API_BGW_UpdateHypervisor.md) 

Las siguientes acciones cuentan con el apoyo de Búsqueda de AWS Backup:
+  [GetSearchJob](API_BKS_GetSearchJob.md) 
+  [GetSearchResultExportJob](API_BKS_GetSearchResultExportJob.md) 
+  [ListSearchJobBackups](API_BKS_ListSearchJobBackups.md) 
+  [ListSearchJobResults](API_BKS_ListSearchJobResults.md) 
+  [ListSearchJobs](API_BKS_ListSearchJobs.md) 
+  [ListSearchResultExportJobs](API_BKS_ListSearchResultExportJobs.md) 
+  [ListTagsForResource](API_BKS_ListTagsForResource.md) 
+  [StartSearchJob](API_BKS_StartSearchJob.md) 
+  [StartSearchResultExportJob](API_BKS_StartSearchResultExportJob.md) 
+  [StopSearchJob](API_BKS_StopSearchJob.md) 
+  [TagResource](API_BKS_TagResource.md) 
+  [UntagResource](API_BKS_UntagResource.md) 

# AWS Backup
<a name="API_Operations_AWS_Backup"></a>

Las siguientes acciones cuentan con el apoyo de AWS Backup:
+  [AssociateBackupVaultMpaApprovalTeam](API_AssociateBackupVaultMpaApprovalTeam.md) 
+  [CancelLegalHold](API_CancelLegalHold.md) 
+  [CreateBackupPlan](API_CreateBackupPlan.md) 
+  [CreateBackupSelection](API_CreateBackupSelection.md) 
+  [CreateBackupVault](API_CreateBackupVault.md) 
+  [CreateFramework](API_CreateFramework.md) 
+  [CreateLegalHold](API_CreateLegalHold.md) 
+  [CreateLogicallyAirGappedBackupVault](API_CreateLogicallyAirGappedBackupVault.md) 
+  [CreateReportPlan](API_CreateReportPlan.md) 
+  [CreateRestoreAccessBackupVault](API_CreateRestoreAccessBackupVault.md) 
+  [CreateRestoreTestingPlan](API_CreateRestoreTestingPlan.md) 
+  [CreateRestoreTestingSelection](API_CreateRestoreTestingSelection.md) 
+  [CreateTieringConfiguration](API_CreateTieringConfiguration.md) 
+  [DeleteBackupPlan](API_DeleteBackupPlan.md) 
+  [DeleteBackupSelection](API_DeleteBackupSelection.md) 
+  [DeleteBackupVault](API_DeleteBackupVault.md) 
+  [DeleteBackupVaultAccessPolicy](API_DeleteBackupVaultAccessPolicy.md) 
+  [DeleteBackupVaultLockConfiguration](API_DeleteBackupVaultLockConfiguration.md) 
+  [DeleteBackupVaultNotifications](API_DeleteBackupVaultNotifications.md) 
+  [DeleteFramework](API_DeleteFramework.md) 
+  [DeleteRecoveryPoint](API_DeleteRecoveryPoint.md) 
+  [DeleteReportPlan](API_DeleteReportPlan.md) 
+  [DeleteRestoreTestingPlan](API_DeleteRestoreTestingPlan.md) 
+  [DeleteRestoreTestingSelection](API_DeleteRestoreTestingSelection.md) 
+  [DeleteTieringConfiguration](API_DeleteTieringConfiguration.md) 
+  [DescribeBackupJob](API_DescribeBackupJob.md) 
+  [DescribeBackupVault](API_DescribeBackupVault.md) 
+  [DescribeCopyJob](API_DescribeCopyJob.md) 
+  [DescribeFramework](API_DescribeFramework.md) 
+  [DescribeGlobalSettings](API_DescribeGlobalSettings.md) 
+  [DescribeProtectedResource](API_DescribeProtectedResource.md) 
+  [DescribeRecoveryPoint](API_DescribeRecoveryPoint.md) 
+  [DescribeRegionSettings](API_DescribeRegionSettings.md) 
+  [DescribeReportJob](API_DescribeReportJob.md) 
+  [DescribeReportPlan](API_DescribeReportPlan.md) 
+  [DescribeRestoreJob](API_DescribeRestoreJob.md) 
+  [DescribeScanJob](API_DescribeScanJob.md) 
+  [DisassociateBackupVaultMpaApprovalTeam](API_DisassociateBackupVaultMpaApprovalTeam.md) 
+  [DisassociateRecoveryPoint](API_DisassociateRecoveryPoint.md) 
+  [DisassociateRecoveryPointFromParent](API_DisassociateRecoveryPointFromParent.md) 
+  [ExportBackupPlanTemplate](API_ExportBackupPlanTemplate.md) 
+  [GetBackupPlan](API_GetBackupPlan.md) 
+  [GetBackupPlanFromJSON](API_GetBackupPlanFromJSON.md) 
+  [GetBackupPlanFromTemplate](API_GetBackupPlanFromTemplate.md) 
+  [GetBackupSelection](API_GetBackupSelection.md) 
+  [GetBackupVaultAccessPolicy](API_GetBackupVaultAccessPolicy.md) 
+  [GetBackupVaultNotifications](API_GetBackupVaultNotifications.md) 
+  [GetLegalHold](API_GetLegalHold.md) 
+  [GetRecoveryPointIndexDetails](API_GetRecoveryPointIndexDetails.md) 
+  [GetRecoveryPointRestoreMetadata](API_GetRecoveryPointRestoreMetadata.md) 
+  [GetRestoreJobMetadata](API_GetRestoreJobMetadata.md) 
+  [GetRestoreTestingInferredMetadata](API_GetRestoreTestingInferredMetadata.md) 
+  [GetRestoreTestingPlan](API_GetRestoreTestingPlan.md) 
+  [GetRestoreTestingSelection](API_GetRestoreTestingSelection.md) 
+  [GetSupportedResourceTypes](API_GetSupportedResourceTypes.md) 
+  [GetTieringConfiguration](API_GetTieringConfiguration.md) 
+  [ListBackupJobs](API_ListBackupJobs.md) 
+  [ListBackupJobSummaries](API_ListBackupJobSummaries.md) 
+  [ListBackupPlans](API_ListBackupPlans.md) 
+  [ListBackupPlanTemplates](API_ListBackupPlanTemplates.md) 
+  [ListBackupPlanVersions](API_ListBackupPlanVersions.md) 
+  [ListBackupSelections](API_ListBackupSelections.md) 
+  [ListBackupVaults](API_ListBackupVaults.md) 
+  [ListCopyJobs](API_ListCopyJobs.md) 
+  [ListCopyJobSummaries](API_ListCopyJobSummaries.md) 
+  [ListFrameworks](API_ListFrameworks.md) 
+  [ListIndexedRecoveryPoints](API_ListIndexedRecoveryPoints.md) 
+  [ListLegalHolds](API_ListLegalHolds.md) 
+  [ListProtectedResources](API_ListProtectedResources.md) 
+  [ListProtectedResourcesByBackupVault](API_ListProtectedResourcesByBackupVault.md) 
+  [ListRecoveryPointsByBackupVault](API_ListRecoveryPointsByBackupVault.md) 
+  [ListRecoveryPointsByLegalHold](API_ListRecoveryPointsByLegalHold.md) 
+  [ListRecoveryPointsByResource](API_ListRecoveryPointsByResource.md) 
+  [ListReportJobs](API_ListReportJobs.md) 
+  [ListReportPlans](API_ListReportPlans.md) 
+  [ListRestoreAccessBackupVaults](API_ListRestoreAccessBackupVaults.md) 
+  [ListRestoreJobs](API_ListRestoreJobs.md) 
+  [ListRestoreJobsByProtectedResource](API_ListRestoreJobsByProtectedResource.md) 
+  [ListRestoreJobSummaries](API_ListRestoreJobSummaries.md) 
+  [ListRestoreTestingPlans](API_ListRestoreTestingPlans.md) 
+  [ListRestoreTestingSelections](API_ListRestoreTestingSelections.md) 
+  [ListScanJobs](API_ListScanJobs.md) 
+  [ListScanJobSummaries](API_ListScanJobSummaries.md) 
+  [ListTags](API_ListTags.md) 
+  [ListTieringConfigurations](API_ListTieringConfigurations.md) 
+  [PutBackupVaultAccessPolicy](API_PutBackupVaultAccessPolicy.md) 
+  [PutBackupVaultLockConfiguration](API_PutBackupVaultLockConfiguration.md) 
+  [PutBackupVaultNotifications](API_PutBackupVaultNotifications.md) 
+  [PutRestoreValidationResult](API_PutRestoreValidationResult.md) 
+  [RevokeRestoreAccessBackupVault](API_RevokeRestoreAccessBackupVault.md) 
+  [StartBackupJob](API_StartBackupJob.md) 
+  [StartCopyJob](API_StartCopyJob.md) 
+  [StartReportJob](API_StartReportJob.md) 
+  [StartRestoreJob](API_StartRestoreJob.md) 
+  [StartScanJob](API_StartScanJob.md) 
+  [StopBackupJob](API_StopBackupJob.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateBackupPlan](API_UpdateBackupPlan.md) 
+  [UpdateFramework](API_UpdateFramework.md) 
+  [UpdateGlobalSettings](API_UpdateGlobalSettings.md) 
+  [UpdateRecoveryPointIndexSettings](API_UpdateRecoveryPointIndexSettings.md) 
+  [UpdateRecoveryPointLifecycle](API_UpdateRecoveryPointLifecycle.md) 
+  [UpdateRegionSettings](API_UpdateRegionSettings.md) 
+  [UpdateReportPlan](API_UpdateReportPlan.md) 
+  [UpdateRestoreTestingPlan](API_UpdateRestoreTestingPlan.md) 
+  [UpdateRestoreTestingSelection](API_UpdateRestoreTestingSelection.md) 
+  [UpdateTieringConfiguration](API_UpdateTieringConfiguration.md) 

# AssociateBackupVaultMpaApprovalTeam
<a name="API_AssociateBackupVaultMpaApprovalTeam"></a>

Asocia un equipo de aprobación MPA a un almacén de copias de seguridad.

## Sintaxis de la solicitud
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/mpaApprovalTeam HTTP/1.1
Content-type: application/json

{
   "MpaApprovalTeamArn": "string",
   "RequesterComment": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-uri-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad que se va a asociar al equipo de aprobación MPA.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [MpaApprovalTeamArn](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-MpaApprovalTeamArn"></a>
Es el Nombre de recurso de Amazon (ARN) que se va a asociar al equipo de aprobación MPA.  
Tipo: cadena  
Obligatorio: sí

 ** [RequesterComment](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-RequesterComment"></a>
Es un comentario proporcionado por el solicitante en el que se explica la solicitud de asociación.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_AssociateBackupVaultMpaApprovalTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_AssociateBackupVaultMpaApprovalTeam_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_AssociateBackupVaultMpaApprovalTeam_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_AssociateBackupVaultMpaApprovalTeam_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam) 

# CancelLegalHold
<a name="API_CancelLegalHold"></a>

Elimina la retención legal especificada en un punto de recuperación. Solo puede realizar esta acción un usuario con permisos suficientes.

## Sintaxis de la solicitud
<a name="API_CancelLegalHold_RequestSyntax"></a>

```
DELETE /legal-holds/legalHoldId?cancelDescription=CancelDescription&retainRecordInDays=RetainRecordInDays HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_CancelLegalHold_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [CancelDescription](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-CancelDescription"></a>
Una cadena que describe el motivo de la eliminación de la retención legal.  
Obligatorio: sí

 ** [legalHoldId](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-LegalHoldId"></a>
El identificador de la retención legal.  
Obligatorio: sí

 ** [RetainRecordInDays](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-RetainRecordInDays"></a>
La cantidad entera, en días, transcurridos desde los que se elimina la retención legal.

## Cuerpo de la solicitud
<a name="API_CancelLegalHold_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_CancelLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 201
```

## Elementos de respuesta
<a name="API_CancelLegalHold_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201 con un cuerpo HTTP vacío.

## Errores
<a name="API_CancelLegalHold_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidResourceStateException **   
 AWS Backup ya está realizando una acción en este punto de recuperación. No es posible realizar la acción que ha solicitado hasta que finalice la primera acción. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CancelLegalHold_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CancelLegalHold) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CancelLegalHold) 

# CreateBackupPlan
<a name="API_CreateBackupPlan"></a>

Crea un plan de copia de seguridad con el nombre del plan y las reglas de copia de seguridad. Un plan de respaldo es un documento que contiene información que se AWS Backup utiliza para programar tareas que crean puntos de recuperación para los recursos.

Si llama a `CreateBackupPlan` con un plan que ya existe, recibirá una excepción `AlreadyExistsException`.

## Sintaxis de la solicitud
<a name="API_CreateBackupPlan_RequestSyntax"></a>

```
PUT /backup/plans/ HTTP/1.1
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   },
   "BackupPlanTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateBackupPlan_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateBackupPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-BackupPlan"></a>
El cuerpo de un plan de copia de seguridad. Incluye un `BackupPlanName` y uno o más conjuntos de `Rules`.  
Tipo: objeto [BackupPlanInput](API_BackupPlanInput.md)  
Obligatorio: sí

 ** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-BackupPlanTags"></a>
Las etiquetas que se van a asignar al plan de copia de seguridad.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-CreatorRequestId"></a>
Identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Si la solicitud incluye un `CreatorRequestId` que coincide con un plan de copia de seguridad existente, se devuelve ese plan. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_CreateBackupPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "VersionId": "string"
}
```

## Elementos de respuesta
<a name="API_CreateBackupPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AdvancedBackupSettings](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-AdvancedBackupSettings"></a>
La configuración para un tipo de recurso. Esta opción solo está disponible para los trabajos de copia de seguridad de Volume Shadow Copy Service (VSS) de Windows.  
Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md)

 ** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena

 ** [BackupPlanId](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-BackupPlanId"></a>
El ID del plan de copia de seguridad.  
Tipo: cadena

 ** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-CreationDate"></a>
La fecha y la hora en que se creó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [VersionId](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-VersionId"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. No es posible editarlos.  
Tipo: cadena

## Errores
<a name="API_CreateBackupPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateBackupPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupPlan) 

# CreateBackupSelection
<a name="API_CreateBackupSelection"></a>

Crea un documento JSON que especifica un conjunto de recursos que se asignarán a un plan de copia de seguridad. Para ver ejemplos, consulte [Asignación de recursos mediante programación](https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json). 

## Sintaxis de la solicitud
<a name="API_CreateBackupSelection_RequestSyntax"></a>

```
PUT /backup/plans/backupPlanId/selections/ HTTP/1.1
Content-type: application/json

{
   "BackupSelection": { 
      "Conditions": { 
         "StringEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ]
      },
      "IamRoleArn": "string",
      "ListOfTags": [ 
         { 
            "ConditionKey": "string",
            "ConditionType": "string",
            "ConditionValue": "string"
         }
      ],
      "NotResources": [ "string" ],
      "Resources": [ "string" ],
      "SelectionName": "string"
   },
   "CreatorRequestId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateBackupSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-uri-BackupPlanId"></a>
El ID del plan de copia de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateBackupSelection_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupSelection](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-BackupSelection"></a>
El cuerpo de una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Tipo: objeto [BackupSelection](API_BackupSelection.md)  
Obligatorio: sí

 ** [CreatorRequestId](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_CreateBackupSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanId": "string",
   "CreationDate": number,
   "SelectionId": "string"
}
```

## Elementos de respuesta
<a name="API_CreateBackupSelection_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanId](#API_CreateBackupSelection_ResponseSyntax) **   <a name="Backup-CreateBackupSelection-response-BackupPlanId"></a>
El ID del plan de copia de seguridad.  
Tipo: cadena

 ** [CreationDate](#API_CreateBackupSelection_ResponseSyntax) **   <a name="Backup-CreateBackupSelection-response-CreationDate"></a>
La fecha y la hora en que se creó la selección de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [SelectionId](#API_CreateBackupSelection_ResponseSyntax) **   <a name="Backup-CreateBackupSelection-response-SelectionId"></a>
Identifica de forma única el cuerpo de una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Tipo: cadena

## Errores
<a name="API_CreateBackupSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateBackupSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupSelection) 

# CreateBackupVault
<a name="API_CreateBackupVault"></a>

Crea un contenedor lógico donde se almacenan las copias de seguridad. Una solicitud `CreateBackupVault` incluye un nombre, opcionalmente una o varias etiquetas de recursos, una clave de cifrado y un ID de solicitud.

**nota**  
No incluya datos confidenciales, como los números de pasaporte, en el nombre de un almacén de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_CreateBackupVault_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json

{
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateBackupVault_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupVaultTags](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-BackupVaultTags"></a>
Las etiquetas que se van a asignar al almacén de copias de seguridad.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [CreatorRequestId](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** [EncryptionKeyArn](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-EncryptionKeyArn"></a>
La clave de cifrado en el servidor que se utiliza para proteger sus copias de seguridad; por ejemplo, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_CreateBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number
}
```

## Elementos de respuesta
<a name="API_CreateBackupVault_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_CreateBackupVault_ResponseSyntax) **   <a name="Backup-CreateBackupVault-response-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [BackupVaultName](#API_CreateBackupVault_ResponseSyntax) **   <a name="Backup-CreateBackupVault-response-BackupVaultName"></a>
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 donde se crearon. Constan de letras minúsculas, números y guiones.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [CreationDate](#API_CreateBackupVault_ResponseSyntax) **   <a name="Backup-CreateBackupVault-response-CreationDate"></a>
La fecha y la hora en que se creó el almacén, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

## Errores
<a name="API_CreateBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupVault) 

# CreateFramework
<a name="API_CreateFramework"></a>

Crea un marco con uno o más controles. Un marco es un conjunto de controles que puede usar para evaluar sus prácticas de copia de seguridad. Mediante el uso de controles personalizables prediseñados para definir sus políticas, puede evaluar si sus prácticas de copia de seguridad cumplen con sus políticas y qué recursos aún no.

## Sintaxis de la solicitud
<a name="API_CreateFramework_RequestSyntax"></a>

```
POST /audit/frameworks HTTP/1.1
Content-type: application/json

{
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "FrameworkName": "string",
   "FrameworkTags": { 
      "string" : "string" 
   },
   "IdempotencyToken": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateFramework_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateFramework_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [FrameworkControls](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkControls"></a>
Los controles que componen el marco. Cada control de la lista tiene un nombre, parámetros de entrada y alcance.  
Tipo: matriz de objetos [FrameworkControl](API_FrameworkControl.md)  
Obligatorio: sí

 ** [FrameworkDescription](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkDescription"></a>
Una descripción opcional del marco con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** [FrameworkName](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkName"></a>
El nombre único del marco. El nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

 ** [FrameworkTags](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkTags"></a>
Las etiquetas que se van a asignar al marco.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [IdempotencyToken](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `CreateFrameworkInput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_CreateFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FrameworkArn": "string",
   "FrameworkName": "string"
}
```

## Elementos de respuesta
<a name="API_CreateFramework_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [FrameworkArn](#API_CreateFramework_ResponseSyntax) **   <a name="Backup-CreateFramework-response-FrameworkArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [FrameworkName](#API_CreateFramework_ResponseSyntax) **   <a name="Backup-CreateFramework-response-FrameworkName"></a>
El nombre único del marco. El nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

## Errores
<a name="API_CreateFramework_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateFramework_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateFramework) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateFramework) 

# CreateLegalHold
<a name="API_CreateLegalHold"></a>

Crea una retención legal en un punto de recuperación (copia de seguridad). Una retención legal es una restricción a la modificación o eliminación de una copia de seguridad hasta que un usuario autorizado cancele la retención legal. Toda acción que se lleve a cabo para eliminar o disociar un punto de recuperación dará lugar a un error si hay una o más retenciones legales activas en el punto de recuperación.

## Sintaxis de la solicitud
<a name="API_CreateLegalHold_RequestSyntax"></a>

```
POST /legal-holds/ HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "IdempotencyToken": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Tags": { 
      "string" : "string" 
   },
   "Title": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateLegalHold_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateLegalHold_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Description](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Description"></a>
La descripción de la cadena de la retención legal.  
Tipo: cadena  
Obligatorio: sí

 ** [IdempotencyToken](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-IdempotencyToken"></a>
Se trata de una cadena elegida por el usuario que se utiliza para distinguir entre llamadas que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [RecoveryPointSelection](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-RecoveryPointSelection"></a>
Los criterios para asignar un conjunto de recursos, como los tipos de recursos o los almacenes de copias de seguridad.  
Tipo: objeto [RecoveryPointSelection](API_RecoveryPointSelection.md)  
Obligatorio: no

 ** [Tags](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Tags"></a>
Etiquetas opcionales que se incluirán. Una etiqueta es un par clave-valor que puede utilizar para administrar, filtrar y buscar sus recursos. Los caracteres permitidos incluyen espacios, números y letras en UTF-8, además de los siguientes caracteres especiales: \$1 - = . \$1 : /.   
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [Title](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Title"></a>
El título de la retención legal.  
Tipo: cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationDate": number,
   "Description": "string",
   "LegalHoldArn": "string",
   "LegalHoldId": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Status": "string",
   "Title": "string"
}
```

## Elementos de respuesta
<a name="API_CreateLegalHold_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationDate](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-CreationDate"></a>
La hora en la que se creó la retención legal.  
Tipo: marca temporal

 ** [Description](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Description"></a>
La descripción de la cadena de la retención legal.  
Tipo: cadena

 ** [LegalHoldArn](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-LegalHoldArn"></a>
El nombre de recurso de Amazon (ARN) de la retención legal.  
Tipo: cadena

 ** [LegalHoldId](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-LegalHoldId"></a>
El identificador de la retención legal.  
Tipo: cadena

 ** [RecoveryPointSelection](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-RecoveryPointSelection"></a>
Los criterios para asignar a un conjunto de recursos, como los tipos de recursos o los almacenes de copias de seguridad.  
Tipo: objeto [RecoveryPointSelection](API_RecoveryPointSelection.md)

 ** [Status](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Status"></a>
El estado de la retención legal.  
Tipo: cadena  
Valores válidos: `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Title"></a>
El título de la retención legal.  
Tipo: cadena

## Errores
<a name="API_CreateLegalHold_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateLegalHold_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateLegalHold) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateLegalHold) 

# CreateLogicallyAirGappedBackupVault
<a name="API_CreateLogicallyAirGappedBackupVault"></a>

Crea un contenedor lógico en el que se pueden copiar las copias de seguridad.

Esta solicitud incluye un nombre, la región, el número máximo de días de retención y el número mínimo de días de retención y, opcionalmente, puede incluir etiquetas y un identificador de solicitud del creador.

**nota**  
No incluya datos confidenciales, como los números de pasaporte, en el nombre de un almacén de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_CreateLogicallyAirGappedBackupVault_RequestSyntax"></a>

```
PUT /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json

{
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string",
   "MaxRetentionDays": number,
   "MinRetentionDays": number
}
```

## Parámetros de solicitud del URI
<a name="API_CreateLogicallyAirGappedBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad independientes lógicamente se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región en la que se crearon.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateLogicallyAirGappedBackupVault_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupVaultTags](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-BackupVaultTags"></a>
Las etiquetas que se van a asignar al almacén.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [CreatorRequestId](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-CreatorRequestId"></a>
El identificador de la solicitud de creación.  
Este parámetro es opcional. Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** [EncryptionKeyArn](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-EncryptionKeyArn"></a>
El ARN de la clave KMS administrada por el cliente que se utilizará para cifrar el almacén de copias de seguridad aislado de forma lógica. Si no se especifica, el almacén se cifrará con una clave AWS propia gestionada por AWS Backup.  
Tipo: cadena  
Requerido: no

 ** [MaxRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-MaxRetentionDays"></a>
El periodo máximo de retención durante el cual el almacén retiene sus puntos de recuperación.  
Tipo: largo  
Obligatorio: sí

 ** [MinRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-MinRetentionDays"></a>
Esta configuración especifica el periodo mínimo de retención durante el cual el almacén retiene sus puntos de recuperación.  
El valor mínimo aceptado es de 7 días.  
Tipo: largo  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateLogicallyAirGappedBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number,
   "VaultState": "string"
}
```

## Elementos de respuesta
<a name="API_CreateLogicallyAirGappedBackupVault_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-BackupVaultArn"></a>
El nombre de recurso de Amazon (ARN) del almacén.  
Tipo: cadena

 ** [BackupVaultName](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad independientes lógicamente se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región en la que se crearon.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [CreationDate](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-CreationDate"></a>
Fecha y hora en que se creó el almacén.  
Este valor está en formato Unix, horario universal coordinado (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [VaultState](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-VaultState"></a>
El estado actual del almacén.  
Tipo: cadena  
Valores válidos: `CREATING | AVAILABLE | FAILED` 

## Errores
<a name="API_CreateLogicallyAirGappedBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateLogicallyAirGappedBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault) 

# CreateReportPlan
<a name="API_CreateReportPlan"></a>

Crea un plan de informe. Un plan de informes es un documento que contiene información sobre el contenido del informe y dónde AWS Backup se entregará.

Si llama a `CreateReportPlan` con un plan que ya existe, recibirá una excepción `AlreadyExistsException`.

## Sintaxis de la solicitud
<a name="API_CreateReportPlan_RequestSyntax"></a>

```
POST /audit/report-plans HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string",
   "ReportDeliveryChannel": { 
      "Formats": [ "string" ],
      "S3BucketName": "string",
      "S3KeyPrefix": "string"
   },
   "ReportPlanDescription": "string",
   "ReportPlanName": "string",
   "ReportPlanTags": { 
      "string" : "string" 
   },
   "ReportSetting": { 
      "Accounts": [ "string" ],
      "FrameworkArns": [ "string" ],
      "NumberOfFrameworks": number,
      "OrganizationUnits": [ "string" ],
      "Regions": [ "string" ],
      "ReportTemplate": "string"
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateReportPlan_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateReportPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `CreateReportPlanInput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [ReportDeliveryChannel](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportDeliveryChannel"></a>
Una estructura que contiene información sobre dónde y cómo entregar sus informes, específicamente el nombre del bucket de Amazon S3, el prefijo de clave de S3 y los formatos de sus informes.  
Tipo: objeto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)  
Obligatorio: sí

 ** [ReportPlanDescription](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanDescription"></a>
Una descripción opcional del plan de informes con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** [ReportPlanName](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanName"></a>
El nombre único del plan de informes. El nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

 ** [ReportPlanTags](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanTags"></a>
Las etiquetas que se van a asignar al plan de informe.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportSetting"></a>
Identifica la plantilla para el informe. Los informes se crean mediante una plantilla. Las plantillas de informes son:  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT `   
Si la plantilla del informe es `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, este recurso de API también describe la cobertura del informe por marcos Regiones de AWS y marcos.  
Tipo: objeto [ReportSetting](API_ReportSetting.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "string"
}
```

## Elementos de respuesta
<a name="API_CreateReportPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-CreationTime"></a>
La fecha y la hora en que se creó la lista de dominios, en formato Unix y horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ReportPlanArn](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [ReportPlanName](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanName"></a>
El nombre único del plan de informes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

## Errores
<a name="API_CreateReportPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateReportPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateReportPlan) 

# CreateRestoreAccessBackupVault
<a name="API_CreateRestoreAccessBackupVault"></a>

Crea un almacén de copias de seguridad con acceso a la restauración que proporciona acceso temporal a los puntos de recuperación de un almacén de copias de seguridad aislado lógicamente y sujeto a la aprobación MPA.

## Sintaxis de la solicitud
<a name="API_CreateRestoreAccessBackupVault_RequestSyntax"></a>

```
PUT /restore-access-backup-vaults HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "RequesterComment": "string",
   "SourceBackupVaultArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateRestoreAccessBackupVault_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateRestoreAccessBackupVault_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupVaultName](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad que se va a asociar al equipo de aprobación MPA.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: no

 ** [BackupVaultTags](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-BackupVaultTags"></a>
Etiquetas opcionales que se van a asignar al almacén de copias de seguridad con acceso a la restauración.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [CreatorRequestId](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-CreatorRequestId"></a>
Es una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han generado un error sin el riesgo de ejecutar la operación dos veces.  
Tipo: cadena  
Requerido: no

 ** [RequesterComment](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-RequesterComment"></a>
Es un comentario que explica el motivo para solicitar acceso a la restauración del almacén de copias de seguridad.  
Tipo: cadena  
Requerido: no

 ** [SourceBackupVaultArn](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-SourceBackupVaultArn"></a>
Es el ARN del almacén de copias de seguridad de origen que contiene los puntos de recuperación a los que se solicita acceso temporal.  
Tipo: cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateRestoreAccessBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationDate": number,
   "RestoreAccessBackupVaultArn": "string",
   "RestoreAccessBackupVaultName": "string",
   "VaultState": "string"
}
```

## Elementos de respuesta
<a name="API_CreateRestoreAccessBackupVault_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationDate](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-CreationDate"></a>
Es la fecha y la hora en que se creó el almacén de copias de seguridad con acceso a la restauración, expresadas en formato Unix y en horario universal coordinado (UTC).   
Tipo: marca temporal

 ** [RestoreAccessBackupVaultArn](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-RestoreAccessBackupVaultArn"></a>
Es el ARN que identifica de forma unívoca el almacén de copias de seguridad con acceso a la restauración creado.  
Tipo: cadena

 ** [RestoreAccessBackupVaultName](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-RestoreAccessBackupVaultName"></a>
Es el nombre del almacén de copias de seguridad con acceso a la restauración creado.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [VaultState](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-VaultState"></a>
Es el estado actual del almacén de copias de seguridad con acceso a la restauración.  
Tipo: cadena  
Valores válidos: `CREATING | AVAILABLE | FAILED` 

## Errores
<a name="API_CreateRestoreAccessBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateRestoreAccessBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreAccessBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreAccessBackupVault) 

# CreateRestoreTestingPlan
<a name="API_CreateRestoreTestingPlan"></a>

Crea un plan de prueba de restauración.

El primero de los dos pasos para crear un plan de prueba de restauración. Una vez que esta solicitud sea exitosa, finalice el procedimiento utilizando CreateRestoreTestingSelection.

## Sintaxis de la solicitud
<a name="API_CreateRestoreTestingPlan_RequestSyntax"></a>

```
PUT /restore-testing/plans HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "RestoreTestingPlan": { 
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "RestoreTestingPlanName": "string",
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   },
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateRestoreTestingPlan_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateRestoreTestingPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [CreatorRequestId](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-CreatorRequestId"></a>
Es una cadena única que identifica la solicitud y permite que se reintenten las solicitudes con un error sin riesgo de ejecutar la operación dos veces. Este parámetro es opcional. Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** [RestoreTestingPlan](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-RestoreTestingPlan"></a>
Un plan de prueba de restauración debe contener una cadena `RestoreTestingPlanName` única que usted crea y debe contener un cron de `ScheduleExpression`. Puede incluir opcionalmente un entero de `StartWindowHours` y una cadena de `CreatorRequestId`.  
`RestoreTestingPlanName` es una cadena única que es el nombre del plan de prueba de restauración. No se puede cambiar después de la creación y debe constar únicamente de caracteres alfanuméricos y guiones bajos.  
Tipo: objeto [RestoreTestingPlanForCreate](API_RestoreTestingPlanForCreate.md)  
Obligatorio: sí

 ** [Tags](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-Tags"></a>
Las etiquetas que se van a asignar al plan de prueba de restauración.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string"
}
```

## Elementos de respuesta
<a name="API_CreateRestoreTestingPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-CreationTime"></a>
La fecha y la hora en que se creó el plan de informes, en formato Unix y Hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [RestoreTestingPlanArn](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva el plan de prueba de restauración creado.  
Tipo: cadena

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
Esta cadena única es el nombre del plan de prueba de restauración.  
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena

## Errores
<a name="API_CreateRestoreTestingPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateRestoreTestingPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreTestingPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreTestingPlan) 

# CreateRestoreTestingSelection
<a name="API_CreateRestoreTestingSelection"></a>

Esta solicitud se puede enviar después de que la CreateRestoreTestingPlan solicitud se devuelva correctamente. Es la segunda parte de la creación de un plan de prueba de recursos y debe completarse secuencialmente.

Consta de `RestoreTestingSelectionName`, `ProtectedResourceType` y uno de los siguientes elementos:
+  `ProtectedResourceArns` 
+  `ProtectedResourceConditions` 

Cada tipo de recurso protegido puede tener un único valor.

Una selección de pruebas de restauración puede incluir un valor comodín ("\$1") como `ProtectedResourceArns` junto con `ProtectedResourceConditions`. Como alternativa, puede incluir hasta 30 recursos ARNs protegidos específicos`ProtectedResourceArns`.

No se puede seleccionar tanto por tipos de recursos protegidos como por específicos ARNs. La solicitud producirá error si se incluyen ambos.

## Sintaxis de la solicitud
<a name="API_CreateRestoreTestingSelection_RequestSyntax"></a>

```
PUT /restore-testing/plans/RestoreTestingPlanName/selections HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "RestoreTestingSelection": { 
      "IamRoleArn": "string",
      "ProtectedResourceArns": [ "string" ],
      "ProtectedResourceConditions": { 
         "StringEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      },
      "ProtectedResourceType": "string",
      "RestoreMetadataOverrides": { 
         "string" : "string" 
      },
      "RestoreTestingSelectionName": "string",
      "ValidationWindowHours": number
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateRestoreTestingSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
Introduzca el nombre del plan de pruebas de restauración devuelto por la CreateRestoreTestingPlan solicitud relacionada.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_CreateRestoreTestingSelection_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [CreatorRequestId](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-CreatorRequestId"></a>
Es una cadena única opcional que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** [RestoreTestingSelection](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-RestoreTestingSelection"></a>
Consta de `RestoreTestingSelectionName`, `ProtectedResourceType` y uno de los siguientes elementos:  
+  `ProtectedResourceArns` 
+  `ProtectedResourceConditions` 
Cada tipo de recurso protegido puede tener un único valor.  
Una selección de pruebas de restauración puede incluir un valor comodín ("\$1") como `ProtectedResourceArns` junto con `ProtectedResourceConditions`. Como alternativa, puede incluir hasta 30 recursos ARNs protegidos específicos`ProtectedResourceArns`.  
Tipo: objeto [RestoreTestingSelectionForCreate](API_RestoreTestingSelectionForCreate.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string",
   "RestoreTestingSelectionName": "string"
}
```

## Elementos de respuesta
<a name="API_CreateRestoreTestingSelection_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-CreationTime"></a>
La hora en la que la selección de pruebas de recursos se creó.  
Tipo: marca temporal

 ** [RestoreTestingPlanArn](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingPlanArn"></a>
El ARN del plan de prueba de restauración al que está asociada la selección de pruebas de restauración.  
Tipo: cadena

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingPlanName"></a>
El nombre del plan de prueba de restauración.  
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena

 ** [RestoreTestingSelectionName](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingSelectionName"></a>
El nombre de la selección de pruebas de restauración para el plan de prueba de restauración.  
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena

## Errores
<a name="API_CreateRestoreTestingSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateRestoreTestingSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreTestingSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreTestingSelection) 

# CreateTieringConfiguration
<a name="API_CreateTieringConfiguration"></a>

Crea una configuración de estratificación.

Una configuración por niveles permite el movimiento automático de los datos de respaldo a un nivel de almacenamiento de menor costo en función de la antigüedad de los objetos respaldados en la bóveda de respaldo.

Cada almacén solo puede tener una configuración de estratificación específica para cada almacén, además de cualquier configuración global que se aplique a todos los almacenes.

## Sintaxis de la solicitud
<a name="API_CreateTieringConfiguration_RequestSyntax"></a>

```
PUT /tiering-configurations HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationName": "string"
   },
   "TieringConfigurationTags": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateTieringConfiguration_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateTieringConfiguration_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-CreatorRequestId"></a>
Se trata de una cadena única que identifica la solicitud y permite volver a intentar las solicitudes fallidas sin correr el riesgo de ejecutar la operación dos veces. Este parámetro es opcional. Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
Una configuración por niveles debe contener una `TieringConfigurationName` cadena única que usted cree y debe contener una `BackupVaultName` y. `ResourceSelection` Si lo desea, puede incluir una `CreatorRequestId` cadena.  
`TieringConfigurationName`Es una cadena única que es el nombre de la configuración de estratificación. No se puede cambiar después de la creación y debe constar únicamente de caracteres alfanuméricos y guiones bajos.  
Tipo: objeto [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md)  
Obligatorio: sí

 ** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
Las etiquetas que se van a asignar a la configuración de organización por niveles.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "string"
}
```

## Elementos de respuesta
<a name="API_CreateTieringConfiguration_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-CreationTime"></a>
La fecha y la hora en que se creó una configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva la configuración de estratificación creada.  
Tipo: cadena

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
Esta cadena única es el nombre de la configuración de estratificación.  
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 200.  
Tipo: cadena

## Errores
<a name="API_CreateTieringConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateTieringConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateTieringConfiguration) 

# DeleteBackupPlan
<a name="API_DeleteBackupPlan"></a>

Elimina un plan de copia de seguridad. Solo puede eliminar un plan de copia de seguridad después de haber eliminado todas las selecciones de recursos asociadas. La eliminación de un plan de copia de seguridad elimina la versión actual del plan. Las versiones anteriores, si las hay, seguirán existiendo.

## Sintaxis de la solicitud
<a name="API_DeleteBackupPlan_RequestSyntax"></a>

```
DELETE /backup/plans/backupPlanId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteBackupPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_DeleteBackupPlan_RequestSyntax) **   <a name="Backup-DeleteBackupPlan-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBackupPlan_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBackupPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "DeletionDate": number,
   "VersionId": "string"
}
```

## Elementos de respuesta
<a name="API_DeleteBackupPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanArn](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena

 ** [BackupPlanId](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena

 ** [DeletionDate](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-DeletionDate"></a>
La fecha y la hora en que se eliminó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `DeletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [VersionId](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-VersionId"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. La versión IDs no se puede editar.  
Tipo: cadena

## Errores
<a name="API_DeleteBackupPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteBackupPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupPlan) 

# DeleteBackupSelection
<a name="API_DeleteBackupSelection"></a>

Elimina la selección de recursos asociada a un plan de copia de seguridad especificado por `SelectionId`.

## Sintaxis de la solicitud
<a name="API_DeleteBackupSelection_RequestSyntax"></a>

```
DELETE /backup/plans/backupPlanId/selections/selectionId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteBackupSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_DeleteBackupSelection_RequestSyntax) **   <a name="Backup-DeleteBackupSelection-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

 ** [selectionId](#API_DeleteBackupSelection_RequestSyntax) **   <a name="Backup-DeleteBackupSelection-request-uri-SelectionId"></a>
Identifica de forma única el cuerpo de una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBackupSelection_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBackupSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteBackupSelection_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteBackupSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteBackupSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupSelection) 

# DeleteBackupVault
<a name="API_DeleteBackupVault"></a>

Elimina el almacén de copias de seguridad identificado por su nombre. Un almacén solo se puede eliminar si está vacío.

## Sintaxis de la solicitud
<a name="API_DeleteBackupVault_RequestSyntax"></a>

```
DELETE /backup-vaults/backupVaultName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DeleteBackupVault_RequestSyntax) **   <a name="Backup-DeleteBackupVault-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBackupVault_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteBackupVault_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVault) 

# DeleteBackupVaultAccessPolicy
<a name="API_DeleteBackupVaultAccessPolicy"></a>

Elimina el documento de política que administra los permisos en un almacén de copias de seguridad.

## Sintaxis de la solicitud
<a name="API_DeleteBackupVaultAccessPolicy_RequestSyntax"></a>

```
DELETE /backup-vaults/backupVaultName/access-policy HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteBackupVaultAccessPolicy_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DeleteBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-DeleteBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBackupVaultAccessPolicy_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBackupVaultAccessPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteBackupVaultAccessPolicy_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteBackupVaultAccessPolicy_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteBackupVaultAccessPolicy_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVaultAccessPolicy) 

# DeleteBackupVaultLockConfiguration
<a name="API_DeleteBackupVaultLockConfiguration"></a>

Elimina AWS Backup Vault Lock de un almacén de respaldo especificado por un nombre de almacén de respaldo.

Si la configuración del bloqueo de almacenes es inmutable, no podrá eliminar el bloqueo de almacenes mediante operaciones de API y recibirá una `InvalidRequestException` si lo intenta. Para obtener más información, consulte [Vault Lock](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html) en la *Guía para AWS Backup desarrolladores*.

## Sintaxis de la solicitud
<a name="API_DeleteBackupVaultLockConfiguration_RequestSyntax"></a>

```
DELETE /backup-vaults/backupVaultName/vault-lock HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteBackupVaultLockConfiguration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DeleteBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-DeleteBackupVaultLockConfiguration-request-uri-BackupVaultName"></a>
El nombre del almacén de respaldo del que se va a eliminar AWS Backup Vault Lock.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBackupVaultLockConfiguration_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBackupVaultLockConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteBackupVaultLockConfiguration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteBackupVaultLockConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteBackupVaultLockConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVaultLockConfiguration) 

# DeleteBackupVaultNotifications
<a name="API_DeleteBackupVaultNotifications"></a>

Elimina las notificaciones de eventos para el almacén de copias de seguridad especificado.

## Sintaxis de la solicitud
<a name="API_DeleteBackupVaultNotifications_RequestSyntax"></a>

```
DELETE /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteBackupVaultNotifications_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DeleteBackupVaultNotifications_RequestSyntax) **   <a name="Backup-DeleteBackupVaultNotifications-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de donde se crearon.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteBackupVaultNotifications_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteBackupVaultNotifications_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteBackupVaultNotifications_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteBackupVaultNotifications_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteBackupVaultNotifications_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVaultNotifications) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVaultNotifications) 

# DeleteFramework
<a name="API_DeleteFramework"></a>

Elimina el marco especificado por un nombre de marco.

## Sintaxis de la solicitud
<a name="API_DeleteFramework_RequestSyntax"></a>

```
DELETE /audit/frameworks/frameworkName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteFramework_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [frameworkName](#API_DeleteFramework_RequestSyntax) **   <a name="Backup-DeleteFramework-request-uri-FrameworkName"></a>
El nombre único de un marco.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteFramework_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteFramework_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteFramework_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteFramework_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteFramework) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteFramework) 

# DeleteRecoveryPoint
<a name="API_DeleteRecoveryPoint"></a>

Elimina el punto de recuperación especificado por un ID de punto de recuperación.

Si el ID del punto de recuperación pertenece a una copia de seguridad continua, al llamar a este punto de conexión se elimina la copia de seguridad continua existente y se detiene la copia de seguridad continua futura.

Cuando los permisos de un rol de IAM no son suficientes para llamar a esta API, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío, pero el punto de recuperación no se elimina. En su lugar, entra en un estado `EXPIRED`.

 Los puntos de recuperación `EXPIRED` se pueden eliminar con esta API una vez que el rol de IAM tenga la acción `iam:CreateServiceLinkedRole`. Para obtener más información acerca de cómo agregar este rol, consulte [Solución de problemas de eliminaciones manuales](https://docs.aws.amazon.com/aws-backup/latest/devguide/deleting-backups.html#deleting-backups-troubleshooting).

Si se elimina el usuario o el rol o se quita el permiso del rol, la eliminación no se realizará correctamente y pasará a un estado `EXPIRED`.

## Sintaxis de la solicitud
<a name="API_DeleteRecoveryPoint_RequestSyntax"></a>

```
DELETE /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteRecoveryPoint_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DeleteRecoveryPoint_RequestSyntax) **   <a name="Backup-DeleteRecoveryPoint-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_DeleteRecoveryPoint_RequestSyntax) **   <a name="Backup-DeleteRecoveryPoint-request-uri-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteRecoveryPoint_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteRecoveryPoint_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteRecoveryPoint_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteRecoveryPoint_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** InvalidResourceStateException **   
 AWS Backup ya está realizando una acción en este punto de recuperación. No es posible realizar la acción que ha solicitado hasta que finalice la primera acción. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteRecoveryPoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteRecoveryPoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteRecoveryPoint) 

# DeleteReportPlan
<a name="API_DeleteReportPlan"></a>

Elimina el plan de informes especificado por un nombre de plan de informes.

## Sintaxis de la solicitud
<a name="API_DeleteReportPlan_RequestSyntax"></a>

```
DELETE /audit/report-plans/reportPlanName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteReportPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [reportPlanName](#API_DeleteReportPlan_RequestSyntax) **   <a name="Backup-DeleteReportPlan-request-uri-ReportPlanName"></a>
El nombre único de un plan de informes.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteReportPlan_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteReportPlan_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteReportPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteReportPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteReportPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteReportPlan) 

# DeleteRestoreTestingPlan
<a name="API_DeleteRestoreTestingPlan"></a>

Esta solicitud elimina el plan de prueba de restauración especificado.

La eliminación solo se puede realizar correctamente si se eliminan primero todas las selecciones de pruebas de restauración asociadas.

## Sintaxis de la solicitud
<a name="API_DeleteRestoreTestingPlan_RequestSyntax"></a>

```
DELETE /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteRestoreTestingPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_DeleteRestoreTestingPlan_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
Nombre único obligatorio del plan de prueba de restauración que desea eliminar.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteRestoreTestingPlan_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteRestoreTestingPlan_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteRestoreTestingPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteRestoreTestingPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteRestoreTestingPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteRestoreTestingPlan) 

# DeleteRestoreTestingSelection
<a name="API_DeleteRestoreTestingSelection"></a>

Introduzca el nombre del plan de prueba de restauración y el nombre de la selección de pruebas de restauración.

Todas las selecciones de pruebas asociadas a un plan de prueba de restauración deben eliminarse para poder eliminar el plan de prueba de restauración.

## Sintaxis de la solicitud
<a name="API_DeleteRestoreTestingSelection_RequestSyntax"></a>

```
DELETE /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteRestoreTestingSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_DeleteRestoreTestingSelection_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
Nombre único obligatorio del plan de prueba de restauración que contiene la selección de pruebas de restauración que desea eliminar.  
Obligatorio: sí

 ** [RestoreTestingSelectionName](#API_DeleteRestoreTestingSelection_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
Nombre único obligatorio de la selección de pruebas de restauración que desea eliminar.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteRestoreTestingSelection_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteRestoreTestingSelection_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteRestoreTestingSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteRestoreTestingSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteRestoreTestingSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteRestoreTestingSelection) 

# DeleteTieringConfiguration
<a name="API_DeleteTieringConfiguration"></a>

Elimina la configuración de estratificación especificada por un nombre de configuración de estratificación.

## Sintaxis de la solicitud
<a name="API_DeleteTieringConfiguration_RequestSyntax"></a>

```
DELETE /tiering-configurations/tieringConfigurationName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteTieringConfiguration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [tieringConfigurationName](#API_DeleteTieringConfiguration_RequestSyntax) **   <a name="Backup-DeleteTieringConfiguration-request-uri-TieringConfigurationName"></a>
El nombre exclusivo de una configuración de organización por niveles.  
Patrón: `^[a-zA-Z0-9_]{1,200}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteTieringConfiguration_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteTieringConfiguration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteTieringConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DeleteTieringConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteTieringConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteTieringConfiguration) 

# DescribeBackupJob
<a name="API_DescribeBackupJob"></a>

Devuelve los detalles del trabajo de copia de seguridad para el `BackupJobId` especificado.

## Sintaxis de la solicitud
<a name="API_DescribeBackupJob_RequestSyntax"></a>

```
GET /backup-jobs/backupJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeBackupJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupJobId](#API_DescribeBackupJob_RequestSyntax) **   <a name="Backup-DescribeBackupJob-request-uri-BackupJobId"></a>
Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeBackupJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeBackupJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupJobId": "string",
   "BackupOptions": { 
      "string" : "string" 
   },
   "BackupSizeInBytes": number,
   "BackupType": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "BytesTransferred": number,
   "ChildJobsInState": { 
      "string" : number 
   },
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "ExpectedCompletionDate": number,
   "IamRoleArn": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "MessageCategory": "string",
   "NumberOfChildJobs": number,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointLifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "StartBy": number,
   "State": "string",
   "StatusMessage": "string",
   "VaultLockState": "string",
   "VaultType": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeBackupJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccountId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-AccountId"></a>
Devuelve el ID de la cuenta a la que pertenece el trabajo de copia de seguridad.  
Tipo: cadena  
Patrón: `^[0-9]{12}$` 

 ** [BackupJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupJobId"></a>
Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso.  
Tipo: cadena

 ** [BackupOptions](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupOptions"></a>
Representa las opciones especificadas como parte del plan de copia de seguridad o del trabajo de copia de seguridad bajo demanda.  
Tipo: mapa de cadena a cadena  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Patrón de valores: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [BackupSizeInBytes](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupSizeInBytes"></a>
Es el tamaño de una copia de seguridad (punto de recuperación) en bytes.  
Este valor puede representarse de forma diferente según el tipo de recurso, ya que AWS Backup extrae información de datos de otros AWS servicios. Por ejemplo, el valor devuelto puede mostrar un valor `0`, que puede ser distinto al valor previsto.  
A continuación se describe el comportamiento esperado de los valores por tipo de recurso:  
+ En Amazon Aurora, Amazon DocumentDB y Amazon Neptune, este valor no se rellena con la operación `GetBackupJobStatus`.
+ En el caso de Amazon DynamoDB con características avanzadas, este valor es el tamaño del punto de recuperación (copia de seguridad).
+ Amazon EC2 y Amazon EBS muestran el tamaño del volumen (almacenamiento aprovisionado) devuelto como parte de este valor. Amazon EBS no devuelve información sobre el tamaño de la copia de seguridad; el tamaño de la instantánea tendrá el mismo valor que el recurso original a partir del cual se realizó la copia de seguridad.
+ En Amazon EFS, este valor hace referencia a los bytes delta transferidos durante una copia de seguridad.
+ En el caso de Amazon EKS, este valor se refiere al tamaño del punto de recuperación de EKS anidado.
+ Amazon FSx no rellena este valor a partir de la operación `GetBackupJobStatus` para sistemas de FSx archivos.
+ Una instancia de Amazon RDS se mostrará como `0`.
+ En el caso de las máquinas virtuales en ejecución VMware, este valor se transfiere a AWS Backup través de un flujo de trabajo asíncrono, lo que puede provocar que el valor mostrado no represente el tamaño real de la copia de seguridad.
Tipo: largo

 ** [BackupType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupType"></a>
Representa el tipo de copia de seguridad real seleccionado para un trabajo de copia de seguridad. Por ejemplo, si se realizó una copia de seguridad correcta de Volume Shadow Copy Service (VSS) de Windows, `BackupType` devuelve `"WindowsVSS"`. Si `BackupType` está vacío, significa que el tipo de copia de seguridad era una copia de seguridad normal.  
Tipo: cadena

 ** [BackupVaultArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [BackupVaultName](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [BytesTransferred](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BytesTransferred"></a>
El tamaño en bytes transferido a un almacén de copias de seguridad en el momento en que se consultó el estado del trabajo.  
Tipo: largo

 ** [ChildJobsInState](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ChildJobsInState"></a>
Devuelve las estadísticas de los trabajos de copia de seguridad secundarios (anidados) incluidos.  
Tipo: mapa de cadena a largo  
Claves válidas: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [CompletionDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para crear un trabajo de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatedBy](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de copia de seguridad, que incluye los valores de `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` y `BackupRuleId` del plan de copia de seguridad utilizado para crearlo.  
Tipo: objeto [RecoveryPointCreator](API_RecoveryPointCreator.md)

 ** [CreationDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-CreationDate"></a>
La fecha y la hora en que se creó el trabajo de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [EncryptionKeyArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-EncryptionKeyArn"></a>
Es el nombre de recurso de Amazon (ARN) de la clave de KMS que se utiliza para cifrar la copia de seguridad. Puede ser una clave administrada por el cliente o una clave administrada, según la AWS configuración del almacén.  
Tipo: cadena

 ** [ExpectedCompletionDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ExpectedCompletionDate"></a>
La fecha y la hora en que se espera completar un trabajo de copia de seguridad de recursos, en formato Unix y horario universal coordinado (UTC). El valor de `ExpectedCompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IamRoleArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena

 ** [InitiationDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-InitiationDate"></a>
La fecha en que se inició un trabajo de copia de seguridad.  
Tipo: marca temporal

 ** [IsEncrypted](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IsEncrypted"></a>
Es un valor booleano que indica si la copia de seguridad está cifrada. Todas las copias de seguridad AWS Backup están cifradas, pero este campo indica el estado de cifrado para mayor transparencia.  
Tipo: Booleano

 ** [IsParent](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IsParent"></a>
Esto devuelve el valor booleano de que un trabajo de copia de seguridad es un trabajo principal (compuesto).  
Tipo: Booleano

 ** [MessageCategory](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-MessageCategory"></a>
El recuento de trabajos de la categoría de mensajes especificada.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` y `INVALIDPARAMETERS`. Consulta la [sección Supervisión](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) para ver una lista de MessageCategory las cadenas aceptadas.  
Tipo: cadena

 ** [NumberOfChildJobs](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-NumberOfChildJobs"></a>
Esto devuelve el número de trabajos de copia de seguridad secundarios (anidados).  
Tipo: largo

 ** [ParentJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ParentJobId"></a>
Esto devuelve el ID del trabajo de copia de seguridad del recurso principal (compuesto).  
Tipo: cadena

 ** [PercentDone](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-PercentDone"></a>
Contiene el porcentaje estimado que se ha completado de un trabajo en el momento en que se consultó el estado del trabajo.  
Tipo: cadena

 ** [RecoveryPointArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [RecoveryPointLifecycle](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointLifecycle"></a>
Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine.  
Las copias de seguridad que se transfieran a cámaras frigoríficas deben almacenarse en cámaras frigoríficas durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)

 ** [ResourceArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceArn"></a>
Un ARN que identifica de forma exclusiva un recurso guardado. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [ResourceName](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena

 ** [ResourceType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceType"></a>
El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [StartBy](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-StartBy"></a>
Especifica la hora en formato Unix y horario universal coordinado (UTC) en la que se debe iniciar un trabajo de copia de seguridad antes de que se cancele. El valor se calcula agregando el periodo de inicio a la hora programada. Por lo tanto, si la hora programada fueran las 18:00 h y el periodo de inicio fuera de 2 horas, la hora `StartBy` sería las 20:00 h en la fecha especificada. El valor de `StartBy` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [State](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-State"></a>
El estado actual de un trabajo de copia de seguridad.  
Tipo: cadena  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [StatusMessage](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-StatusMessage"></a>
Un mensaje detallado que explica el estado del trabajo de copia de seguridad de un recurso.  
Tipo: cadena

 ** [VaultLockState](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultLockState"></a>
Es el estado de bloqueo del almacén de copias de seguridad. En el caso de los almacenes aislados lógicamente, indica si el almacén está bloqueado en el modo de conformidad. Los valores válidos son `LOCKED` y `UNLOCKED`.  
Tipo: cadena

 ** [VaultType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultType"></a>
Es el tipo de almacén de copias de seguridad en el que se guarda el punto de recuperación. Los valores válidos son `BACKUP_VAULT` para los almacenes de copias de seguridad estándar y `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` para los almacenes aislados lógicamente.  
Tipo: cadena

## Errores
<a name="API_DescribeBackupJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** DependencyFailureException **   
Un AWS servicio o recurso dependiente devolvió un error al AWS Backup servicio y no se pudo completar la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeBackupJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupJob) 

# DescribeBackupVault
<a name="API_DescribeBackupVault"></a>

Devuelve los metadatos de un almacén de copias de seguridad especificado por su nombre.

## Sintaxis de la solicitud
<a name="API_DescribeBackupVault_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) **   <a name="Backup-DescribeBackupVault-request-uri-BackupVaultAccountId"></a>
El identificador de cuenta del almacén de copias de seguridad especificado.

 ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) **   <a name="Backup-DescribeBackupVault-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeBackupVault_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string",
   "EncryptionKeyType": "string",
   "LatestMpaApprovalTeamUpdate": { 
      "ExpiryDate": number,
      "InitiationDate": number,
      "MpaSessionArn": "string",
      "Status": "string",
      "StatusMessage": "string"
   },
   "LockDate": number,
   "Locked": boolean,
   "MaxRetentionDays": number,
   "MinRetentionDays": number,
   "MpaApprovalTeamArn": "string",
   "MpaSessionArn": "string",
   "NumberOfRecoveryPoints": number,
   "SourceBackupVaultArn": "string",
   "VaultState": "string",
   "VaultType": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeBackupVault_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [BackupVaultName](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región donde se crearon.  
Tipo: cadena

 ** [CreationDate](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-CreationDate"></a>
La fecha y la hora en que se creó el almacén, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional. Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena

 ** [EncryptionKeyArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-EncryptionKeyArn"></a>
La clave de cifrado en el servidor que se utiliza para proteger sus copias de seguridad; por ejemplo, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Tipo: cadena

 ** [EncryptionKeyType](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-EncryptionKeyType"></a>
El tipo de clave de cifrado utilizada para el almacén de copias de seguridad. Los valores válidos son CUSTOMER\$1MANAGED\$1KMS\$1KEY para las claves gestionadas por el cliente o \$1OWNED\$1KMS\$1KEY para las claves propias. AWS AWS  
Tipo: cadena  
Valores válidos: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` 

 ** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-LatestMpaApprovalTeamUpdate"></a>
Información sobre la última actualización de la asociación del equipo de aprobación MPA para este almacén de copias de seguridad.  
Tipo: objeto [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md)

 ** [LockDate](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-LockDate"></a>
La fecha y la hora en las que no se AWS Backup puede cambiar ni eliminar la configuración de Vault Lock.  
Si ha aplicado el bloqueo de almacenes a su almacén sin especificar una fecha de bloqueo, puede cambiar cualquier configuración del bloqueo de almacenes o eliminarlo del almacén por completo en cualquier momento.  
Este valor está en formato Unix, horario universal coordinado (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [Locked](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-Locked"></a>
Un valor booleano que indica si AWS Backup Vault Lock protege actualmente el almacén de respaldo. `True`significa que Vault Lock provoca un error en las operaciones de eliminación o actualización de los puntos de recuperación almacenados en el almacén.  
Tipo: Booleano

 ** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MaxRetentionDays"></a>
La configuración de bloqueo del AWS Backup almacén que especifica el período máximo de retención durante el que el almacén conserva sus puntos de recuperación. Si no se especifica este parámetro, el bloqueo de almacenes no impone un periodo de retención máximo en los puntos de recuperación del almacén (lo que permite un almacenamiento indefinido).  
Si se especifica, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o inferior al periodo de retención máximo. Si el periodo de retención del trabajo es superior a ese periodo de retención máximo, el almacén falla el trabajo de copia de seguridad o de copia de seguridad, y deberá modificar la configuración del ciclo de vida o utilizar un almacén diferente. Los puntos de recuperación ya almacenados en el almacén antes del bloqueo del mismo no se ven afectados.  
Tipo: largo

 ** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MinRetentionDays"></a>
La configuración de bloqueo del AWS Backup almacén que especifica el período mínimo de retención durante el que el almacén conserva sus puntos de recuperación. Si no se especifica este parámetro, el bloqueo del almacén no impondrá un periodo mínimo de retención.  
Si se especifica, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o superior al periodo de retención mínimo. Si el periodo de retención del trabajo es más breve que ese periodo de retención mínimo, el almacén dará error en el trabajo de copia de seguridad o copia, y deberá modificar la configuración del ciclo de vida o usar un almacén diferente. Los puntos de recuperación ya almacenados en el almacén antes del bloqueo del mismo no se ven afectados.  
Tipo: largo

 ** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MpaApprovalTeamArn"></a>
Es el ARN del equipo de aprobación MPA asociado con este almacén de copias de seguridad.  
Tipo: cadena

 ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MpaSessionArn"></a>
Es el ARN de la sesión de MPA asociado con este almacén de copias de seguridad.  
Tipo: cadena

 ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-NumberOfRecoveryPoints"></a>
El número de puntos de recuperación que se almacenan en un almacén de copias de seguridad.  
El valor del recuento de puntos de recuperación que se muestra en la consola puede ser una aproximación. Utilice la API [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html) para obtener el recuento exacto.  
Tipo: largo

 ** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-SourceBackupVaultArn"></a>
Es el ARN del almacén de copias de seguridad de origen a partir del cual se ha creado este almacén de copias de seguridad con acceso a la restauración.  
Tipo: cadena

 ** [VaultState](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-VaultState"></a>
El estado actual del almacén.->  
Tipo: cadena  
Valores válidos: `CREATING | AVAILABLE | FAILED` 

 ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-VaultType"></a>
El tipo de almacén descrito.  
Tipo: cadena  
Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

## Errores
<a name="API_DescribeBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupVault) 

# DescribeCopyJob
<a name="API_DescribeCopyJob"></a>

Devuelve los metadatos asociados a la creación de una copia de un recurso.

## Sintaxis de la solicitud
<a name="API_DescribeCopyJob_RequestSyntax"></a>

```
GET /copy-jobs/copyJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeCopyJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [copyJobId](#API_DescribeCopyJob_RequestSyntax) **   <a name="Backup-DescribeCopyJob-request-uri-CopyJobId"></a>
Identifica de forma exclusiva un trabajo de copia.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeCopyJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeCopyJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CopyJob": { 
      "AccountId": "string",
      "BackupSizeInBytes": number,
      "ChildJobsInState": { 
         "string" : number 
      },
      "CompletionDate": number,
      "CompositeMemberIdentifier": "string",
      "CopyJobId": "string",
      "CreatedBy": { 
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "BackupPlanVersion": "string",
         "BackupRuleCron": "string",
         "BackupRuleId": "string",
         "BackupRuleName": "string",
         "BackupRuleTimezone": "string"
      },
      "CreatedByBackupJobId": "string",
      "CreationDate": number,
      "DestinationBackupVaultArn": "string",
      "DestinationEncryptionKeyArn": "string",
      "DestinationRecoveryPointArn": "string",
      "DestinationRecoveryPointLifecycle": { 
         "DeleteAfterDays": number,
         "DeleteAfterEvent": "string",
         "MoveToColdStorageAfterDays": number,
         "OptInToArchiveForSupportedResources": boolean
      },
      "DestinationVaultLockState": "string",
      "DestinationVaultType": "string",
      "IamRoleArn": "string",
      "IsParent": boolean,
      "MessageCategory": "string",
      "NumberOfChildJobs": number,
      "ParentJobId": "string",
      "ResourceArn": "string",
      "ResourceName": "string",
      "ResourceType": "string",
      "SourceBackupVaultArn": "string",
      "SourceRecoveryPointArn": "string",
      "State": "string",
      "StatusMessage": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeCopyJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CopyJob](#API_DescribeCopyJob_ResponseSyntax) **   <a name="Backup-DescribeCopyJob-response-CopyJob"></a>
Contiene información detallada acerca de un trabajo de copia.  
Tipo: objeto [CopyJob](API_CopyJob.md)

## Errores
<a name="API_DescribeCopyJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeCopyJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeCopyJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeCopyJob) 

# DescribeFramework
<a name="API_DescribeFramework"></a>

Devuelve los detalles del marco para el `FrameworkName` especificado.

## Sintaxis de la solicitud
<a name="API_DescribeFramework_RequestSyntax"></a>

```
GET /audit/frameworks/frameworkName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeFramework_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [frameworkName](#API_DescribeFramework_RequestSyntax) **   <a name="Backup-DescribeFramework-request-uri-FrameworkName"></a>
El nombre único de un marco.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeFramework_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "DeploymentStatus": "string",
   "FrameworkArn": "string",
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "FrameworkName": "string",
   "FrameworkStatus": "string",
   "IdempotencyToken": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeFramework_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-CreationTime"></a>
Es la fecha y la hora en que se creó un marco con la norma ISO 8601. El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, 2020-07-10T15:00:00.000-08:00 representa el 10 de julio de 2020 a las 15:00 h, 8 horas menos que UTC.  
Tipo: marca temporal

 ** [DeploymentStatus](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-DeploymentStatus"></a>
El estado de implementación de un marco. Los estados son:  
 `CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED`   
Tipo: cadena

 ** [FrameworkArn](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [FrameworkControls](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkControls"></a>
Los controles que componen el marco. Cada control de la lista tiene un nombre, parámetros de entrada y alcance.  
Tipo: matriz de objetos [FrameworkControl](API_FrameworkControl.md)

 ** [FrameworkDescription](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkDescription"></a>
Una descripción opcional del marco.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*` 

 ** [FrameworkName](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkName"></a>
El nombre único de un marco.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

 ** [FrameworkStatus](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkStatus"></a>
Un marco consta de uno o varios controles. Cada control rige un recurso, como los planes de copia de seguridad, las selecciones de copia de seguridad, los almacenes de copia de seguridad o los puntos de recuperación. También puede activar o desactivar la grabación de AWS Config para cada recurso. Los estados son:  
+  `ACTIVE` cuando la grabación está activada para todos los recursos regidos por el marco.
+  `PARTIALLY_ACTIVE` cuando la grabación está desactivada para al menos un recurso regido por el marco.
+  `INACTIVE` cuando la grabación está desactivada para todos los recursos regidos por el marco.
+  `UNAVAILABLE`cuando AWS Backup no puede validar el estado de la grabación en este momento.
Tipo: cadena

 ** [IdempotencyToken](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `DescribeFrameworkOutput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena

## Errores
<a name="API_DescribeFramework_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeFramework_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeFramework) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeFramework) 

# DescribeGlobalSettings
<a name="API_DescribeGlobalSettings"></a>

Describe si la AWS cuenta ha habilitado diferentes opciones de administración multicuenta, incluida la copia de seguridad multicuenta, la aprobación multiparte y el administrador delegado. Devuelve un error si la cuenta no forma parte de una organización de Organizations. Ejemplo: `describe-global-settings --region us-west-2` 

## Sintaxis de la solicitud
<a name="API_DescribeGlobalSettings_RequestSyntax"></a>

```
GET /global-settings HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeGlobalSettings_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_DescribeGlobalSettings_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeGlobalSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "GlobalSettings": { 
      "string" : "string" 
   },
   "LastUpdateTime": number
}
```

## Elementos de respuesta
<a name="API_DescribeGlobalSettings_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GlobalSettings](#API_DescribeGlobalSettings_ResponseSyntax) **   <a name="Backup-DescribeGlobalSettings-response-GlobalSettings"></a>
El estado de las banderas `isCrossAccountBackupEnabled` `isMpaEnabled` («Mpa» se refiere a la aprobación multipartidista) y. `isDelegatedAdministratorEnabled`  
+  `isCrossAccountBackupEnabled`: Permita que las cuentas de su organización copien copias de seguridad a otras cuentas.
+  `isMpaEnabled`: Añada el acceso multicuenta a su organización con la opción de asignar un equipo de aprobación multipartito a una bóveda aislada de forma lógica.
+  `isDelegatedAdministratorEnabled`: Permita que Backup sincronice automáticamente los permisos de administrador delegados con Organizations.
Tipo: mapa de cadena a cadena

 ** [LastUpdateTime](#API_DescribeGlobalSettings_ResponseSyntax) **   <a name="Backup-DescribeGlobalSettings-response-LastUpdateTime"></a>
La fecha y la hora en que se actualizaron por última vez los indicadores compatibles. Esta actualización está en formato Unix y horario universal coordinado (UTC). El valor de `LastUpdateTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

## Errores
<a name="API_DescribeGlobalSettings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeGlobalSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeGlobalSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeGlobalSettings) 

# DescribeProtectedResource
<a name="API_DescribeProtectedResource"></a>

Devuelve información sobre un recurso guardado, incluida la última vez que se realizó una copia de seguridad, su nombre de recurso de Amazon (ARN) y el tipo de AWS servicio del recurso guardado.

## Sintaxis de la solicitud
<a name="API_DescribeProtectedResource_RequestSyntax"></a>

```
GET /resources/resourceArn HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeProtectedResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [resourceArn](#API_DescribeProtectedResource_RequestSyntax) **   <a name="Backup-DescribeProtectedResource-request-uri-ResourceArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeProtectedResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeProtectedResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LastBackupTime": number,
   "LastBackupVaultArn": "string",
   "LastRecoveryPointArn": "string",
   "LatestRestoreExecutionTimeMinutes": number,
   "LatestRestoreJobCreationDate": number,
   "LatestRestoreRecoveryPointCreationDate": number,
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeProtectedResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [LastBackupTime](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LastBackupTime"></a>
La fecha y la hora en que se realizó la última una copia de seguridad de un recurso, en formato Unix y horario universal coordinado (UTC). El valor de `LastBackupTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [LastBackupVaultArn](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LastBackupVaultArn"></a>
El ARN (nombre de recurso de Amazon) del almacén de copias de seguridad que contiene el punto de recuperación de copia de seguridad más reciente.  
Tipo: cadena

 ** [LastRecoveryPointArn](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LastRecoveryPointArn"></a>
El ARN (nombre de recurso de Amazon) del punto de recuperación más reciente.  
Tipo: cadena

 ** [LatestRestoreExecutionTimeMinutes](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreExecutionTimeMinutes"></a>
El tiempo en minutos que tardó en completarse el trabajo de restauración más reciente.  
Tipo: largo

 ** [LatestRestoreJobCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreJobCreationDate"></a>
La fecha de creación del trabajo de restauración más reciente.  
Tipo: marca temporal

 ** [LatestRestoreRecoveryPointCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreRecoveryPointCreationDate"></a>
La fecha de creación del punto de recuperación más reciente.  
Tipo: marca temporal

 ** [ResourceArn](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-ResourceArn"></a>
Un ARN que identifica de forma única a un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [ResourceName](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-ResourceName"></a>
El nombre del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena

 ** [ResourceType](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-ResourceType"></a>
El tipo de AWS recurso guardado como punto de recuperación; por ejemplo, un volumen de Amazon EBS o una base de datos de Amazon RDS.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

## Errores
<a name="API_DescribeProtectedResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeProtectedResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeProtectedResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeProtectedResource) 

# DescribeRecoveryPoint
<a name="API_DescribeRecoveryPoint"></a>

Devuelve los metadatos asociados a un punto de recuperación, incluidos el ID, el estado, el cifrado y el ciclo de vida.

## Sintaxis de la solicitud
<a name="API_DescribeRecoveryPoint_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeRecoveryPoint_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultAccountId"></a>
El identificador de cuenta del almacén de copias de seguridad especificado.  
Patrón: `^[0-9]{12}$` 

 ** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeRecoveryPoint_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeRecoveryPoint_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "CompletionDate": number,
   "CompositeMemberIdentifier": "string",
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "EncryptionKeyType": "string",
   "IamRoleArn": "string",
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "LastRestoreTime": number,
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ParentRecoveryPointArn": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanResults": [ 
      { 
         "Findings": [ "string" ],
         "LastScanTimestamp": number,
         "MalwareScanner": "string",
         "ScanJobState": "string"
      }
   ],
   "SourceBackupVaultArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "StorageClass": "string",
   "VaultType": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeRecoveryPoint_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupSizeInBytes](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupSizeInBytes"></a>
El tamaño de una copia de seguridad, en bytes.  
Tipo: largo

 ** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultArn"></a>
Un ARN que identifica de forma exclusiva un almacén de copias de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [BackupVaultName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región donde se crearon.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [CalculatedLifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CalculatedLifecycle"></a>
Un objeto `CalculatedLifecycle` que contiene las marcas temporales `MoveToColdStorageAt` y `DeleteAt`.  
Tipo: objeto [CalculatedLifecycle](API_CalculatedLifecycle.md)

 ** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para crear un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CompositeMemberIdentifier](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompositeMemberIdentifier"></a>
El identificador de un recurso dentro de un grupo compuesto, como un punto de recuperación anidado (secundario) que pertenece a una pila compuesta (principal). El ID se transfiere desde el [ID lógico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) de una pila.  
Tipo: cadena

 ** [CreatedBy](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CreatedBy"></a>
Contiene información de identificación sobre la creación de un punto de recuperación, que incluye los valores de `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` y `BackupRuleId` del plan de copia de seguridad utilizado para crearlo.  
Tipo: objeto [RecoveryPointCreator](API_RecoveryPointCreator.md)

 ** [CreationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CreationDate"></a>
La fecha y la hora en que se creó un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [EncryptionKeyArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyArn"></a>
La clave de cifrado en el servidor utilizada para proteger sus copias de seguridad; por ejemplo, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Tipo: cadena

 ** [EncryptionKeyType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyType"></a>
El tipo de clave de cifrado utilizada para el punto de recuperación. Los valores válidos son CUSTOMER\$1MANAGED\$1KMS\$1KEY para las claves administradas por el cliente o \$1OWNED\$1KMS\$1KEY para las claves propiedad del cliente. AWS AWS  
Tipo: cadena  
Valores válidos: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` 

 ** [IamRoleArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena

 ** [IndexStatus](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatus"></a>
Este es el estado actual del índice de copias de seguridad asociado al punto de recuperación especificado.  
Los estados son: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Tipo: cadena  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [IndexStatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatusMessage"></a>
Es una cadena en forma de mensaje detallado que explica el estado del índice de copias de seguridad asociado al punto de recuperación.  
Tipo: cadena

 ** [InitiationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-InitiationDate"></a>
Fecha y hora en que se inició el trabajo de copia de seguridad que ha creado este punto de recuperación, expresadas en formato Unix y horario universal coordinado (UTC).  
Tipo: marca temporal

 ** [IsEncrypted](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IsEncrypted"></a>
Un valor booleano que se devuelve como `TRUE` si el punto de recuperación especificado está cifrado o como `FALSE` si el punto de recuperación no está cifrado.  
Tipo: Booleano

 ** [IsParent](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IsParent"></a>
Esto devuelve el valor booleano de que un punto de recuperación es un trabajo principal (compuesto).  
Tipo: Booleano

 ** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-LastRestoreTime"></a>
La fecha y hora en que se restauró por última vez un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `LastRestoreTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [Lifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup cambia y vence las copias de seguridad automáticamente de acuerdo con el ciclo de vida que usted defina.  
Las copias de seguridad que se han migrado al almacenamiento en frío deben permanecer en él durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.   
Los tipos de recursos que pueden pasar al almacenamiento en frío se muestran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)

 ** [ParentRecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ParentRecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación principal (compuesto); por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [RecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [ResourceArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceArn"></a>
Un ARN que identifica de forma exclusiva un recurso guardado. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceName"></a>
El nombre del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena

 ** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceType"></a>
El tipo de AWS recurso que se va a guardar como punto de recuperación; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ScanResults](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ScanResults"></a>
Contiene los resultados de escaneo más recientes comparados con el punto de recuperación y, actualmente`MalwareScanner`, incluye, `ScanJobState` y `Findings` `LastScanTimestamp`   
Tipo: matriz de objetos [ScanResult](API_ScanResult.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 5 artículos.

 ** [SourceBackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-SourceBackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva el almacén de origen en el que se realizó la copia de seguridad original del recurso; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Si la recuperación se restaura en la misma AWS cuenta o región, este valor será`null`.  
Tipo: cadena

 ** [Status](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-Status"></a>
Un código de estado que especifica el estado del punto de recuperación. Para obtener más información, consulta el [estado de los puntos de recuperación](https://docs.aws.amazon.com/aws-backup/latest/devguide/applicationstackbackups.html#cfnrecoverypointstatus) en la *Guía para AWS Backup desarrolladores*.  
+  `CREATING`el estado indica que se ha iniciado un AWS Backup trabajo para un recurso. El proceso de copia de seguridad se ha iniciado y está procesando activamente un trabajo de copia de seguridad para el punto de recuperación asociado.
+  El estado `AVAILABLE` indica que la copia de seguridad se ha creado correctamente para el punto de recuperación. El proceso de copia de seguridad se ha completado sin problemas y el punto de recuperación ya está listo para su uso.
+  El estado `PARTIAL` indica que un punto de recuperación compuesto tiene uno o más puntos de recuperación anidados que no estaban en la copia de seguridad.
+  `EXPIRED`el estado indica que el punto de recuperación ha superado su período de retención, pero AWS Backup carece de permiso o no puede eliminarlo por algún motivo. Para eliminar estos puntos de recuperación manualmente, consulte el [Paso 3: elimine los puntos de recuperación](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups) en la sección *Depuración de recursos* de la *Introducción*.
+  El estado `STOPPED` se produce en una copia de seguridad continua cuando un usuario ha realizado alguna acción que provoca la desactivación de la copia de seguridad continua. Esto puede deberse a la eliminación de los permisos, a la desactivación del control de versiones, a la desactivación de los eventos a EventBridge los que se envían o a la desactivación de EventBridge las reglas establecidas por. AWS Backup En el caso de los puntos de recuperación de los recursos de Amazon S3, Amazon RDS y Amazon Aurora, este estado se produce cuando se cambia el período de retención de una regla de copia de seguridad continua.

  Para resolver el estado `STOPPED`, asegúrese de que todos los permisos solicitados estén en vigor y de que el control de versiones esté activado en el bucket de S3. Una vez que se cumplan estas condiciones, la siguiente instancia de una regla de copia de seguridad que se ejecute provocará la creación de un nuevo punto de recuperación continuo. No es necesario eliminar los puntos de recuperación con el estado STOPPED.

  En el caso de SAP HANA on Amazon, el EC2 `STOPPED` estado se debe a una acción del usuario, a una mala configuración de la aplicación o a un error en la copia de seguridad. Para garantizar que las futuras copias de seguridad continuas se realicen correctamente, consulte el estado del punto de recuperación y consulte SAP HANA para obtener más información.
Tipo: cadena  
Valores válidos: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING` 

 ** [StatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StatusMessage"></a>
Un mensaje de estado que explica el estado del punto de recuperación.  
Tipo: cadena

 ** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StorageClass"></a>
Especifica la clase de almacenamiento del punto de recuperación. Los valores válidos son `WARM` o `COLD`.  
Tipo: cadena  
Valores válidos: `WARM | COLD | DELETED` 

 ** [VaultType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-VaultType"></a>
El tipo de almacén en el que se guarda el punto de recuperación descrito.  
Tipo: cadena  
Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

## Errores
<a name="API_DescribeRecoveryPoint_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeRecoveryPoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRecoveryPoint) 

# DescribeRegionSettings
<a name="API_DescribeRegionSettings"></a>

Devuelve la configuración actual de suscripción del servicio para la región. Si la opción de servicio está habilitada para un servicio, AWS Backup intenta proteger los recursos de ese servicio en esta región cuando el recurso esté incluido en un plan de respaldo bajo demanda o programado. De no ser así, AWS Backup no intenta proteger los recursos de ese servicio en esta región.

## Sintaxis de la solicitud
<a name="API_DescribeRegionSettings_RequestSyntax"></a>

```
GET /account-settings HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeRegionSettings_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_DescribeRegionSettings_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeRegionSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ResourceTypeManagementPreference": { 
      "string" : boolean 
   },
   "ResourceTypeOptInPreference": { 
      "string" : boolean 
   }
}
```

## Elementos de respuesta
<a name="API_DescribeRegionSettings_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ResourceTypeManagementPreference](#API_DescribeRegionSettings_ResponseSyntax) **   <a name="Backup-DescribeRegionSettings-response-ResourceTypeManagementPreference"></a>
Devuelve si administra AWS Backup completamente las copias de seguridad de un tipo de recurso.  
Para conocer las ventajas de una AWS Backup administración completa, consulte [AWS Backup Administración completa](https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#full-management).  
Para obtener una lista de los tipos de recursos y saber si cada uno de ellos admite una AWS Backup administración completa, consulte la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource).  
Si`"DynamoDB":false`, puede habilitar la AWS Backup administración completa de las copias de seguridad de DynamoDB habilitando las funciones [avanzadas de copia de seguridad AWS Backup de DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli).  
Tipo: mapa de cadena a booleano  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ResourceTypeOptInPreference](#API_DescribeRegionSettings_ResponseSyntax) **   <a name="Backup-DescribeRegionSettings-response-ResourceTypeOptInPreference"></a>
Los servicios junto con las preferencias de suscripción de la región.  
Tipo: mapa de cadena a booleano  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

## Errores
<a name="API_DescribeRegionSettings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeRegionSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas AWS SDKs específicos, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRegionSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRegionSettings) 

# DescribeReportJob
<a name="API_DescribeReportJob"></a>

Devuelve los detalles asociados a la creación de un informe especificado por su `ReportJobId`.

## Sintaxis de la solicitud
<a name="API_DescribeReportJob_RequestSyntax"></a>

```
GET /audit/report-jobs/reportJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeReportJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [reportJobId](#API_DescribeReportJob_RequestSyntax) **   <a name="Backup-DescribeReportJob-request-uri-ReportJobId"></a>
El identificador del trabajo de informes. Una única cadena cifrada en UTF-8, Unicode, generada aleatoriamente que tiene como máximo una longitud de 1024 bytes. El ID del trabajo de informes no se puede editar.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeReportJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeReportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReportJob": { 
      "CompletionTime": number,
      "CreationTime": number,
      "ReportDestination": { 
         "S3BucketName": "string",
         "S3Keys": [ "string" ]
      },
      "ReportJobId": "string",
      "ReportPlanArn": "string",
      "ReportTemplate": "string",
      "Status": "string",
      "StatusMessage": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeReportJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ReportJob](#API_DescribeReportJob_ResponseSyntax) **   <a name="Backup-DescribeReportJob-response-ReportJob"></a>
La información sobre un trabajo de informes, que incluye las horas de finalización y creación, el destino del informe, el ID único del trabajo de informes, el nombre de recurso de Amazon (ARN), la plantilla del informe, el estado y el mensaje de estado.  
Tipo: objeto [ReportJob](API_ReportJob.md)

## Errores
<a name="API_DescribeReportJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeReportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeReportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeReportJob) 

# DescribeReportPlan
<a name="API_DescribeReportPlan"></a>

Devuelve una lista de todos los planes de informes de un Cuenta de AWS y Región de AWS.

## Sintaxis de la solicitud
<a name="API_DescribeReportPlan_RequestSyntax"></a>

```
GET /audit/report-plans/reportPlanName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeReportPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [reportPlanName](#API_DescribeReportPlan_RequestSyntax) **   <a name="Backup-DescribeReportPlan-request-uri-ReportPlanName"></a>
El nombre único de un plan de informes.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeReportPlan_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReportPlan": { 
      "CreationTime": number,
      "DeploymentStatus": "string",
      "LastAttemptedExecutionTime": number,
      "LastSuccessfulExecutionTime": number,
      "ReportDeliveryChannel": { 
         "Formats": [ "string" ],
         "S3BucketName": "string",
         "S3KeyPrefix": "string"
      },
      "ReportPlanArn": "string",
      "ReportPlanDescription": "string",
      "ReportPlanName": "string",
      "ReportSetting": { 
         "Accounts": [ "string" ],
         "FrameworkArns": [ "string" ],
         "NumberOfFrameworks": number,
         "OrganizationUnits": [ "string" ],
         "Regions": [ "string" ],
         "ReportTemplate": "string"
      }
   }
}
```

## Elementos de respuesta
<a name="API_DescribeReportPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ReportPlan](#API_DescribeReportPlan_ResponseSyntax) **   <a name="Backup-DescribeReportPlan-response-ReportPlan"></a>
Devuelve detalles sobre el plan de informes especificado por su nombre. Estos detalles incluyen el nombre de recurso de Amazon (ARN) del plan de informes, la descripción, la configuración, el canal de entrega, el estado de implementación, la hora de creación y las últimas veces que se intentó ejecutar y se ejecutó correctamente.  
Tipo: objeto [ReportPlan](API_ReportPlan.md)

## Errores
<a name="API_DescribeReportPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeReportPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeReportPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeReportPlan) 

# DescribeRestoreJob
<a name="API_DescribeRestoreJob"></a>

Devuelve los metadatos asociados a un trabajo de restauración especificado mediante un ID de trabajo.

## Sintaxis de la solicitud
<a name="API_DescribeRestoreJob_RequestSyntax"></a>

```
GET /restore-jobs/restoreJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeRestoreJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [restoreJobId](#API_DescribeRestoreJob_RequestSyntax) **   <a name="Backup-DescribeRestoreJob-request-uri-RestoreJobId"></a>
Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeRestoreJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeRestoreJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "RestoreTestingPlanArn": "string"
   },
   "CreatedResourceArn": "string",
   "CreationDate": number,
   "DeletionStatus": "string",
   "DeletionStatusMessage": "string",
   "ExpectedCompletionTimeMinutes": number,
   "IamRoleArn": "string",
   "IsParent": boolean,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointCreationDate": number,
   "ResourceType": "string",
   "RestoreJobId": "string",
   "SourceResourceArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeRestoreJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccountId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-AccountId"></a>
Devuelve el ID de la cuenta a la que pertenece el trabajo de restauración.  
Tipo: cadena  
Patrón: `^[0-9]{12}$` 

 ** [BackupSizeInBytes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupSizeInBytes"></a>
El tamaño del recurso restaurado, en bytes.  
Tipo: largo

 ** [BackupVaultArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupVaultArn"></a>
Es el Nombre de recurso de Amazon (ARN) del almacén de copias de seguridad que contiene el punto de recuperación que se va a restaurar. Esto ayuda a identificar las políticas y los permisos de acceso al almacén.  
Tipo: cadena

 ** [CompletionDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para restaurar un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatedBy](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de restauración.  
Tipo: objeto [RestoreJobCreator](API_RestoreJobCreator.md)

 ** [CreatedResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedResourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso que creó el trabajo de restauración.  
El formato del ARN depende del tipo de recurso del que se ha hecho copia de seguridad.  
Tipo: cadena

 ** [CreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreationDate"></a>
La fecha y la hora en que se creó un trabajo de restauración, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [DeletionStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatus"></a>
El estado de los datos generados por la prueba de restauración.  
Tipo: cadena  
Valores válidos: `DELETING | FAILED | SUCCESSFUL` 

 ** [DeletionStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatusMessage"></a>
Describe el estado de eliminación del trabajo de restauración.  
Tipo: cadena

 ** [ExpectedCompletionTimeMinutes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ExpectedCompletionTimeMinutes"></a>
La cantidad de tiempo en minutos que se espera que tarde un trabajo de restauración de un punto de recuperación.  
Tipo: largo

 ** [IamRoleArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena

 ** [IsParent](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IsParent"></a>
Se trata de un valor booleano que indica si el trabajo de restauración es un trabajo de restauración principal (compuesto).  
Tipo: Booleano

 ** [ParentJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ParentJobId"></a>
Es el identificador único del trabajo de restauración principal del trabajo de restauración seleccionado.  
Tipo: cadena

 ** [PercentDone](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-PercentDone"></a>
Contiene el porcentaje estimado que se ha completado de un trabajo en el momento en que se consultó el estado del trabajo.  
Tipo: cadena

 ** [RecoveryPointArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [RecoveryPointCreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointCreationDate"></a>
La fecha de creación del punto de recuperación creado por el trabajo de restauración especificado.  
Tipo: marca temporal

 ** [ResourceType](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ResourceType"></a>
Devuelve los metadatos asociados a un trabajo de restauración enumerados por tipo de recurso.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RestoreJobId"></a>
Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.  
Tipo: cadena

 ** [SourceResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-SourceResourceArn"></a>
Es el Nombre de recurso de Amazon (ARN) del recurso original del que se ha realizado la copia de seguridad. Proporciona un contexto sobre el recurso que se está restaurando.  
Tipo: cadena

 ** [Status](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-Status"></a>
Código de estado que especifica el estado del trabajo que se inicia AWS Backup para restaurar un punto de recuperación.  
Tipo: cadena  
Valores válidos: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [StatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-StatusMessage"></a>
Un mensaje que muestra el estado de un trabajo para restaurar un punto de recuperación.  
Tipo: cadena

 ** [ValidationStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatus"></a>
El estado de la validación ejecutada en el trabajo de restauración indicado.  
Tipo: cadena  
Valores válidos: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING` 

 ** [ValidationStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatusMessage"></a>
Mensaje del estado.  
Tipo: cadena

## Errores
<a name="API_DescribeRestoreJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** DependencyFailureException **   
Un AWS servicio o recurso dependiente devolvió un error al AWS Backup servicio y la acción no se pudo completar.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeRestoreJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRestoreJob) 

# DescribeScanJob
<a name="API_DescribeScanJob"></a>

Devuelve los detalles del trabajo de escaneo para el ScanJob ID especificado.

## Sintaxis de la solicitud
<a name="API_DescribeScanJob_RequestSyntax"></a>

```
GET /scan/jobs/ScanJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeScanJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ScanJobId](#API_DescribeScanJob_RequestSyntax) **   <a name="Backup-DescribeScanJob-request-uri-ScanJobId"></a>
Identifica de forma exclusiva una solicitud AWS Backup para escanear un recurso.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeScanJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeScanJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanVersion": "string",
      "BackupRuleId": "string"
   },
   "CreationDate": number,
   "IamRoleArn": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanId": "string",
   "ScanJobId": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string",
   "ScanResult": { 
      "ScanResultStatus": "string"
   },
   "State": "string",
   "StatusMessage": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeScanJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccountId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-AccountId"></a>
Devuelve el ID de cuenta propietario del trabajo de escaneo.  
Patrón: `^[0-9]{12}$`   
Tipo: cadena

 ** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`   
Tipo: cadena

 ** [BackupVaultName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon.  
Patrón: `^[a-zA-Z0-9\-\_\.]{2,50}$`   
Tipo: cadena

 ** [CompletionDate](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CompletionDate"></a>
Es la fecha y la hora en que ha finalizado la creación del índice de copias de seguridad, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatedBy](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de escaneo, incluidos el plan de respaldo y la regla que inició el escaneo.  
Tipo: objeto [ScanJobCreator](API_ScanJobCreator.md)

 ** [CreationDate](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreationDate"></a>
Es la fecha y la hora en que ha finalizado la creación del índice de copias de seguridad, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IamRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-IamRoleArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena

 ** [MalwareScanner](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-MalwareScanner"></a>
El motor de escaneo utilizado para el trabajo de escaneo correspondiente. En la actualidad, solo se admite `GUARDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY` 

 ** [RecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva el punto de recuperación objetivo para el escaneo.; por ejemplo,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`  
Tipo: cadena

 ** [ResourceArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceArn"></a>
Un ARN que identifica de forma exclusiva el recurso de origen del ARN del punto de recuperación correspondiente.  
Tipo: cadena

 ** [ResourceName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena

 ** [ResourceType](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceType"></a>
El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS).  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Tipo: cadena  
Valores válidos: `EBS | EC2 | S3` 

 ** [ScanBaseRecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanBaseRecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva el punto de recuperación base para el escaneo. Este campo solo se rellenará cuando se haya realizado un trabajo de escaneo incremental.  
Tipo: cadena

 ** [ScanId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanId"></a>
El identificador de escaneado generado por Amazon GuardDuty para la correspondiente solicitud de Scan Job ID de AWS Backup.  
Tipo: cadena

 ** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanJobId"></a>
El identificador del trabajo de escaneo que identificó de forma exclusiva la solicitud AWS Backup.  
Tipo: cadena

 ** [ScanMode](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanMode"></a>
Especifica el tipo de escaneo utilizado para el trabajo de escaneo.  
Tipo: cadena  
Valores válidos: `FULL_SCAN | INCREMENTAL_SCAN` 

 ** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScannerRoleArn"></a>
Especifica la función de IAM del escáner (ARN) que se utiliza para el trabajo de digitalización.  
Tipo: cadena

 ** [ScanResult](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanResult"></a>
 Contiene el `ScanResultsStatus` correspondiente al trabajo de digitalización y devuelve `THREATS_FOUND` o `NO_THREATS_FOUND` corresponde a los trabajos finalizados.  
Tipo: objeto [ScanResultInfo](API_ScanResultInfo.md)

 ** [State](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-State"></a>
El estado actual de un trabajo de escaneo.  
Tipo: cadena  
Valores válidos: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-StatusMessage"></a>
Un mensaje detallado que explica el estado del trabajo de copia de seguridad de un recurso.  
Tipo: cadena

## Errores
<a name="API_DescribeScanJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeScanJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeScanJob) 

# DisassociateBackupVaultMpaApprovalTeam
<a name="API_DisassociateBackupVaultMpaApprovalTeam"></a>

Elimina la asociación entre un equipo de aprobación MPA y un almacén de copias de seguridad, lo que desactiva el flujo de trabajo de aprobación MPA para las operaciones de restauración.

## Sintaxis de la solicitud
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/mpaApprovalTeam?delete HTTP/1.1
Content-type: application/json

{
   "RequesterComment": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-DisassociateBackupVaultMpaApprovalTeam-request-uri-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad del que se va a desasociar el equipo de aprobación MPA.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [RequesterComment](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-DisassociateBackupVaultMpaApprovalTeam-request-RequesterComment"></a>
Es un comentario opcional que explica el motivo por el que se desasocia al equipo de aprobación MPA del almacén de copias de seguridad.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_DisassociateBackupVaultMpaApprovalTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DisassociateBackupVaultMpaApprovalTeam_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_DisassociateBackupVaultMpaApprovalTeam_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DisassociateBackupVaultMpaApprovalTeam_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam) 

# DisassociateRecoveryPoint
<a name="API_DisassociateRecoveryPoint"></a>

Elimina el punto de recuperación de copias de seguridad continuas especificado AWS Backup y transfiere el control de esa copia de seguridad continua al servicio de origen, como Amazon RDS. El servicio de origen seguirá creando y reteniendo copias de seguridad continuas según el ciclo de vida que haya especificado en su plan de copia de seguridad original.

No admite puntos de recuperación de copias de seguridad instantáneas.

## Sintaxis de la solicitud
<a name="API_DisassociateRecoveryPoint_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/disassociate HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DisassociateRecoveryPoint_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DisassociateRecoveryPoint_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPoint-request-uri-BackupVaultName"></a>
El nombre exclusivo de un AWS Backup almacén.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_DisassociateRecoveryPoint_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPoint-request-uri-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de AWS Backup recuperación.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DisassociateRecoveryPoint_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DisassociateRecoveryPoint_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DisassociateRecoveryPoint_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DisassociateRecoveryPoint_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** InvalidResourceStateException **   
 AWS Backup ya está realizando una acción en este punto de recuperación. No es posible realizar la acción que ha solicitado hasta que finalice la primera acción. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DisassociateRecoveryPoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DisassociateRecoveryPoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DisassociateRecoveryPoint) 

# DisassociateRecoveryPointFromParent
<a name="API_DisassociateRecoveryPointFromParent"></a>

Esta acción dirigida a un punto de recuperación secundario (anidado) específico elimina la relación entre el punto de recuperación especificado y su punto de recuperación principal (compuesto).

## Sintaxis de la solicitud
<a name="API_DisassociateRecoveryPointFromParent_RequestSyntax"></a>

```
DELETE /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/parentAssociation HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DisassociateRecoveryPointFromParent_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_DisassociateRecoveryPointFromParent_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPointFromParent-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico en el que se almacena el punto de recuperación secundario (anidado). Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_DisassociateRecoveryPointFromParent_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPointFromParent-request-uri-RecoveryPointArn"></a>
El nombre de recurso de Amazon (ARN) que identifica de forma exclusiva el punto de recuperación secundario (anidado); por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DisassociateRecoveryPointFromParent_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DisassociateRecoveryPointFromParent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DisassociateRecoveryPointFromParent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_DisassociateRecoveryPointFromParent_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DisassociateRecoveryPointFromParent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DisassociateRecoveryPointFromParent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DisassociateRecoveryPointFromParent) 

# ExportBackupPlanTemplate
<a name="API_ExportBackupPlanTemplate"></a>

Devuelve el plan de copia de seguridad especificado por el ID del plan como plantilla de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_ExportBackupPlanTemplate_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/toTemplate/ HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ExportBackupPlanTemplate_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_ExportBackupPlanTemplate_RequestSyntax) **   <a name="Backup-ExportBackupPlanTemplate-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_ExportBackupPlanTemplate_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ExportBackupPlanTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanTemplateJson": "string"
}
```

## Elementos de respuesta
<a name="API_ExportBackupPlanTemplate_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanTemplateJson](#API_ExportBackupPlanTemplate_ResponseSyntax) **   <a name="Backup-ExportBackupPlanTemplate-response-BackupPlanTemplateJson"></a>
El cuerpo de una plantilla de plan de copia de seguridad en formato JSON.  
Se trata de un documento JSON firmado que no se puede modificar antes de pasarlo a `GetBackupPlanFromJSON.` 
Tipo: cadena

## Errores
<a name="API_ExportBackupPlanTemplate_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ExportBackupPlanTemplate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ExportBackupPlanTemplate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ExportBackupPlanTemplate) 

# GetBackupPlan
<a name="API_GetBackupPlan"></a>

Devuelve los detalles del `BackupPlan` para el `BackupPlanId` especificado. Los detalles son el cuerpo de un plan de copia de seguridad en formato JSON, además de los metadatos del plan.

## Sintaxis de la solicitud
<a name="API_GetBackupPlan_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/?MaxScheduledRunsPreview=MaxScheduledRunsPreview&versionId=VersionId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetBackupPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

 ** [MaxScheduledRunsPreview](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-MaxScheduledRunsPreview"></a>
Número de ejecuciones de copias de seguridad programadas futuras para previsualizar. Si se establece en 0 (valor predeterminado), no se incluye ninguna vista previa de ejecuciones programadas en la respuesta. El rango válido es de 0 a 10.  
Rango válido: valor mínimo de 0. Valor máximo de 10.

 ** [VersionId](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-VersionId"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. La versión IDs no se puede editar.

## Cuerpo de la solicitud
<a name="API_GetBackupPlan_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBackupPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   },
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "DeletionDate": number,
   "LastExecutionDate": number,
   "ScheduledRunsPreview": [ 
      { 
         "ExecutionTime": number,
         "RuleExecutionType": "string",
         "RuleId": "string"
      }
   ],
   "VersionId": "string"
}
```

## Elementos de respuesta
<a name="API_GetBackupPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AdvancedBackupSettings](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-AdvancedBackupSettings"></a>
Contiene una lista de `BackupOptions` para cada tipo de recurso. La lista se rellena solo si se ha configurado la opción avanzada para el plan de copia de seguridad.  
Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md)

 ** [BackupPlan](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-BackupPlan"></a>
Especifica el cuerpo de un plan de copia de seguridad. Incluye un `BackupPlanName` y uno o más conjuntos de `Rules`.  
Tipo: objeto [BackupPlan](API_BackupPlan.md)

 ** [BackupPlanArn](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena

 ** [BackupPlanId](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena

 ** [CreationDate](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-CreationDate"></a>
La fecha y la hora en que se creó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatorRequestId](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces.   
Tipo: cadena

 ** [DeletionDate](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-DeletionDate"></a>
La fecha y la hora en que se eliminó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `DeletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [LastExecutionDate](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-LastExecutionDate"></a>
La última vez que se ejecutó este plan de copia de seguridad. Una fecha y hora, en formato Unix y horario universal coordinado (UTC). El valor de `LastExecutionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ScheduledRunsPreview](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-ScheduledRunsPreview"></a>
Lista de las próximas ejecuciones de copias de seguridad programadas. Solo se incluye cuando el parámetro `MaxScheduledRunsPreview` sea mayor que 0. Contiene hasta 10 futuras ejecuciones de copias de seguridad con sus horarios programados, tipos de ejecución y regla asociada IDs.  
Tipo: matriz de objetos [ScheduledPlanExecutionMember](API_ScheduledPlanExecutionMember.md)

 ** [VersionId](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-VersionId"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. La versión IDs no se puede editar.  
Tipo: cadena

## Errores
<a name="API_GetBackupPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetBackupPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupPlan) 

# GetBackupPlanFromJSON
<a name="API_GetBackupPlanFromJSON"></a>

Devuelve un documento JSON válido que especifica un plan de copia de seguridad o un error.

## Sintaxis de la solicitud
<a name="API_GetBackupPlanFromJSON_RequestSyntax"></a>

```
POST /backup/template/json/toPlan HTTP/1.1
Content-type: application/json

{
   "BackupPlanTemplateJson": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_GetBackupPlanFromJSON_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_GetBackupPlanFromJSON_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupPlanTemplateJson](#API_GetBackupPlanFromJSON_RequestSyntax) **   <a name="Backup-GetBackupPlanFromJSON-request-BackupPlanTemplateJson"></a>
Un documento del plan de copia de seguridad proporcionado por el cliente en formato JSON.  
Tipo: cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_GetBackupPlanFromJSON_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   }
}
```

## Elementos de respuesta
<a name="API_GetBackupPlanFromJSON_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlan](#API_GetBackupPlanFromJSON_ResponseSyntax) **   <a name="Backup-GetBackupPlanFromJSON-response-BackupPlan"></a>
Especifica el cuerpo de un plan de copia de seguridad. Incluye un `BackupPlanName` y uno o más conjuntos de `Rules`.  
Tipo: objeto [BackupPlan](API_BackupPlan.md)

## Errores
<a name="API_GetBackupPlanFromJSON_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetBackupPlanFromJSON_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupPlanFromJSON) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupPlanFromJSON) 

# GetBackupPlanFromTemplate
<a name="API_GetBackupPlanFromTemplate"></a>

Devuelve la plantilla especificada por su `templateId` como plan de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_GetBackupPlanFromTemplate_RequestSyntax"></a>

```
GET /backup/template/plans/templateId/toPlan HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetBackupPlanFromTemplate_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [templateId](#API_GetBackupPlanFromTemplate_RequestSyntax) **   <a name="Backup-GetBackupPlanFromTemplate-request-uri-BackupPlanTemplateId"></a>
Identifica de forma exclusiva una plantilla de plan de copia de seguridad almacenada.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBackupPlanFromTemplate_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBackupPlanFromTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanDocument": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   }
}
```

## Elementos de respuesta
<a name="API_GetBackupPlanFromTemplate_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanDocument](#API_GetBackupPlanFromTemplate_ResponseSyntax) **   <a name="Backup-GetBackupPlanFromTemplate-response-BackupPlanDocument"></a>
Devuelve el cuerpo de un plan de copia de seguridad en función de la plantilla de destino, incluidos el nombre, las reglas y el almacén de copias de seguridad del plan.  
Tipo: objeto [BackupPlan](API_BackupPlan.md)

## Errores
<a name="API_GetBackupPlanFromTemplate_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetBackupPlanFromTemplate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupPlanFromTemplate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupPlanFromTemplate) 

# GetBackupSelection
<a name="API_GetBackupSelection"></a>

Devuelve los metadatos de selección y un documento en formato JSON que especifica una lista de recursos asociados a un plan de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_GetBackupSelection_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/selections/selectionId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetBackupSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_GetBackupSelection_RequestSyntax) **   <a name="Backup-GetBackupSelection-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

 ** [selectionId](#API_GetBackupSelection_RequestSyntax) **   <a name="Backup-GetBackupSelection-request-uri-SelectionId"></a>
Identifica de forma única el cuerpo de una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBackupSelection_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBackupSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanId": "string",
   "BackupSelection": { 
      "Conditions": { 
         "StringEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ]
      },
      "IamRoleArn": "string",
      "ListOfTags": [ 
         { 
            "ConditionKey": "string",
            "ConditionType": "string",
            "ConditionValue": "string"
         }
      ],
      "NotResources": [ "string" ],
      "Resources": [ "string" ],
      "SelectionName": "string"
   },
   "CreationDate": number,
   "CreatorRequestId": "string",
   "SelectionId": "string"
}
```

## Elementos de respuesta
<a name="API_GetBackupSelection_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanId](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena

 ** [BackupSelection](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-BackupSelection"></a>
Especifica el cuerpo de una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Tipo: objeto [BackupSelection](API_BackupSelection.md)

 ** [CreationDate](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-CreationDate"></a>
La fecha y la hora en que se creó la selección de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatorRequestId](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces.  
Tipo: cadena

 ** [SelectionId](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-SelectionId"></a>
Identifica de forma única el cuerpo de una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Tipo: cadena

## Errores
<a name="API_GetBackupSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetBackupSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupSelection) 

# GetBackupVaultAccessPolicy
<a name="API_GetBackupVaultAccessPolicy"></a>

Devuelve el documento de política de acceso asociado al almacén de copias de seguridad indicado.

## Sintaxis de la solicitud
<a name="API_GetBackupVaultAccessPolicy_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/access-policy HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetBackupVaultAccessPolicy_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_GetBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-GetBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBackupVaultAccessPolicy_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBackupVaultAccessPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "Policy": "string"
}
```

## Elementos de respuesta
<a name="API_GetBackupVaultAccessPolicy_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **   <a name="Backup-GetBackupVaultAccessPolicy-response-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [BackupVaultName](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **   <a name="Backup-GetBackupVaultAccessPolicy-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región donde se crearon.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [Policy](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **   <a name="Backup-GetBackupVaultAccessPolicy-response-Policy"></a>
El documento de política de acceso al almacén de copias de seguridad en formato JSON.  
Tipo: cadena

## Errores
<a name="API_GetBackupVaultAccessPolicy_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetBackupVaultAccessPolicy_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupVaultAccessPolicy) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupVaultAccessPolicy) 

# GetBackupVaultNotifications
<a name="API_GetBackupVaultNotifications"></a>

Devuelve notificaciones de eventos para el almacén de copias de seguridad especificado.

## Sintaxis de la solicitud
<a name="API_GetBackupVaultNotifications_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetBackupVaultNotifications_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_GetBackupVaultNotifications_RequestSyntax) **   <a name="Backup-GetBackupVaultNotifications-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetBackupVaultNotifications_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetBackupVaultNotifications_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultEvents": [ "string" ],
   "BackupVaultName": "string",
   "SNSTopicArn": "string"
}
```

## Elementos de respuesta
<a name="API_GetBackupVaultNotifications_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_GetBackupVaultNotifications_ResponseSyntax) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [BackupVaultEvents](#API_GetBackupVaultNotifications_ResponseSyntax) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultEvents"></a>
Una matriz de eventos que indica el estado de los trabajos para realizar copias de seguridad de recursos en el almacén de copia de seguridad.  
Tipo: matriz de cadenas  
Valores válidos: `BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED | CONTINUOUS_BACKUP_INTERRUPTED | RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED` 

 ** [BackupVaultName](#API_GetBackupVaultNotifications_ResponseSyntax) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región donde se crearon.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [SNSTopicArn](#API_GetBackupVaultNotifications_ResponseSyntax) **   <a name="Backup-GetBackupVaultNotifications-response-SNSTopicArn"></a>
Un ARN que identifica de forma exclusiva un tema de Amazon Simple Notification Service (Amazon SNS); por ejemplo, `arn:aws:sns:us-west-2:111122223333:MyTopic`.  
Tipo: cadena

## Errores
<a name="API_GetBackupVaultNotifications_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetBackupVaultNotifications_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupVaultNotifications) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupVaultNotifications) 

# GetLegalHold
<a name="API_GetLegalHold"></a>

Esta acción devuelve los detalles de una retención legal concreta. Los detalles son el cuerpo de una retención legal en formato JSON, además de los metadatos.

## Sintaxis de la solicitud
<a name="API_GetLegalHold_RequestSyntax"></a>

```
GET /legal-holds/legalHoldId/ HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetLegalHold_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [legalHoldId](#API_GetLegalHold_RequestSyntax) **   <a name="Backup-GetLegalHold-request-uri-LegalHoldId"></a>
El identificador de la retención legal.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetLegalHold_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CancelDescription": "string",
   "CancellationDate": number,
   "CreationDate": number,
   "Description": "string",
   "LegalHoldArn": "string",
   "LegalHoldId": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "RetainRecordUntil": number,
   "Status": "string",
   "Title": "string"
}
```

## Elementos de respuesta
<a name="API_GetLegalHold_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CancelDescription](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancelDescription"></a>
El motivo de la eliminación de la retención legal.  
Tipo: cadena

 ** [CancellationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancellationDate"></a>
Hora a la que se canceló la retención legal.  
Tipo: marca temporal

 ** [CreationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CreationDate"></a>
La hora en la que se creó la retención legal.  
Tipo: marca temporal

 ** [Description](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Description"></a>
La descripción de la cadena de la retención legal.  
Tipo: cadena

 ** [LegalHoldArn](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldArn"></a>
El ARN del marco para la retención legal especificada. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [LegalHoldId](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldId"></a>
El identificador de la retención legal.  
Tipo: cadena

 ** [RecoveryPointSelection](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RecoveryPointSelection"></a>
Los criterios para asignar un conjunto de recursos, como los tipos de recursos o los almacenes de copias de seguridad.  
Tipo: objeto [RecoveryPointSelection](API_RecoveryPointSelection.md)

 ** [RetainRecordUntil](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RetainRecordUntil"></a>
La fecha y la hora hasta las que se conservará el registro de la retención legal.  
Tipo: marca temporal

 ** [Status](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Status"></a>
El estado de la retención legal.  
Tipo: cadena  
Valores válidos: `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Title"></a>
El título de la retención legal.  
Tipo: cadena

## Errores
<a name="API_GetLegalHold_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetLegalHold_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetLegalHold) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetLegalHold) 

# GetRecoveryPointIndexDetails
<a name="API_GetRecoveryPointIndexDetails"></a>

Esta operación devuelve los metadatos y detalles específicos del índice de copias de seguridad asociado al punto de recuperación especificado.

## Sintaxis de la solicitud
<a name="API_GetRecoveryPointIndexDetails_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetRecoveryPointIndexDetails_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_GetRecoveryPointIndexDetails_RequestSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de donde se crearon.  
Los caracteres permitidos son: letras minúsculas, números y guiones.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_GetRecoveryPointIndexDetails_RequestSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-request-uri-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetRecoveryPointIndexDetails_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetRecoveryPointIndexDetails_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "IndexCompletionDate": number,
   "IndexCreationDate": number,
   "IndexDeletionDate": number,
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "RecoveryPointArn": "string",
   "SourceResourceArn": "string",
   "TotalItemsIndexed": number
}
```

## Elementos de respuesta
<a name="API_GetRecoveryPointIndexDetails_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-BackupVaultArn"></a>
Es un ARN que identifica de forma unívoca el almacén de copias de seguridad en el que se almacena el índice de puntos de recuperación.  
Por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [IndexCompletionDate](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexCompletionDate"></a>
Es la fecha y la hora en que ha finalizado la creación del índice de copias de seguridad, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IndexCreationDate](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexCreationDate"></a>
Es la fecha y la hora de creación de un índice de copias de seguridad, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IndexDeletionDate](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexDeletionDate"></a>
Es la fecha y la hora de eliminación de un índice de copias de seguridad, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IndexStatus](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexStatus"></a>
Este es el estado actual del índice de copias de seguridad asociado al punto de recuperación especificado.  
Los estados son: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Tipo: cadena  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [IndexStatusMessage](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexStatusMessage"></a>
Es un mensaje detallado que explica el estado del índice de copias de seguridad asociado al punto de recuperación.  
Tipo: cadena

 ** [RecoveryPointArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [SourceResourceArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-SourceResourceArn"></a>
Es una cadena de un Nombre de recurso de Amazon (ARN) que identifica de forma unívoca un recurso de origen.  
Tipo: cadena

 ** [TotalItemsIndexed](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-TotalItemsIndexed"></a>
Es el recuento de elementos del índice de copias de seguridad asociado al punto de recuperación.  
Tipo: largo

## Errores
<a name="API_GetRecoveryPointIndexDetails_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetRecoveryPointIndexDetails_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRecoveryPointIndexDetails) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRecoveryPointIndexDetails) 

# GetRecoveryPointRestoreMetadata
<a name="API_GetRecoveryPointRestoreMetadata"></a>

Devuelve un conjunto de pares clave-valor de metadatos que se utilizaron para crear la copia de seguridad.

## Sintaxis de la solicitud
<a name="API_GetRecoveryPointRestoreMetadata_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/restore-metadata?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetRecoveryPointRestoreMetadata_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultAccountId](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-request-uri-BackupVaultAccountId"></a>
El identificador de cuenta del almacén de copias de seguridad especificado.  
Patrón: `^[0-9]{12}$` 

 ** [backupVaultName](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-request-uri-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetRecoveryPointRestoreMetadata_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetRecoveryPointRestoreMetadata_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "RecoveryPointArn": "string",
   "ResourceType": "string",
   "RestoreMetadata": { 
      "string" : "string" 
   }
}
```

## Elementos de respuesta
<a name="API_GetRecoveryPointRestoreMetadata_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-BackupVaultArn"></a>
Un ARN que identifica de forma exclusiva un almacén de copias de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [RecoveryPointArn](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [ResourceType](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-ResourceType"></a>
El tipo de recurso del punto de recuperación.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreMetadata](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-RestoreMetadata"></a>
El conjunto de pares clave-valor de metadatos que describen la configuración original del recurso del que se ha hecho una copia de seguridad. Estos valores varían en función del servicio que se esté restaurando.  
Tipo: mapa de cadena a cadena

## Errores
<a name="API_GetRecoveryPointRestoreMetadata_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetRecoveryPointRestoreMetadata_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRecoveryPointRestoreMetadata) 

# GetRestoreJobMetadata
<a name="API_GetRestoreJobMetadata"></a>

Esta solicitud devuelve los metadatos del trabajo de restauración especificado.

## Sintaxis de la solicitud
<a name="API_GetRestoreJobMetadata_RequestSyntax"></a>

```
GET /restore-jobs/restoreJobId/metadata HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetRestoreJobMetadata_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [restoreJobId](#API_GetRestoreJobMetadata_RequestSyntax) **   <a name="Backup-GetRestoreJobMetadata-request-uri-RestoreJobId"></a>
Se trata de un identificador único de un trabajo de restauración interno AWS Backup.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetRestoreJobMetadata_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetRestoreJobMetadata_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Metadata": { 
      "string" : "string" 
   },
   "RestoreJobId": "string"
}
```

## Elementos de respuesta
<a name="API_GetRestoreJobMetadata_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Metadata](#API_GetRestoreJobMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreJobMetadata-response-Metadata"></a>
Contiene los metadatos del trabajo de copia de seguridad especificado.  
Tipo: mapa de cadena a cadena

 ** [RestoreJobId](#API_GetRestoreJobMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreJobMetadata-response-RestoreJobId"></a>
Se trata de un identificador único de un trabajo de restauración interno AWS Backup.  
Tipo: cadena

## Errores
<a name="API_GetRestoreJobMetadata_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetRestoreJobMetadata_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreJobMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreJobMetadata) 

# GetRestoreTestingInferredMetadata
<a name="API_GetRestoreTestingInferredMetadata"></a>

Esta solicitud devuelve el conjunto mínimo de metadatos necesario para iniciar un trabajo de restauración con una configuración predeterminada segura. `BackupVaultName` y `RecoveryPointArn` son parámetros obligatorios. `BackupVaultAccountId` es un parámetro opcional.

## Sintaxis de la solicitud
<a name="API_GetRestoreTestingInferredMetadata_RequestSyntax"></a>

```
GET /restore-testing/inferred-metadata?BackupVaultAccountId=BackupVaultAccountId&BackupVaultName=BackupVaultName&RecoveryPointArn=RecoveryPointArn HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetRestoreTestingInferredMetadata_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultAccountId](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-BackupVaultAccountId"></a>
El identificador de cuenta del almacén de copias de seguridad especificado.

 ** [BackupVaultName](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon. Constan de letras minúsculas, números y guiones.  
Obligatorio: sí

 ** [RecoveryPointArn](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetRestoreTestingInferredMetadata_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetRestoreTestingInferredMetadata_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "InferredMetadata": { 
      "string" : "string" 
   }
}
```

## Elementos de respuesta
<a name="API_GetRestoreTestingInferredMetadata_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [InferredMetadata](#API_GetRestoreTestingInferredMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-response-InferredMetadata"></a>
Es un mapa de cadenas de los metadatos inferidos de la solicitud.  
Tipo: mapa de cadena a cadena

## Errores
<a name="API_GetRestoreTestingInferredMetadata_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetRestoreTestingInferredMetadata_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreTestingInferredMetadata) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreTestingInferredMetadata) 

# GetRestoreTestingPlan
<a name="API_GetRestoreTestingPlan"></a>

Devuelve los detalles del `RestoreTestingPlan` para el `RestoreTestingPlanName` especificado. Los detalles son el cuerpo de un plan de prueba de restauración en formato JSON, además de los metadatos del plan.

## Sintaxis de la solicitud
<a name="API_GetRestoreTestingPlan_RequestSyntax"></a>

```
GET /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetRestoreTestingPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_GetRestoreTestingPlan_RequestSyntax) **   <a name="Backup-GetRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
Nombre único obligatorio del plan de prueba de restauración.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetRestoreTestingPlan_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreTestingPlan": { 
      "CreationTime": number,
      "CreatorRequestId": "string",
      "LastExecutionTime": number,
      "LastUpdateTime": number,
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "RestoreTestingPlanArn": "string",
      "RestoreTestingPlanName": "string",
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   }
}
```

## Elementos de respuesta
<a name="API_GetRestoreTestingPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [RestoreTestingPlan](#API_GetRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-GetRestoreTestingPlan-response-RestoreTestingPlan"></a>
Especifica el cuerpo de un plan de prueba de restauración. Incluye `RestoreTestingPlanName`.  
Tipo: objeto [RestoreTestingPlanForGet](API_RestoreTestingPlanForGet.md)

## Errores
<a name="API_GetRestoreTestingPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetRestoreTestingPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreTestingPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreTestingPlan) 

# GetRestoreTestingSelection
<a name="API_GetRestoreTestingSelection"></a>

Devuelve RestoreTestingSelection, que muestra los recursos y elementos del plan de pruebas de restauración.

## Sintaxis de la solicitud
<a name="API_GetRestoreTestingSelection_RequestSyntax"></a>

```
GET /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetRestoreTestingSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_GetRestoreTestingSelection_RequestSyntax) **   <a name="Backup-GetRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
Nombre único obligatorio del plan de prueba de restauración.  
Obligatorio: sí

 ** [RestoreTestingSelectionName](#API_GetRestoreTestingSelection_RequestSyntax) **   <a name="Backup-GetRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
Nombre único obligatorio de la selección de pruebas de restauración.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetRestoreTestingSelection_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreTestingSelection": { 
      "CreationTime": number,
      "CreatorRequestId": "string",
      "IamRoleArn": "string",
      "ProtectedResourceArns": [ "string" ],
      "ProtectedResourceConditions": { 
         "StringEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      },
      "ProtectedResourceType": "string",
      "RestoreMetadataOverrides": { 
         "string" : "string" 
      },
      "RestoreTestingPlanName": "string",
      "RestoreTestingSelectionName": "string",
      "ValidationWindowHours": number
   }
}
```

## Elementos de respuesta
<a name="API_GetRestoreTestingSelection_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [RestoreTestingSelection](#API_GetRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-GetRestoreTestingSelection-response-RestoreTestingSelection"></a>
Nombre único de la selección de pruebas de restauración.  
Tipo: objeto [RestoreTestingSelectionForGet](API_RestoreTestingSelectionForGet.md)

## Errores
<a name="API_GetRestoreTestingSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetRestoreTestingSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreTestingSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreTestingSelection) 

# GetSupportedResourceTypes
<a name="API_GetSupportedResourceTypes"></a>

Devuelve los tipos AWS de recursos admitidos por AWS Backup.

## Sintaxis de la solicitud
<a name="API_GetSupportedResourceTypes_RequestSyntax"></a>

```
GET /supported-resource-types HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetSupportedResourceTypes_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_GetSupportedResourceTypes_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetSupportedResourceTypes_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ResourceTypes": [ "string" ]
}
```

## Elementos de respuesta
<a name="API_GetSupportedResourceTypes_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ResourceTypes](#API_GetSupportedResourceTypes_ResponseSyntax) **   <a name="Backup-GetSupportedResourceTypes-response-ResourceTypes"></a>
Contiene una cadena con los tipos de AWS recursos admitidos:  
+  `Aurora` para Amazon Aurora
+  `CloudFormation`para AWS CloudFormation 
+  `DocumentDB` para Amazon DocumentDB (compatible 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
+  `EKS` para Amazon Elastic Kubernetes Service
+  `FSx`para Amazon FSx
+  `Neptune` para Amazon Neptune
+  `RDS` para Amazon Relational Database Service
+  `Redshift` para Amazon Redshift
+  `S3` para Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2` para bases de datos de SAP HANA en instancias de Amazon Elastic Compute Cloud
+  `Storage Gateway`para AWS Storage Gateway 
+  `Timestream` para Amazon Timestream
+  `VirtualMachine`para máquinas VMware virtuales
Tipo: matriz de cadenas  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

## Errores
<a name="API_GetSupportedResourceTypes_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetSupportedResourceTypes_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetSupportedResourceTypes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetSupportedResourceTypes) 

# GetTieringConfiguration
<a name="API_GetTieringConfiguration"></a>

Devuelve los detalles del `TieringConfiguration` para el `TieringConfigurationName` especificado. Los detalles son el cuerpo de una configuración por niveles en formato JSON, además de los metadatos de configuración.

## Sintaxis de la solicitud
<a name="API_GetTieringConfiguration_RequestSyntax"></a>

```
GET /tiering-configurations/tieringConfigurationName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetTieringConfiguration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [tieringConfigurationName](#API_GetTieringConfiguration_RequestSyntax) **   <a name="Backup-GetTieringConfiguration-request-uri-TieringConfigurationName"></a>
El nombre exclusivo de una configuración de organización por niveles.  
Patrón: `^[a-zA-Z0-9_]{1,200}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetTieringConfiguration_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "CreationTime": number,
      "CreatorRequestId": "string",
      "LastUpdatedTime": number,
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationArn": "string",
      "TieringConfigurationName": "string"
   }
}
```

## Elementos de respuesta
<a name="API_GetTieringConfiguration_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [TieringConfiguration](#API_GetTieringConfiguration_ResponseSyntax) **   <a name="Backup-GetTieringConfiguration-response-TieringConfiguration"></a>
Especifica el cuerpo de una configuración de estratificación. Incluye `TieringConfigurationName`.  
Tipo: objeto [TieringConfiguration](API_TieringConfiguration.md)

## Errores
<a name="API_GetTieringConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_GetTieringConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetTieringConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetTieringConfiguration) 

# ListBackupJobs
<a name="API_ListBackupJobs"></a>

Devuelve una lista de los trabajos de copia de seguridad existentes para una cuenta autenticada durante los últimos 30 días. Para un periodo de tiempo más prolongado, considere la posibilidad de utilizar estas [herramientas de monitorización](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html).

## Sintaxis de la solicitud
<a name="API_ListBackupJobs_RequestSyntax"></a>

```
GET /backup-jobs/?accountId=ByAccountId&backupVaultName=ByBackupVaultName&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByAccountId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByAccountId"></a>
El ID de la cuenta desde la que se van a enumerar los trabajos. Devuelve solo los trabajos de copia de seguridad asociados al ID de cuenta especificado.  
Si se usa desde una cuenta AWS Organizations de administración, la `*` transferencia devuelve todos los trabajos de la organización.  
Patrón: `^[0-9]{12}$` 

 ** [ByBackupVaultName](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByBackupVaultName"></a>
Devuelve solo los trabajos de copia de seguridad que se almacenarán en el almacén de copias de seguridad especificado. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [ByCompleteAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteAfter"></a>
Devuelve solo los trabajos de copia de seguridad completados después de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCompleteBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteBefore"></a>
Devuelve solo los trabajos de copia de seguridad completados antes de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCreatedAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedAfter"></a>
Devuelve solo los trabajos de copia de seguridad que se crearon después de la fecha especificada.

 ** [ByCreatedBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedBefore"></a>
Devuelve solo los trabajos de copia de seguridad que se crearon antes de la fecha especificada.

 ** [ByMessageCategory](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByMessageCategory"></a>
Se trata de un parámetro opcional que se puede utilizar para filtrar los trabajos con un valor MessageCategory que coincida con el valor introducido.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` y `InvalidParameters`.  
Vista [Monitorización](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)   
El comodín () devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.

 ** [ByParentJobId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByParentJobId"></a>
Se trata de un filtro para enumerar los trabajos secundarios (anidados) en función del ID del trabajo principal.

 ** [ByResourceArn](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceArn"></a>
Devuelve solo los trabajos de copia de seguridad que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado.

 ** [ByResourceType](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceType"></a>
Devuelve únicamente los trabajos de copia de seguridad de los recursos especificados:  
+  `Aurora` para Amazon Aurora
+  `CloudFormation`para AWS CloudFormation 
+  `DocumentDB` para Amazon DocumentDB (compatible 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
+  `EKS` para Amazon Elastic Kubernetes Service
+  `FSx`para Amazon FSx
+  `Neptune` para Amazon Neptune
+  `RDS` para Amazon Relational Database Service
+  `Redshift` para Amazon Redshift
+  `S3` para Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2` para bases de datos de SAP HANA en instancias de Amazon Elastic Compute Cloud
+  `Storage Gateway`para AWS Storage Gateway 
+  `Timestream` para Amazon Timestream
+  `VirtualMachine`para máquinas VMware virtuales
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ByState](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByState"></a>
Devuelve solo los trabajos de copia de seguridad que se encuentran en el estado especificado.  
 `Completed with issues` es un estado que solo se encuentra en la consola de AWS Backup . En el caso de la API, este estado se refiere a los trabajos con un estado de `MessageCategory` y una `SUCCESS` con un valor distinto de `COMPLETED`; es decir, el estado se ha completado pero genera un mensaje de estado.  
Para obtener el recuento de trabajos de `Completed with issues`, ejecute dos solicitudes GET y reste el segundo número, más pequeño:  
GET /backup-jobs/?state=COMPLETED  
GET /backup-jobs/?messageCategory=SUCCESS&state=COMPLETED  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [MaxResults](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-MaxResults"></a>
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](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-NextToken"></a>
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
<a name="API_ListBackupJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupJobs": [ 
      { 
         "AccountId": "string",
         "BackupJobId": "string",
         "BackupOptions": { 
            "string" : "string" 
         },
         "BackupSizeInBytes": number,
         "BackupType": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "BytesTransferred": number,
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "ExpectedCompletionDate": number,
         "IamRoleArn": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "MessageCategory": "string",
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "StartBy": number,
         "State": "string",
         "StatusMessage": "string",
         "VaultLockState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupJobs](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-BackupJobs"></a>
Una matriz de estructuras que contiene metadatos sobre trabajos de copia de seguridad devueltos en formato JSON.  
Tipo: matriz de objetos [BackupJob](API_BackupJob.md)

 ** [NextToken](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-NextToken"></a>
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

## Errores
<a name="API_ListBackupJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupJobs) 

# ListBackupJobSummaries
<a name="API_ListBackupJobSummaries"></a>

Es una solicitud de resumen de trabajos de copia de seguridad creados o en ejecución en los 30 últimos días. Puede incluir los parámetros AccountID, State,,, ResourceType MessageCategory AggregationPeriod MaxResults, NextToken o para filtrar los resultados.

Esta solicitud devuelve un resumen que contiene la región, la cuenta, el estado, ResourceType, MessageCategory StartTime EndTime, y el recuento de los trabajos incluidos.

## Sintaxis de la solicitud
<a name="API_ListBackupJobSummaries_RequestSyntax"></a>

```
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupJobSummaries_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AccountId](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AccountId"></a>
Devuelve el recuento de trabajos de la cuenta especificada.  
Si la solicitud se envía desde una cuenta de miembro o una cuenta que no forma parte de AWS Organizations, se devolverán los trabajos de la cuenta del solicitante.  
Las cuentas raíz, de administrador y de administrador delegado pueden utilizar el valor ANY para devolver recuentos de trabajos de todas las cuentas de la organización.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las cuentas de la organización autenticada y, a continuación, devuelve la suma.  
Patrón: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`: el recuento de trabajos diarios de los 14 días anteriores.
+  `SEVEN_DAYS`: el recuento total de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`: el recuento total de trabajos de los 14 días anteriores.
Valores válidos: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MaxResults](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-MaxResults"></a>
Número máximo de elementos que se van a devolver.  
El valor es un entero. El rango de valores aceptados está entre 1 y 500.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [MessageCategory](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-MessageCategory"></a>
Este parámetro devuelve el recuento de trabajos de la categoría de mensajes especificada.  
Ejemplos de cadenas aceptadas son `AccessDenied`, `Success` y `InvalidParameters`. Consulte [Supervisión](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) para ver una lista de las cadenas aceptadas MessageCategory .  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.

 ** [NextToken](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [ResourceType](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-ResourceType"></a>
Devuelve el recuento de trabajos del tipo de recurso especificado. Utilice `GetSupportedResourceTypes` de solicitud para obtener cadenas para los tipos de recursos compatibles.  
El valor ANY devuelve el recuento de todos los tipos de recursos.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de recursos y devuelve la suma.  
El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-State"></a>
Este parámetro devuelve el recuento de los trabajos con el estado especificado.  
El valor ANY devuelve el recuento de todos los estados.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de estados y devuelve la suma.  
 `Completed with issues` es un estado que solo se encuentra en la consola de AWS Backup . En el caso de la API, este estado se refiere a los trabajos con un estado de `MessageCategory` y una `SUCCESS` con un valor distinto de `COMPLETED`; es decir, el estado se ha completado pero genera un mensaje de estado. Para obtener el recuento de trabajos de `Completed with issues`, ejecute dos solicitudes GET y reste el segundo número, más pequeño:  
¿OBTENER /audit/? backup-job-summaries AggregationPeriod=Catorce días&STATE=Completado  
¿OBTENER /audit/? backup-job-summaries AggregationPeriodMessageCategory=CATORCEEN\$1DÍAS& =ÉXITO&ESTADO=Completado  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY` 

## Cuerpo de la solicitud
<a name="API_ListBackupJobSummaries_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "BackupJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MessageCategory": "string",
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupJobSummaries_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AggregationPeriod](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`: el recuento de trabajos diarios de los 14 días anteriores.
+  `SEVEN_DAYS`: el recuento total de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`: el recuento total de trabajos de los 14 días anteriores.
Tipo: cadena

 ** [BackupJobSummaries](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-BackupJobSummaries"></a>
La información del resumen.  
Tipo: matriz de objetos [BackupJobSummary](API_BackupJobSummary.md)

 ** [NextToken](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

## Errores
<a name="API_ListBackupJobSummaries_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupJobSummaries_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos, consulte lo siguiente: AWS SDKs
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupJobSummaries) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupJobSummaries) 

# ListBackupPlans
<a name="API_ListBackupPlans"></a>

Muestra los planes de copia de seguridad activos de la cuenta.

## Sintaxis de la solicitud
<a name="API_ListBackupPlans_RequestSyntax"></a>

```
GET /backup/plans/?includeDeleted=IncludeDeleted&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupPlans_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [IncludeDeleted](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-IncludeDeleted"></a>
Un valor booleano con un valor predeterminado de `FALSE` que devuelve los planes de copia de seguridad eliminados si se establece en `TRUE`.

 ** [MaxResults](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-MaxResults"></a>
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](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-NextToken"></a>
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
<a name="API_ListBackupPlans_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupPlans_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlansList": [ 
      { 
         "AdvancedBackupSettings": [ 
            { 
               "BackupOptions": { 
                  "string" : "string" 
               },
               "ResourceType": "string"
            }
         ],
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "DeletionDate": number,
         "LastExecutionDate": number,
         "VersionId": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupPlans_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlansList](#API_ListBackupPlans_ResponseSyntax) **   <a name="Backup-ListBackupPlans-response-BackupPlansList"></a>
Información sobre los planes de copia de seguridad.  
Tipo: matriz de objetos [BackupPlansListMember](API_BackupPlansListMember.md)

 ** [NextToken](#API_ListBackupPlans_ResponseSyntax) **   <a name="Backup-ListBackupPlans-response-NextToken"></a>
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

## Errores
<a name="API_ListBackupPlans_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupPlans_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupPlans) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupPlans) 

# ListBackupPlanTemplates
<a name="API_ListBackupPlanTemplates"></a>

Muestra las plantillas del plan de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_ListBackupPlanTemplates_RequestSyntax"></a>

```
GET /backup/template/plans?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupPlanTemplates_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListBackupPlanTemplates_RequestSyntax) **   <a name="Backup-ListBackupPlanTemplates-request-uri-MaxResults"></a>
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](#API_ListBackupPlanTemplates_RequestSyntax) **   <a name="Backup-ListBackupPlanTemplates-request-uri-NextToken"></a>
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
<a name="API_ListBackupPlanTemplates_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupPlanTemplates_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanTemplatesList": [ 
      { 
         "BackupPlanTemplateId": "string",
         "BackupPlanTemplateName": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupPlanTemplates_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanTemplatesList](#API_ListBackupPlanTemplates_ResponseSyntax) **   <a name="Backup-ListBackupPlanTemplates-response-BackupPlanTemplatesList"></a>
Una matriz de elementos de la lista de plantillas que contiene metadatos sobre las plantillas guardadas.  
Tipo: matriz de objetos [BackupPlanTemplatesListMember](API_BackupPlanTemplatesListMember.md)

 ** [NextToken](#API_ListBackupPlanTemplates_ResponseSyntax) **   <a name="Backup-ListBackupPlanTemplates-response-NextToken"></a>
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

## Errores
<a name="API_ListBackupPlanTemplates_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupPlanTemplates_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupPlanTemplates) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupPlanTemplates) 

# ListBackupPlanVersions
<a name="API_ListBackupPlanVersions"></a>

Devuelve los metadatos de las versiones de sus planes de copia de seguridad, incluidos los nombres de los recursos de Amazon (ARNs), el plan de copia de seguridad IDs, las fechas de creación y eliminación, los nombres de los planes y la versión IDs.

## Sintaxis de la solicitud
<a name="API_ListBackupPlanVersions_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/versions/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupPlanVersions_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

 ** [MaxResults](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-MaxResults"></a>
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](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-NextToken"></a>
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
<a name="API_ListBackupPlanVersions_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupPlanVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanVersionsList": [ 
      { 
         "AdvancedBackupSettings": [ 
            { 
               "BackupOptions": { 
                  "string" : "string" 
               },
               "ResourceType": "string"
            }
         ],
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "DeletionDate": number,
         "LastExecutionDate": number,
         "VersionId": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupPlanVersions_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupPlanVersionsList](#API_ListBackupPlanVersions_ResponseSyntax) **   <a name="Backup-ListBackupPlanVersions-response-BackupPlanVersionsList"></a>
Una matriz de elementos de la lista de versiones que contiene metadatos sobre sus planes de copia de seguridad.  
Tipo: matriz de objetos [BackupPlansListMember](API_BackupPlansListMember.md)

 ** [NextToken](#API_ListBackupPlanVersions_ResponseSyntax) **   <a name="Backup-ListBackupPlanVersions-response-NextToken"></a>
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

## Errores
<a name="API_ListBackupPlanVersions_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupPlanVersions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupPlanVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupPlanVersions) 

# ListBackupSelections
<a name="API_ListBackupSelections"></a>

Devuelve una matriz que contiene los metadatos de los recursos asociados al plan de copia de seguridad de destino.

## Sintaxis de la solicitud
<a name="API_ListBackupSelections_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/selections/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupSelections_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Obligatorio: sí

 ** [MaxResults](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-MaxResults"></a>
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](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-NextToken"></a>
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
<a name="API_ListBackupSelections_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupSelections_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupSelectionsList": [ 
      { 
         "BackupPlanId": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "IamRoleArn": "string",
         "SelectionId": "string",
         "SelectionName": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupSelections_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupSelectionsList](#API_ListBackupSelections_ResponseSyntax) **   <a name="Backup-ListBackupSelections-response-BackupSelectionsList"></a>
Una matriz de elementos de la lista de selección de copias de seguridad que contiene metadatos sobre cada recurso de la lista.  
Tipo: matriz de objetos [BackupSelectionsListMember](API_BackupSelectionsListMember.md)

 ** [NextToken](#API_ListBackupSelections_ResponseSyntax) **   <a name="Backup-ListBackupSelections-response-NextToken"></a>
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

## Errores
<a name="API_ListBackupSelections_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupSelections_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupSelections) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupSelections) 

# ListBackupVaults
<a name="API_ListBackupVaults"></a>

Devuelve una lista de contenedores de almacenamiento de puntos de recuperación junto con información sobre ellos.

## Sintaxis de la solicitud
<a name="API_ListBackupVaults_RequestSyntax"></a>

```
GET /backup-vaults/?maxResults=MaxResults&nextToken=NextToken&shared=ByShared&vaultType=ByVaultType HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListBackupVaults_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByShared](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-ByShared"></a>
Este parámetro ordenará la lista de almacenes por almacenes compartidos.

 ** [ByVaultType](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-ByVaultType"></a>
Este parámetro ordenará la lista de almacenes por tipo de almacén.  
Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

 ** [MaxResults](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-MaxResults"></a>
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](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-NextToken"></a>
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
<a name="API_ListBackupVaults_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListBackupVaults_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultList": [ 
      { 
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "LockDate": number,
         "Locked": boolean,
         "MaxRetentionDays": number,
         "MinRetentionDays": number,
         "NumberOfRecoveryPoints": number,
         "VaultState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBackupVaults_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultList](#API_ListBackupVaults_ResponseSyntax) **   <a name="Backup-ListBackupVaults-response-BackupVaultList"></a>
Una matriz de miembros de la lista del almacén de copias de seguridad que contiene metadatos del almacén, como el nombre de recurso de Amazon (ARN), el nombre de visualización, la fecha de creación, el número de puntos de recuperación guardados y la información de cifrado si los recursos guardados en el almacén de copias de seguridad están cifrados.  
Tipo: matriz de objetos [BackupVaultListMember](API_BackupVaultListMember.md)

 ** [NextToken](#API_ListBackupVaults_ResponseSyntax) **   <a name="Backup-ListBackupVaults-response-NextToken"></a>
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

## Errores
<a name="API_ListBackupVaults_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListBackupVaults_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupVaults) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupVaults) 

# ListCopyJobs
<a name="API_ListCopyJobs"></a>

Devuelve los metadatos de los trabajos de copia.

## Sintaxis de la solicitud
<a name="API_ListCopyJobs_RequestSyntax"></a>

```
GET /copy-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&destinationVaultArn=ByDestinationVaultArn&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&sourceRecoveryPointArn=BySourceRecoveryPointArn&state=ByState HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListCopyJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByAccountId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByAccountId"></a>
El ID de la cuenta desde la que se van a enumerar los trabajos. Devuelve solo los trabajos de copia asociados al ID de cuenta especificado.  
Patrón: `^[0-9]{12}$` 

 ** [ByCompleteAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteAfter"></a>
Devuelve solo los trabajos de copia completados después de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCompleteBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteBefore"></a>
Devuelve solo los trabajos de copia completados antes de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCreatedAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedAfter"></a>
Devuelve solo los trabajos de copia que se crearon después de la fecha especificada.

 ** [ByCreatedBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedBefore"></a>
Devuelve solo los trabajos de copia que se crearon antes de la fecha especificada.

 ** [ByDestinationVaultArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByDestinationVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad de origen desde el que realizar copias; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. 

 ** [ByMessageCategory](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByMessageCategory"></a>
Se trata de un parámetro opcional que se puede utilizar para filtrar los trabajos con un valor MessageCategory que coincida con el valor introducido.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` y `INVALIDPARAMETERS`.  
Consulte en [Monitorización](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) una lista de cadenas aceptadas.  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.

 ** [ByParentJobId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByParentJobId"></a>
Se trata de un filtro para enumerar los trabajos secundarios (anidados) en función del ID del trabajo principal.

 ** [ByResourceArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceArn"></a>
Devuelve solo los trabajos de copia que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado. 

 ** [ByResourceType](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceType"></a>
Devuelve únicamente los trabajos de copia de seguridad de los recursos especificados:  
+  `Aurora` para Amazon Aurora
+  `CloudFormation`para AWS CloudFormation 
+  `DocumentDB` para Amazon DocumentDB (compatible 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
+  `EKS` para Amazon Elastic Kubernetes Service
+  `FSx`para Amazon FSx
+  `Neptune` para Amazon Neptune
+  `RDS` para Amazon Relational Database Service
+  `Redshift` para Amazon Redshift
+  `S3` para Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2` para bases de datos de SAP HANA en instancias de Amazon Elastic Compute Cloud
+  `Storage Gateway`para AWS Storage Gateway 
+  `Timestream` para Amazon Timestream
+  `VirtualMachine`para máquinas VMware virtuales
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [BySourceRecoveryPointArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-BySourceRecoveryPointArn"></a>
Filtra los trabajos de copia por el punto de recuperación de origen especificado (ARN).

 ** [ByState](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByState"></a>
Devuelve solo los trabajos de copia que se encuentran en el estado especificado.  
Valores válidos: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL` 

 ** [MaxResults](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-MaxResults"></a>
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](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el MaxResults número de artículos NextToken , podrá devolver más artículos de la lista empezando por la ubicación indicada por el siguiente token. 

## Cuerpo de la solicitud
<a name="API_ListCopyJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListCopyJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CopyJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "ChildJobsInState": { 
            "string" : number 
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CopyJobId": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreatedByBackupJobId": "string",
         "CreationDate": number,
         "DestinationBackupVaultArn": "string",
         "DestinationEncryptionKeyArn": "string",
         "DestinationRecoveryPointArn": "string",
         "DestinationRecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "DestinationVaultLockState": "string",
         "DestinationVaultType": "string",
         "IamRoleArn": "string",
         "IsParent": boolean,
         "MessageCategory": "string",
         "NumberOfChildJobs": number,
         "ParentJobId": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "string",
         "SourceRecoveryPointArn": "string",
         "State": "string",
         "StatusMessage": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListCopyJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CopyJobs](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-CopyJobs"></a>
Una matriz de estructuras que contiene metadatos sobre trabajos de copia devueltos en formato JSON.   
Tipo: matriz de objetos [CopyJob](API_CopyJob.md)

 ** [NextToken](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el MaxResults número de NextToken artículos, podrás devolver más artículos de la lista empezando por la ubicación que indique el siguiente token.   
Tipo: cadena

## Errores
<a name="API_ListCopyJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListCopyJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobs) 

# ListCopyJobSummaries
<a name="API_ListCopyJobSummaries"></a>

Esta solicitud obtiene una lista de trabajos de copia creados o en ejecución en los 30 últimos días. Puede incluir los parámetros AccountID, State,,, ResourceType MessageCategory AggregationPeriod MaxResults, NextToken o para filtrar los resultados.

Esta solicitud devuelve un resumen que contiene la región, la cuenta, el estado, RestourceType, MessageCategory StartTime EndTime, y el recuento de los trabajos incluidos.

## Sintaxis de la solicitud
<a name="API_ListCopyJobSummaries_RequestSyntax"></a>

```
GET /audit/copy-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListCopyJobSummaries_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AccountId](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-AccountId"></a>
Devuelve el recuento de trabajos de la cuenta especificada.  
Si la solicitud se envía desde una cuenta de miembro o desde una cuenta que no forma parte de AWS Organizations, se devolverán los trabajos de la cuenta del solicitante.  
Las cuentas raíz, de administrador y de administrador delegado pueden utilizar el valor ANY para devolver recuentos de trabajos de todas las cuentas de la organización.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las cuentas de la organización autenticada y, a continuación, devuelve la suma.  
Patrón: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`: el recuento de trabajos diarios de los 14 días anteriores.
+  `SEVEN_DAYS`: el recuento total de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`: el recuento total de trabajos de los 14 días anteriores.
Valores válidos: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MaxResults](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-MaxResults"></a>
Este parámetro establece el número máximo de elementos que se van a devolver.  
El valor es un entero. El rango de valores aceptados está entre 1 y 500.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [MessageCategory](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-MessageCategory"></a>
Este parámetro devuelve el recuento de trabajos de la categoría de mensajes especificada.  
Ejemplos de cadenas aceptadas son `AccessDenied`, `Success` y `InvalidParameters`. Consulte [Supervisión](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) para ver una lista de las cadenas aceptadas MessageCategory .  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.

 ** [NextToken](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [ResourceType](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-ResourceType"></a>
Devuelve el recuento de trabajos del tipo de recurso especificado. Utilice `GetSupportedResourceTypes` de solicitud para obtener cadenas para los tipos de recursos compatibles.  
El valor ANY devuelve el recuento de todos los tipos de recursos.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de recursos y devuelve la suma.  
El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-State"></a>
Este parámetro devuelve el recuento de los trabajos con el estado especificado.  
El valor ANY devuelve el recuento de todos los estados.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de estados y devuelve la suma.  
Valores válidos: `CREATED | RUNNING | ABORTING | ABORTED | COMPLETING | COMPLETED | FAILING | FAILED | PARTIAL | AGGREGATE_ALL | ANY` 

## Cuerpo de la solicitud
<a name="API_ListCopyJobSummaries_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListCopyJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "CopyJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MessageCategory": "string",
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListCopyJobSummaries_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AggregationPeriod](#API_ListCopyJobSummaries_ResponseSyntax) **   <a name="Backup-ListCopyJobSummaries-response-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`: el recuento de trabajos diarios de los 14 días anteriores.
+  `SEVEN_DAYS`: el recuento total de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`: el recuento total de trabajos de los 14 días anteriores.
Tipo: cadena

 ** [CopyJobSummaries](#API_ListCopyJobSummaries_ResponseSyntax) **   <a name="Backup-ListCopyJobSummaries-response-CopyJobSummaries"></a>
Esta devolución muestra un resumen que contiene la región, la cuenta, el estado,, ResourceType MessageCategory StartTime EndTime, y el recuento de los trabajos incluidos.  
Tipo: matriz de objetos [CopyJobSummary](API_CopyJobSummary.md)

 ** [NextToken](#API_ListCopyJobSummaries_ResponseSyntax) **   <a name="Backup-ListCopyJobSummaries-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

## Errores
<a name="API_ListCopyJobSummaries_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListCopyJobSummaries_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobSummaries) 

# ListFrameworks
<a name="API_ListFrameworks"></a>

Devuelve una lista de todos los marcos de un Cuenta de AWS y Región de AWS.

## Sintaxis de la solicitud
<a name="API_ListFrameworks_RequestSyntax"></a>

```
GET /audit/frameworks?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListFrameworks_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListFrameworks_RequestSyntax) **   <a name="Backup-ListFrameworks-request-uri-MaxResults"></a>
El número de resultados deseados va de 1 a 1000. Opcional. Si no se especifica, la consulta devolverá 1 MB de datos.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListFrameworks_RequestSyntax) **   <a name="Backup-ListFrameworks-request-uri-NextToken"></a>
Un identificador que se devolvió de la llamada anterior a esta operación, que se puede usar para devolver el siguiente conjunto de elementos de la lista.

## Cuerpo de la solicitud
<a name="API_ListFrameworks_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListFrameworks_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Frameworks": [ 
      { 
         "CreationTime": number,
         "DeploymentStatus": "string",
         "FrameworkArn": "string",
         "FrameworkDescription": "string",
         "FrameworkName": "string",
         "NumberOfControls": number
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListFrameworks_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Frameworks](#API_ListFrameworks_ResponseSyntax) **   <a name="Backup-ListFrameworks-response-Frameworks"></a>
Los marcos con detalles de cada marco, incluidos el nombre del marco, el nombre de recurso de Amazon (ARN), la descripción, el número de controles, la hora de creación y el estado de la implementación.  
Tipo: matriz de objetos [Framework](API_Framework.md)

 ** [NextToken](#API_ListFrameworks_ResponseSyntax) **   <a name="Backup-ListFrameworks-response-NextToken"></a>
Un identificador que se devolvió de la llamada anterior a esta operación, que se puede usar para devolver el siguiente conjunto de elementos de la lista.  
Tipo: cadena

## Errores
<a name="API_ListFrameworks_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListFrameworks_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListFrameworks) 

# ListIndexedRecoveryPoints
<a name="API_ListIndexedRecoveryPoints"></a>

Esta operación devuelve una lista de puntos de recuperación que tienen un índice asociado que pertenece a la cuenta especificada.

Los parámetros opcionales que puede incluir son: MaxResults NextToken; SourceResourceArns; CreatedBefore; CreatedAfter; y ResourceType.

## Sintaxis de la solicitud
<a name="API_ListIndexedRecoveryPoints_RequestSyntax"></a>

```
GET /indexes/recovery-point/?createdAfter=CreatedAfter&createdBefore=CreatedBefore&indexStatus=IndexStatus&maxResults=MaxResults&nextToken=NextToken&resourceType=ResourceType&sourceResourceArn=SourceResourceArn HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListIndexedRecoveryPoints_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [CreatedAfter](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-CreatedAfter"></a>
Devuelve solo los puntos de recuperación indexados creados tras la fecha especificada.

 ** [CreatedBefore](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-CreatedBefore"></a>
Devuelve solo los puntos de recuperación indexados creados antes de la fecha especificada.

 ** [IndexStatus](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-IndexStatus"></a>
Incluya este parámetro para filtrar la lista devuelta según los estados indicados.  
Valores aceptados: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [MaxResults](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-NextToken"></a>
Es el elemento que sigue a una lista parcial de los puntos de recuperación devueltos.  
Por ejemplo, si se solicita que se devuelva el número `MaxResults` de puntos de recuperación indexados, `NextToken` le permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [ResourceType](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-ResourceType"></a>
Devuelve una lista de puntos de recuperación indexados para el tipo o los tipos de recurso especificados.  
Los valores aceptados son:  
+  `EBS` para Amazon Elastic Block Store (EBS)
+  `S3` para Amazon Simple Storage Service (Amazon S3)
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [SourceResourceArn](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-SourceResourceArn"></a>
Es una cadena de un Nombre de recurso de Amazon (ARN) que identifica de forma unívoca un recurso de origen.

## Cuerpo de la solicitud
<a name="API_ListIndexedRecoveryPoints_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListIndexedRecoveryPoints_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "IndexedRecoveryPoints": [ 
      { 
         "BackupCreationDate": number,
         "BackupVaultArn": "string",
         "IamRoleArn": "string",
         "IndexCreationDate": number,
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "RecoveryPointArn": "string",
         "ResourceType": "string",
         "SourceResourceArn": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListIndexedRecoveryPoints_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [IndexedRecoveryPoints](#API_ListIndexedRecoveryPoints_ResponseSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-response-IndexedRecoveryPoints"></a>
Es una lista de puntos de recuperación que tienen un índice asociado que pertenece a la cuenta especificada.  
Tipo: matriz de objetos [IndexedRecoveryPoint](API_IndexedRecoveryPoint.md)

 ** [NextToken](#API_ListIndexedRecoveryPoints_ResponseSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-response-NextToken"></a>
Es el elemento que sigue a una lista parcial de los puntos de recuperación devueltos.  
Por ejemplo, si se solicita que se devuelva el número `MaxResults` de puntos de recuperación indexados, `NextToken` le permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

## Errores
<a name="API_ListIndexedRecoveryPoints_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListIndexedRecoveryPoints_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListIndexedRecoveryPoints) 

# ListLegalHolds
<a name="API_ListLegalHolds"></a>

Esta acción devuelve metadatos sobre las retenciones legales activas y anteriores.

## Sintaxis de la solicitud
<a name="API_ListLegalHolds_RequestSyntax"></a>

```
GET /legal-holds/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListLegalHolds_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListLegalHolds_RequestSyntax) **   <a name="Backup-ListLegalHolds-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListLegalHolds_RequestSyntax) **   <a name="Backup-ListLegalHolds-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

## Cuerpo de la solicitud
<a name="API_ListLegalHolds_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListLegalHolds_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LegalHolds": [ 
      { 
         "CancellationDate": number,
         "CreationDate": number,
         "Description": "string",
         "LegalHoldArn": "string",
         "LegalHoldId": "string",
         "Status": "string",
         "Title": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListLegalHolds_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [LegalHolds](#API_ListLegalHolds_ResponseSyntax) **   <a name="Backup-ListLegalHolds-response-LegalHolds"></a>
Se trata de una matriz de retenciones legales devueltas, tanto activas como anteriores.  
Tipo: matriz de objetos [LegalHold](API_LegalHold.md)

 ** [NextToken](#API_ListLegalHolds_ResponseSyntax) **   <a name="Backup-ListLegalHolds-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

## Errores
<a name="API_ListLegalHolds_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListLegalHolds_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListLegalHolds) 

# ListProtectedResources
<a name="API_ListProtectedResources"></a>

Devuelve una matriz de recursos con puntos de recuperación creados por AWS Backup (independientemente del [estado](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRecoveryPoint.html#Backup-DescribeRecoveryPoint-response-Status) del punto de recuperación), incluida la hora en que se guardó el recurso, el nombre de recurso de Amazon (ARN) del recurso y el tipo de recurso.

## Sintaxis de la solicitud
<a name="API_ListProtectedResources_RequestSyntax"></a>

```
GET /resources/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListProtectedResources_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListProtectedResources_RequestSyntax) **   <a name="Backup-ListProtectedResources-request-uri-MaxResults"></a>
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](#API_ListProtectedResources_RequestSyntax) **   <a name="Backup-ListProtectedResources-request-uri-NextToken"></a>
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
<a name="API_ListProtectedResources_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListProtectedResources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { 
         "LastBackupTime": number,
         "LastBackupVaultArn": "string",
         "LastRecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListProtectedResources_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListProtectedResources_ResponseSyntax) **   <a name="Backup-ListProtectedResources-response-NextToken"></a>
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

 ** [Results](#API_ListProtectedResources_ResponseSyntax) **   <a name="Backup-ListProtectedResources-response-Results"></a>
Un conjunto de recursos del que se hizo una copia de seguridad correcta, AWS Backup incluyendo la hora en que se guardó el recurso, el nombre de recurso de Amazon (ARN) del recurso y el tipo de recurso.  
Tipo: matriz de objetos [ProtectedResource](API_ProtectedResource.md)

## Errores
<a name="API_ListProtectedResources_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListProtectedResources_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListProtectedResources) 

# ListProtectedResourcesByBackupVault
<a name="API_ListProtectedResourcesByBackupVault"></a>

En esta solicitud se enumeran los recursos protegidos correspondientes a cada almacén de copias de seguridad.

## Sintaxis de la solicitud
<a name="API_ListProtectedResourcesByBackupVault_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/resources/?backupVaultAccountId=BackupVaultAccountId&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListProtectedResourcesByBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultAccountId](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-BackupVaultAccountId"></a>
La lista de recursos protegidos por almacén de copias de seguridad dentro de los almacenes que especifique mediante el identificador de cuenta.  
Patrón: `^[0-9]{12}$` 

 ** [backupVaultName](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-BackupVaultName"></a>
La lista de recursos protegidos por almacén de copias de seguridad dentro de los almacenes que especifique por nombre.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [MaxResults](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-MaxResults"></a>
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](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-NextToken"></a>
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
<a name="API_ListProtectedResourcesByBackupVault_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListProtectedResourcesByBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { 
         "LastBackupTime": number,
         "LastBackupVaultArn": "string",
         "LastRecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListProtectedResourcesByBackupVault_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListProtectedResourcesByBackupVault_ResponseSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-response-NextToken"></a>
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

 ** [Results](#API_ListProtectedResourcesByBackupVault_ResponseSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-response-Results"></a>
Estos son los resultados devueltos para la solicitud ListProtectedResourcesByBackupVault.  
Tipo: matriz de objetos [ProtectedResource](API_ProtectedResource.md)

## Errores
<a name="API_ListProtectedResourcesByBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListProtectedResourcesByBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 

# ListRecoveryPointsByBackupVault
<a name="API_ListRecoveryPointsByBackupVault"></a>

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

## Sintaxis de la solicitud
<a name="API_ListRecoveryPointsByBackupVault_RequestSyntax"></a>

```
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
<a name="API_ListRecoveryPointsByBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [BackupVaultAccountId](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-BackupVaultAccountId"></a>
Este parámetro ordenará la lista de puntos de recuperación por ID de cuenta.  
Patrón: `^[0-9]{12}$` 

 ** [backupVaultName](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
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](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByBackupPlanId"></a>
Devuelve solo los puntos de recuperación que coinciden con el identificador del plan de copia de seguridad especificado.

 ** [ByCreatedAfter](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByCreatedAfter"></a>
Devuelve solo los puntos de recuperación que se crearon después de la marca de tiempo especificada.

 ** [ByCreatedBefore](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByCreatedBefore"></a>
Devuelve solo los puntos de recuperación que se crearon antes de la marca de tiempo especificada.

 ** [ByParentRecoveryPointArn](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByParentRecoveryPointArn"></a>
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](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByResourceArn"></a>
Devuelve solo los puntos de recuperación que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado.

 ** [ByResourceType](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByResourceType"></a>
Devuelve solo los puntos de recuperación que coinciden con el tipo o los tipos de recurso especificados.  
+  `Aurora` para Amazon Aurora
+  `CloudFormation`para AWS CloudFormation 
+  `DocumentDB` para Amazon DocumentDB (compatible 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
+  `EKS` para Amazon Elastic Kubernetes Service
+  `FSx`para Amazon FSx
+  `Neptune` para Amazon Neptune
+  `RDS` para Amazon Relational Database Service
+  `Redshift` para Amazon Redshift
+  `S3` para Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2` para bases de datos de SAP HANA en instancias de Amazon Elastic Compute Cloud
+  `Storage Gateway`para AWS Storage Gateway 
+  `Timestream` para Amazon Timestream
+  `VirtualMachine`para máquinas VMware virtuales
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [MaxResults](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-MaxResults"></a>
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](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-NextToken"></a>
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
<a name="API_ListRecoveryPointsByBackupVault_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRecoveryPointsByBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "AggregatedScanResult": { 
            "FailedScan": boolean,
            "Findings": [ "string" ],
            "LastComputed": number
         },
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CalculatedLifecycle": { 
            "DeleteAt": number,
            "MoveToColdStorageAt": number
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "IamRoleArn": "string",
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "LastRestoreTime": number,
         "Lifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "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
<a name="API_ListRecoveryPointsByBackupVault_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRecoveryPointsByBackupVault_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-response-NextToken"></a>
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](#API_ListRecoveryPointsByBackupVault_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-response-RecoveryPoints"></a>
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](API_RecoveryPointByBackupVault.md)

## Errores
<a name="API_ListRecoveryPointsByBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRecoveryPointsByBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 

# ListRecoveryPointsByLegalHold
<a name="API_ListRecoveryPointsByLegalHold"></a>

Esta acción devuelve el punto de recuperación ARNs (Amazon Resource Names) de la retención legal especificada.

## Sintaxis de la solicitud
<a name="API_ListRecoveryPointsByLegalHold_RequestSyntax"></a>

```
GET /legal-holds/legalHoldId/recovery-points?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRecoveryPointsByLegalHold_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [legalHoldId](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-LegalHoldId"></a>
El identificador de la retención legal.  
Obligatorio: sí

 ** [MaxResults](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

## Cuerpo de la solicitud
<a name="API_ListRecoveryPointsByLegalHold_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRecoveryPointsByLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupVaultName": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRecoveryPointsByLegalHold_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos.  
Tipo: cadena

 ** [RecoveryPoints](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-response-RecoveryPoints"></a>
Los puntos de recuperación.  
Tipo: matriz de objetos [RecoveryPointMember](API_RecoveryPointMember.md)

## Errores
<a name="API_ListRecoveryPointsByLegalHold_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRecoveryPointsByLegalHold_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 

# ListRecoveryPointsByResource
<a name="API_ListRecoveryPointsByResource"></a>

La información detallada sobre todos los puntos de recuperación del tipo especificado por el nombre de recurso de Amazon (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
<a name="API_ListRecoveryPointsByResource_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_ListRecoveryPointsByResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ManagedByAWSBackupOnly](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-ManagedByAWSBackupOnly"></a>
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 administrados por AWS Backup.  
Si se establece en `FALSE`, la respuesta contendrá todos los puntos de recuperación asociados al recurso.  
Tipo: Booleano

 ** [MaxResults](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-MaxResults"></a>
Número máximo de elementos que se van a devolver.  
Amazon RDS requiere un valor mínimo de 20.
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-NextToken"></a>
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](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-ResourceArn"></a>
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
<a name="API_ListRecoveryPointsByResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRecoveryPointsByResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "AggregatedScanResult": { 
            "FailedScan": boolean,
            "Findings": [ "string" ],
            "LastComputed": number
         },
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRecoveryPointsByResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRecoveryPointsByResource_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByResource-response-NextToken"></a>
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](#API_ListRecoveryPointsByResource_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByResource-response-RecoveryPoints"></a>
Una matriz de objetos que contiene información detallada sobre los puntos de recuperación del tipo de recurso especificado.  
Solo se devuelven Amazon EFS y los puntos EC2 de recuperación de Amazon BackupVaultName.
Tipo: matriz de objetos [RecoveryPointByResource](API_RecoveryPointByResource.md)

## Errores
<a name="API_ListRecoveryPointsByResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRecoveryPointsByResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByResource) 

# ListReportJobs
<a name="API_ListReportJobs"></a>

Devuelve detalles sobre sus trabajos de informes.

## Sintaxis de la solicitud
<a name="API_ListReportJobs_RequestSyntax"></a>

```
GET /audit/report-jobs?CreationAfter=ByCreationAfter&CreationBefore=ByCreationBefore&MaxResults=MaxResults&NextToken=NextToken&ReportPlanName=ByReportPlanName&Status=ByStatus HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListReportJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByCreationAfter](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationAfter"></a>
Devuelve solo los trabajos de informes que se crearon después de la fecha y la hora especificadas en formato Unix y horario universal coordinado (UTC). Por ejemplo, el valor 1516925490 representa el viernes 26 de enero de 2018 a las 12:11:30 h

 ** [ByCreationBefore](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationBefore"></a>
Devuelve solo los trabajos de informes que se crearon antes de la fecha y la hora, expresadas en formato Unix y horario universal coordinado (UTC). Por ejemplo, el valor 1516925490 representa el viernes 26 de enero de 2018 a las 12:11:30 h

 ** [ByReportPlanName](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByReportPlanName"></a>
Devuelve solo los trabajos de informe con el nombre del plan de informes especificado.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

 ** [ByStatus](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByStatus"></a>
Devuelve solo los trabajos de informes que se encuentran en el estado especificado. Los estados son:  
 `CREATED | RUNNING | COMPLETED | FAILED | COMPLETED_WITH_ISSUES`   
 Tenga en cuenta que solo los trabajos de escaneo terminan con el estado completado con problemas. En el caso de los trabajos de copia de seguridad, se trata de una interpretación en consola de un trabajo que finaliza y que tiene un mensaje de estado.

 ** [MaxResults](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-MaxResults"></a>
El número de resultados deseados va de 1 a 1000. Opcional. Si no se especifica, la consulta devolverá 1 MB de datos.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-NextToken"></a>
Un identificador que se devolvió de la llamada anterior a esta operación, que se puede usar para devolver el siguiente conjunto de elementos de la lista.

## Cuerpo de la solicitud
<a name="API_ListReportJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListReportJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ReportJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "ReportDestination": { 
            "S3BucketName": "string",
            "S3Keys": [ "string" ]
         },
         "ReportJobId": "string",
         "ReportPlanArn": "string",
         "ReportTemplate": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListReportJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListReportJobs_ResponseSyntax) **   <a name="Backup-ListReportJobs-response-NextToken"></a>
Un identificador que se devolvió de la llamada anterior a esta operación, que se puede usar para devolver el siguiente conjunto de elementos de la lista.  
Tipo: cadena

 ** [ReportJobs](#API_ListReportJobs_ResponseSyntax) **   <a name="Backup-ListReportJobs-response-ReportJobs"></a>
Detalles sobre sus trabajos de informes en formato JSON.  
Tipo: matriz de objetos [ReportJob](API_ReportJob.md)

## Errores
<a name="API_ListReportJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListReportJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListReportJobs) 

# ListReportPlans
<a name="API_ListReportPlans"></a>

Devuelve una lista de los planes de informes. Para obtener información detallada sobre un plan de informes único, utilice `DescribeReportPlan`.

## Sintaxis de la solicitud
<a name="API_ListReportPlans_RequestSyntax"></a>

```
GET /audit/report-plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListReportPlans_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListReportPlans_RequestSyntax) **   <a name="Backup-ListReportPlans-request-uri-MaxResults"></a>
El número de resultados deseados va de 1 a 1000. Opcional. Si no se especifica, la consulta devolverá 1 MB de datos.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListReportPlans_RequestSyntax) **   <a name="Backup-ListReportPlans-request-uri-NextToken"></a>
Un identificador que se devolvió de la llamada anterior a esta operación, que se puede usar para devolver el siguiente conjunto de elementos de la lista.

## Cuerpo de la solicitud
<a name="API_ListReportPlans_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListReportPlans_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ReportPlans": [ 
      { 
         "CreationTime": number,
         "DeploymentStatus": "string",
         "LastAttemptedExecutionTime": number,
         "LastSuccessfulExecutionTime": number,
         "ReportDeliveryChannel": { 
            "Formats": [ "string" ],
            "S3BucketName": "string",
            "S3KeyPrefix": "string"
         },
         "ReportPlanArn": "string",
         "ReportPlanDescription": "string",
         "ReportPlanName": "string",
         "ReportSetting": { 
            "Accounts": [ "string" ],
            "FrameworkArns": [ "string" ],
            "NumberOfFrameworks": number,
            "OrganizationUnits": [ "string" ],
            "Regions": [ "string" ],
            "ReportTemplate": "string"
         }
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListReportPlans_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListReportPlans_ResponseSyntax) **   <a name="Backup-ListReportPlans-response-NextToken"></a>
Un identificador que se devolvió de la llamada anterior a esta operación, que se puede usar para devolver el siguiente conjunto de elementos de la lista.  
Tipo: cadena

 ** [ReportPlans](#API_ListReportPlans_ResponseSyntax) **   <a name="Backup-ListReportPlans-response-ReportPlans"></a>
Los planes de informes con información detallada de cada plan. Esta información incluye el nombre de recurso de Amazon (ARN), el nombre del plan de informes, la descripción, la configuración, el canal de entrega, el estado de implementación, la hora de creación y las últimas veces que el plan de informes se intentó ejecutar y se ejecutó correctamente.  
Tipo: matriz de objetos [ReportPlan](API_ReportPlan.md)

## Errores
<a name="API_ListReportPlans_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListReportPlans_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListReportPlans) 

# ListRestoreAccessBackupVaults
<a name="API_ListRestoreAccessBackupVaults"></a>

Devuelve una lista de los almacenes de copias de seguridad con acceso a la restauración asociados a un almacén de copias de seguridad específico.

## Sintaxis de la solicitud
<a name="API_ListRestoreAccessBackupVaults_RequestSyntax"></a>

```
GET /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRestoreAccessBackupVaults_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad a partir del cual se genera la lista de almacenes de copias de seguridad con acceso a la restauración asociados.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [MaxResults](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-MaxResults"></a>
Es el número máximo de elementos que se devuelve en la respuesta.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-NextToken"></a>
Es el token de paginación de una solicitud anterior para obtener el siguiente conjunto de resultados.

## Cuerpo de la solicitud
<a name="API_ListRestoreAccessBackupVaults_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRestoreAccessBackupVaults_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreAccessBackupVaults": [ 
      { 
         "ApprovalDate": number,
         "CreationDate": number,
         "LatestRevokeRequest": { 
            "ExpiryDate": number,
            "InitiationDate": number,
            "MpaSessionArn": "string",
            "Status": "string",
            "StatusMessage": "string"
         },
         "RestoreAccessBackupVaultArn": "string",
         "VaultState": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRestoreAccessBackupVaults_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-response-NextToken"></a>
Es el token de paginación que se debe utilizar en una solicitud subsiguiente para obtener el siguiente conjunto de resultados.  
Tipo: cadena

 ** [RestoreAccessBackupVaults](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-response-RestoreAccessBackupVaults"></a>
Es una lista de los almacenes de copias de seguridad con acceso a la restauración asociadas a un almacén de copias de seguridad específico.  
Tipo: matriz de objetos [RestoreAccessBackupVaultListMember](API_RestoreAccessBackupVaultListMember.md)

## Errores
<a name="API_ListRestoreAccessBackupVaults_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRestoreAccessBackupVaults_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreAccessBackupVaults) 

# ListRestoreJobs
<a name="API_ListRestoreJobs"></a>

Devuelve una lista de los trabajos que AWS Backup se iniciaron para restaurar un recurso guardado, incluidos los detalles del proceso de recuperación.

## Sintaxis de la solicitud
<a name="API_ListRestoreJobs_RequestSyntax"></a>

```
GET /restore-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentJobId=ByParentJobId&resourceType=ByResourceType&restoreTestingPlanArn=ByRestoreTestingPlanArn&status=ByStatus HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRestoreJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByAccountId](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByAccountId"></a>
El ID de la cuenta desde la que se van a enumerar los trabajos. Devuelve solo los trabajos de restauración asociados al ID de cuenta especificado.  
Patrón: `^[0-9]{12}$` 

 ** [ByCompleteAfter](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCompleteAfter"></a>
Devuelve solo los trabajos de copia completados después de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCompleteBefore](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCompleteBefore"></a>
Devuelve solo los trabajos de copia completados antes de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCreatedAfter](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCreatedAfter"></a>
Devuelve solo los trabajos de restauración que se crearon después de la fecha especificada.

 ** [ByCreatedBefore](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCreatedBefore"></a>
Devuelve solo los trabajos de restauración que se crearon antes de la fecha especificada.

 ** [ByParentJobId](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByParentJobId"></a>
Se trata de un filtro para enumerar los trabajos de restauración secundarios (anidados) en función del identificador del trabajo de restauración principal.

 ** [ByResourceType](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByResourceType"></a>
Incluya este parámetro para devolver únicamente los trabajos de restauración de los recursos especificados:  
+  `Aurora` para Amazon Aurora
+  `CloudFormation`para AWS CloudFormation 
+  `DocumentDB` para Amazon DocumentDB (compatible 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
+  `EKS` para Amazon Elastic Kubernetes Service
+  `FSx`para Amazon FSx
+  `Neptune` para Amazon Neptune
+  `RDS` para Amazon Relational Database Service
+  `Redshift` para Amazon Redshift
+  `S3` para Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2` para bases de datos de SAP HANA en instancias de Amazon Elastic Compute Cloud
+  `Storage Gateway`para AWS Storage Gateway 
+  `Timestream` para Amazon Timestream
+  `VirtualMachine`para máquinas VMware virtuales
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ByRestoreTestingPlanArn](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByRestoreTestingPlanArn"></a>
Devuelve solo los trabajos de restauración que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado.

 ** [ByStatus](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByStatus"></a>
Devuelve solo los trabajos de restauración asociados al estado de trabajo especificado.  
Valores válidos: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [MaxResults](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-MaxResults"></a>
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](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-NextToken"></a>
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
<a name="API_ListRestoreJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRestoreJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "IsParent": boolean,
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRestoreJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRestoreJobs_ResponseSyntax) **   <a name="Backup-ListRestoreJobs-response-NextToken"></a>
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

 ** [RestoreJobs](#API_ListRestoreJobs_ResponseSyntax) **   <a name="Backup-ListRestoreJobs-response-RestoreJobs"></a>
Una matriz de objetos que contiene información detallada sobre los trabajos para restaurar los recursos guardados.  
Tipo: matriz de objetos [RestoreJobsListMember](API_RestoreJobsListMember.md)

## Errores
<a name="API_ListRestoreJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRestoreJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobs) 

# ListRestoreJobsByProtectedResource
<a name="API_ListRestoreJobsByProtectedResource"></a>

Devuelve los trabajos de restauración que contienen el recurso protegido especificado.

Debe incluir `ResourceArn`. Opcionalmente, puede incluir `NextToken`, `ByStatus`, `MaxResults`, `ByRecoveryPointCreationDateAfter` y `ByRecoveryPointCreationDateBefore`.

## Sintaxis de la solicitud
<a name="API_ListRestoreJobsByProtectedResource_RequestSyntax"></a>

```
GET /resources/resourceArn/restore-jobs/?maxResults=MaxResults&nextToken=NextToken&recoveryPointCreationDateAfter=ByRecoveryPointCreationDateAfter&recoveryPointCreationDateBefore=ByRecoveryPointCreationDateBefore&status=ByStatus HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRestoreJobsByProtectedResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByRecoveryPointCreationDateAfter](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByRecoveryPointCreationDateAfter"></a>
Devuelve solo los trabajos de restauración de puntos de recuperación que se crearon después de la fecha especificada.

 ** [ByRecoveryPointCreationDateBefore](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByRecoveryPointCreationDateBefore"></a>
Devuelve solo los trabajos de restauración de puntos de recuperación que se crearon antes de la fecha especificada.

 ** [ByStatus](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByStatus"></a>
Devuelve solo los trabajos de restauración asociados al estado de trabajo especificado.  
Valores válidos: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [MaxResults](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-MaxResults"></a>
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](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-NextToken"></a>
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](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ResourceArn"></a>
Devuelve solo los trabajos de restauración que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_ListRestoreJobsByProtectedResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRestoreJobsByProtectedResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "IsParent": boolean,
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRestoreJobsByProtectedResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRestoreJobsByProtectedResource_ResponseSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-response-NextToken"></a>
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

 ** [RestoreJobs](#API_ListRestoreJobsByProtectedResource_ResponseSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-response-RestoreJobs"></a>
Una matriz de objetos que contiene información detallada sobre los trabajos para restaurar los recursos guardados.>  
Tipo: matriz de objetos [RestoreJobsListMember](API_RestoreJobsListMember.md)

## Errores
<a name="API_ListRestoreJobsByProtectedResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRestoreJobsByProtectedResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 

# ListRestoreJobSummaries
<a name="API_ListRestoreJobSummaries"></a>

Esta solicitud obtiene un resumen de los trabajos de restauración creados o en ejecución en los 30 últimos días. Puede incluir los parámetros AccountID, State,, ResourceType AggregationPeriod MaxResults, NextToken o para filtrar los resultados.

Esta solicitud devuelve un resumen que contiene la región, la cuenta, el estado, RestourceType, MessageCategory StartTime EndTime, y el recuento de los trabajos incluidos.

## Sintaxis de la solicitud
<a name="API_ListRestoreJobSummaries_RequestSyntax"></a>

```
GET /audit/restore-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRestoreJobSummaries_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AccountId](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-AccountId"></a>
Devuelve el recuento de trabajos de la cuenta especificada.  
Si la solicitud se envía desde una cuenta de miembro o desde una cuenta que no forma parte de AWS Organizations, se devolverán los trabajos de la cuenta del solicitante.  
Las cuentas raíz, de administrador y de administrador delegado pueden utilizar el valor ANY para devolver recuentos de trabajos de todas las cuentas de la organización.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las cuentas de la organización autenticada y, a continuación, devuelve la suma.  
Patrón: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`: el recuento de trabajos diarios de los 14 días anteriores.
+  `SEVEN_DAYS`: el recuento total de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`: el recuento total de trabajos de los 14 días anteriores.
Valores válidos: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MaxResults](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-MaxResults"></a>
Este parámetro establece el número máximo de elementos que se van a devolver.  
El valor es un entero. El rango de valores aceptados está entre 1 y 500.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [ResourceType](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-ResourceType"></a>
Devuelve el recuento de trabajos del tipo de recurso especificado. Utilice `GetSupportedResourceTypes` de solicitud para obtener cadenas para los tipos de recursos compatibles.  
El valor ANY devuelve el recuento de todos los tipos de recursos.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de recursos y devuelve la suma.  
El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-State"></a>
Este parámetro devuelve el recuento de los trabajos con el estado especificado.  
El valor ANY devuelve el recuento de todos los estados.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de estados y devuelve la suma.  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTED | COMPLETED | FAILED | AGGREGATE_ALL | ANY` 

## Cuerpo de la solicitud
<a name="API_ListRestoreJobSummaries_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRestoreJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "RestoreJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRestoreJobSummaries_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AggregationPeriod](#API_ListRestoreJobSummaries_ResponseSyntax) **   <a name="Backup-ListRestoreJobSummaries-response-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`: el recuento de trabajos diarios de los 14 días anteriores.
+  `SEVEN_DAYS`: el recuento total de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`: el recuento total de trabajos de los 14 días anteriores.
Tipo: cadena

 ** [NextToken](#API_ListRestoreJobSummaries_ResponseSyntax) **   <a name="Backup-ListRestoreJobSummaries-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

 ** [RestoreJobSummaries](#API_ListRestoreJobSummaries_ResponseSyntax) **   <a name="Backup-ListRestoreJobSummaries-response-RestoreJobSummaries"></a>
Esta declaración contiene un resumen que incluye la región, la cuenta, el estado,, ResourceType MessageCategory StartTime EndTime, y el recuento de los trabajos incluidos.  
Tipo: matriz de objetos [RestoreJobSummary](API_RestoreJobSummary.md)

## Errores
<a name="API_ListRestoreJobSummaries_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRestoreJobSummaries_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobSummaries) 

# ListRestoreTestingPlans
<a name="API_ListRestoreTestingPlans"></a>

Devuelve una lista de los planes de prueba de restauración.

## Sintaxis de la solicitud
<a name="API_ListRestoreTestingPlans_RequestSyntax"></a>

```
GET /restore-testing/plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRestoreTestingPlans_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListRestoreTestingPlans_RequestSyntax) **   <a name="Backup-ListRestoreTestingPlans-request-uri-MaxResults"></a>
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](#API_ListRestoreTestingPlans_RequestSyntax) **   <a name="Backup-ListRestoreTestingPlans-request-uri-NextToken"></a>
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
<a name="API_ListRestoreTestingPlans_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRestoreTestingPlans_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreTestingPlans": [ 
      { 
         "CreationTime": number,
         "LastExecutionTime": number,
         "LastUpdateTime": number,
         "RestoreTestingPlanArn": "string",
         "RestoreTestingPlanName": "string",
         "ScheduleExpression": "string",
         "ScheduleExpressionTimezone": "string",
         "StartWindowHours": number
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRestoreTestingPlans_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRestoreTestingPlans_ResponseSyntax) **   <a name="Backup-ListRestoreTestingPlans-response-NextToken"></a>
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

 ** [RestoreTestingPlans](#API_ListRestoreTestingPlans_ResponseSyntax) **   <a name="Backup-ListRestoreTestingPlans-response-RestoreTestingPlans"></a>
Es una lista devuelta de planes de prueba de restauración.  
Tipo: matriz de objetos [RestoreTestingPlanForList](API_RestoreTestingPlanForList.md)

## Errores
<a name="API_ListRestoreTestingPlans_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRestoreTestingPlans_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreTestingPlans) 

# ListRestoreTestingSelections
<a name="API_ListRestoreTestingSelections"></a>

Devuelve una lista de selecciones de pruebas de restauración. Se puede filtrar por `MaxResults` y `RestoreTestingPlanName`.

## Sintaxis de la solicitud
<a name="API_ListRestoreTestingSelections_RequestSyntax"></a>

```
GET /restore-testing/plans/RestoreTestingPlanName/selections?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListRestoreTestingSelections_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-MaxResults"></a>
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](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-NextToken"></a>
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.

 ** [RestoreTestingPlanName](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-RestoreTestingPlanName"></a>
Devuelve las selecciones de pruebas de restauración por el nombre del plan de prueba de restauración especificado.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_ListRestoreTestingSelections_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListRestoreTestingSelections_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreTestingSelections": [ 
      { 
         "CreationTime": number,
         "IamRoleArn": "string",
         "ProtectedResourceType": "string",
         "RestoreTestingPlanName": "string",
         "RestoreTestingSelectionName": "string",
         "ValidationWindowHours": number
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRestoreTestingSelections_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListRestoreTestingSelections_ResponseSyntax) **   <a name="Backup-ListRestoreTestingSelections-response-NextToken"></a>
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

 ** [RestoreTestingSelections](#API_ListRestoreTestingSelections_ResponseSyntax) **   <a name="Backup-ListRestoreTestingSelections-response-RestoreTestingSelections"></a>
Las selecciones de pruebas de restauración devueltas asociadas al plan de prueba de restauración.  
Tipo: matriz de objetos [RestoreTestingSelectionForList](API_RestoreTestingSelectionForList.md)

## Errores
<a name="API_ListRestoreTestingSelections_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListRestoreTestingSelections_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreTestingSelections) 

# ListScanJobs
<a name="API_ListScanJobs"></a>

Devuelve una lista de los trabajos de escaneo existentes para una cuenta autenticada durante los últimos 30 días.

## Sintaxis de la solicitud
<a name="API_ListScanJobs_RequestSyntax"></a>

```
GET /scan/jobs?ByAccountId=ByAccountId&ByBackupVaultName=ByBackupVaultName&ByCompleteAfter=ByCompleteAfter&ByCompleteBefore=ByCompleteBefore&ByMalwareScanner=ByMalwareScanner&ByRecoveryPointArn=ByRecoveryPointArn&ByResourceArn=ByResourceArn&ByResourceType=ByResourceType&ByScanResultStatus=ByScanResultStatus&ByState=ByState&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListScanJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByAccountId](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByAccountId"></a>
El ID de la cuenta desde la que se van a enumerar los trabajos. Devuelve solo los trabajos de copia de seguridad asociados al ID de cuenta especificado.  
Si se usa desde una AWS cuenta de administración de Organizations, la `*` transferencia devuelve todos los trabajos de la organización.  
Patrón: `^[0-9]{12}$` 

 ** [ByBackupVaultName](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByBackupVaultName"></a>
Devuelve solo los trabajos de escaneo que se almacenarán en la bóveda de respaldo especificada. Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon.  
Patrón: `^[a-zA-Z0-9\-\_\.]{2,50}$` 

 ** [ByCompleteAfter](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteAfter"></a>
Solo devuelve los trabajos de escaneo completados después de una fecha expresada en formato Unix y en la hora universal coordinada (UTC).

 ** [ByCompleteBefore](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteBefore"></a>
Devuelve solo los trabajos de copia de seguridad completados antes de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByMalwareScanner](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByMalwareScanner"></a>
Devuelve solo los trabajos de escaneo del escáner de malware especificado. Actualmente, solo admite `GUARDDUTY`.  
Valores válidos: `GUARDDUTY` 

 ** [ByRecoveryPointArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByRecoveryPointArn"></a>
Devuelve solo los trabajos de escaneo que se ejecutan en el punto de recuperación especificado.

 ** [ByResourceArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceArn"></a>
Devuelve solo los trabajos de escaneo que coinciden con el nombre de recurso Amazon (ARN) del recurso especificado.

 ** [ByResourceType](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceType"></a>
Devuelve las selecciones de pruebas de restauración por el nombre del plan de prueba de restauración especificado.  
+  `EBS`para Amazon Elastic Block Store
+  `EC2`para Amazon Elastic Compute Cloud
+  `S3`para Amazon Simple Storage Service (Amazon S3)
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Valores válidos: `EBS | EC2 | S3` 

 ** [ByScanResultStatus](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByScanResultStatus"></a>
Devuelve solo los trabajos de escaneo para los resultados de escaneo especificados:  
+  `THREATS_FOUND` 
+  `NO_THREATS_FOUND` 
Valores válidos: `NO_THREATS_FOUND | THREATS_FOUND` 

 ** [ByState](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByState"></a>
Devuelve solo los trabajos de escaneo para el estado del trabajo de escaneo especificado.  
Valores válidos: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [MaxResults](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-MaxResults"></a>
Número máximo de elementos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-NextToken"></a>
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
<a name="API_ListScanJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListScanJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ScanJobs": [ 
      { 
         "AccountId": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "IamRoleArn": "string",
         "MalwareScanner": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "ScanBaseRecoveryPointArn": "string",
         "ScanId": "string",
         "ScanJobId": "string",
         "ScanMode": "string",
         "ScannerRoleArn": "string",
         "ScanResult": { 
            "ScanResultStatus": "string"
         },
         "State": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListScanJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListScanJobs_ResponseSyntax) **   <a name="Backup-ListScanJobs-response-NextToken"></a>
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

 ** [ScanJobs](#API_ListScanJobs_ResponseSyntax) **   <a name="Backup-ListScanJobs-response-ScanJobs"></a>
Un conjunto de estructuras que contienen metadatos sobre sus trabajos de escaneo devueltos en formato JSON.  
Tipo: matriz de objetos [ScanJob](API_ScanJob.md)

## Errores
<a name="API_ListScanJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListScanJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobs) 

# ListScanJobSummaries
<a name="API_ListScanJobSummaries"></a>

Se trata de una solicitud de resumen de los trabajos de digitalización creados o en ejecución en los últimos 30 días.

## Sintaxis de la solicitud
<a name="API_ListScanJobSummaries_RequestSyntax"></a>

```
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListScanJobSummaries_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AccountId](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AccountId"></a>
Devuelve el recuento de trabajos de la cuenta especificada.  
Si la solicitud se envía desde una cuenta de miembro o una cuenta que no forma parte de AWS Organizations, se devolverán los trabajos de la cuenta del solicitante.  
Las cuentas raíz, de administrador y de administrador delegado pueden usar el valor `ANY` para devolver los recuentos de puestos de trabajo de todas las cuentas de la organización.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las cuentas de la organización autenticada y, a continuación, devuelve la suma.  
Patrón: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`El recuento diario de trabajos del día anterior.
+  `SEVEN_DAYS`El recuento diario de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`El recuento diario de trabajos de los 14 días anteriores.
Valores válidos: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MalwareScanner](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-MalwareScanner"></a>
Devuelve solo los trabajos de escaneo del escáner de malware especificado. Actualmente, el único MalwareScanner es`GUARDDUTY`. Pero el campo también apoya`ANY`, y`AGGREGATE_ALL`.  
Valores válidos: `GUARDDUTY` 

 ** [MaxResults](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-MaxResults"></a>
Número máximo de elementos que se van a devolver.  
El valor es un entero. El rango de valores aceptados está entre 1 y 500.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-NextToken"></a>
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.

 ** [ResourceType](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-ResourceType"></a>
Devuelve el recuento de trabajos del tipo de recurso especificado. Utilice `GetSupportedResourceTypes` de solicitud para obtener cadenas para los tipos de recursos compatibles.  
El valor `ANY` devuelve el recuento de todos los tipos de recursos.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todos los tipos de recursos y devuelve la suma.  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ScanResultStatus](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-ScanResultStatus"></a>
Devuelve solo los trabajos de escaneo para los resultados de escaneo especificados.  
Valores válidos: `NO_THREATS_FOUND | THREATS_FOUND` 

 ** [State](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-State"></a>
Devuelve solo los trabajos de escaneo para el estado del trabajo de escaneo especificado.  
Valores válidos: `CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY` 

## Cuerpo de la solicitud
<a name="API_ListScanJobSummaries_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListScanJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "ScanJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MalwareScanner": "string",
         "Region": "string",
         "ResourceType": "string",
         "ScanResultStatus": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListScanJobSummaries_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AggregationPeriod](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-AggregationPeriod"></a>
El período de los resultados devueltos.  
+  `ONE_DAY`El recuento de trabajos diarios del día anterior.
+  `SEVEN_DAYS`El recuento diario de trabajos de los 7 días anteriores.
+  `FOURTEEN_DAYS`El recuento diario de trabajos de los 14 días anteriores.
Valores válidos: `'ONE_DAY'` \$1 `'SEVEN_DAYS'` \$1 `'FOURTEEN_DAYS'`   
Tipo: cadena

 ** [NextToken](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-NextToken"></a>
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

 ** [ScanJobSummaries](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-ScanJobSummaries"></a>
La información del resumen.  
Tipo: matriz de objetos [ScanJobSummary](API_ScanJobSummary.md)

## Errores
<a name="API_ListScanJobSummaries_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListScanJobSummaries_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobSummaries) 

# ListTags
<a name="API_ListTags"></a>

Devuelve las etiquetas asignadas al recurso, como un punto de recuperación, plan de copia de seguridad o almacén de copias de seguridad de destino.

Esta operación devuelve resultados en función del tipo de recurso utilizado en el valor de `resourceArn`. Por ejemplo, los puntos de recuperación de Amazon DynamoDB con configuración avanzada tienen un ARN (nombre de recurso de Amazon) que comienza por `arn:aws:backup`. Los puntos de recuperación (copias de seguridad) de DynamoDB sin la configuración avanzada activada tienen un ARN que comienza por `arn:aws:dynamodb`.

Cuando se llama a esta operación y se incluyen valores de `resourceArn` que tienen un ARN distinto de `arn:aws:backup`, es posible que devuelva una de las excepciones que se enumera a continuación. Para evitar esta excepción, incluya únicamente los valores que representen los tipos de recursos completamente administrados por AWS Backup. Estos valores tienen un ARN que comienza por `arn:aws:backup` y se incluyen en la tabla [Disponibilidad de características por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource).

## Sintaxis de la solicitud
<a name="API_ListTags_RequestSyntax"></a>

```
GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListTags_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-MaxResults"></a>
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](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-NextToken"></a>
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](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-ResourceArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso. Los destinos válidos de `ListTags` son los puntos de recuperación, los planes de copia de seguridad y los almacenes de copias de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_ListTags_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListTags_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Elementos de respuesta
<a name="API_ListTags_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTags_ResponseSyntax) **   <a name="Backup-ListTags-response-NextToken"></a>
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

 ** [Tags](#API_ListTags_ResponseSyntax) **   <a name="Backup-ListTags-response-Tags"></a>
Información acerca de las etiquetas.  
Tipo: mapa de cadena a cadena

## Errores
<a name="API_ListTags_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListTags_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListTags) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListTags) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListTags) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListTags) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListTags) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListTags) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListTags) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListTags) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListTags) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListTags) 

# ListTieringConfigurations
<a name="API_ListTieringConfigurations"></a>

Devuelve una lista de configuraciones de estratificación.

## Sintaxis de la solicitud
<a name="API_ListTieringConfigurations_RequestSyntax"></a>

```
GET /tiering-configurations/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListTieringConfigurations_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListTieringConfigurations_RequestSyntax) **   <a name="Backup-ListTieringConfigurations-request-uri-MaxResults"></a>
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](#API_ListTieringConfigurations_RequestSyntax) **   <a name="Backup-ListTieringConfigurations-request-uri-NextToken"></a>
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
<a name="API_ListTieringConfigurations_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListTieringConfigurations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "TieringConfigurations": [ 
      { 
         "BackupVaultName": "string",
         "CreationTime": number,
         "LastUpdatedTime": number,
         "TieringConfigurationArn": "string",
         "TieringConfigurationName": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListTieringConfigurations_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTieringConfigurations_ResponseSyntax) **   <a name="Backup-ListTieringConfigurations-response-NextToken"></a>
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

 ** [TieringConfigurations](#API_ListTieringConfigurations_ResponseSyntax) **   <a name="Backup-ListTieringConfigurations-response-TieringConfigurations"></a>
Un conjunto de configuraciones de estratificación devueltas por la `ListTieringConfigurations` llamada.  
Tipo: matriz de objetos [TieringConfigurationsListMember](API_TieringConfigurationsListMember.md)

## Errores
<a name="API_ListTieringConfigurations_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListTieringConfigurations_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListTieringConfigurations) 

# PutBackupVaultAccessPolicy
<a name="API_PutBackupVaultAccessPolicy"></a>

Establece una política basada en recursos que se utiliza para administrar los permisos de acceso en el almacén de copias de seguridad de destino. Requiere un nombre de almacén de copias de seguridad y un documento de política de acceso en formato JSON.

## Sintaxis de la solicitud
<a name="API_PutBackupVaultAccessPolicy_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/access-policy HTTP/1.1
Content-type: application/json

{
   "Policy": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_PutBackupVaultAccessPolicy_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_PutBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-PutBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutBackupVaultAccessPolicy_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Policy](#API_PutBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-PutBackupVaultAccessPolicy-request-Policy"></a>
El documento de política de acceso al almacén de copias de seguridad en formato JSON.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_PutBackupVaultAccessPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_PutBackupVaultAccessPolicy_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_PutBackupVaultAccessPolicy_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_PutBackupVaultAccessPolicy_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultAccessPolicy) 

# PutBackupVaultLockConfiguration
<a name="API_PutBackupVaultLockConfiguration"></a>

Aplica AWS Backup Vault Lock a una bóveda de copias de seguridad, lo que impide los intentos de eliminar cualquier punto de recuperación almacenado o creado en una bóveda de copias de seguridad. El bloqueo de almacenes también impide los intentos de actualizar la política de ciclo de vida que controla el periodo de retención de cualquier punto de recuperación almacenado actualmente en un almacén de copias de seguridad. Si se especifica, el bloqueo de almacenes impone un periodo de retención mínimo y máximo a los futuros trabajos de copia y copia de seguridad que tengan como destino un almacén de copias de seguridad.

**nota**  
 AWS Backup Cohasset Associates ha evaluado el uso de Vault Lock en entornos sujetos a las normas SEC 17a-4, la CFTC y la FINRA. [Para obtener más información sobre la relación de AWS Backup Vault Lock con estas normas, consulte la evaluación de conformidad de Cohasset Associates.](https://docs.aws.amazon.com/aws-backup/latest/devguide/samples/cohassetreport.zip) 

Para obtener más información, consulte [Bloqueo de almacenes de AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html).

## Sintaxis de la solicitud
<a name="API_PutBackupVaultLockConfiguration_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1
Content-type: application/json

{
   "ChangeableForDays": number,
   "MaxRetentionDays": number,
   "MinRetentionDays": number
}
```

## Parámetros de solicitud del URI
<a name="API_PutBackupVaultLockConfiguration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-uri-BackupVaultName"></a>
La configuración de AWS Backup Vault Lock que especifica el nombre de la bóveda de respaldo que protege.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutBackupVaultLockConfiguration_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ChangeableForDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-ChangeableForDays"></a>
La configuración de AWS Backup Vault Lock que especifica el número de días antes de la fecha de bloqueo. Por ejemplo, si se fija `ChangeableForDays` en 30 el 1 de enero de 2022 a las 20:00 UTC, la fecha de bloqueo será el 31 de enero de 2022 a las 20:00 UTC.  
 AWS Backup impone un período de reflexión de 72 horas antes de que Vault Lock entre en vigor y pase a ser inmutable. Por tanto, debe establecer `ChangeableForDays` a 3 o mayor.  
El valor máximo que puede especificar es de 36 500 días (aproximadamente 100 años).  
Antes de la fecha de bloqueo, puede eliminar el bloqueo de almacenes mediante `DeleteBackupVaultLockConfiguration` o cambiar la configuración de este mediante `PutBackupVaultLockConfiguration`. A partir de la fecha de bloqueo, el bloqueo de almacenes pasa a ser inmutable y no se puede cambiar ni eliminar.  
Si no se especifica este parámetro, puede eliminar el bloqueo de almacenes mediante `DeleteBackupVaultLockConfiguration` o cambiar la configuración del bloqueo de almacenes mediante `PutBackupVaultLockConfiguration` en cualquier momento.  
Tipo: largo  
Obligatorio: no

 ** [MaxRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-MaxRetentionDays"></a>
La configuración de AWS Backup Vault Lock que especifica el período máximo de retención durante el que el almacén conserva sus puntos de recuperación. Esta configuración puede resultar útil si, por ejemplo, las políticas de su organización requieren que destruya ciertos datos después de retenerlos durante cuatro años (1460 días).  
Si no se incluye este parámetro, el bloqueo de almacenes no impone un periodo de retención máximo en los puntos de recuperación del almacén. Si este parámetro se incluye sin un valor, el bloqueo de almacenes no aplicará un periodo de retención máximo.  
Si se especifica este parámetro, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o inferior al periodo de retención máximo. Si el periodo de retención del trabajo es superior a ese periodo de retención máximo, el almacén falla el trabajo de copia de seguridad o de copia de seguridad, y deberá modificar la configuración del ciclo de vida o utilizar un almacén diferente. El periodo de retención máximo más largo que puede especificar es de 36 500 días (aproximadamente 100 años). Los puntos de recuperación ya guardados en el almacén antes del bloqueo del almacén de no se ven afectados.  
Tipo: largo  
Obligatorio: no

 ** [MinRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-MinRetentionDays"></a>
La configuración de AWS Backup Vault Lock que especifica el período mínimo de retención durante el que el almacén conserva sus puntos de recuperación. Esta configuración puede ser útil si, por ejemplo, las políticas de su organización requieren que se retengan ciertos datos durante al menos siete años (2555 días).  
Este parámetro es obligatorio cuando se crea un bloqueo de almacén AWS CloudFormation; de lo contrario, este parámetro es opcional. Si no se especifica este parámetro, el bloqueo del almacén no impondrá un periodo mínimo de retención.  
Si se especifica este parámetro, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o superior al periodo de retención mínimo. Si el periodo de retención del trabajo es más corto que ese periodo de retención mínimo, el almacén no supera ese trabajo de copia o copia, y debe modificar la configuración del ciclo de vida o usar un almacén diferente. El periodo de retención mínimo más corto que puede especificar es de 1 día. Los puntos de recuperación ya guardados en el almacén antes del bloqueo del almacén de no se ven afectados.  
Tipo: largo  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_PutBackupVaultLockConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_PutBackupVaultLockConfiguration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_PutBackupVaultLockConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_PutBackupVaultLockConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultLockConfiguration) 

# PutBackupVaultNotifications
<a name="API_PutBackupVaultNotifications"></a>

Activa las notificaciones en un almacén de copias de seguridad para el tema y los eventos especificados.

## Sintaxis de la solicitud
<a name="API_PutBackupVaultNotifications_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json

{
   "BackupVaultEvents": [ "string" ],
   "SNSTopicArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_PutBackupVaultNotifications_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutBackupVaultNotifications_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupVaultEvents](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-BackupVaultEvents"></a>
Una matriz de eventos que indica el estado de los trabajos para realizar copias de seguridad de recursos en el almacén de copia de seguridad. Para ver la lista de eventos compatibles, casos de uso comunes y ejemplos de código, consulta [Opciones de notificación con AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-notifications.html).  
La siguiente lista incluye eventos compatibles y obsoletos que ya no se utilizan (como referencia). Los eventos obsoletos no devolverán estados ni notificaciones.
Tipo: matriz de cadenas  
Valores válidos: `BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED | CONTINUOUS_BACKUP_INTERRUPTED | RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED`   
Obligatorio: sí

 ** [SNSTopicArn](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-SNSTopicArn"></a>
El nombre de recurso de Amazon (ARN) que especifica el tema de los eventos de un almacén de copias de seguridad; por ejemplo, `arn:aws:sns:us-west-2:111122223333:MyVaultTopic`.  
Tipo: cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_PutBackupVaultNotifications_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_PutBackupVaultNotifications_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_PutBackupVaultNotifications_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_PutBackupVaultNotifications_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultNotifications) 

# PutRestoreValidationResult
<a name="API_PutRestoreValidationResult"></a>

Esta solicitud permite enviar los resultados de validación de pruebas de restauración independientes que se ejecutan automáticamente. `RestoreJobId` y `ValidationStatus` son obligatorios. Si lo desea, puede introducir un `ValidationStatusMessage`.

## Sintaxis de la solicitud
<a name="API_PutRestoreValidationResult_RequestSyntax"></a>

```
PUT /restore-jobs/restoreJobId/validations HTTP/1.1
Content-type: application/json

{
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_PutRestoreValidationResult_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [restoreJobId](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-uri-RestoreJobId"></a>
Se trata de un identificador único de un trabajo de restauración interno AWS Backup.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutRestoreValidationResult_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ValidationStatus](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-ValidationStatus"></a>
El estado de validación de la restauración.  
Tipo: cadena  
Valores válidos: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`   
Obligatorio: sí

 ** [ValidationStatusMessage](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-ValidationStatusMessage"></a>
Es una cadena de mensaje opcional que puede introducir para describir el estado de validación de la prueba de restauración.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_PutRestoreValidationResult_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_PutRestoreValidationResult_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_PutRestoreValidationResult_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_PutRestoreValidationResult_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutRestoreValidationResult) 

# RevokeRestoreAccessBackupVault
<a name="API_RevokeRestoreAccessBackupVault"></a>

Revoca el acceso a un almacén de copias de seguridad con acceso a la restauración, lo que elimina la posibilidad de restaurar a partir de sus puntos de recuperación y elimina el almacén de forma permanente.

## Sintaxis de la solicitud
<a name="API_RevokeRestoreAccessBackupVault_RequestSyntax"></a>

```
DELETE /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/restoreAccessBackupVaultArn?requesterComment=RequesterComment HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_RevokeRestoreAccessBackupVault_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad de origen asociado al almacén de copias de seguridad con acceso a la restauración que se va a revocar.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [RequesterComment](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-RequesterComment"></a>
Es un comentario que explica el motivo de la revocación del acceso al almacén de copias de seguridad con acceso a la restauración.

 ** [restoreAccessBackupVaultArn](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-RestoreAccessBackupVaultArn"></a>
Es el ARN del almacén de copias de seguridad con acceso a la restauración que se va a revocar.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_RevokeRestoreAccessBackupVault_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_RevokeRestoreAccessBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_RevokeRestoreAccessBackupVault_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_RevokeRestoreAccessBackupVault_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_RevokeRestoreAccessBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 

# StartBackupJob
<a name="API_StartBackupJob"></a>

Inicia un trabajo de copia de seguridad bajo demanda para el recurso especificado.

## Sintaxis de la solicitud
<a name="API_StartBackupJob_RequestSyntax"></a>

```
PUT /backup-jobs HTTP/1.1
Content-type: application/json

{
   "BackupOptions": { 
      "string" : "string" 
   },
   "BackupVaultName": "string",
   "CompleteWindowMinutes": number,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Index": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "LogicallyAirGappedBackupVaultArn": "string",
   "RecoveryPointTags": { 
      "string" : "string" 
   },
   "ResourceArn": "string",
   "StartWindowMinutes": number
}
```

## Parámetros de solicitud del URI
<a name="API_StartBackupJob_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartBackupJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupOptions](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupOptions"></a>
La opción de copia de seguridad para un recurso seleccionado. Esta opción solo está disponible para los trabajos de copia de seguridad de Windows Volume Shadow Copy Service (VSS).  
Valores válidos: configure `"WindowsVSS":"enabled"` para habilitar la opción de copia de seguridad de `WindowsVSS` y crear una copia de seguridad de Windows VSS. Configure `"WindowsVSS""disabled"` para crear una copia de seguridad normal. La opción `WindowsVSS` no está habilitada de forma predeterminada.  
Tipo: mapa de cadena a cadena  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Patrón de valores: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** [BackupVaultName](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [CompleteWindowMinutes](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-CompleteWindowMinutes"></a>
Un valor en minutos durante el cual debe completarse una copia de seguridad que se haya iniciado correctamente o, de lo contrario, AWS Backup cancelará el trabajo. Este valor es opcional. Este valor comienza la cuenta regresiva a partir del momento en que se programó la copia de seguridad. No agrega tiempo adicional para `StartWindowMinutes` o si la copia de seguridad se inició más tarde de lo programado.  
Como `StartWindowMinutes`, este parámetro tiene un valor máximo de 100 años (52 560 000 minutos).  
Tipo: largo  
Obligatorio: no

 ** [IamRoleArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Obligatorio: sí

 ** [IdempotencyToken](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartBackupJob` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [Index](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-Index"></a>
Incluya este parámetro para activar la creación de índices si su trabajo de copia de seguridad tiene un tipo de recurso que admite índices de copia de seguridad.  
Los tipos de recurso que admiten índices de copia de seguridad son:  
+  `EBS` para Amazon Elastic Block Store (EBS)
+  `S3` para Amazon Simple Storage Service (Amazon S3)
El índice puede tener uno o dos valores posibles, `ENABLED` o `DISABLED`.  
Para crear un índice de copias de seguridad para un punto de recuperación `ACTIVE` elegible que aún no tiene un índice de copia de seguridad, establezca el valor en `ENABLED`.  
Para eliminar un índice de copias de seguridad, defina el valor en `DISABLED`.  
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: no

 ** [Lifecycle](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup realizará la transición y caducará las copias de seguridad automáticamente según el ciclo de vida que usted defina.   
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.   
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Este parámetro tiene un valor máximo de 100 años (36 500 días).  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** [LogicallyAirGappedBackupVaultArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-LogicallyAirGappedBackupVaultArn"></a>
El ARN de una bóveda con huecos de aire lógicos. El ARN debe estar en la misma cuenta y región. Si se proporcionan, los recursos compatibles totalmente gestionados realizan copias de seguridad directamente en un almacén aislado de forma lógica, mientras que otros recursos compatibles crean una instantánea temporal (facturable) en el almacén de respaldo y, a continuación, la copian en un almacén aislado de forma lógica. Los recursos no compatibles solo se respaldan en el almacén de respaldo especificado.  
Tipo: cadena  
Requerido: no

 ** [RecoveryPointTags](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-RecoveryPointTags"></a>
Las etiquetas para asignar a los recursos.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [ResourceArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-ResourceArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Obligatorio: sí

 ** [StartWindowMinutes](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-StartWindowMinutes"></a>
Un valor en minutos después del que una copia de seguridad está programada antes de que se cancele el trabajo si no se ha iniciado correctamente. El valor es opcional y el valor predeterminado es 8 horas. Si se incluye este valor, debe ser de al menos 60 minutos para evitar errores.  
Este parámetro tiene un valor máximo de 100 años (52 560 000 minutos).  
Durante el intervalo de inicio, el estado del trabajo de copia de seguridad permanece en ese estado `CREATED` hasta que comience correctamente o hasta que se agote el tiempo del intervalo de inicio. Si dentro de la ventana de inicio, Time AWS Backup recibe un error que permite volver a intentar el trabajo, AWS Backup volverá a intentarlo automáticamente al menos cada 10 minutos hasta que la copia de seguridad comience correctamente (el estado del trabajo cambia a`RUNNING`) o hasta que el estado del trabajo cambie a `EXPIRED` (lo que se espera que ocurra cuando finalice el tiempo de la ventana de inicio).  
Tipo: largo  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_StartBackupJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupJobId": "string",
   "CreationDate": number,
   "IsParent": boolean,
   "RecoveryPointArn": "string"
}
```

## Elementos de respuesta
<a name="API_StartBackupJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupJobId](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-BackupJobId"></a>
Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso.  
Tipo: cadena

 ** [CreationDate](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-CreationDate"></a>
La fecha y la hora en que se creó el trabajo de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IsParent](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-IsParent"></a>
Se trata de un valor booleano devuelto que indica que es un trabajo de copia de seguridad principal (compuesto).  
Tipo: Booleano

 ** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-RecoveryPointArn"></a>
 *Nota: Este campo solo se devuelve para los recursos avanzados de DynamoDB y Amazon EFS.*   
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

## Errores
<a name="API_StartBackupJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_StartBackupJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartBackupJob) 

# StartCopyJob
<a name="API_StartCopyJob"></a>

Inicia un trabajo para crear una copia única del recurso especificado.

No admite copias de seguridad continuas.

Consulte [Reintentar tareas de copia](https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry) para obtener información sobre cómo se AWS Backup reintentan las operaciones de copia de tareas.

## Sintaxis de la solicitud
<a name="API_StartCopyJob_RequestSyntax"></a>

```
PUT /copy-jobs HTTP/1.1
Content-type: application/json

{
   "DestinationBackupVaultArn": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string",
   "SourceBackupVaultName": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_StartCopyJob_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartCopyJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-DestinationBackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad de destino al que copiar; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Obligatorio: sí

 ** [IamRoleArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para copiar el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Obligatorio: sí

 ** [IdempotencyToken](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartCopyJob` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [Lifecycle](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-Lifecycle"></a>
Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine.  
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** [RecoveryPointArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación para usarlo en el trabajo de copia; por ejemplo, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 B5E7-9EB0-435A-A80B-108B488B0D45. EB3   
Tipo: cadena  
Obligatorio: sí

 ** [SourceBackupVaultName](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-SourceBackupVaultName"></a>
El nombre de un contenedor de origen lógico donde se almacenan las copias de seguridad. Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_StartCopyJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CopyJobId": "string",
   "CreationDate": number,
   "IsParent": boolean
}
```

## Elementos de respuesta
<a name="API_StartCopyJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CopyJobId](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-CopyJobId"></a>
Identifica de forma exclusiva un trabajo de copia.  
Tipo: cadena

 ** [CreationDate](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-CreationDate"></a>
La fecha y la hora en que se creó el trabajo de copia, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [IsParent](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-IsParent"></a>
Se trata de un valor booleano devuelto que indica que es un trabajo de copia principal (compuesto).  
Tipo: Booleano

## Errores
<a name="API_StartCopyJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_StartCopyJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartCopyJob) 

# StartReportJob
<a name="API_StartReportJob"></a>

Inicia un trabajo de informes bajo demanda para el plan de informes especificado.

## Sintaxis de la solicitud
<a name="API_StartReportJob_RequestSyntax"></a>

```
POST /audit/report-jobs/reportPlanName HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_StartReportJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [reportPlanName](#API_StartReportJob_RequestSyntax) **   <a name="Backup-StartReportJob-request-uri-ReportPlanName"></a>
El nombre único de un plan de informes.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_StartReportJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [IdempotencyToken](#API_StartReportJob_RequestSyntax) **   <a name="Backup-StartReportJob-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartReportJobInput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_StartReportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReportJobId": "string"
}
```

## Elementos de respuesta
<a name="API_StartReportJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ReportJobId](#API_StartReportJob_ResponseSyntax) **   <a name="Backup-StartReportJob-response-ReportJobId"></a>
El identificador del trabajo de informes. Una única cadena cifrada en UTF-8, Unicode, generada aleatoriamente que tiene como máximo una longitud de 1024 bytes. El ID del trabajo de informes no se puede editar.  
Tipo: cadena

## Errores
<a name="API_StartReportJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_StartReportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartReportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartReportJob) 

# StartRestoreJob
<a name="API_StartRestoreJob"></a>

Recupera el recurso guardado identificado por un nombre de recurso de Amazon (ARN).

## Sintaxis de la solicitud
<a name="API_StartRestoreJob_RequestSyntax"></a>

```
PUT /restore-jobs HTTP/1.1
Content-type: application/json

{
   "CopySourceTagsToRestoredResource": boolean,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Metadata": { 
      "string" : "string" 
   },
   "RecoveryPointArn": "string",
   "ResourceType": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_StartRestoreJob_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartRestoreJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-CopySourceTagsToRestoredResource"></a>
Se trata de un parámetro opcional. Si es igual a `True`, las etiquetas incluidas en la copia de seguridad se copiarán en el recurso restaurado.  
Esto solo se puede aplicar a las copias de seguridad creadas mediante AWS Backup.  
Tipo: Booleano  
Obligatorio: no

 ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-IamRoleArn"></a>
El nombre del recurso de Amazon (ARN) de la función de IAM que se AWS Backup utiliza para crear el recurso de destino; por ejemplo:. `arn:aws:iam::123456789012:role/S3Access`  
Tipo: cadena  
Requerido: no

 ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartRestoreJob` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [Metadata](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-Metadata"></a>
Un conjunto de pares clave-valor de metadatos.  
Para obtener los metadatos de configuración de un recurso en el momento en que se realizó la copia de seguridad, solo tiene que llamar a `GetRecoveryPointRestoreMetadata`. Sin embargo, es posible que para restaurar un recurso se necesiten valores adicionales a los proporcionados por el recurso `GetRecoveryPointRestoreMetadata`. Por ejemplo, puede que tenga que proporcionar un nombre de recurso nuevo si el original ya existe.  
Para obtener más información sobre los metadatos de cada recurso, consulte lo siguiente:  
+  [Metadata for Amazon Aurora](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) 
+  [Metadata for Amazon DocumentDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) 
+  [Metadatos para AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) 
+  [Metadata for Amazon DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) 
+  [ Metadata for Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) 
+  [Metadatos para Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) 
+  [Metadata for Amazon EFS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) 
+  [Metadatos de Amazon EKS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) 
+  [Metadatos para Amazon FSx](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) 
+  [Metadata for Amazon Neptune](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) 
+  [Metadata for Amazon RDS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) 
+  [Metadata for Amazon Redshift](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) 
+  [Metadatos para AWS Storage Gateway](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) 
+  [Metadata for Amazon S3](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) 
+  [Metadata for Amazon Timestream](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) 
+  [Metadata for virtual machines](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) 
Tipo: mapa de cadena a cadena  
Obligatorio: sí

 ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Obligatorio: sí

 ** [ResourceType](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-ResourceType"></a>
Inicia un trabajo para restaurar un punto de recuperación para uno de los siguientes recursos:  
+  `Aurora` - Amazon Aurora
+  `DocumentDB` - Amazon DocumentDB
+  `CloudFormation` - AWS CloudFormation 
+  `DynamoDB` - Amazon DynamoDB
+  `EBS` - Amazon Elastic Block Store
+  `EC2` - Amazon Elastic Compute Cloud
+  `EFS` - Amazon Elastic File System
+  `EKS`- Servicio Amazon Elastic Kubernetes Service
+  `FSx`- Amazon FSx
+  `Neptune` - Amazon Neptune
+  `RDS` - Amazon Relational Database Service
+  `Redshift` - Amazon Redshift
+  `Storage Gateway` - AWS Storage Gateway 
+  `S3` - Amazon Simple Storage Service
+  `Timestream` - Amazon Timestream
+  `VirtualMachine` - Máquinas virtuales
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_StartRestoreJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "string"
}
```

## Elementos de respuesta
<a name="API_StartRestoreJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) **   <a name="Backup-StartRestoreJob-response-RestoreJobId"></a>
Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.  
Tipo: cadena

## Errores
<a name="API_StartRestoreJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_StartRestoreJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob) 

# StartScanJob
<a name="API_StartScanJob"></a>

Comienza a escanear trabajos en busca de recursos específicos.

## Sintaxis de la solicitud
<a name="API_StartScanJob_RequestSyntax"></a>

```
PUT /scan/job HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_StartScanJob_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartScanJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupVaultName](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Tipo: cadena  
Obligatorio: sí

 ** [IamRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Obligatorio: sí

 ** [IdempotencyToken](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartScanJob` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [MalwareScanner](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-MalwareScanner"></a>
Especifica el escáner de malware utilizado durante el trabajo de escaneo. Actualmente, solo admite `GUARDDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY`   
Obligatorio: sí

 ** [RecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación. Este es el punto de recuperación objetivo para un análisis completo. Si está realizando un análisis incremental, este será el punto de recuperación que se haya creado después de seleccionar el punto de recuperación base.  
Tipo: cadena  
Obligatorio: sí

 ** [ScanBaseRecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanBaseRecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva el punto de recuperación base que se utilizará para el escaneo incremental.  
Tipo: cadena  
Requerido: no

 ** [ScanMode](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanMode"></a>
Especifica el tipo de escaneo que se utilizará para el trabajo de escaneo.  
Incluye:  
+  `FULL_SCAN`escaneará todo el linaje de datos de la copia de seguridad.
+  `INCREMENTAL_SCAN`escaneará la diferencia de datos entre el punto de recuperación objetivo y el ARN del punto de recuperación base.
Tipo: cadena  
Valores válidos: `FULL_SCAN | INCREMENTAL_SCAN`   
Obligatorio: sí

 ** [ScannerRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScannerRoleArn"></a>
Especificó el ARN del rol del escáner de IAM.  
Tipo: cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_StartScanJob_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationDate": number,
   "ScanJobId": "string"
}
```

## Elementos de respuesta
<a name="API_StartScanJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationDate](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-CreationDate"></a>
La fecha y la hora en que se creó el trabajo de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ScanJobId](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-ScanJobId"></a>
Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso.  
Tipo: cadena

## Errores
<a name="API_StartScanJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_StartScanJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartScanJob) 

# StopBackupJob
<a name="API_StopBackupJob"></a>

Intenta cancelar un trabajo para crear una copia de seguridad única de un recurso.

Esta acción no es compatible con los siguientes servicios:
+ Amazon Aurora
+ Amazon DocumentDB (compatible con MongoDB)
+ Amazon FSx para Lustre
+ Amazon FSx para NetApp ONTAP
+ Amazon FSx para OpenZFS
+ Servidor FSx de archivos Amazon para Windows
+ Amazon Neptune
+ Bases de datos SAP HANA en EC2 instancias de Amazon
+ Amazon RDS

## Sintaxis de la solicitud
<a name="API_StopBackupJob_RequestSyntax"></a>

```
POST /backup-jobs/backupJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_StopBackupJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupJobId](#API_StopBackupJob_RequestSyntax) **   <a name="Backup-StopBackupJob-request-uri-BackupJobId"></a>
Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_StopBackupJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_StopBackupJob_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_StopBackupJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_StopBackupJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_StopBackupJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StopBackupJob) 

# TagResource
<a name="API_TagResource"></a>

Asigna un conjunto de pares clave-valor a un recurso.

## Sintaxis de la solicitud
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_TagResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="Backup-TagResource-request-uri-ResourceArn"></a>
Es un ARN que identifica de forma unívoca un recurso.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_TagResource_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="Backup-TagResource-request-Tags"></a>
Pares clave-valor que se utiliza para ayudar a organizar los recursos. Puede asignar sus propios metadatos a los recursos que cree. Para mayor claridad, esta es la estructura para asignar etiquetas: `[{"Key":"string","Value":"string"}]`.  
Tipo: mapa de cadena a cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_TagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_TagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Elimina un conjunto de pares clave-valor de un punto de recuperación, plan de copia de seguridad o almacén de copias de seguridad identificado por un nombre de recurso de Amazon (ARN).

Esta API no es compatible con los puntos de recuperación de tipos de recursos, incluidos Aurora y Amazon DocumentDB. Amazon EBS, Amazon FSx, Neptune y Amazon RDS.

## Sintaxis de la solicitud
<a name="API_UntagResource_RequestSyntax"></a>

```
POST /untag/resourceArn HTTP/1.1
Content-type: application/json

{
   "TagKeyList": [ "string" ]
}
```

## Parámetros de solicitud del URI
<a name="API_UntagResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="Backup-UntagResource-request-uri-ResourceArn"></a>
Un ARN que identifica de forma única a un recurso. El formato del ARN depende del tipo de recurso etiquetado.  
ARNs que no lo incluyan `backup` son incompatibles con el etiquetado. `TagResource`y si `UntagResource` no es válido ARNs , se generará un error. Un contenido de ARN aceptable puede ser `arn:aws:backup:us-east`. Un contenido de ARN no válido puede ser `arn:aws:ec2:us-east`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UntagResource_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [TagKeyList](#API_UntagResource_RequestSyntax) **   <a name="Backup-UntagResource-request-TagKeyList"></a>
Las claves para identificar qué etiquetas clave-valor se deben eliminar de un recurso.  
Tipo: matriz de cadenas  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UntagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UntagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UntagResource) 

# UpdateBackupPlan
<a name="API_UpdateBackupPlan"></a>

Actualiza el plan de copia de seguridad especificado. La nueva versión se identifica únicamente con su ID.

## Sintaxis de la solicitud
<a name="API_UpdateBackupPlan_RequestSyntax"></a>

```
POST /backup/plans/backupPlanId HTTP/1.1
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateBackupPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupPlanId](#API_UpdateBackupPlan_RequestSyntax) **   <a name="Backup-UpdateBackupPlan-request-uri-BackupPlanId"></a>
El ID del plan de copia de seguridad.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateBackupPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [BackupPlan](#API_UpdateBackupPlan_RequestSyntax) **   <a name="Backup-UpdateBackupPlan-request-BackupPlan"></a>
El cuerpo de un plan de copia de seguridad. Incluye un `BackupPlanName` y uno o más conjuntos de `Rules`.  
Tipo: objeto [BackupPlanInput](API_BackupPlanInput.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateBackupPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "ScanSettings": [ 
      { 
         "MalwareScanner": "string",
         "ResourceTypes": [ "string" ],
         "ScannerRoleArn": "string"
      }
   ],
   "VersionId": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateBackupPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [AdvancedBackupSettings](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-AdvancedBackupSettings"></a>
Contiene una lista de `BackupOptions` para cada tipo de recurso.  
Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md)

 ** [BackupPlanArn](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena

 ** [BackupPlanId](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena

 ** [CreationDate](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-CreationDate"></a>
La fecha y la hora en que se creó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ScanSettings](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-ScanSettings"></a>
Contiene la configuración de escaneo para el plan de respaldo e incluye el escáner de malware, los recursos seleccionados y la función del escáner.  
Tipo: matriz de objetos [ScanSetting](API_ScanSetting.md)

 ** [VersionId](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-VersionId"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. Los ID de versión no se pueden editar.  
Tipo: cadena

## Errores
<a name="API_UpdateBackupPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateBackupPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateBackupPlan) 

# UpdateFramework
<a name="API_UpdateFramework"></a>

Actualiza el marco especificado.

## Sintaxis de la solicitud
<a name="API_UpdateFramework_RequestSyntax"></a>

```
PUT /audit/frameworks/frameworkName HTTP/1.1
Content-type: application/json

{
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "IdempotencyToken": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateFramework_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [frameworkName](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-uri-FrameworkName"></a>
El nombre único de un marco. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateFramework_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [FrameworkControls](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-FrameworkControls"></a>
Los controles que componen el marco. Cada control de la lista tiene un nombre, parámetros de entrada y alcance.  
Tipo: matriz de objetos [FrameworkControl](API_FrameworkControl.md)  
Obligatorio: no

 ** [FrameworkDescription](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-FrameworkDescription"></a>
Una descripción opcional del marco con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** [IdempotencyToken](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `UpdateFrameworkInput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

## Sintaxis de la respuesta
<a name="API_UpdateFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "FrameworkArn": "string",
   "FrameworkName": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateFramework_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_UpdateFramework_ResponseSyntax) **   <a name="Backup-UpdateFramework-response-CreationTime"></a>
Es la fecha y la hora en que se creó un marco con la norma ISO 8601. El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, 2020-07-10T15:00:00.000-08:00 representa el 10 de julio de 2020 a las 15:00 h, 8 horas menos que UTC.  
Tipo: marca temporal

 ** [FrameworkArn](#API_UpdateFramework_ResponseSyntax) **   <a name="Backup-UpdateFramework-response-FrameworkArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [FrameworkName](#API_UpdateFramework_ResponseSyntax) **   <a name="Backup-UpdateFramework-response-FrameworkName"></a>
El nombre único de un marco. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

## Errores
<a name="API_UpdateFramework_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateFramework_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateFramework) 

# UpdateGlobalSettings
<a name="API_UpdateGlobalSettings"></a>

Actualiza si la AWS cuenta ha habilitado diferentes opciones de administración multicuenta, incluida la copia de seguridad multicuenta, la aprobación multiparte y el administrador delegado. Devuelve un error si la cuenta no es una cuenta de administración de Organizations. Utilice la API `DescribeGlobalSettings` para determinar la configuración actual.

## Sintaxis de la solicitud
<a name="API_UpdateGlobalSettings_RequestSyntax"></a>

```
PUT /global-settings HTTP/1.1
Content-type: application/json

{
   "GlobalSettings": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateGlobalSettings_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UpdateGlobalSettings_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [GlobalSettings](#API_UpdateGlobalSettings_RequestSyntax) **   <a name="Backup-UpdateGlobalSettings-request-GlobalSettings"></a>
Las entradas pueden ser:  
Un valor para. `isCrossAccountBackupEnabled` Los valores pueden ser true o false. Ejemplo: `update-global-settings --global-settings isCrossAccountBackupEnabled=false`.  
Un valor para la aprobación de varias partes, con el siguiente estilo. `isMpaEnabled` Los valores pueden ser true o false. Ejemplo: `update-global-settings --global-settings isMpaEnabled=false`.  
Un valor para la creación de roles vinculados a Backup Service-Linked, con el estilo. `isDelegatedAdministratorEnabled` Los valores pueden ser true o false. Ejemplo: `update-global-settings --global-settings isDelegatedAdministratorEnabled=false`.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateGlobalSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UpdateGlobalSettings_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateGlobalSettings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateGlobalSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateGlobalSettings) 

# UpdateRecoveryPointIndexSettings
<a name="API_UpdateRecoveryPointIndexSettings"></a>

Esta operación actualiza la configuración de un índice de puntos de recuperación.

Necesario: BackupVaultName RecoveryPointArn, y IAMRole Arn

## Sintaxis de la solicitud
<a name="API_UpdateRecoveryPointIndexSettings_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json

{
   "IamRoleArn": "string",
   "Index": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateRecoveryPointIndexSettings_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de donde se crearon.  
Los caracteres permitidos son: letras minúsculas, números y guiones.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateRecoveryPointIndexSettings_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [IamRoleArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para esta operación.  
Por ejemplo, arn:aws:iam::123456789012:role/S3Access  
Tipo: cadena  
Requerido: no

 ** [Index](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-Index"></a>
El índice puede tener uno o dos valores posibles, `ENABLED` o `DISABLED`.  
Para crear un índice de copias de seguridad para un punto de recuperación `ACTIVE` elegible que aún no tiene un índice de copia de seguridad, establezca el valor en `ENABLED`.  
Para eliminar un índice de copias de seguridad, defina el valor en `DISABLED`.  
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateRecoveryPointIndexSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultName": "string",
   "Index": "string",
   "IndexStatus": "string",
   "RecoveryPointArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateRecoveryPointIndexSettings_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultName](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región donde se crearon.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [Index](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-Index"></a>
El índice puede tener uno o dos valores posibles, `ENABLED` o `DISABLED`.  
Un valor `ENABLED` significa que se ha creado un índice de copias de seguridad para un punto de recuperación `ACTIVE` elegible.  
Un valor `DISABLED` significa que se ha eliminado un índice de copias de seguridad.  
Tipo: cadena  
Valores válidos: `ENABLED | DISABLED` 

 ** [IndexStatus](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-IndexStatus"></a>
Este es el estado actual del índice de copias de seguridad asociado al punto de recuperación especificado.  
Los estados son: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Tipo: cadena  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [RecoveryPointArn](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

## Errores
<a name="API_UpdateRecoveryPointIndexSettings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateRecoveryPointIndexSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 

# UpdateRecoveryPointLifecycle
<a name="API_UpdateRecoveryPointLifecycle"></a>

Establece el ciclo de vida de transferencia de un punto de recuperación.

El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup cambia y vence las copias de seguridad automáticamente de acuerdo con el ciclo de vida que usted defina.

Los tipos de recursos que pueden pasar al almacenamiento en frío se muestran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.

Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en dicho almacenamiento durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.

**importante**  
Si su ciclo de vida utiliza actualmente los parámetros `DeleteAfterDays` y `MoveToColdStorageAfterDays`, incluya estos parámetros y sus valores cuando llame a esta operación. Si no los incluye, es posible que su plan se actualice con valores nulos.

Esta operación no admite copias de seguridad continuas.

## Sintaxis de la solicitud
<a name="API_UpdateRecoveryPointLifecycle_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json

{
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateRecoveryPointLifecycle_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [backupVaultName](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-uri-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** [recoveryPointArn](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-uri-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateRecoveryPointLifecycle_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Lifecycle](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup cambia y vence las copias de seguridad automáticamente de acuerdo con el ciclo de vida que usted defina.   
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.   
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateRecoveryPointLifecycle_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateRecoveryPointLifecycle_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BackupVaultArn](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-BackupVaultArn"></a>
Un ARN que identifica de forma exclusiva un almacén de copias de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena

 ** [CalculatedLifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-CalculatedLifecycle"></a>
Un objeto `CalculatedLifecycle` que contiene las marcas temporales `MoveToColdStorageAt` y `DeleteAt`.  
Tipo: objeto [CalculatedLifecycle](API_CalculatedLifecycle.md)

 ** [Lifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup cambia y vence las copias de seguridad automáticamente de acuerdo con el ciclo de vida que usted defina.  
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)

 ** [RecoveryPointArn](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

## Errores
<a name="API_UpdateRecoveryPointLifecycle_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** InvalidRequestException **   
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateRecoveryPointLifecycle_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 

# UpdateRegionSettings
<a name="API_UpdateRegionSettings"></a>

Actualiza la configuración actual de suscripción del servicio para la región.

Utilice la API `DescribeRegionSettings` para determinar los tipos de recursos compatibles.

## Sintaxis de la solicitud
<a name="API_UpdateRegionSettings_RequestSyntax"></a>

```
PUT /account-settings HTTP/1.1
Content-type: application/json

{
   "ResourceTypeManagementPreference": { 
      "string" : boolean 
   },
   "ResourceTypeOptInPreference": { 
      "string" : boolean 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateRegionSettings_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UpdateRegionSettings_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceTypeManagementPreference](#API_UpdateRegionSettings_RequestSyntax) **   <a name="Backup-UpdateRegionSettings-request-ResourceTypeManagementPreference"></a>
Habilita o deshabilita la AWS Backup administración completa de las copias de seguridad para un tipo de recurso. [Para habilitar la AWS Backup administración completa de DynamoDB junto con las funciones [avanzadas de copia de seguridad AWS Backup de DynamoDB, siga el procedimiento para habilitar la copia de seguridad avanzada de DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html) mediante programación.](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli)  
Tipo: mapa de cadena a booleano  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** [ResourceTypeOptInPreference](#API_UpdateRegionSettings_RequestSyntax) **   <a name="Backup-UpdateRegionSettings-request-ResourceTypeOptInPreference"></a>
Actualiza la lista de servicios junto con las preferencias de suscripción de la región.  
Si las asignaciones de recursos se basan únicamente en etiquetas, se aplica la configuración de suscripción al servicio. Si un tipo de recurso se asigna explícitamente a un plan de respaldo, como Amazon S3 EC2, Amazon o Amazon RDS, se incluirá en el respaldo incluso si la opción no está habilitada para ese servicio en particular. Si en una asignación de recursos se especifican tanto el tipo de recurso como las etiquetas, el tipo de recurso especificado en el plan de copia de seguridad tiene prioridad sobre la condición de la etiqueta. En esta situación no se tiene en cuenta la configuración de suscripción al servicio.  
Tipo: mapa de cadena a booleano  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateRegionSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UpdateRegionSettings_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UpdateRegionSettings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateRegionSettings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRegionSettings) 

# UpdateReportPlan
<a name="API_UpdateReportPlan"></a>

Actualiza el plan de informes especificado.

## Sintaxis de la solicitud
<a name="API_UpdateReportPlan_RequestSyntax"></a>

```
PUT /audit/report-plans/reportPlanName HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string",
   "ReportDeliveryChannel": { 
      "Formats": [ "string" ],
      "S3BucketName": "string",
      "S3KeyPrefix": "string"
   },
   "ReportPlanDescription": "string",
   "ReportSetting": { 
      "Accounts": [ "string" ],
      "FrameworkArns": [ "string" ],
      "NumberOfFrameworks": number,
      "OrganizationUnits": [ "string" ],
      "Regions": [ "string" ],
      "ReportTemplate": "string"
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateReportPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [reportPlanName](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-uri-ReportPlanName"></a>
El nombre único del plan de informes. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateReportPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [IdempotencyToken](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `UpdateReportPlanInput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [ReportDeliveryChannel](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-ReportDeliveryChannel"></a>
La información sobre dónde entregar sus informes, específicamente el nombre del bucket de Amazon S3, el prefijo de clave de S3 y los formatos de sus informes.  
Tipo: objeto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)  
Obligatorio: no

 ** [ReportPlanDescription](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-ReportPlanDescription"></a>
Una descripción opcional del plan de informes con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** [ReportSetting](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-ReportSetting"></a>
La plantilla para el informe. Los informes se crean mediante una plantilla. Las plantillas de informes son:  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`   
Si la plantilla del informe es `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, este recurso de API también describe la cobertura del informe por Regiones de AWS y los marcos.  
Tipo: objeto [ReportSetting](API_ReportSetting.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateReportPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_UpdateReportPlan_ResponseSyntax) **   <a name="Backup-UpdateReportPlan-response-CreationTime"></a>
La fecha y la hora en que se creó el plan de informes, en formato Unix y horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ReportPlanArn](#API_UpdateReportPlan_ResponseSyntax) **   <a name="Backup-UpdateReportPlan-response-ReportPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [ReportPlanName](#API_UpdateReportPlan_ResponseSyntax) **   <a name="Backup-UpdateReportPlan-response-ReportPlanName"></a>
El nombre único del plan de informes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

## Errores
<a name="API_UpdateReportPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateReportPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateReportPlan) 

# UpdateRestoreTestingPlan
<a name="API_UpdateRestoreTestingPlan"></a>

Esta solicitud enviará los cambios al plan de prueba de restauración especificado. `RestoreTestingPlanName` no se puede actualizar después de crearlo.

 `RecoveryPointSelection` puede contener:
+  `Algorithm` 
+  `ExcludeVaults` 
+  `IncludeVaults` 
+  `RecoveryPointTypes` 
+  `SelectionWindowDays` 

## Sintaxis de la solicitud
<a name="API_UpdateRestoreTestingPlan_RequestSyntax"></a>

```
PUT /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
Content-type: application/json

{
   "RestoreTestingPlan": { 
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateRestoreTestingPlan_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
El nombre del plan de prueba de restauración.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateRestoreTestingPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [RestoreTestingPlan](#API_UpdateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-request-RestoreTestingPlan"></a>
Especifica el cuerpo de un plan de prueba de restauración.  
Tipo: objeto [RestoreTestingPlanForUpdate](API_RestoreTestingPlanForUpdate.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string",
   "UpdateTime": number
}
```

## Elementos de respuesta
<a name="API_UpdateRestoreTestingPlan_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-CreationTime"></a>
El momento en que se creó el plan de prueba de recursos.  
Tipo: marca temporal

 ** [RestoreTestingPlanArn](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
ARN (Amazon Resource Name) único del plan de prueba de restauración.  
Tipo: cadena

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena

 ** [UpdateTime](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-UpdateTime"></a>
La hora en la que se completó la actualización del plan de prueba de restauración.  
Tipo: marca temporal

## Errores
<a name="API_UpdateRestoreTestingPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateRestoreTestingPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRestoreTestingPlan) 

# UpdateRestoreTestingSelection
<a name="API_UpdateRestoreTestingSelection"></a>

Actualiza la selección de pruebas de restauración especificada.

La mayoría de los elementos, salvo el `RestoreTestingSelectionName`, se pueden actualizar con esta solicitud.

Puede usar el recurso ARNs o las condiciones protegidos, pero no ambos.

## Sintaxis de la solicitud
<a name="API_UpdateRestoreTestingSelection_RequestSyntax"></a>

```
PUT /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
Content-type: application/json

{
   "RestoreTestingSelection": { 
      "IamRoleArn": "string",
      "ProtectedResourceArns": [ "string" ],
      "ProtectedResourceConditions": { 
         "StringEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      },
      "RestoreMetadataOverrides": { 
         "string" : "string" 
      },
      "ValidationWindowHours": number
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateRestoreTestingSelection_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
El nombre del plan de prueba de restauración es obligatorio para actualizar el plan de prueba indicado.  
Obligatorio: sí

 ** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
El nombre de la selección de pruebas de restauración obligatorias que desea actualizar.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateRestoreTestingSelection_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [RestoreTestingSelection](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-RestoreTestingSelection"></a>
Para actualizar la selección de pruebas de restauración, puede utilizar un recurso ARNs o condiciones protegidos, pero no ambos. Es decir, si su selección tiene `ProtectedResourceArns`, no podrá solicitar una actualización con el parámetro `ProtectedResourceConditions`.  
Tipo: objeto [RestoreTestingSelectionForUpdate](API_RestoreTestingSelectionForUpdate.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string",
   "RestoreTestingSelectionName": "string",
   "UpdateTime": number
}
```

## Elementos de respuesta
<a name="API_UpdateRestoreTestingSelection_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-CreationTime"></a>
La hora en la que la selección de pruebas de recursos se actualizó correctamente.  
Tipo: marca temporal

 ** [RestoreTestingPlanArn](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingPlanArn"></a>
Cadena única que es el nombre del plan de prueba de restauración.  
Tipo: cadena

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingPlanName"></a>
El plan de prueba de restauración al que está asociada la selección de pruebas de restauración actualizada.  
Tipo: cadena

 ** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingSelectionName"></a>
El nombre de la selección de pruebas de restauración devuelta.  
Tipo: cadena

 ** [UpdateTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-UpdateTime"></a>
La hora en la que se completó la actualización de la selección de pruebas de restauración.  
Tipo: marca temporal

## Errores
<a name="API_UpdateRestoreTestingSelection_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateRestoreTestingSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRestoreTestingSelection) 

# UpdateTieringConfiguration
<a name="API_UpdateTieringConfiguration"></a>

Esta solicitud enviará los cambios a la configuración de estratificación especificada. `TieringConfigurationName`no se puede actualizar una vez creada.

 `ResourceSelection` puede contener:
+  `Resources` 
+  `TieringDownSettingsInDays` 
+  `ResourceType` 

## Sintaxis de la solicitud
<a name="API_UpdateTieringConfiguration_RequestSyntax"></a>

```
PUT /tiering-configurations/tieringConfigurationName HTTP/1.1
Content-type: application/json

{
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ]
   }
}
```

## Parámetros de solicitud del URI
<a name="API_UpdateTieringConfiguration_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [tieringConfigurationName](#API_UpdateTieringConfiguration_RequestSyntax) **   <a name="Backup-UpdateTieringConfiguration-request-uri-TieringConfigurationName"></a>
El nombre de la configuración de estratificación que se va a actualizar.  
Patrón: `^[a-zA-Z0-9_]{1,200}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_UpdateTieringConfiguration_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [TieringConfiguration](#API_UpdateTieringConfiguration_RequestSyntax) **   <a name="Backup-UpdateTieringConfiguration-request-TieringConfiguration"></a>
Especifica el cuerpo de una configuración de estratificación.  
Tipo: objeto [TieringConfigurationInputForUpdate](API_TieringConfigurationInputForUpdate.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "LastUpdatedTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateTieringConfiguration_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-CreationTime"></a>
La fecha y la hora en que se creó una configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [LastUpdatedTime](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-LastUpdatedTime"></a>
Fecha y hora en que se actualizó la configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `LastUpdatedTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [TieringConfigurationArn](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-TieringConfigurationArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva la configuración de estratificación actualizada.  
Tipo: cadena

 ** [TieringConfigurationName](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-TieringConfigurationName"></a>
Esta cadena única es el nombre de la configuración de estratificación.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9_]{1,200}$` 

## Errores
<a name="API_UpdateTieringConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

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

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_UpdateTieringConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateTieringConfiguration) 

# AWS Backup gateway
<a name="API_Operations_AWS_Backup_Gateway"></a>

AWS Backup gateway admiten las siguientes acciones:
+  [AssociateGatewayToServer](API_BGW_AssociateGatewayToServer.md) 
+  [CreateGateway](API_BGW_CreateGateway.md) 
+  [DeleteGateway](API_BGW_DeleteGateway.md) 
+  [DeleteHypervisor](API_BGW_DeleteHypervisor.md) 
+  [DisassociateGatewayFromServer](API_BGW_DisassociateGatewayFromServer.md) 
+  [GetBandwidthRateLimitSchedule](API_BGW_GetBandwidthRateLimitSchedule.md) 
+  [GetGateway](API_BGW_GetGateway.md) 
+  [GetHypervisor](API_BGW_GetHypervisor.md) 
+  [GetHypervisorPropertyMappings](API_BGW_GetHypervisorPropertyMappings.md) 
+  [GetVirtualMachine](API_BGW_GetVirtualMachine.md) 
+  [ImportHypervisorConfiguration](API_BGW_ImportHypervisorConfiguration.md) 
+  [ListGateways](API_BGW_ListGateways.md) 
+  [ListHypervisors](API_BGW_ListHypervisors.md) 
+  [ListTagsForResource](API_BGW_ListTagsForResource.md) 
+  [ListVirtualMachines](API_BGW_ListVirtualMachines.md) 
+  [PutBandwidthRateLimitSchedule](API_BGW_PutBandwidthRateLimitSchedule.md) 
+  [PutHypervisorPropertyMappings](API_BGW_PutHypervisorPropertyMappings.md) 
+  [PutMaintenanceStartTime](API_BGW_PutMaintenanceStartTime.md) 
+  [StartVirtualMachinesMetadataSync](API_BGW_StartVirtualMachinesMetadataSync.md) 
+  [TagResource](API_BGW_TagResource.md) 
+  [TestHypervisorConfiguration](API_BGW_TestHypervisorConfiguration.md) 
+  [UntagResource](API_BGW_UntagResource.md) 
+  [UpdateGatewayInformation](API_BGW_UpdateGatewayInformation.md) 
+  [UpdateGatewaySoftwareNow](API_BGW_UpdateGatewaySoftwareNow.md) 
+  [UpdateHypervisor](API_BGW_UpdateHypervisor.md) 

# AssociateGatewayToServer
<a name="API_BGW_AssociateGatewayToServer"></a>

Asocia una puerta de enlace de copia de seguridad a su servidor. Después de completar el proceso de asociación, puede realizar una copia de seguridad y restaurarla a VMs través de la puerta de enlace.

## Sintaxis de la solicitud
<a name="API_BGW_AssociateGatewayToServer_RequestSyntax"></a>

```
{
   "GatewayArn": "string",
   "ServerArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_AssociateGatewayToServer_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_AssociateGatewayToServer_RequestSyntax) **   <a name="Backup-BGW_AssociateGatewayToServer-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la `ListGateways` operación para devolver una lista de pasarelas para su cuenta y Región de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [ServerArn](#API_BGW_AssociateGatewayToServer_RequestSyntax) **   <a name="Backup-BGW_AssociateGatewayToServer-request-ServerArn"></a>
El nombre de recurso de Amazon (ARN) del servidor que aloja la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_AssociateGatewayToServer_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_AssociateGatewayToServer_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_AssociateGatewayToServer_ResponseSyntax) **   <a name="Backup-BGW_AssociateGatewayToServer-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de una puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_AssociateGatewayToServer_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_AssociateGatewayToServer_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/AssociateGatewayToServer) 

# CreateGateway
<a name="API_BGW_CreateGateway"></a>

Crea una puerta de enlace de copia de seguridad. Después de crear una puerta de enlace, puede asociarla a un servidor mediante la operación `AssociateGatewayToServer`.

## Sintaxis de la solicitud
<a name="API_BGW_CreateGateway_RequestSyntax"></a>

```
{
   "ActivationKey": "string",
   "GatewayDisplayName": "string",
   "GatewayType": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_BGW_CreateGateway_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ActivationKey](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-ActivationKey"></a>
La clave de activación de la puerta de enlace creada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.  
Patrón: `[0-9a-zA-Z\-]+`   
Obligatorio: sí

 ** [GatewayDisplayName](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayDisplayName"></a>
El nombre de visualización de la puerta de enlace creada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: sí

 ** [GatewayType](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayType"></a>
El tipo de puerta de enlace creada.  
Tipo: cadena  
Valores válidos: `BACKUP_VM`   
Obligatorio: sí

 ** [Tags](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-Tags"></a>
Una lista de hasta 50 etiquetas que se asignarán a la puerta de enlace. Cada etiqueta es un par clave-valor.  
Tipo: matriz de objetos [Tag](API_BGW_Tag.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_CreateGateway_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_CreateGateway_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_CreateGateway_ResponseSyntax) **   <a name="Backup-BGW_CreateGateway-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que crea.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_CreateGateway_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_CreateGateway_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/CreateGateway) 

# DeleteGateway
<a name="API_BGW_DeleteGateway"></a>

Elimina una puerta de enlace de copia de seguridad.

## Sintaxis de la solicitud
<a name="API_BGW_DeleteGateway_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_DeleteGateway_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_DeleteGateway_RequestSyntax) **   <a name="Backup-BGW_DeleteGateway-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_DeleteGateway_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_DeleteGateway_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_DeleteGateway_ResponseSyntax) **   <a name="Backup-BGW_DeleteGateway-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que ha eliminado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_DeleteGateway_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_DeleteGateway_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DeleteGateway) 

# DeleteHypervisor
<a name="API_BGW_DeleteHypervisor"></a>

Elimina un hipervisor.

## Sintaxis de la solicitud
<a name="API_BGW_DeleteHypervisor_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_DeleteHypervisor_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [HypervisorArn](#API_BGW_DeleteHypervisor_RequestSyntax) **   <a name="Backup-BGW_DeleteHypervisor-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_DeleteHypervisor_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_DeleteHypervisor_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [HypervisorArn](#API_BGW_DeleteHypervisor_ResponseSyntax) **   <a name="Backup-BGW_DeleteHypervisor-response-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor que ha eliminado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_DeleteHypervisor_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
La operación no puede continuar porque no tiene permisos suficientes.    
 ** ErrorCode **   
Es una descripción del motivo por el que no tiene permisos suficientes.
Código de estado HTTP: 400

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_DeleteHypervisor_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DeleteHypervisor) 

# DisassociateGatewayFromServer
<a name="API_BGW_DisassociateGatewayFromServer"></a>

Disocia una puerta de enlace de copia de seguridad del servidor especificado. Una vez finalizado el proceso de disociación, la puerta de enlace ya no podrá acceder a las máquinas virtuales del servidor.

## Sintaxis de la solicitud
<a name="API_BGW_DisassociateGatewayFromServer_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_DisassociateGatewayFromServer_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_DisassociateGatewayFromServer_RequestSyntax) **   <a name="Backup-BGW_DisassociateGatewayFromServer-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que se va a disociar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_DisassociateGatewayFromServer_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_DisassociateGatewayFromServer_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_DisassociateGatewayFromServer_ResponseSyntax) **   <a name="Backup-BGW_DisassociateGatewayFromServer-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que ha disociado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_DisassociateGatewayFromServer_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_DisassociateGatewayFromServer_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 

# GetBandwidthRateLimitSchedule
<a name="API_BGW_GetBandwidthRateLimitSchedule"></a>

Recupera la programación de límite de velocidad de ancho de banda de una puerta de enlace especificada. De forma predeterminada, las puertas de enlace no tienen una programación de límite de velocidad de ancho de banda, lo que significa que no hay ningún límite de velocidad de ancho de banda en vigor. Use esto para obtener la programación de límite de velocidad de ancho de banda de una puerta de enlace.

## Sintaxis de la solicitud
<a name="API_BGW_GetBandwidthRateLimitSchedule_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_GetBandwidthRateLimitSchedule_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_GetBandwidthRateLimitSchedule_RequestSyntax) **   <a name="Backup-BGW_GetBandwidthRateLimitSchedule-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html)operación para devolver una lista de pasarelas para su cuenta y Región de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax"></a>

```
{
   "BandwidthRateLimitIntervals": [ 
      { 
         "AverageUploadRateLimitInBitsPerSec": number,
         "DaysOfWeek": [ number ],
         "EndHourOfDay": number,
         "EndMinuteOfHour": number,
         "StartHourOfDay": number,
         "StartMinuteOfHour": number
      }
   ],
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_GetBandwidthRateLimitSchedule_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [BandwidthRateLimitIntervals](#API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax) **   <a name="Backup-BGW_GetBandwidthRateLimitSchedule-response-BandwidthRateLimitIntervals"></a>
Una matriz que contiene los intervalos de programación de límite de velocidad de ancho de banda para una puerta de enlace. Cuando no se ha programado ningún intervalo de límite de velocidad de ancho de banda, la matriz está vacía.  
Tipo: matriz de objetos [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.

 ** [GatewayArn](#API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax) **   <a name="Backup-BGW_GetBandwidthRateLimitSchedule-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html)operación para devolver una lista de pasarelas para su cuenta y. Región de AWS  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_GetBandwidthRateLimitSchedule_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_GetBandwidthRateLimitSchedule_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 

# GetGateway
<a name="API_BGW_GetGateway"></a>

Al proporcionar el ARN (nombre de recurso de Amazon), esta API devuelve la puerta de enlace.

## Sintaxis de la solicitud
<a name="API_BGW_GetGateway_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_GetGateway_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_GetGateway_RequestSyntax) **   <a name="Backup-BGW_GetGateway-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_GetGateway_ResponseSyntax"></a>

```
{
   "Gateway": { 
      "DeprecationDate": number,
      "GatewayArn": "string",
      "GatewayDisplayName": "string",
      "GatewayType": "string",
      "HypervisorId": "string",
      "LastSeenTime": number,
      "MaintenanceStartTime": { 
         "DayOfMonth": number,
         "DayOfWeek": number,
         "HourOfDay": number,
         "MinuteOfHour": number
      },
      "NextUpdateAvailabilityTime": number,
      "SoftwareVersion": "string",
      "VpcEndpoint": "string"
   }
}
```

## Elementos de respuesta
<a name="API_BGW_GetGateway_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Gateway](#API_BGW_GetGateway_ResponseSyntax) **   <a name="Backup-BGW_GetGateway-response-Gateway"></a>
Al proporcionar el ARN (nombre de recurso de Amazon), esta API devuelve la puerta de enlace.  
Tipo: objeto [GatewayDetails](API_BGW_GatewayDetails.md)

## Errores
<a name="API_BGW_GetGateway_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_GetGateway_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetGateway) 

# GetHypervisor
<a name="API_BGW_GetHypervisor"></a>

Esta acción solicita información sobre el hipervisor especificado al que se conectará la puerta de enlace. Un hipervisor es un hardware, software o firmware que crea y administra máquinas virtuales y les asigna recursos.

## Sintaxis de la solicitud
<a name="API_BGW_GetHypervisor_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_GetHypervisor_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [HypervisorArn](#API_BGW_GetHypervisor_RequestSyntax) **   <a name="Backup-BGW_GetHypervisor-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_GetHypervisor_ResponseSyntax"></a>

```
{
   "Hypervisor": { 
      "Host": "string",
      "HypervisorArn": "string",
      "KmsKeyArn": "string",
      "LastSuccessfulMetadataSyncTime": number,
      "LatestMetadataSyncStatus": "string",
      "LatestMetadataSyncStatusMessage": "string",
      "LogGroupArn": "string",
      "Name": "string",
      "State": "string"
   }
}
```

## Elementos de respuesta
<a name="API_BGW_GetHypervisor_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Hypervisor](#API_BGW_GetHypervisor_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisor-response-Hypervisor"></a>
Detalles sobre el hipervisor solicitado.  
Tipo: objeto [HypervisorDetails](API_BGW_HypervisorDetails.md)

## Errores
<a name="API_BGW_GetHypervisor_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_GetHypervisor_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetHypervisor) 

# GetHypervisorPropertyMappings
<a name="API_BGW_GetHypervisorPropertyMappings"></a>

Esta acción recupera las asignaciones de propiedades del hipervisor especificado. Un mapeo de propiedades de hipervisor muestra la relación entre las propiedades de la entidad disponibles en el hipervisor y las propiedades disponibles en. AWS

## Sintaxis de la solicitud
<a name="API_BGW_GetHypervisorPropertyMappings_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_GetHypervisorPropertyMappings_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [HypervisorArn](#API_BGW_GetHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_GetHypervisorPropertyMappings_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string",
   "IamRoleArn": "string",
   "VmwareToAwsTagMappings": [ 
      { 
         "AwsTagKey": "string",
         "AwsTagValue": "string",
         "VmwareCategory": "string",
         "VmwareTagName": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_BGW_GetHypervisorPropertyMappings_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [HypervisorArn](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-response-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

 ** [IamRoleArn](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-response-IamRoleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de IAM.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):iam::([0-9]+):role/(\S+)` 

 ** [VmwareToAwsTagMappings](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-response-VmwareToAwsTagMappings"></a>
Esta es una visualización de las asignaciones de etiquetas a las VMware etiquetas. AWS   
Tipo: matriz de objetos [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md)

## Errores
<a name="API_BGW_GetHypervisorPropertyMappings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_GetHypervisorPropertyMappings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 

# GetVirtualMachine
<a name="API_BGW_GetVirtualMachine"></a>

Al proporcionar el ARN (nombre de recurso de Amazon), esta API devuelve la máquina virtual.

## Sintaxis de la solicitud
<a name="API_BGW_GetVirtualMachine_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_GetVirtualMachine_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceArn](#API_BGW_GetVirtualMachine_RequestSyntax) **   <a name="Backup-BGW_GetVirtualMachine-request-ResourceArn"></a>
El nombre de recurso de Amazon (ARN) de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_GetVirtualMachine_ResponseSyntax"></a>

```
{
   "VirtualMachine": { 
      "HostName": "string",
      "HypervisorId": "string",
      "LastBackupDate": number,
      "Name": "string",
      "Path": "string",
      "ResourceArn": "string",
      "VmwareTags": [ 
         { 
            "VmwareCategory": "string",
            "VmwareTagDescription": "string",
            "VmwareTagName": "string"
         }
      ]
   }
}
```

## Elementos de respuesta
<a name="API_BGW_GetVirtualMachine_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [VirtualMachine](#API_BGW_GetVirtualMachine_ResponseSyntax) **   <a name="Backup-BGW_GetVirtualMachine-response-VirtualMachine"></a>
Este objeto contiene los atributos básicos de las `VirtualMachine` contenidas en el resultado de `GetVirtualMachine`   
Tipo: objeto [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md)

## Errores
<a name="API_BGW_GetVirtualMachine_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_GetVirtualMachine_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetVirtualMachine) 

# ImportHypervisorConfiguration
<a name="API_BGW_ImportHypervisorConfiguration"></a>

Conéctese a un hipervisor importando su configuración.

## Sintaxis de la solicitud
<a name="API_BGW_ImportHypervisorConfiguration_RequestSyntax"></a>

```
{
   "Host": "string",
   "KmsKeyArn": "string",
   "Name": "string",
   "Password": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "Username": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_ImportHypervisorConfiguration_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Host](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Host"></a>
El host del servidor del hipervisor. Puede ser una dirección IP o un nombre de dominio completo (FQDN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 128.  
Patrón: `.+`   
Obligatorio: sí

 ** [KmsKeyArn](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-KmsKeyArn"></a>
El AWS Key Management Service para el hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`   
Obligatorio: no

 ** [Name](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Name"></a>
El nombre del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: sí

 ** [Password](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Password"></a>
La contraseña del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[ -~]+`   
Obligatorio: no

 ** [Tags](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Tags"></a>
Las etiquetas de configuración del hipervisor que se van a importar.  
Tipo: matriz de objetos [Tag](API_BGW_Tag.md)  
Obligatorio: no

 ** [Username](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Username"></a>
El nombre de usuario del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_ImportHypervisorConfiguration_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_ImportHypervisorConfiguration_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [HypervisorArn](#API_BGW_ImportHypervisorConfiguration_ResponseSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-response-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor que ha disociado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_ImportHypervisorConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
La operación no puede continuar porque no tiene permisos suficientes.    
 ** ErrorCode **   
Es una descripción del motivo por el que no tiene permisos suficientes.
Código de estado HTTP: 400

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_ImportHypervisorConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 

# ListGateways
<a name="API_BGW_ListGateways"></a>

Enumera las puertas de enlace de respaldo propiedad de un Cuenta de AWS en un Región de AWS. La lista obtenida se ordena por el nombre de recurso de Amazon (ARN) de la puerta de enlace.

## Sintaxis de la solicitud
<a name="API_BGW_ListGateways_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_ListGateways_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_BGW_ListGateways_RequestSyntax) **   <a name="Backup-BGW_ListGateways-request-MaxResults"></a>
El número máximo de puertas de enlace que se van a enumerar.  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [NextToken](#API_BGW_ListGateways_RequestSyntax) **   <a name="Backup-BGW_ListGateways-request-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_ListGateways_ResponseSyntax"></a>

```
{
   "Gateways": [ 
      { 
         "GatewayArn": "string",
         "GatewayDisplayName": "string",
         "GatewayType": "string",
         "HypervisorId": "string",
         "LastSeenTime": number
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_ListGateways_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Gateways](#API_BGW_ListGateways_ResponseSyntax) **   <a name="Backup-BGW_ListGateways-response-Gateways"></a>
Una lista de sus puertas de enlace.  
Tipo: matriz de objetos [Gateway](API_BGW_Gateway.md)

 ** [NextToken](#API_BGW_ListGateways_ResponseSyntax) **   <a name="Backup-BGW_ListGateways-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `maxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `.+` 

## Errores
<a name="API_BGW_ListGateways_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_ListGateways_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListGateways) 

# ListHypervisors
<a name="API_BGW_ListHypervisors"></a>

Enumera los hipervisores.

## Sintaxis de la solicitud
<a name="API_BGW_ListHypervisors_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_ListHypervisors_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [MaxResults](#API_BGW_ListHypervisors_RequestSyntax) **   <a name="Backup-BGW_ListHypervisors-request-MaxResults"></a>
El número máximo de hipervisores que se van a enumerar.  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [NextToken](#API_BGW_ListHypervisors_RequestSyntax) **   <a name="Backup-BGW_ListHypervisors-request-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `maxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_ListHypervisors_ResponseSyntax"></a>

```
{
   "Hypervisors": [ 
      { 
         "Host": "string",
         "HypervisorArn": "string",
         "KmsKeyArn": "string",
         "Name": "string",
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_ListHypervisors_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Hypervisors](#API_BGW_ListHypervisors_ResponseSyntax) **   <a name="Backup-BGW_ListHypervisors-response-Hypervisors"></a>
Una lista de tus `Hypervisor` objetos, ordenados por sus nombres de recursos de Amazon (ARNs).  
Tipo: matriz de objetos [Hypervisor](API_BGW_Hypervisor.md)

 ** [NextToken](#API_BGW_ListHypervisors_ResponseSyntax) **   <a name="Backup-BGW_ListHypervisors-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `maxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `.+` 

## Errores
<a name="API_BGW_ListHypervisors_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_ListHypervisors_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListHypervisors) 

# ListTagsForResource
<a name="API_BGW_ListTagsForResource"></a>

Enumera las etiquetas aplicadas al recurso identificado por su nombre de recurso de Amazon (ARN).

## Sintaxis de la solicitud
<a name="API_BGW_ListTagsForResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_ListTagsForResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceArn](#API_BGW_ListTagsForResource_RequestSyntax) **   <a name="Backup-BGW_ListTagsForResource-request-ResourceArn"></a>
El nombre de recurso de Amazon (ARN) de las etiquetas del recurso a enumerar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_ListTagsForResource_ResponseSyntax"></a>

```
{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_BGW_ListTagsForResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ResourceArn](#API_BGW_ListTagsForResource_ResponseSyntax) **   <a name="Backup-BGW_ListTagsForResource-response-ResourceArn"></a>
El nombre de recurso de Amazon (ARN) de las etiquetas del recurso que ha enumerado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

 ** [Tags](#API_BGW_ListTagsForResource_ResponseSyntax) **   <a name="Backup-BGW_ListTagsForResource-response-Tags"></a>
Una lista de las etiquetas del recurso.  
Tipo: matriz de objetos [Tag](API_BGW_Tag.md)

## Errores
<a name="API_BGW_ListTagsForResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListTagsForResource) 

# ListVirtualMachines
<a name="API_BGW_ListVirtualMachines"></a>

Enumera sus máquinas virtuales.

## Sintaxis de la solicitud
<a name="API_BGW_ListVirtualMachines_RequestSyntax"></a>

```
{
   "HypervisorArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_ListVirtualMachines_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [HypervisorArn](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor conectado a la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

 ** [MaxResults](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-MaxResults"></a>
El número máximo de máquinas virtuales que se van a enumerar.  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [NextToken](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `maxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_ListVirtualMachines_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "VirtualMachines": [ 
      { 
         "HostName": "string",
         "HypervisorId": "string",
         "LastBackupDate": number,
         "Name": "string",
         "Path": "string",
         "ResourceArn": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_BGW_ListVirtualMachines_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_BGW_ListVirtualMachines_ResponseSyntax) **   <a name="Backup-BGW_ListVirtualMachines-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos `maxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `.+` 

 ** [VirtualMachines](#API_BGW_ListVirtualMachines_ResponseSyntax) **   <a name="Backup-BGW_ListVirtualMachines-response-VirtualMachines"></a>
Una lista de tus `VirtualMachine` objetos, ordenados por sus nombres de recursos de Amazon (ARNs).  
Tipo: matriz de objetos [VirtualMachine](API_BGW_VirtualMachine.md)

## Errores
<a name="API_BGW_ListVirtualMachines_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_ListVirtualMachines_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListVirtualMachines) 

# PutBandwidthRateLimitSchedule
<a name="API_BGW_PutBandwidthRateLimitSchedule"></a>

Esta acción establece la programación de límite de velocidad de ancho de banda para una puerta de enlace especificada. De forma predeterminada, las puertas de enlace no tienen una programación de límite de velocidad de ancho de banda, lo que significa que no hay ningún límite de velocidad de ancho de banda en vigor. Use esto para iniciar la programación de límite de velocidad de ancho de banda de una puerta de enlace.

## Sintaxis de la solicitud
<a name="API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax"></a>

```
{
   "BandwidthRateLimitIntervals": [ 
      { 
         "AverageUploadRateLimitInBitsPerSec": number,
         "DaysOfWeek": [ number ],
         "EndHourOfDay": number,
         "EndMinuteOfHour": number,
         "StartHourOfDay": number,
         "StartMinuteOfHour": number
      }
   ],
   "GatewayArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_PutBandwidthRateLimitSchedule_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [BandwidthRateLimitIntervals](#API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax) **   <a name="Backup-BGW_PutBandwidthRateLimitSchedule-request-BandwidthRateLimitIntervals"></a>
Una matriz que contiene los intervalos de programación de límite de velocidad de ancho de banda para una puerta de enlace. Cuando no se ha programado ningún intervalo de límite de velocidad de ancho de banda, la matriz está vacía.  
Tipo: matriz de objetos [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.  
Obligatorio: sí

 ** [GatewayArn](#API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax) **   <a name="Backup-BGW_PutBandwidthRateLimitSchedule-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html)operación para devolver una lista de pasarelas para su cuenta y Región de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_PutBandwidthRateLimitSchedule_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_PutBandwidthRateLimitSchedule_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_PutBandwidthRateLimitSchedule_ResponseSyntax) **   <a name="Backup-BGW_PutBandwidthRateLimitSchedule-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html)operación para devolver una lista de pasarelas para su cuenta y. Región de AWS  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_PutBandwidthRateLimitSchedule_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_PutBandwidthRateLimitSchedule_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 

# PutHypervisorPropertyMappings
<a name="API_BGW_PutHypervisorPropertyMappings"></a>

Esta acción establece las asignaciones de propiedades del hipervisor especificado. Un mapeo de propiedades de hipervisor muestra la relación entre las propiedades de la entidad disponibles en el hipervisor y las propiedades disponibles en. AWS

## Sintaxis de la solicitud
<a name="API_BGW_PutHypervisorPropertyMappings_RequestSyntax"></a>

```
{
   "HypervisorArn": "string",
   "IamRoleArn": "string",
   "VmwareToAwsTagMappings": [ 
      { 
         "AwsTagKey": "string",
         "AwsTagValue": "string",
         "VmwareCategory": "string",
         "VmwareTagName": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_BGW_PutHypervisorPropertyMappings_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [HypervisorArn](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [IamRoleArn](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-request-IamRoleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de IAM.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):iam::([0-9]+):role/(\S+)`   
Obligatorio: sí

 ** [VmwareToAwsTagMappings](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-request-VmwareToAwsTagMappings"></a>
Esta acción solicita la asignación de etiquetas a las VMware etiquetas. AWS   
Tipo: matriz de objetos [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_PutHypervisorPropertyMappings_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_PutHypervisorPropertyMappings_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [HypervisorArn](#API_BGW_PutHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-response-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_PutHypervisorPropertyMappings_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
La operación no puede continuar porque no tiene permisos suficientes.    
 ** ErrorCode **   
Es una descripción del motivo por el que no tiene permisos suficientes.
Código de estado HTTP: 400

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_PutHypervisorPropertyMappings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 

# PutMaintenanceStartTime
<a name="API_BGW_PutMaintenanceStartTime"></a>

Establece la hora de inicio del mantenimiento de una puerta de enlace.

## Sintaxis de la solicitud
<a name="API_BGW_PutMaintenanceStartTime_RequestSyntax"></a>

```
{
   "DayOfMonth": number,
   "DayOfWeek": number,
   "GatewayArn": "string",
   "HourOfDay": number,
   "MinuteOfHour": number
}
```

## Parámetros de la solicitud
<a name="API_BGW_PutMaintenanceStartTime_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [DayOfMonth](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-DayOfMonth"></a>
El día del mes de inicio del mantenimiento de una puerta de enlace.  
Los valores válidos van de `Sunday` a `Saturday`.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 31.  
Obligatorio: no

 ** [DayOfWeek](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-DayOfWeek"></a>
El día de la semana de inicio del mantenimiento de una puerta de enlace.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 6.  
Obligatorio: no

 ** [GatewayArn](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace, que se utiliza para especificar la hora de inicio del mantenimiento.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [HourOfDay](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-HourOfDay"></a>
La hora del día de inicio del mantenimiento de una puerta de enlace.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 23.  
Obligatorio: sí

 ** [MinuteOfHour](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-MinuteOfHour"></a>
El minuto de la hora de inicio del mantenimiento de una puerta de enlace.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 59.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_PutMaintenanceStartTime_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_PutMaintenanceStartTime_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_PutMaintenanceStartTime_ResponseSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de una puerta de enlace para la que haya establecido la hora de inicio del mantenimiento.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_PutMaintenanceStartTime_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_PutMaintenanceStartTime_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 

# StartVirtualMachinesMetadataSync
<a name="API_BGW_StartVirtualMachinesMetadataSync"></a>

Esta acción envía una solicitud para sincronizar los metadatos en las máquinas virtuales especificadas.

## Sintaxis de la solicitud
<a name="API_BGW_StartVirtualMachinesMetadataSync_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_StartVirtualMachinesMetadataSync_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [HypervisorArn](#API_BGW_StartVirtualMachinesMetadataSync_RequestSyntax) **   <a name="Backup-BGW_StartVirtualMachinesMetadataSync-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_StartVirtualMachinesMetadataSync_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_StartVirtualMachinesMetadataSync_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [HypervisorArn](#API_BGW_StartVirtualMachinesMetadataSync_ResponseSyntax) **   <a name="Backup-BGW_StartVirtualMachinesMetadataSync-response-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_StartVirtualMachinesMetadataSync_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
La operación no puede continuar porque no tiene permisos suficientes.    
 ** ErrorCode **   
Es una descripción del motivo por el que no tiene permisos suficientes.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_StartVirtualMachinesMetadataSync_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 

# TagResource
<a name="API_BGW_TagResource"></a>

Etiqueta el recurso.

## Sintaxis de la solicitud
<a name="API_BGW_TagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_BGW_TagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_BGW_TagResource_RequestSyntax) **   <a name="Backup-BGW_TagResource-request-ResourceARN"></a>
El nombre de recurso de Amazon (ARN) del recurso que se va a etiquetar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [Tags](#API_BGW_TagResource_RequestSyntax) **   <a name="Backup-BGW_TagResource-request-Tags"></a>
Una lista de etiquetas que se asignarán al recurso.  
Tipo: matriz de objetos [Tag](API_BGW_Tag.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_TagResource_ResponseSyntax"></a>

```
{
   "ResourceARN": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_TagResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ResourceARN](#API_BGW_TagResource_ResponseSyntax) **   <a name="Backup-BGW_TagResource-response-ResourceARN"></a>
El nombre de recurso de Amazon (ARN) del recurso que ha etiquetado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_TagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/TagResource) 

# TestHypervisorConfiguration
<a name="API_BGW_TestHypervisorConfiguration"></a>

Prueba la configuración del hipervisor para validar que la puerta de enlace de copia de seguridad pueda conectarse con el hipervisor y sus recursos.

## Sintaxis de la solicitud
<a name="API_BGW_TestHypervisorConfiguration_RequestSyntax"></a>

```
{
   "GatewayArn": "string",
   "Host": "string",
   "Password": "string",
   "Username": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_TestHypervisorConfiguration_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace al hipervisor que se va a probar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [Host](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-Host"></a>
El host del servidor del hipervisor. Puede ser una dirección IP o un nombre de dominio completo (FQDN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 128.  
Patrón: `.+`   
Obligatorio: sí

 ** [Password](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-Password"></a>
La contraseña del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[ -~]+`   
Obligatorio: no

 ** [Username](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-Username"></a>
El nombre de usuario del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`   
Obligatorio: no

## Elementos de respuesta
<a name="API_BGW_TestHypervisorConfiguration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_BGW_TestHypervisorConfiguration_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_TestHypervisorConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 

# UntagResource
<a name="API_BGW_UntagResource"></a>

Elimina etiquetas del recurso.

## Sintaxis de la solicitud
<a name="API_BGW_UntagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## Parámetros de la solicitud
<a name="API_BGW_UntagResource_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ResourceARN](#API_BGW_UntagResource_RequestSyntax) **   <a name="Backup-BGW_UntagResource-request-ResourceARN"></a>
El nombre de recurso de Amazon (ARN) del recurso del que se van a eliminar etiquetas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [TagKeys](#API_BGW_UntagResource_RequestSyntax) **   <a name="Backup-BGW_UntagResource-request-TagKeys"></a>
La lista de claves de etiquetas que especifica las etiquetas que se van a eliminar.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_UntagResource_ResponseSyntax"></a>

```
{
   "ResourceARN": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_UntagResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ResourceARN](#API_BGW_UntagResource_ResponseSyntax) **   <a name="Backup-BGW_UntagResource-response-ResourceARN"></a>
El nombre de recurso de Amazon (ARN) del recurso del que ha eliminado etiquetas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_UntagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UntagResource) 

# UpdateGatewayInformation
<a name="API_BGW_UpdateGatewayInformation"></a>

Actualiza el nombre de una puerta de enlace. Especifique la puerta de enlace que desea actualizar mediante el nombre de recurso de Amazon (ARN) de la puerta de enlace en su solicitud.

## Sintaxis de la solicitud
<a name="API_BGW_UpdateGatewayInformation_RequestSyntax"></a>

```
{
   "GatewayArn": "string",
   "GatewayDisplayName": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_UpdateGatewayInformation_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_UpdateGatewayInformation_RequestSyntax) **   <a name="Backup-BGW_UpdateGatewayInformation-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que se va a actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [GatewayDisplayName](#API_BGW_UpdateGatewayInformation_RequestSyntax) **   <a name="Backup-BGW_UpdateGatewayInformation-request-GatewayDisplayName"></a>
El nombre de visualización actualizado de la puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_UpdateGatewayInformation_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_UpdateGatewayInformation_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_UpdateGatewayInformation_ResponseSyntax) **   <a name="Backup-BGW_UpdateGatewayInformation-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que ha actualizado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_UpdateGatewayInformation_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_UpdateGatewayInformation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateGatewayInformation) 

# UpdateGatewaySoftwareNow
<a name="API_BGW_UpdateGatewaySoftwareNow"></a>

Esta operación actualiza el software de máquina virtual (VM) de la puerta de enlace. La solicitud activa inmediatamente la actualización del software.

**nota**  
Al realizar esta solicitud, se obtiene inmediatamente una respuesta `200 OK` de confirmación. Sin embargo, es posible que la actualización tarde algún tiempo en completarse.

## Sintaxis de la solicitud
<a name="API_BGW_UpdateGatewaySoftwareNow_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_UpdateGatewaySoftwareNow_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [GatewayArn](#API_BGW_UpdateGatewaySoftwareNow_RequestSyntax) **   <a name="Backup-BGW_UpdateGatewaySoftwareNow-request-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que se va a actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BGW_UpdateGatewaySoftwareNow_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_UpdateGatewaySoftwareNow_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [GatewayArn](#API_BGW_UpdateGatewaySoftwareNow_ResponseSyntax) **   <a name="Backup-BGW_UpdateGatewaySoftwareNow-response-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace que ha actualizado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_UpdateGatewaySoftwareNow_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_UpdateGatewaySoftwareNow_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 

# UpdateHypervisor
<a name="API_BGW_UpdateHypervisor"></a>

Actualiza los metadatos de un hipervisor, lo que incluye el host, el nombre de usuario y la contraseña. Especifique el hipervisor que desea actualizar mediante el nombre de recurso de Amazon (ARN) del hipervisor en su solicitud.

## Sintaxis de la solicitud
<a name="API_BGW_UpdateHypervisor_RequestSyntax"></a>

```
{
   "Host": "string",
   "HypervisorArn": "string",
   "LogGroupArn": "string",
   "Name": "string",
   "Password": "string",
   "Username": "string"
}
```

## Parámetros de la solicitud
<a name="API_BGW_UpdateHypervisor_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [Host](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Host"></a>
El host actualizado del hipervisor. Puede ser una dirección IP o un nombre de dominio completo (FQDN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 128.  
Patrón: `.+`   
Obligatorio: no

 ** [HypervisorArn](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor que se va a actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: sí

 ** [LogGroupArn](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-LogGroupArn"></a>
El nombre de recurso de Amazon (ARN) de grupo de puertas de enlace dentro del registro solicitado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0 caracteres. La longitud máxima es de 2048 caracteres.  
Patrón: `$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*`   
Obligatorio: no

 ** [Name](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Name"></a>
El nombre actualizado del hipervisor  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** [Password](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Password"></a>
La contraseña actualizada del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[ -~]+`   
Obligatorio: no

 ** [Username](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Username"></a>
El nombre de usuario actualizado del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BGW_UpdateHypervisor_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## Elementos de respuesta
<a name="API_BGW_UpdateHypervisor_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [HypervisorArn](#API_BGW_UpdateHypervisor_ResponseSyntax) **   <a name="Backup-BGW_UpdateHypervisor-response-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor que ha actualizado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## Errores
<a name="API_BGW_UpdateHypervisor_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
La operación no puede continuar porque no tiene permisos suficientes.    
 ** ErrorCode **   
Es una descripción del motivo por el que no tiene permisos suficientes.
Código de estado HTTP: 400

 ** ConflictException **   
La operación no puede continuar porque no se admite.    
 ** ErrorCode **   
Es una descripción de los motivos por los que no se admite la operación.
Código de estado HTTP: 400

 ** InternalServerException **   
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.    
 ** ErrorCode **   
Es una descripción del error interno que se ha producido.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se encontró un recurso necesario para la acción.    
 ** ErrorCode **   
Es la descripción del motivo por el que no se ha encontrado el recurso.
Código de estado HTTP: 400

 ** ThrottlingException **   
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.    
 ** ErrorCode **   
Error: Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400

 ** ValidationException **   
La operación no se realizó correctamente porque se produjo un error de validación.    
 ** ErrorCode **   
Es una descripción de la causa del error de validación.
Código de estado HTTP: 400

## Véase también
<a name="API_BGW_UpdateHypervisor_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateHypervisor) 

# Búsqueda de AWS Backup
<a name="API_Operations_AWS_Backup_Search"></a>

Las siguientes acciones cuentan con el apoyo de Búsqueda de AWS Backup:
+  [GetSearchJob](API_BKS_GetSearchJob.md) 
+  [GetSearchResultExportJob](API_BKS_GetSearchResultExportJob.md) 
+  [ListSearchJobBackups](API_BKS_ListSearchJobBackups.md) 
+  [ListSearchJobResults](API_BKS_ListSearchJobResults.md) 
+  [ListSearchJobs](API_BKS_ListSearchJobs.md) 
+  [ListSearchResultExportJobs](API_BKS_ListSearchResultExportJobs.md) 
+  [ListTagsForResource](API_BKS_ListTagsForResource.md) 
+  [StartSearchJob](API_BKS_StartSearchJob.md) 
+  [StartSearchResultExportJob](API_BKS_StartSearchResultExportJob.md) 
+  [StopSearchJob](API_BKS_StopSearchJob.md) 
+  [TagResource](API_BKS_TagResource.md) 
+  [UntagResource](API_BKS_UntagResource.md) 

# GetSearchJob
<a name="API_BKS_GetSearchJob"></a>

Esta operación obtiene los metadatos de un trabajo de búsqueda, incluido su progreso.

## Sintaxis de la solicitud
<a name="API_BKS_GetSearchJob_RequestSyntax"></a>

```
GET /search-jobs/SearchJobIdentifier HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_GetSearchJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_RequestSyntax) **   <a name="Backup-BKS_GetSearchJob-request-uri-SearchJobIdentifier"></a>
Cadena única requerida que especifica el trabajo de búsqueda.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_GetSearchJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_GetSearchJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompletionTime": number,
   "CreationTime": number,
   "CurrentSearchProgress": { 
      "ItemsMatchedCount": number,
      "ItemsScannedCount": number,
      "RecoveryPointsScannedCount": number
   },
   "EncryptionKeyArn": "string",
   "ItemFilters": { 
      "EBSItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "FilePaths": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "LastModificationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ]
         }
      ],
      "S3ItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "ETags": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "ObjectKeys": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "VersionIds": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ]
         }
      ]
   },
   "Name": "string",
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string",
   "SearchScope": { 
      "BackupResourceArns": [ "string" ],
      "BackupResourceCreationTime": { 
         "CreatedAfter": number,
         "CreatedBefore": number
      },
      "BackupResourceTags": { 
         "string" : "string" 
      },
      "BackupResourceTypes": [ "string" ],
      "SourceResourceArns": [ "string" ]
   },
   "SearchScopeSummary": { 
      "TotalItemsToScanCount": number,
      "TotalRecoveryPointsToScanCount": number
   },
   "Status": "string",
   "StatusMessage": "string"
}
```

## Elementos de respuesta
<a name="API_BKS_GetSearchJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CompletionTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CompletionTime"></a>
Fecha y hora en que se completó el trabajo de búsqueda, en formato Unix y en la hora universal coordinada (UTC). El valor de `CompletionTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreationTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CreationTime"></a>
Fecha y hora en que se creó el trabajo de búsqueda, en formato Unix y en la hora universal coordinada (UTC). El valor de `CompletionTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CurrentSearchProgress](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CurrentSearchProgress"></a>
Devuelve números que representan BackupsScannedCount ItemsScanned, y ItemsMatched.  
Tipo: objeto [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md)

 ** [EncryptionKeyArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-EncryptionKeyArn"></a>
Es la clave de cifrado del trabajo de búsqueda especificado.  
Ejemplo: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Tipo: cadena

 ** [ItemFilters](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-ItemFilters"></a>
Son los filtros de elementos que representan todas las propiedades de los elementos de entrada especificados al crear la búsqueda.  
Tipo: objeto [ItemFilters](API_BKS_ItemFilters.md)

 ** [Name](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Name"></a>
Nombre devuelto del trabajo de búsqueda especificado.  
Tipo: cadena

 ** [SearchJobArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobArn"></a>
Cadena única que identifica el nombre de recurso de Amazon (ARN) del trabajo de búsqueda especificado.  
Tipo: cadena

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobIdentifier"></a>
Cadena única que identifica el trabajo de búsqueda especificado.  
Tipo: cadena

 ** [SearchScope](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScope"></a>
Ámbito de búsqueda que incluye todas las propiedades de copia de seguridad introducidas en una búsqueda.  
Tipo: objeto [SearchScope](API_BKS_SearchScope.md)

 ** [SearchScopeSummary](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScopeSummary"></a>
Devuelve un resumen del ámbito del trabajo de búsqueda especificado, que incluye:   
+ TotalBackupsToScanCount, el número de puntos de recuperación devueltos por la búsqueda.
+ TotalItemsToScanCount, el número de elementos devueltos por la búsqueda.
Tipo: objeto [SearchScopeSummary](API_BKS_SearchScopeSummary.md)

 ** [Status](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Status"></a>
Estado actual del trabajo de búsqueda especificado.  
Un trabajo de búsqueda puede tener uno de los siguientes estados: `RUNNING`; `COMPLETED`; `STOPPED`; `FAILED` `TIMED_OUT` o `EXPIRED`.  
Tipo: cadena  
Valores válidos: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [StatusMessage](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-StatusMessage"></a>
Se devolverá un mensaje de estado para cada trabajo de búsqueda con un estado `ERRORED` o un estado de trabajos `COMPLETED` con problemas.  
Por ejemplo, un mensaje puede indicar que una búsqueda contiene puntos de recuperación que no se han podido analizar debido a un problema con permisos.  
Tipo: cadena

## Errores
<a name="API_BKS_GetSearchJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_GetSearchJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchJob) 

# GetSearchResultExportJob
<a name="API_BKS_GetSearchResultExportJob"></a>

Esta operación obtiene los metadatos de un trabajo de exportación.

Un trabajo de exportación es una operación que transmite los resultados de un trabajo de búsqueda a un bucket de S3 específico en un archivo .csv.

Un trabajo de exportación le permite conservar los resultados de una búsqueda más allá de los siete días programados para el trabajo de búsqueda.

## Sintaxis de la solicitud
<a name="API_BKS_GetSearchResultExportJob_RequestSyntax"></a>

```
GET /export-search-jobs/ExportJobIdentifier HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_GetSearchResultExportJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ExportJobIdentifier](#API_BKS_GetSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-request-uri-ExportJobIdentifier"></a>
Esta es la cadena unívoca que identifica un trabajo de exportación específico.  
Es obligatoria para esta operación.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_GetSearchResultExportJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_GetSearchResultExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompletionTime": number,
   "CreationTime": number,
   "ExportJobArn": "string",
   "ExportJobIdentifier": "string",
   "ExportSpecification": { ... },
   "SearchJobArn": "string",
   "Status": "string",
   "StatusMessage": "string"
}
```

## Elementos de respuesta
<a name="API_BKS_GetSearchResultExportJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CompletionTime](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-CompletionTime"></a>
Fecha y hora en que se completó el trabajo de exportación, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreationTime](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-CreationTime"></a>
Fecha y hora en que se creó un trabajo de exportación, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ExportJobArn](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-ExportJobArn"></a>
Es el Nombre de recurso de Amazon (ARN) unívoco que identifica de forma exclusiva el trabajo de exportación.  
Tipo: cadena

 ** [ExportJobIdentifier](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-ExportJobIdentifier"></a>
Esta es la cadena unívoca que identifica un trabajo de exportación específico.  
Tipo: cadena

 ** [ExportSpecification](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-ExportSpecification"></a>
La especificación de exportación consta del bucket de S3 de destino al que se exportaron los resultados de la búsqueda, junto con el prefijo de destino.  
Tipo: objeto [ExportSpecification](API_BKS_ExportSpecification.md)  
 **Nota:** Este objeto es una unión. Solo se puede especificar o devolver un miembro de este objeto.

 ** [SearchJobArn](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-SearchJobArn"></a>
Cadena única que identifica el nombre de recurso de Amazon (ARN) del trabajo de búsqueda especificado.  
Tipo: cadena

 ** [Status](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-Status"></a>
Este es el estado actual del trabajo de exportación.  
Tipo: cadena  
Valores válidos: `RUNNING | FAILED | COMPLETED` 

 ** [StatusMessage](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-StatusMessage"></a>
Un mensaje de estado es una cadena que se devuelve para el trabajo de búsqueda con un estado `FAILED`, junto con los pasos para corregir y volver a intentar la operación.  
Tipo: cadena

## Errores
<a name="API_BKS_GetSearchResultExportJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_GetSearchResultExportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchResultExportJob) 

# ListSearchJobBackups
<a name="API_BKS_ListSearchJobBackups"></a>

Esta operación devuelve una lista de todas las copias de seguridad (puntos de recuperación) en formato paginado que se han incluido en el trabajo de búsqueda.

Si una búsqueda no muestra la copia de seguridad esperada en los resultados, puede llamar a esta operación para que se muestren todas las copias de seguridad incluidas en la búsqueda. Se mostrarán todas las copias de seguridad que no se hayan incluido porque tenían el estado `FAILED` de un problema de permisos, junto con un mensaje de estado.

En los resultados de búsqueda solo se incluyen puntos de recuperación con un índice de copias de seguridad con el estado `ACTIVE`. Si el índice tiene otro estado, este se mostrará junto con un mensaje de estado.

## Sintaxis de la solicitud
<a name="API_BKS_ListSearchJobBackups_RequestSyntax"></a>

```
GET /search-jobs/SearchJobIdentifier/backups?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_ListSearchJobBackups_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_BKS_ListSearchJobBackups_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_BKS_ListSearchJobBackups_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-request-uri-NextToken"></a>
Es el siguiente elemento tras una lista parcial de copias de seguridad devueltas que se incluyen en un trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [SearchJobIdentifier](#API_BKS_ListSearchJobBackups_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-request-uri-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_ListSearchJobBackups_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_ListSearchJobBackups_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { 
         "BackupCreationTime": number,
         "BackupResourceArn": "string",
         "IndexCreationTime": number,
         "ResourceType": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_BKS_ListSearchJobBackups_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_BKS_ListSearchJobBackups_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-response-NextToken"></a>
Es el siguiente elemento tras una lista parcial de copias de seguridad devueltas que se incluyen en un trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

 ** [Results](#API_BKS_ListSearchJobBackups_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-response-Results"></a>
Los puntos de recuperación devuelven los resultados de un trabajo de búsqueda.  
Tipo: matriz de objetos [SearchJobBackupsResult](API_BKS_SearchJobBackupsResult.md)

## Errores
<a name="API_BKS_ListSearchJobBackups_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_ListSearchJobBackups_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobBackups) 

# ListSearchJobResults
<a name="API_BKS_ListSearchJobResults"></a>

Esta operación devuelve una lista de un trabajo de búsqueda especificado.

## Sintaxis de la solicitud
<a name="API_BKS_ListSearchJobResults_RequestSyntax"></a>

```
GET /search-jobs/SearchJobIdentifier/search-results?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_ListSearchJobResults_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_BKS_ListSearchJobResults_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobResults-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_BKS_ListSearchJobResults_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobResults-request-uri-NextToken"></a>
Es el elemento que sigue a una lista parcial de los resultados del trabajo de búsqueda devueltos.  
Por ejemplo, si se solicita que se devuelva el número `MaxResults` de resultados del trabajo de búsqueda, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [SearchJobIdentifier](#API_BKS_ListSearchJobResults_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobResults-request-uri-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_ListSearchJobResults_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_ListSearchJobResults_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { ... }
   ]
}
```

## Elementos de respuesta
<a name="API_BKS_ListSearchJobResults_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_BKS_ListSearchJobResults_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobResults-response-NextToken"></a>
Es el elemento que sigue a una lista parcial de los resultados del trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

 ** [Results](#API_BKS_ListSearchJobResults_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobResults-response-Results"></a>
Los resultados consisten en EBSResult Item o S3ResultItem.  
Tipo: matriz de objetos [ResultItem](API_BKS_ResultItem.md)

## Errores
<a name="API_BKS_ListSearchJobResults_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_ListSearchJobResults_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobResults) 

# ListSearchJobs
<a name="API_BKS_ListSearchJobs"></a>

Esta operación devuelve una lista de los trabajos de búsqueda que pertenecen a una cuenta.

## Sintaxis de la solicitud
<a name="API_BKS_ListSearchJobs_RequestSyntax"></a>

```
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_ListSearchJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-ByStatus"></a>
Incluya este parámetro para filtrar la lista por estado del trabajo de búsqueda.  
Valores válidos: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-NextToken"></a>
Es el elemento que sigue a una lista parcial de los resultados del trabajo de búsqueda devueltos.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

## Cuerpo de la solicitud
<a name="API_BKS_ListSearchJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_ListSearchJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SearchJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "Name": "string",
         "SearchJobArn": "string",
         "SearchJobIdentifier": "string",
         "SearchScopeSummary": { 
            "TotalItemsToScanCount": number,
            "TotalRecoveryPointsToScanCount": number
         },
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_BKS_ListSearchJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-NextToken"></a>
Es el siguiente elemento tras una lista parcial de copias de seguridad devueltas que se incluyen en un trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

 ** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-SearchJobs"></a>
Son los trabajos de búsqueda de la lista que incluyen detalles de los trabajos de búsqueda devueltos.  
Tipo: matriz de objetos [SearchJobSummary](API_BKS_SearchJobSummary.md)

## Errores
<a name="API_BKS_ListSearchJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_ListSearchJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs) 

# ListSearchResultExportJobs
<a name="API_BKS_ListSearchResultExportJobs"></a>

Esta operación exporta los resultados de búsqueda de un trabajo de búsqueda a un bucket de S3 de destino específico.

## Sintaxis de la solicitud
<a name="API_BKS_ListSearchResultExportJobs_RequestSyntax"></a>

```
GET /export-search-jobs?MaxResults=MaxResults&NextToken=NextToken&SearchJobIdentifier=SearchJobIdentifier&Status=Status HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_ListSearchResultExportJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-NextToken"></a>
Es el siguiente elemento tras una lista parcial de copias de seguridad devueltas que se incluyen en un trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

 ** [SearchJobIdentifier](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.

 ** [Status](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-Status"></a>
Los trabajos de búsqueda que se van a incluir en el trabajo de exportación se pueden filtrar mediante la inclusión de este parámetro.  
Valores válidos: `RUNNING | FAILED | COMPLETED` 

## Cuerpo de la solicitud
<a name="API_BKS_ListSearchResultExportJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_ListSearchResultExportJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "ExportJobArn": "string",
         "ExportJobIdentifier": "string",
         "SearchJobArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_BKS_ListSearchResultExportJobs_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ExportJobs](#API_BKS_ListSearchResultExportJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-response-ExportJobs"></a>
La operación devuelve los trabajos de exportación incluidos.  
Tipo: matriz de objetos [ExportJobSummary](API_BKS_ExportJobSummary.md)

 ** [NextToken](#API_BKS_ListSearchResultExportJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-response-NextToken"></a>
Es el siguiente elemento tras una lista parcial de copias de seguridad devueltas que se incluyen en un trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

## Errores
<a name="API_BKS_ListSearchResultExportJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ServiceQuotaExceededException **   
La solicitud se ha denegado debido a que se han superado los límites de cuota permitidos.    
 ** message **   
Esta solicitud no se ha realizado correctamente debido a que la cuota de servicio ha superado los límites.  
 ** quotaCode **   
Este es el código específico del tipo de cuota.  
 ** resourceId **   
Es el identificador del recurso.  
 ** resourceType **   
Tipo de recurso.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen con la cuota.
Código de estado HTTP: 402

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_ListSearchResultExportJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchResultExportJobs) 

# ListTagsForResource
<a name="API_BKS_ListTagsForResource"></a>

Esta operación devuelve las etiquetas de un tipo de recurso.

## Sintaxis de la solicitud
<a name="API_BKS_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/ResourceArn HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_ListTagsForResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ResourceArn](#API_BKS_ListTagsForResource_RequestSyntax) **   <a name="Backup-BKS_ListTagsForResource-request-uri-ResourceArn"></a>
Es el Nombre de recurso de Amazon (ARN) que identifica de forma unívoca el recurso.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_ListTagsForResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Elementos de respuesta
<a name="API_BKS_ListTagsForResource_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Tags](#API_BKS_ListTagsForResource_ResponseSyntax) **   <a name="Backup-BKS_ListTagsForResource-response-Tags"></a>
Es la lista de etiquetas que devuelve la operación.  
Tipo: mapa de cadena a cadena

## Errores
<a name="API_BKS_ListTagsForResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListTagsForResource) 

# StartSearchJob
<a name="API_BKS_StartSearchJob"></a>

Esta operación crea un trabajo de búsqueda que devuelve puntos de recuperación filtrados por SearchScope y elementos filtrados por ItemFilters.

Si lo desea ClientToken, puede incluir EncryptionKeyArn, nombre o and/or etiquetas.

## Sintaxis de la solicitud
<a name="API_BKS_StartSearchJob_RequestSyntax"></a>

```
PUT /search-jobs HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "EncryptionKeyArn": "string",
   "ItemFilters": { 
      "EBSItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "FilePaths": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "LastModificationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ]
         }
      ],
      "S3ItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "ETags": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "ObjectKeys": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "VersionIds": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ]
         }
      ]
   },
   "Name": "string",
   "SearchScope": { 
      "BackupResourceArns": [ "string" ],
      "BackupResourceCreationTime": { 
         "CreatedAfter": number,
         "CreatedBefore": number
      },
      "BackupResourceTags": { 
         "string" : "string" 
      },
      "BackupResourceTypes": [ "string" ],
      "SourceResourceArns": [ "string" ]
   },
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_BKS_StartSearchJob_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_BKS_StartSearchJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-ClientToken"></a>
Incluya este parámetro para permitir múltiples llamadas idénticas de idempotencia.  
Un token de cliente es válido durante ocho horas desde el momento en que finaliza la primera solicitud que lo utiliza. Pasado ese tiempo, cualquier solicitud con el mismo token se considera una solicitud nueva.  
Tipo: cadena  
Requerido: no

 ** [EncryptionKeyArn](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-EncryptionKeyArn"></a>
Es la clave de cifrado del trabajo de búsqueda especificado.  
Tipo: cadena  
Requerido: no

 ** [ItemFilters](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-ItemFilters"></a>
Son los filtros de elementos que representan todas las propiedades de los elementos de entrada especificados al crear la búsqueda.  
Contiene EBSItem filtros o S3 ItemFilters  
Tipo: objeto [ItemFilters](API_BKS_ItemFilters.md)  
Obligatorio: no

 ** [Name](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-Name"></a>
Incluye caracteres alfanuméricos para crear un nombre para este trabajo de búsqueda.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 500 caracteres.  
Obligatorio: no

 ** [SearchScope](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-SearchScope"></a>
Este objeto puede contener BackupResourceTypes, BackupResourceArns BackupResourceCreationTime BackupResourceTags, y filtrar SourceResourceArns los puntos de recuperación devueltos por el trabajo de búsqueda.  
Tipo: objeto [SearchScope](API_BKS_SearchScope.md)  
Obligatorio: sí

 ** [Tags](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-Tags"></a>
Es la lista de etiquetas que devuelve la operación.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BKS_StartSearchJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string"
}
```

## Elementos de respuesta
<a name="API_BKS_StartSearchJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-CreationTime"></a>
Fecha y hora en que se creó el trabajo, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CompletionTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [SearchJobArn](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-SearchJobArn"></a>
Cadena única que identifica el nombre de recurso de Amazon (ARN) del trabajo de búsqueda especificado.  
Tipo: cadena

 ** [SearchJobIdentifier](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.  
Tipo: cadena

## Errores
<a name="API_BKS_StartSearchJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** ConflictException **   
Esta excepción se produce cuando se detecta un conflicto con una operación anterior completada correctamente. Esto suele ocurrir cuando la operación anterior no ha podido propagarse al host que atiende la solicitud actual.  
La respuesta recomendada a esta excepción es intentarlo de nuevo (con la lógica de retroceso adecuada).    
 ** message **   
Actualizar o eliminar un recurso puede generar un estado incoherente.  
 ** resourceId **   
Es el identificador del recurso afectado.  
 ** resourceType **   
Es el tipo de recurso afectado.
Código de estado HTTP: 409

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ServiceQuotaExceededException **   
La solicitud se ha denegado debido a que se han superado los límites de cuota permitidos.    
 ** message **   
Esta solicitud no se ha realizado correctamente debido a que la cuota de servicio ha superado los límites.  
 ** quotaCode **   
Este es el código específico del tipo de cuota.  
 ** resourceId **   
Es el identificador del recurso.  
 ** resourceType **   
Tipo de recurso.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen con la cuota.
Código de estado HTTP: 402

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_StartSearchJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchJob) 

# StartSearchResultExportJob
<a name="API_BKS_StartSearchResultExportJob"></a>

Esta operación inicia un trabajo para exportar los resultados del trabajo de búsqueda a un bucket de S3 designado.

## Sintaxis de la solicitud
<a name="API_BKS_StartSearchResultExportJob_RequestSyntax"></a>

```
PUT /export-search-jobs HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "ExportSpecification": { ... },
   "RoleArn": "string",
   "SearchJobIdentifier": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_BKS_StartSearchResultExportJob_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_BKS_StartSearchResultExportJob_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ClientToken](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ClientToken"></a>
Incluya este parámetro para permitir múltiples llamadas idénticas de idempotencia.  
Un token de cliente es válido durante ocho horas desde el momento en que finaliza la primera solicitud que lo utiliza. Pasado ese tiempo, cualquier solicitud con el mismo token se considera una solicitud nueva.  
Tipo: cadena  
Requerido: no

 ** [ExportSpecification](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ExportSpecification"></a>
Esta especificación contiene una cadena obligatoria del bucket de destino; si lo desea, puede incluir el prefijo de destino.  
Tipo: objeto [ExportSpecification](API_BKS_ExportSpecification.md)  
 **Nota:** Este objeto es una unión. Solo se puede especificar o devolver un miembro de este objeto.  
Obligatorio: sí

 ** [RoleArn](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-RoleArn"></a>
Este parámetro especifica el ARN del rol que se utiliza para iniciar los trabajos de exportación de los resultados de la búsqueda.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.  
Patrón: `arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)`   
Obligatorio: no

 ** [SearchJobIdentifier](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.  
Tipo: cadena  
Obligatorio: sí

 ** [Tags](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-Tags"></a>
Etiquetas opcionales que se incluirán. Una etiqueta es un par clave-valor que puede utilizar para administrar, filtrar y buscar sus recursos. Los caracteres permitidos incluyen espacios, números y letras en UTF-8, además de los siguientes caracteres especiales: \$1 - = . \$1 : /.   
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_BKS_StartSearchResultExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportJobArn": "string",
   "ExportJobIdentifier": "string"
}
```

## Elementos de respuesta
<a name="API_BKS_StartSearchResultExportJob_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ExportJobArn](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobArn"></a>
Este es el ARN (Nombre de recurso de Amazon) exclusivo que pertenece al nuevo trabajo de exportación.  
Tipo: cadena

 ** [ExportJobIdentifier](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobIdentifier"></a>
Este es el identificador unívoco que especifica el nuevo trabajo de exportación.  
Tipo: cadena

## Errores
<a name="API_BKS_StartSearchResultExportJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** ConflictException **   
Esta excepción se produce cuando se detecta un conflicto con una operación anterior completada correctamente. Esto suele ocurrir cuando la operación anterior no ha podido propagarse al host que atiende la solicitud actual.  
La respuesta recomendada a esta excepción es intentarlo de nuevo (con la lógica de retroceso adecuada).    
 ** message **   
Actualizar o eliminar un recurso puede generar un estado incoherente.  
 ** resourceId **   
Es el identificador del recurso afectado.  
 ** resourceType **   
Es el tipo de recurso afectado.
Código de estado HTTP: 409

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ServiceQuotaExceededException **   
La solicitud se ha denegado debido a que se han superado los límites de cuota permitidos.    
 ** message **   
Esta solicitud no se ha realizado correctamente debido a que la cuota de servicio ha superado los límites.  
 ** quotaCode **   
Este es el código específico del tipo de cuota.  
 ** resourceId **   
Es el identificador del recurso.  
 ** resourceType **   
Tipo de recurso.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen con la cuota.
Código de estado HTTP: 402

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_StartSearchResultExportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchResultExportJob) 

# StopSearchJob
<a name="API_BKS_StopSearchJob"></a>

Esta operación finaliza un trabajo de búsqueda.

Solo se puede detener un trabajo de búsqueda que tenga el estado `RUNNING`.

## Sintaxis de la solicitud
<a name="API_BKS_StopSearchJob_RequestSyntax"></a>

```
PUT /search-jobs/SearchJobIdentifier/actions/cancel HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_StopSearchJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [SearchJobIdentifier](#API_BKS_StopSearchJob_RequestSyntax) **   <a name="Backup-BKS_StopSearchJob-request-uri-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_StopSearchJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_StopSearchJob_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_BKS_StopSearchJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_BKS_StopSearchJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** ConflictException **   
Esta excepción se produce cuando se detecta un conflicto con una operación anterior completada correctamente. Esto suele ocurrir cuando la operación anterior no ha podido propagarse al host que atiende la solicitud actual.  
La respuesta recomendada a esta excepción es intentarlo de nuevo (con la lógica de retroceso adecuada).    
 ** message **   
Actualizar o eliminar un recurso puede generar un estado incoherente.  
 ** resourceId **   
Es el identificador del recurso afectado.  
 ** resourceType **   
Es el tipo de recurso afectado.
Código de estado HTTP: 409

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_StopSearchJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StopSearchJob) 

# TagResource
<a name="API_BKS_TagResource"></a>

Esta operación coloca etiquetas en el recurso que indique.

## Sintaxis de la solicitud
<a name="API_BKS_TagResource_RequestSyntax"></a>

```
POST /tags/ResourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_BKS_TagResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ResourceArn](#API_BKS_TagResource_RequestSyntax) **   <a name="Backup-BKS_TagResource-request-uri-ResourceArn"></a>
Es el Nombre de recurso de Amazon (ARN) que identifica de forma unívoca el recurso.  
Este es el recurso que tendrá las etiquetas indicadas.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_TagResource_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Tags](#API_BKS_TagResource_RequestSyntax) **   <a name="Backup-BKS_TagResource-request-Tags"></a>
Son las etiquetas que se deben incluir. Una etiqueta es un par clave-valor que puede utilizar para administrar, filtrar y buscar sus recursos. Los caracteres permitidos incluyen espacios, números y letras en UTF-8, además de los siguientes caracteres especiales: \$1 - = . \$1 : /.   
Tipo: mapa de cadena a cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_BKS_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_BKS_TagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_BKS_TagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/TagResource) 

# UntagResource
<a name="API_BKS_UntagResource"></a>

Esta operación elimina etiquetas del recurso especificado.

## Sintaxis de la solicitud
<a name="API_BKS_UntagResource_RequestSyntax"></a>

```
DELETE /tags/ResourceArn?tagKeys=TagKeys HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_BKS_UntagResource_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ResourceArn](#API_BKS_UntagResource_RequestSyntax) **   <a name="Backup-BKS_UntagResource-request-uri-ResourceArn"></a>
Es el nombre de recurso de Amazon (ARN) que identifica el recurso de forma unívoca para el que desea eliminar las etiquetas.  
Obligatorio: sí

 ** [TagKeys](#API_BKS_UntagResource_RequestSyntax) **   <a name="Backup-BKS_UntagResource-request-uri-TagKeys"></a>
Este parámetro obligatorio contiene las claves de etiqueta que desea eliminar del origen.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_BKS_UntagResource_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_BKS_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_BKS_UntagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_BKS_UntagResource_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso para esta solicitud.  
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.    
 ** message **   
La solicitud hace referencia a un recurso que no existe.  
 ** resourceId **   
Identificador hipotético del recurso afectado.  
 ** resourceType **   
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/UntagResource) 

# Data Types
<a name="API_Types"></a>

Los siguientes tipos de datos son compatibles con AWS Backup:
+  [AdvancedBackupSetting](API_AdvancedBackupSetting.md) 
+  [AggregatedScanResult](API_AggregatedScanResult.md) 
+  [BackupJob](API_BackupJob.md) 
+  [BackupJobSummary](API_BackupJobSummary.md) 
+  [BackupPlan](API_BackupPlan.md) 
+  [BackupPlanInput](API_BackupPlanInput.md) 
+  [BackupPlansListMember](API_BackupPlansListMember.md) 
+  [BackupPlanTemplatesListMember](API_BackupPlanTemplatesListMember.md) 
+  [BackupRule](API_BackupRule.md) 
+  [BackupRuleInput](API_BackupRuleInput.md) 
+  [BackupSelection](API_BackupSelection.md) 
+  [BackupSelectionsListMember](API_BackupSelectionsListMember.md) 
+  [BackupVaultListMember](API_BackupVaultListMember.md) 
+  [CalculatedLifecycle](API_CalculatedLifecycle.md) 
+  [Condition](API_Condition.md) 
+  [ConditionParameter](API_ConditionParameter.md) 
+  [Conditions](API_Conditions.md) 
+  [ControlInputParameter](API_ControlInputParameter.md) 
+  [ControlScope](API_ControlScope.md) 
+  [CopyAction](API_CopyAction.md) 
+  [CopyJob](API_CopyJob.md) 
+  [CopyJobSummary](API_CopyJobSummary.md) 
+  [DateRange](API_DateRange.md) 
+  [Framework](API_Framework.md) 
+  [FrameworkControl](API_FrameworkControl.md) 
+  [IndexAction](API_IndexAction.md) 
+  [IndexedRecoveryPoint](API_IndexedRecoveryPoint.md) 
+  [KeyValue](API_KeyValue.md) 
+  [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md) 
+  [LatestRevokeRequest](API_LatestRevokeRequest.md) 
+  [LegalHold](API_LegalHold.md) 
+  [Lifecycle](API_Lifecycle.md) 
+  [ProtectedResource](API_ProtectedResource.md) 
+  [ProtectedResourceConditions](API_ProtectedResourceConditions.md) 
+  [RecoveryPointByBackupVault](API_RecoveryPointByBackupVault.md) 
+  [RecoveryPointByResource](API_RecoveryPointByResource.md) 
+  [RecoveryPointCreator](API_RecoveryPointCreator.md) 
+  [RecoveryPointMember](API_RecoveryPointMember.md) 
+  [RecoveryPointSelection](API_RecoveryPointSelection.md) 
+  [ReportDeliveryChannel](API_ReportDeliveryChannel.md) 
+  [ReportDestination](API_ReportDestination.md) 
+  [ReportJob](API_ReportJob.md) 
+  [ReportPlan](API_ReportPlan.md) 
+  [ReportSetting](API_ReportSetting.md) 
+  [ResourceSelection](API_ResourceSelection.md) 
+  [RestoreAccessBackupVaultListMember](API_RestoreAccessBackupVaultListMember.md) 
+  [RestoreJobCreator](API_RestoreJobCreator.md) 
+  [RestoreJobsListMember](API_RestoreJobsListMember.md) 
+  [RestoreJobSummary](API_RestoreJobSummary.md) 
+  [RestoreTestingPlanForCreate](API_RestoreTestingPlanForCreate.md) 
+  [RestoreTestingPlanForGet](API_RestoreTestingPlanForGet.md) 
+  [RestoreTestingPlanForList](API_RestoreTestingPlanForList.md) 
+  [RestoreTestingPlanForUpdate](API_RestoreTestingPlanForUpdate.md) 
+  [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md) 
+  [RestoreTestingSelectionForCreate](API_RestoreTestingSelectionForCreate.md) 
+  [RestoreTestingSelectionForGet](API_RestoreTestingSelectionForGet.md) 
+  [RestoreTestingSelectionForList](API_RestoreTestingSelectionForList.md) 
+  [RestoreTestingSelectionForUpdate](API_RestoreTestingSelectionForUpdate.md) 
+  [ScanAction](API_ScanAction.md) 
+  [ScanJob](API_ScanJob.md) 
+  [ScanJobCreator](API_ScanJobCreator.md) 
+  [ScanJobSummary](API_ScanJobSummary.md) 
+  [ScanResult](API_ScanResult.md) 
+  [ScanResultInfo](API_ScanResultInfo.md) 
+  [ScanSetting](API_ScanSetting.md) 
+  [ScheduledPlanExecutionMember](API_ScheduledPlanExecutionMember.md) 
+  [TieringConfiguration](API_TieringConfiguration.md) 
+  [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md) 
+  [TieringConfigurationInputForUpdate](API_TieringConfigurationInputForUpdate.md) 
+  [TieringConfigurationsListMember](API_TieringConfigurationsListMember.md) 

Los siguientes tipos de datos son compatibles con AWS Backup gateway:
+  [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md) 
+  [Gateway](API_BGW_Gateway.md) 
+  [GatewayDetails](API_BGW_GatewayDetails.md) 
+  [Hypervisor](API_BGW_Hypervisor.md) 
+  [HypervisorDetails](API_BGW_HypervisorDetails.md) 
+  [MaintenanceStartTime](API_BGW_MaintenanceStartTime.md) 
+  [Tag](API_BGW_Tag.md) 
+  [VirtualMachine](API_BGW_VirtualMachine.md) 
+  [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md) 
+  [VmwareTag](API_BGW_VmwareTag.md) 
+  [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md) 

Los siguientes tipos de datos son compatibles con Búsqueda de AWS Backup:
+  [BackupCreationTimeFilter](API_BKS_BackupCreationTimeFilter.md) 
+  [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md) 
+  [EBSItemFilter](API_BKS_EBSItemFilter.md) 
+  [EBSResultItem](API_BKS_EBSResultItem.md) 
+  [ExportJobSummary](API_BKS_ExportJobSummary.md) 
+  [ExportSpecification](API_BKS_ExportSpecification.md) 
+  [ItemFilters](API_BKS_ItemFilters.md) 
+  [LongCondition](API_BKS_LongCondition.md) 
+  [ResultItem](API_BKS_ResultItem.md) 
+  [S3ExportSpecification](API_BKS_S3ExportSpecification.md) 
+  [S3ItemFilter](API_BKS_S3ItemFilter.md) 
+  [S3ResultItem](API_BKS_S3ResultItem.md) 
+  [SearchJobBackupsResult](API_BKS_SearchJobBackupsResult.md) 
+  [SearchJobSummary](API_BKS_SearchJobSummary.md) 
+  [SearchScope](API_BKS_SearchScope.md) 
+  [SearchScopeSummary](API_BKS_SearchScopeSummary.md) 
+  [StringCondition](API_BKS_StringCondition.md) 
+  [TimeCondition](API_BKS_TimeCondition.md) 

# AWS Backup
<a name="API_Types_AWS_Backup"></a>

Los siguientes tipos de datos son compatibles con AWS Backup:
+  [AdvancedBackupSetting](API_AdvancedBackupSetting.md) 
+  [AggregatedScanResult](API_AggregatedScanResult.md) 
+  [BackupJob](API_BackupJob.md) 
+  [BackupJobSummary](API_BackupJobSummary.md) 
+  [BackupPlan](API_BackupPlan.md) 
+  [BackupPlanInput](API_BackupPlanInput.md) 
+  [BackupPlansListMember](API_BackupPlansListMember.md) 
+  [BackupPlanTemplatesListMember](API_BackupPlanTemplatesListMember.md) 
+  [BackupRule](API_BackupRule.md) 
+  [BackupRuleInput](API_BackupRuleInput.md) 
+  [BackupSelection](API_BackupSelection.md) 
+  [BackupSelectionsListMember](API_BackupSelectionsListMember.md) 
+  [BackupVaultListMember](API_BackupVaultListMember.md) 
+  [CalculatedLifecycle](API_CalculatedLifecycle.md) 
+  [Condition](API_Condition.md) 
+  [ConditionParameter](API_ConditionParameter.md) 
+  [Conditions](API_Conditions.md) 
+  [ControlInputParameter](API_ControlInputParameter.md) 
+  [ControlScope](API_ControlScope.md) 
+  [CopyAction](API_CopyAction.md) 
+  [CopyJob](API_CopyJob.md) 
+  [CopyJobSummary](API_CopyJobSummary.md) 
+  [DateRange](API_DateRange.md) 
+  [Framework](API_Framework.md) 
+  [FrameworkControl](API_FrameworkControl.md) 
+  [IndexAction](API_IndexAction.md) 
+  [IndexedRecoveryPoint](API_IndexedRecoveryPoint.md) 
+  [KeyValue](API_KeyValue.md) 
+  [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md) 
+  [LatestRevokeRequest](API_LatestRevokeRequest.md) 
+  [LegalHold](API_LegalHold.md) 
+  [Lifecycle](API_Lifecycle.md) 
+  [ProtectedResource](API_ProtectedResource.md) 
+  [ProtectedResourceConditions](API_ProtectedResourceConditions.md) 
+  [RecoveryPointByBackupVault](API_RecoveryPointByBackupVault.md) 
+  [RecoveryPointByResource](API_RecoveryPointByResource.md) 
+  [RecoveryPointCreator](API_RecoveryPointCreator.md) 
+  [RecoveryPointMember](API_RecoveryPointMember.md) 
+  [RecoveryPointSelection](API_RecoveryPointSelection.md) 
+  [ReportDeliveryChannel](API_ReportDeliveryChannel.md) 
+  [ReportDestination](API_ReportDestination.md) 
+  [ReportJob](API_ReportJob.md) 
+  [ReportPlan](API_ReportPlan.md) 
+  [ReportSetting](API_ReportSetting.md) 
+  [ResourceSelection](API_ResourceSelection.md) 
+  [RestoreAccessBackupVaultListMember](API_RestoreAccessBackupVaultListMember.md) 
+  [RestoreJobCreator](API_RestoreJobCreator.md) 
+  [RestoreJobsListMember](API_RestoreJobsListMember.md) 
+  [RestoreJobSummary](API_RestoreJobSummary.md) 
+  [RestoreTestingPlanForCreate](API_RestoreTestingPlanForCreate.md) 
+  [RestoreTestingPlanForGet](API_RestoreTestingPlanForGet.md) 
+  [RestoreTestingPlanForList](API_RestoreTestingPlanForList.md) 
+  [RestoreTestingPlanForUpdate](API_RestoreTestingPlanForUpdate.md) 
+  [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md) 
+  [RestoreTestingSelectionForCreate](API_RestoreTestingSelectionForCreate.md) 
+  [RestoreTestingSelectionForGet](API_RestoreTestingSelectionForGet.md) 
+  [RestoreTestingSelectionForList](API_RestoreTestingSelectionForList.md) 
+  [RestoreTestingSelectionForUpdate](API_RestoreTestingSelectionForUpdate.md) 
+  [ScanAction](API_ScanAction.md) 
+  [ScanJob](API_ScanJob.md) 
+  [ScanJobCreator](API_ScanJobCreator.md) 
+  [ScanJobSummary](API_ScanJobSummary.md) 
+  [ScanResult](API_ScanResult.md) 
+  [ScanResultInfo](API_ScanResultInfo.md) 
+  [ScanSetting](API_ScanSetting.md) 
+  [ScheduledPlanExecutionMember](API_ScheduledPlanExecutionMember.md) 
+  [TieringConfiguration](API_TieringConfiguration.md) 
+  [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md) 
+  [TieringConfigurationInputForUpdate](API_TieringConfigurationInputForUpdate.md) 
+  [TieringConfigurationsListMember](API_TieringConfigurationsListMember.md) 

# AdvancedBackupSetting
<a name="API_AdvancedBackupSetting"></a>

Las opciones de copia de seguridad para cada tipo de recurso.

## Contenido
<a name="API_AdvancedBackupSetting_Contents"></a>

 ** BackupOptions **   <a name="Backup-Type-AdvancedBackupSetting-BackupOptions"></a>
Especifica la opción de copia de seguridad para un recurso seleccionado. Esta opción está disponible para los trabajos de copia de seguridad de Windows VSS y las copias de seguridad de S3.  
Valores válidos:   
Configure `"WindowsVSS":"enabled"` para habilitar la opción de copia de seguridad de `WindowsVSS` y crear una copia de seguridad de Windows VSS.   
Configure `"WindowsVSS":"disabled"` para crear una copia de seguridad normal. La opción `WindowsVSS` no está habilitada de forma predeterminada.  
Para las copias de seguridad de S3, `"BackupACLs":"disabled"` configúrelo para ACLs excluirlo de la copia de seguridad o `"BackupObjectTags":"disabled"` para excluir las etiquetas de objetos de la copia de seguridad. De forma predeterminada, tanto las etiquetas como ACLs las de objeto se incluyen en las copias de seguridad de S3.  
Si especifica una opción no válida, obtendrá una excepción `InvalidParameterValueException`.  
Para obtener más información acerca de las copias de seguridad de Windows VSS, consulte [Creación de una copia de seguridad de Windows habilitada para VSS](https://docs.aws.amazon.com/aws-backup/latest/devguide/windows-backups.html).  
Tipo: mapa de cadena a cadena  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Patrón de valores: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** ResourceType **   <a name="Backup-Type-AdvancedBackupSetting-ResourceType"></a>
Especifica un objeto que contiene diferentes opciones de tipos de recursos y copias de seguridad. El único tipo de recurso compatible son las instancias de Amazon EC2 con Windows Volume Shadow Copy Service (VSS). Para ver un CloudFormation ejemplo, consulte la [ CloudFormation plantilla de ejemplo para habilitar Windows VSS](https://docs.aws.amazon.com/aws-backup/latest/devguide/integrate-cloudformation-with-aws-backup.html) en la *Guía del AWS Backup usuario*.  
Valores válidos: `EC2`.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Véase también
<a name="API_AdvancedBackupSetting_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/AdvancedBackupSetting) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/AdvancedBackupSetting) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/AdvancedBackupSetting) 

# AggregatedScanResult
<a name="API_AggregatedScanResult"></a>

Contiene resultados de escaneo agregados en múltiples operaciones de escaneo, proporcionando un resumen del estado del escaneo y los hallazgos.

## Contenido
<a name="API_AggregatedScanResult_Contents"></a>

 ** FailedScan **   <a name="Backup-Type-AggregatedScanResult-FailedScan"></a>
Un valor booleano que indica si alguno de los escaneos agregados ha fallado.  
Tipo: Booleano  
Obligatorio: no

 ** Findings **   <a name="Backup-Type-AggregatedScanResult-Findings"></a>
Conjunto de hallazgos descubiertos en todos los escaneos agregados.  
Tipo: matriz de cadenas  
Valores válidos: `MALWARE`   
Obligatorio: no

 ** LastComputed **   <a name="Backup-Type-AggregatedScanResult-LastComputed"></a>
La marca temporal en la que se calculó por última vez el resultado agregado del escaneo, en formato Unix y en hora universal coordinada (UTC).  
Tipo: marca temporal  
Obligatorio: no

## Véase también
<a name="API_AggregatedScanResult_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/AggregatedScanResult) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/AggregatedScanResult) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/AggregatedScanResult) 

# BackupJob
<a name="API_BackupJob"></a>

Contiene información detallada acerca de un trabajo de copia de seguridad.

## Contenido
<a name="API_BackupJob_Contents"></a>

 ** AccountId **   <a name="Backup-Type-BackupJob-AccountId"></a>
El ID de la cuenta a la que pertenece el trabajo de copia de seguridad.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** BackupJobId **   <a name="Backup-Type-BackupJob-BackupJobId"></a>
Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso.  
Tipo: cadena  
Requerido: no

 ** BackupOptions **   <a name="Backup-Type-BackupJob-BackupOptions"></a>
Especifica la opción de copia de seguridad para un recurso seleccionado. Esta opción solo está disponible para los trabajos de copia de seguridad de Windows Volume Shadow Copy Service (VSS).  
Valores válidos: configure `"WindowsVSS":"enabled"` para habilitar la opción de copia de seguridad de `WindowsVSS` y crear una copia de seguridad de Windows VSS. Configure `"WindowsVSS":"disabled"` para crear una copia de seguridad normal. Si especifica una opción no válida, obtendrá una excepción `InvalidParameterValueException`.  
Tipo: mapa de cadena a cadena  
Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Patrón de valores: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** BackupSizeInBytes **   <a name="Backup-Type-BackupJob-BackupSizeInBytes"></a>
Es el tamaño de una copia de seguridad (punto de recuperación) en bytes.  
Este valor puede representarse de forma diferente según el tipo de recurso, ya que AWS Backup extrae información de datos de otros AWS servicios. Por ejemplo, el valor devuelto puede mostrar un valor `0`, que puede ser distinto al valor previsto.  
A continuación se describe el comportamiento esperado de los valores por tipo de recurso:  
+ En Amazon Aurora, Amazon DocumentDB y Amazon Neptune, este valor no se rellena con la operación `GetBackupJobStatus`.
+ En el caso de Amazon DynamoDB con características avanzadas, este valor es el tamaño del punto de recuperación (copia de seguridad).
+ Amazon EC2 y Amazon EBS muestran el tamaño del volumen (almacenamiento aprovisionado) devuelto como parte de este valor. Amazon EBS no devuelve información sobre el tamaño de la copia de seguridad; el tamaño de la instantánea tendrá el mismo valor que el recurso original a partir del cual se realizó la copia de seguridad.
+ En Amazon EFS, este valor hace referencia a los bytes delta transferidos durante una copia de seguridad.
+ En el caso de Amazon EKS, este valor se refiere al tamaño del punto de recuperación de EKS anidado.
+ Amazon FSx no rellena este valor a partir de la operación `GetBackupJobStatus` para sistemas de FSx archivos.
+ Una instancia de Amazon RDS se mostrará como `0`.
+ En el caso de las máquinas virtuales en ejecución VMware, este valor se transfiere a AWS Backup través de un flujo de trabajo asíncrono, lo que puede provocar que el valor mostrado no represente el tamaño real de la copia de seguridad.
Tipo: largo  
Obligatorio: no

 ** BackupType **   <a name="Backup-Type-BackupJob-BackupType"></a>
Representa el tipo de copia de seguridad de un trabajo de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** BackupVaultArn **   <a name="Backup-Type-BackupJob-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Requerido: no

 ** BackupVaultName **   <a name="Backup-Type-BackupJob-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: no

 ** BytesTransferred **   <a name="Backup-Type-BackupJob-BytesTransferred"></a>
El tamaño en bytes transferido a un almacén de copias de seguridad en el momento en que se consultó el estado del trabajo.  
Tipo: largo  
Obligatorio: no

 ** CompletionDate **   <a name="Backup-Type-BackupJob-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para crear un trabajo de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatedBy **   <a name="Backup-Type-BackupJob-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de copia de seguridad, que incluye los valores de `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` y `BackupRuleId` del plan de copia de seguridad utilizado para crearlo.  
Tipo: objeto [RecoveryPointCreator](API_RecoveryPointCreator.md)  
Obligatorio: no

 ** CreationDate **   <a name="Backup-Type-BackupJob-CreationDate"></a>
La fecha y la hora en que se creó el trabajo de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** EncryptionKeyArn **   <a name="Backup-Type-BackupJob-EncryptionKeyArn"></a>
Es el nombre de recurso de Amazon (ARN) de la clave de KMS que se utiliza para cifrar la copia de seguridad. Puede ser una clave administrada por el cliente o una clave administrada, según la AWS configuración del almacén.  
Tipo: cadena  
Requerido: no

 ** ExpectedCompletionDate **   <a name="Backup-Type-BackupJob-ExpectedCompletionDate"></a>
La fecha y la hora en que se espera completar un trabajo de copia de seguridad de recursos, en formato Unix y horario universal coordinado (UTC). El valor de `ExpectedCompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** IamRoleArn **   <a name="Backup-Type-BackupJob-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino. Los roles de IAM distintos del rol predeterminado deben incluir `AWSBackup` o `AwsBackup` en el nombre del rol. Por ejemplo, `arn:aws:iam::123456789012:role/AWSBackupRDSAccess`. Los nombres de los roles sin esas cadenas carecen de permisos para realizar trabajos de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** InitiationDate **   <a name="Backup-Type-BackupJob-InitiationDate"></a>
La fecha en que se inició un trabajo de copia de seguridad.  
Tipo: marca temporal  
Obligatorio: no

 ** IsEncrypted **   <a name="Backup-Type-BackupJob-IsEncrypted"></a>
Es un valor booleano que indica si la copia de seguridad está cifrada. Todas las copias de seguridad AWS Backup están cifradas, pero este campo indica el estado de cifrado para mayor transparencia.  
Tipo: Booleano  
Obligatorio: no

 ** IsParent **   <a name="Backup-Type-BackupJob-IsParent"></a>
Se trata de un valor booleano que indica que es un trabajo de copia de seguridad principal (compuesto).  
Tipo: Booleano  
Obligatorio: no

 ** MessageCategory **   <a name="Backup-Type-BackupJob-MessageCategory"></a>
Este parámetro es el recuento de trabajos de la categoría de mensajes especificada.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` y `INVALIDPARAMETERS`. Consulte [Supervisión](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) para ver una lista de MessageCategory cadenas.  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.  
Tipo: cadena  
Requerido: no

 ** ParentJobId **   <a name="Backup-Type-BackupJob-ParentJobId"></a>
Identifica de forma exclusiva una solicitud de AWS Backup para hacer una copia de seguridad de un recurso. Se devolverá el ID del trabajo principal (compuesto).  
Tipo: cadena  
Requerido: no

 ** PercentDone **   <a name="Backup-Type-BackupJob-PercentDone"></a>
Contiene el porcentaje estimado que se ha completado de un trabajo en el momento en que se consultó el estado del trabajo.  
Tipo: cadena  
Requerido: no

 ** RecoveryPointArn **   <a name="Backup-Type-BackupJob-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** RecoveryPointLifecycle **   <a name="Backup-Type-BackupJob-RecoveryPointLifecycle"></a>
Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine.  
Las copias de seguridad que se transfieran a cámaras frigoríficas deben almacenarse en cámaras frigoríficas durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** ResourceArn **   <a name="Backup-Type-BackupJob-ResourceArn"></a>
Un ARN que identifica de forma única a un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** ResourceName **   <a name="Backup-Type-BackupJob-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-BackupJob-ResourceType"></a>
El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS). Para las copias de seguridad de Windows Volume Shadow Copy Service (VSS), el único tipo de recurso compatible es Amazon EC2.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** StartBy **   <a name="Backup-Type-BackupJob-StartBy"></a>
Especifica la hora en formato Unix y horario universal coordinado (UTC) en la que se debe iniciar un trabajo de copia de seguridad antes de que se cancele. El valor se calcula agregando el periodo de inicio a la hora programada. Por lo tanto, si la hora programada fueran las 18:00 h y el periodo de inicio fuera de 2 horas, la hora `StartBy` sería las 20:00 h en la fecha especificada. El valor de `StartBy` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** State **   <a name="Backup-Type-BackupJob-State"></a>
El estado actual de un trabajo de copia de seguridad.  
Tipo: cadena  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-BackupJob-StatusMessage"></a>
Un mensaje detallado que explica el estado del trabajo de copia de seguridad de un recurso.  
Tipo: cadena  
Requerido: no

 ** VaultLockState **   <a name="Backup-Type-BackupJob-VaultLockState"></a>
Es el estado de bloqueo del almacén de copias de seguridad. En el caso de los almacenes aislados lógicamente, indica si el almacén está bloqueado en el modo de conformidad. Los valores válidos son `LOCKED` y `UNLOCKED`.  
Tipo: cadena  
Requerido: no

 ** VaultType **   <a name="Backup-Type-BackupJob-VaultType"></a>
Es el tipo de almacén de copias de seguridad en el que se guarda el punto de recuperación. Los valores válidos son `BACKUP_VAULT` para los almacenes de copias de seguridad estándar y `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` para los almacenes aislados lógicamente.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BackupJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupJob) 

# BackupJobSummary
<a name="API_BackupJobSummary"></a>

Es un resumen de los trabajos creados o en ejecución en los 30 últimos días.

El resumen devuelto puede contener lo siguiente: Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime y Count de trabajos incluidos.

## Contenido
<a name="API_BackupJobSummary_Contents"></a>

 ** AccountId **   <a name="Backup-Type-BackupJobSummary-AccountId"></a>
El ID de la cuenta propietaria de los trabajos del resumen.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** Count **   <a name="Backup-Type-BackupJobSummary-Count"></a>
El valor expresado como número de trabajos en un resumen de trabajos.  
Tipo: entero  
Obligatorio: no

 ** EndTime **   <a name="Backup-Type-BackupJobSummary-EndTime"></a>
El valor de hora en formato numérico de la hora de finalización de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** MessageCategory **   <a name="Backup-Type-BackupJobSummary-MessageCategory"></a>
Este parámetro es el recuento de trabajos de la categoría de mensajes especificada.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `Success` y `InvalidParameters`. Consulte en [Monitorización](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) una lista de cadenas de MessageCategory.  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.  
Tipo: cadena  
Requerido: no

 ** Region **   <a name="Backup-Type-BackupJobSummary-Region"></a>
Las regiones de AWS incluidas en el resumen del trabajo.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-BackupJobSummary-ResourceType"></a>
Este valor es el recuento de trabajos para el tipo de recurso especificado. La solicitud `GetSupportedResourceTypes` devuelve cadenas para los tipos de recursos compatibles.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** StartTime **   <a name="Backup-Type-BackupJobSummary-StartTime"></a>
El valor de hora en formato numérico de la hora de inicio de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** State **   <a name="Backup-Type-BackupJobSummary-State"></a>
Este valor es el recuento de trabajos con el estado especificado.  
Tipo: cadena  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY`   
Obligatorio: no

## Véase también
<a name="API_BackupJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupJobSummary) 

# BackupPlan
<a name="API_BackupPlan"></a>

Contiene un nombre de visualización de plan de copia de seguridad opcional y una matriz de objetos `BackupRule`, cada uno de los cuales especifica una regla de copia de seguridad. Cada regla de un plan de copia de seguridad es una tarea programada independiente y puede hacer una copia de seguridad de una selección diferente de recursos de AWS .

## Contenido
<a name="API_BackupPlan_Contents"></a>

 ** BackupPlanName **   <a name="Backup-Type-BackupPlan-BackupPlanName"></a>
El nombre de visualización del plan de copia de seguridad. Debe contener solo caracteres alfanuméricos o “-\$1”. caracteres especiales.  
Si se establece en la consola, puede contener de 1 a 50 caracteres; si se establece mediante CLI o API, puede contener de 1 a 200 caracteres.  
Tipo: cadena  
Obligatorio: sí

 ** Rules **   <a name="Backup-Type-BackupPlan-Rules"></a>
Una matriz de objetos `BackupRule`, cada uno de los cuales especifica una tarea programada que se utiliza para realizar una copia de seguridad de una selección de recursos.   
Tipo: matriz de objetos [BackupRule](API_BackupRule.md)  
Obligatorio: sí

 ** AdvancedBackupSettings **   <a name="Backup-Type-BackupPlan-AdvancedBackupSettings"></a>
Contiene una lista de `BackupOptions` para cada tipo de recurso.  
Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md)  
Obligatorio: no

 ** ScanSettings **   <a name="Backup-Type-BackupPlan-ScanSettings"></a>
Contiene la configuración de escaneo para el plan de respaldo e incluye el escáner de malware, los recursos seleccionados y la función del escáner.  
Tipo: matriz de objetos [ScanSetting](API_ScanSetting.md)  
Obligatorio: no

## Véase también
<a name="API_BackupPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlan) 

# BackupPlanInput
<a name="API_BackupPlanInput"></a>

Contiene un nombre de visualización de plan de copia de seguridad opcional y una matriz de objetos `BackupRule`, cada uno de los cuales especifica una regla de copia de seguridad. Cada regla de un plan de copia de seguridad es una tarea programada independiente. 

## Contenido
<a name="API_BackupPlanInput_Contents"></a>

 ** BackupPlanName **   <a name="Backup-Type-BackupPlanInput-BackupPlanName"></a>
El nombre de visualización del plan de copia de seguridad. Debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Obligatorio: sí

 ** Rules **   <a name="Backup-Type-BackupPlanInput-Rules"></a>
Una matriz de objetos `BackupRule`, cada uno de los cuales especifica una tarea programada que se utiliza para realizar una copia de seguridad de una selección de recursos.  
Tipo: matriz de objetos [BackupRuleInput](API_BackupRuleInput.md)  
Obligatorio: sí

 ** AdvancedBackupSettings **   <a name="Backup-Type-BackupPlanInput-AdvancedBackupSettings"></a>
Especifica una lista de `BackupOptions` para cada tipo de recurso. Esta configuración solo está disponible para los trabajos de copia de seguridad de Windows Volume Shadow Copy Service (VSS).  
Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md)  
Obligatorio: no

 ** ScanSettings **   <a name="Backup-Type-BackupPlanInput-ScanSettings"></a>
Contiene la configuración de escaneo para la regla de respaldo e incluye el escáner de malware y el modo de escaneo completo o incremental.  
Tipo: matriz de objetos [ScanSetting](API_ScanSetting.md)  
Obligatorio: no

## Véase también
<a name="API_BackupPlanInput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlanInput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlanInput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlanInput) 

# BackupPlansListMember
<a name="API_BackupPlansListMember"></a>

Contiene metadatos sobre un plan de copia de seguridad.

## Contenido
<a name="API_BackupPlansListMember_Contents"></a>

 ** AdvancedBackupSettings **   <a name="Backup-Type-BackupPlansListMember-AdvancedBackupSettings"></a>
Contiene una lista de `BackupOptions` para un tipo de recurso.  
Tipo: matriz de objetos [AdvancedBackupSetting](API_AdvancedBackupSetting.md)  
Obligatorio: no

 ** BackupPlanArn **   <a name="Backup-Type-BackupPlansListMember-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena  
Requerido: no

 ** BackupPlanId **   <a name="Backup-Type-BackupPlansListMember-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** BackupPlanName **   <a name="Backup-Type-BackupPlansListMember-BackupPlanName"></a>
El nombre de visualización del plan de copia de seguridad guardado.  
Tipo: cadena  
Requerido: no

 ** CreationDate **   <a name="Backup-Type-BackupPlansListMember-CreationDate"></a>
La fecha y la hora en que se creó el plan de copia de seguridad de un recurso, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatorRequestId **   <a name="Backup-Type-BackupPlansListMember-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** DeletionDate **   <a name="Backup-Type-BackupPlansListMember-DeletionDate"></a>
La fecha y la hora en que se eliminó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `DeletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** LastExecutionDate **   <a name="Backup-Type-BackupPlansListMember-LastExecutionDate"></a>
La última vez que se ejecutó este plan de copia de seguridad. Una fecha y hora, en formato Unix y horario universal coordinado (UTC). El valor de `LastExecutionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** VersionId **   <a name="Backup-Type-BackupPlansListMember-VersionId"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. Los ID de versión no se pueden editar.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BackupPlansListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlansListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlansListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlansListMember) 

# BackupPlanTemplatesListMember
<a name="API_BackupPlanTemplatesListMember"></a>

Un objeto que especifica los metadatos asociados a una plantilla de plan de copia de seguridad.

## Contenido
<a name="API_BackupPlanTemplatesListMember_Contents"></a>

 ** BackupPlanTemplateId **   <a name="Backup-Type-BackupPlanTemplatesListMember-BackupPlanTemplateId"></a>
Identifica de forma exclusiva una plantilla de plan de copia de seguridad almacenada.  
Tipo: cadena  
Requerido: no

 ** BackupPlanTemplateName **   <a name="Backup-Type-BackupPlanTemplatesListMember-BackupPlanTemplateName"></a>
El nombre de visualización opcional de la plantilla de copia de seguridad.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BackupPlanTemplatesListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlanTemplatesListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlanTemplatesListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlanTemplatesListMember) 

# BackupRule
<a name="API_BackupRule"></a>

Especifica una tarea programada utilizada para hacer una copia de seguridad de una selección de recursos.

## Contenido
<a name="API_BackupRule_Contents"></a>

 ** RuleName **   <a name="Backup-Type-BackupRule-RuleName"></a>
Un nombre de visualización para una regla de copia de seguridad. Debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: sí

 ** TargetBackupVaultName **   <a name="Backup-Type-BackupRule-TargetBackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** CompletionWindowMinutes **   <a name="Backup-Type-BackupRule-CompletionWindowMinutes"></a>
Un valor en minutos después de que un trabajo de copia de seguridad se haya iniciado correctamente antes que AWS Backup deba completarlo o cancelarlo. Este valor es opcional.  
Tipo: largo  
Obligatorio: no

 ** CopyActions **   <a name="Backup-Type-BackupRule-CopyActions"></a>
Una matriz de objetos `CopyAction`, que contiene los detalles de la operación de copia.  
Tipo: matriz de objetos [CopyAction](API_CopyAction.md)  
Obligatorio: no

 ** EnableContinuousBackup **   <a name="Backup-Type-BackupRule-EnableContinuousBackup"></a>
Especifica si AWS Backup crea copias de seguridad continuas. True hace AWS Backup que se creen copias de seguridad continuas con capacidad de point-in-time restauración (PITR). Si es falso (o no se ha especificado), AWS Backup se crean copias de seguridad instantáneas.  
Tipo: Booleano  
Obligatorio: no

 ** IndexActions **   <a name="Backup-Type-BackupRule-IndexActions"></a>
IndexActions es una matriz que se utiliza para especificar cómo se deben indexar los datos de las copias de seguridad.  
Cada una BackupRule puede tener 0 o 1 IndexAction, ya que cada copia de seguridad puede tener hasta un índice asociado.  
Dentro de la matriz está ResourceType. Solo se aceptará uno para cada uno BackupRule.  
Tipo: matriz de objetos [IndexAction](API_IndexAction.md)  
Obligatorio: no

 ** Lifecycle **   <a name="Backup-Type-BackupRule-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup cambia y vence las copias de seguridad automáticamente según el ciclo de vida que usted defina.   
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.   
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** RecoveryPointTags **   <a name="Backup-Type-BackupRule-RecoveryPointTags"></a>
Las etiquetas que se asignan a los recursos asociados a esta regla cuando se restauran desde una copia de seguridad.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** RuleId **   <a name="Backup-Type-BackupRule-RuleId"></a>
Identifica de forma exclusiva una regla que se utiliza para programar la copia de seguridad de una selección de recursos.  
Tipo: cadena  
Requerido: no

 ** ScanActions **   <a name="Backup-Type-BackupRule-ScanActions"></a>
Contiene la configuración de escaneo para la regla de respaldo e incluye el escáner de malware y el modo de escaneo completo o incremental.  
Tipo: matriz de objetos [ScanAction](API_ScanAction.md)  
Obligatorio: no

 ** ScheduleExpression **   <a name="Backup-Type-BackupRule-ScheduleExpression"></a>
Expresión cron en UTC que especifica cuándo se AWS Backup inicia un trabajo de copia de seguridad. Si no se proporciona ninguna expresión CRON, AWS Backup utilizará la expresión por defecto. `cron(0 5 ? * * *)`  
Para obtener más información sobre las expresiones AWS cron, consulte [Programar expresiones para reglas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html) en la *Guía del usuario de Amazon CloudWatch Events*.  
Dos ejemplos de expresiones AWS cron son ` 15 * ? * * *` (realizar una copia de seguridad cada hora 15 minutos después de la hora) y `0 12 * * ? *` (realizar una copia de seguridad todos los días a las 12 del mediodía UTC).  
Para ver una tabla de ejemplos, haga clic en el enlace anterior y desplácese hacia abajo en la página.  
Tipo: cadena  
Requerido: no

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-BackupRule-ScheduleExpressionTimezone"></a>
La zona horaria en la que se establece la expresión de programación. De forma predeterminada, ScheduleExpressions están en UTC. Puede modificar esto para una zona horaria específica.  
Tipo: cadena  
Requerido: no

 ** StartWindowMinutes **   <a name="Backup-Type-BackupRule-StartWindowMinutes"></a>
Un valor en minutos después del que una copia de seguridad está programada antes de que se cancele el trabajo si no se ha iniciado correctamente. Este valor es opcional. Si se incluye este valor, debe ser de al menos 60 minutos para evitar errores.  
Durante el intervalo de inicio, el estado del trabajo de copia de seguridad permanece en ese estado `CREATED` hasta que comience correctamente o hasta que se agote el tiempo del intervalo de inicio. Si dentro de la ventana de inicio, Time AWS Backup recibe un error que permite volver a intentar el trabajo, AWS Backup volverá a intentarlo automáticamente al menos cada 10 minutos hasta que la copia de seguridad comience correctamente (el estado del trabajo cambia a`RUNNING`) o hasta que el estado del trabajo cambie a `EXPIRED` (lo que se espera que ocurra cuando finalice el tiempo de la ventana de inicio).  
Tipo: largo  
Obligatorio: no

 ** TargetLogicallyAirGappedBackupVaultArn **   <a name="Backup-Type-BackupRule-TargetLogicallyAirGappedBackupVaultArn"></a>
El ARN de una bóveda con huecos de aire lógicos. El ARN debe estar en la misma cuenta y región. Si se proporcionan, los recursos compatibles totalmente gestionados realizan copias de seguridad directamente en un almacén aislado de forma lógica, mientras que otros recursos compatibles crean una instantánea temporal (facturable) en el almacén de respaldo y, a continuación, la copian en un almacén aislado de forma lógica. Los recursos no compatibles solo se respaldan en el almacén de respaldo especificado.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BackupRule_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupRule) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupRule) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupRule) 

# BackupRuleInput
<a name="API_BackupRuleInput"></a>

Especifica una tarea programada utilizada para hacer una copia de seguridad de una selección de recursos.

## Contenido
<a name="API_BackupRuleInput_Contents"></a>

 ** RuleName **   <a name="Backup-Type-BackupRuleInput-RuleName"></a>
Un nombre de visualización para una regla de copia de seguridad. Debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: sí

 ** TargetBackupVaultName **   <a name="Backup-Type-BackupRuleInput-TargetBackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: sí

 ** CompletionWindowMinutes **   <a name="Backup-Type-BackupRuleInput-CompletionWindowMinutes"></a>
Un valor en minutos después de que un trabajo de copia de seguridad se haya iniciado correctamente antes que AWS Backup deba completarlo o cancelarlo. Este valor es opcional.  
Tipo: largo  
Obligatorio: no

 ** CopyActions **   <a name="Backup-Type-BackupRuleInput-CopyActions"></a>
Una matriz de objetos `CopyAction`, que contiene los detalles de la operación de copia.  
Tipo: matriz de objetos [CopyAction](API_CopyAction.md)  
Obligatorio: no

 ** EnableContinuousBackup **   <a name="Backup-Type-BackupRuleInput-EnableContinuousBackup"></a>
Especifica si AWS Backup crea copias de seguridad continuas. True hace AWS Backup que se creen copias de seguridad continuas con capacidad de point-in-time restauración (PITR). Si es falso (o no se ha especificado), AWS Backup se crean copias de seguridad instantáneas.  
Tipo: Booleano  
Obligatorio: no

 ** IndexActions **   <a name="Backup-Type-BackupRuleInput-IndexActions"></a>
Puede haber hasta una IndexAction en cada una BackupRule, ya que cada copia de seguridad puede tener 0 o 1 índice de copia de seguridad asociado.  
Dentro de la matriz está ResourceTypes. Solo se aceptará 1 tipo de recurso para cada uno BackupRule. Valores válidos:  
+  `EBS` para Amazon Elastic Block Store (EBS)
+  `S3` para Amazon Simple Storage Service (Amazon S3)
Tipo: matriz de objetos [IndexAction](API_IndexAction.md)  
Obligatorio: no

 ** Lifecycle **   <a name="Backup-Type-BackupRuleInput-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup realizará la transición y caducará las copias de seguridad automáticamente según el ciclo de vida que usted defina.   
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Este parámetro tiene un valor máximo de 100 años (36 500 días).  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** RecoveryPointTags **   <a name="Backup-Type-BackupRuleInput-RecoveryPointTags"></a>
Las etiquetas para asignar a los recursos.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** ScanActions **   <a name="Backup-Type-BackupRuleInput-ScanActions"></a>
Contiene la configuración de escaneo para la regla de respaldo e incluye el escáner de malware y el modo de escaneo completo o incremental.  
Tipo: matriz de objetos [ScanAction](API_ScanAction.md)  
Obligatorio: no

 ** ScheduleExpression **   <a name="Backup-Type-BackupRuleInput-ScheduleExpression"></a>
Expresión CRON en UTC que especifica cuándo se AWS Backup inicia un trabajo de copia de seguridad. Si no se proporciona ninguna expresión CRON, AWS Backup utilizará la expresión por defecto. `cron(0 5 ? * * *)`  
Tipo: cadena  
Requerido: no

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-BackupRuleInput-ScheduleExpressionTimezone"></a>
La zona horaria en la que se establece la expresión de programación. De forma predeterminada, ScheduleExpressions están en UTC. Puede modificar esto para una zona horaria específica.  
Tipo: cadena  
Requerido: no

 ** StartWindowMinutes **   <a name="Backup-Type-BackupRuleInput-StartWindowMinutes"></a>
Un valor en minutos después del que una copia de seguridad está programada antes de que se cancele el trabajo si no se ha iniciado correctamente. Este valor es opcional. Si se incluye este valor, debe ser de al menos 60 minutos para evitar errores.  
Este parámetro tiene un valor máximo de 100 años (52 560 000 minutos).  
Durante el intervalo de inicio, el estado del trabajo de copia de seguridad permanece en ese estado `CREATED` hasta que comience correctamente o hasta que se agote el tiempo del intervalo de inicio. Si dentro de la ventana de inicio, Time AWS Backup recibe un error que permite volver a intentar el trabajo, AWS Backup volverá a intentarlo automáticamente al menos cada 10 minutos hasta que la copia de seguridad comience correctamente (el estado del trabajo cambia a`RUNNING`) o hasta que el estado del trabajo cambie a `EXPIRED` (lo que se espera que ocurra cuando finalice el tiempo de la ventana de inicio).  
Tipo: largo  
Obligatorio: no

 ** TargetLogicallyAirGappedBackupVaultArn **   <a name="Backup-Type-BackupRuleInput-TargetLogicallyAirGappedBackupVaultArn"></a>
El ARN de una bóveda con huecos de aire lógicos. El ARN debe estar en la misma cuenta y región. Si se proporcionan, los recursos compatibles totalmente gestionados realizan copias de seguridad directamente en un almacén aislado de forma lógica, mientras que otros recursos compatibles crean una instantánea temporal (facturable) en el almacén de respaldo y, a continuación, la copian en un almacén aislado de forma lógica. Los recursos no compatibles solo se respaldan en el almacén de respaldo especificado.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BackupRuleInput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupRuleInput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupRuleInput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupRuleInput) 

# BackupSelection
<a name="API_BackupSelection"></a>

Se usa para especificar un conjunto de recursos para un plan de copia de seguridad.

Le recomendamos que especifique las condiciones, etiquetas o recursos que desee incluir o excluir. De lo contrario, Backup intentará seleccionar todos los recursos de almacenamiento compatibles y opcionales, lo que podría tener implicaciones de costo imprevistas.

Para obtener más información, consulte [Asignación de recursos mediante programación](https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json).

## Contenido
<a name="API_BackupSelection_Contents"></a>

 ** IamRoleArn **   <a name="Backup-Type-BackupSelection-IamRoleArn"></a>
El ARN de la función de IAM que se AWS Backup utiliza para autenticarse al realizar una copia de seguridad del recurso de destino; por ejemplo,. `arn:aws:iam::123456789012:role/S3Access`  
Tipo: cadena  
Obligatorio: sí

 ** SelectionName **   <a name="Backup-Type-BackupSelection-SelectionName"></a>
El nombre de visualización de un documento de selección de recursos. Debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: sí

 ** Conditions **   <a name="Backup-Type-BackupSelection-Conditions"></a>
Las condiciones que defina para asignar recursos a sus planes de copia de seguridad mediante etiquetas. Por ejemplo, `"StringEquals": { "ConditionKey": "aws:ResourceTag/backup", "ConditionValue": "daily" }`.  
 `Conditions` admite `StringEquals`, `StringLike`, `StringNotEquals` y `StringNotLike`. Los operadores de condición distinguen entre mayúsculas y minúsculas.  
Si especifica varias condiciones, los recursos deben coincidir con todas las condiciones (lógica AND).  
Tipo: objeto [Conditions](API_Conditions.md)  
Obligatorio: no

 ** ListOfTags **   <a name="Backup-Type-BackupSelection-ListOfTags"></a>
Le recomendamos que utilice el parámetro `Conditions` en lugar de este parámetro.  
Las condiciones que defina para asignar recursos a sus planes de copia de seguridad mediante etiquetas. Por ejemplo, `"StringEquals": { "ConditionKey": "backup", "ConditionValue": "daily"}`.  
 `ListOfTags` solo es compatible con `StringEquals`. Los operadores de condición distinguen entre mayúsculas y minúsculas.  
Si especifica varias condiciones, los recursos deben coincidir con cualquiera de las condiciones (lógica OR).  
Tipo: matriz de objetos [Condition](API_Condition.md)  
Obligatorio: no

 ** NotResources **   <a name="Backup-Type-BackupSelection-NotResources"></a>
Los nombres de los recursos de Amazon (ARNs) de los recursos que se van a excluir de un plan de respaldo. El número máximo ARNs es 500 sin caracteres comodín o 30 ARNs con caracteres comodín.  
Si necesita excluir muchos recursos de un plan de copia de seguridad, considere una estrategia de selección de recursos diferente, como asignar solo uno o unos pocos tipos de recursos o refinar su selección de recursos utilizando etiquetas.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** Resources **   <a name="Backup-Type-BackupSelection-Resources"></a>
Los nombres de los recursos de Amazon (ARNs) de los recursos que se van a asignar a un plan de respaldo. El número máximo ARNs es 500 sin caracteres comodín o 30 ARNs con caracteres comodín.  
Si necesita asignar muchos recursos a un plan de copia de seguridad, considere una estrategia de selección de recursos diferente, como asignar todos los recursos de un tipo de recurso o ajustar su selección de recursos mediante etiquetas.  
Si especifica varios ARNs, los recursos coinciden con creces con alguna de las opciones ARNs (lógica OR).  
Si se utilizan caracteres comodín en los patrones de ARN para las selecciones de respaldo, el asterisco (\$1) debe aparecer al final de la cadena ARN (patrón de prefijo). Por ejemplo, `arn:aws:s3:::my-bucket-*` es válido, pero no se admite. `arn:aws:s3:::*-logs`
Tipo: matriz de cadenas  
Obligatorio: no

## Véase también
<a name="API_BackupSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupSelection) 

# BackupSelectionsListMember
<a name="API_BackupSelectionsListMember"></a>

Contiene metadatos sobre un objeto `BackupSelection`.

## Contenido
<a name="API_BackupSelectionsListMember_Contents"></a>

 ** BackupPlanId **   <a name="Backup-Type-BackupSelectionsListMember-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** CreationDate **   <a name="Backup-Type-BackupSelectionsListMember-CreationDate"></a>
La fecha y la hora en que se creó el plan de copia de seguridad, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatorRequestId **   <a name="Backup-Type-BackupSelectionsListMember-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** IamRoleArn **   <a name="Backup-Type-BackupSelectionsListMember-IamRoleArn"></a>
Especifica el nombre de recurso de Amazon (ARN) del rol de IAM para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Requerido: no

 ** SelectionId **   <a name="Backup-Type-BackupSelectionsListMember-SelectionId"></a>
Identifica de forma única una solicitud para asignar un conjunto de recursos a un plan de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** SelectionName **   <a name="Backup-Type-BackupSelectionsListMember-SelectionName"></a>
El nombre de visualización de un documento de selección de recursos.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Véase también
<a name="API_BackupSelectionsListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupSelectionsListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupSelectionsListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupSelectionsListMember) 

# BackupVaultListMember
<a name="API_BackupVaultListMember"></a>

Contiene metadatos sobre un almacén de copias de seguridad.

## Contenido
<a name="API_BackupVaultListMember_Contents"></a>

 ** BackupVaultArn **   <a name="Backup-Type-BackupVaultListMember-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Requerido: no

 ** BackupVaultName **   <a name="Backup-Type-BackupVaultListMember-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: no

 ** CreationDate **   <a name="Backup-Type-BackupVaultListMember-CreationDate"></a>
La fecha y la hora en que se creó la copia de seguridad de un recurso, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatorRequestId **   <a name="Backup-Type-BackupVaultListMember-CreatorRequestId"></a>
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** EncryptionKeyArn **   <a name="Backup-Type-BackupVaultListMember-EncryptionKeyArn"></a>
Una clave de cifrado del lado del servidor que puede especificar para cifrar las copias de seguridad de los servicios que admiten la AWS Backup administración completa; por ejemplo,. `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` Si especifica una clave, debe especificar su ARN, no su alias. Si no especifica ninguna clave, AWS Backup crea una clave de KMS para usted de forma predeterminada.  
Para saber qué AWS Backup servicios admiten la AWS Backup administración completa y cómo se AWS Backup gestiona el cifrado de las copias de seguridad de los servicios que aún no lo son AWS Backup, consulte [Cifrado](https://docs.aws.amazon.com/aws-backup/latest/devguide/encryption.html) de copias de seguridad en AWS Backup  
Tipo: cadena  
Requerido: no

 ** EncryptionKeyType **   <a name="Backup-Type-BackupVaultListMember-EncryptionKeyType"></a>
El tipo de clave de cifrado utilizada para el almacén de copias de seguridad. Los valores válidos son CUSTOMER\$1MANAGED\$1KMS\$1KEY para las claves administradas por el cliente o \$1OWNED\$1KMS\$1KEY para las claves propiedad del cliente. AWS AWS  
Tipo: cadena  
Valores válidos: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`   
Obligatorio: no

 ** LockDate **   <a name="Backup-Type-BackupVaultListMember-LockDate"></a>
La fecha y la hora en que la configuración de Vault Lock pasa a ser inmutable, lo que significa que no se puede cambiar ni eliminar. AWS Backup   
Si ha aplicado el bloqueo de almacenes a su almacén sin especificar una fecha de bloqueo, puede cambiar la configuración del bloqueo de almacenes o eliminarlo del almacén por completo en cualquier momento.  
Este valor está en formato Unix, horario universal coordinado (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** Locked **   <a name="Backup-Type-BackupVaultListMember-Locked"></a>
Un valor booleano que indica si AWS Backup Vault Lock se aplica al almacén de respaldo seleccionado. Si `true`, el bloqueo de almacenes impide las operaciones de eliminación y actualización en los puntos de recuperación del almacén seleccionado.  
Tipo: Booleano  
Obligatorio: no

 ** MaxRetentionDays **   <a name="Backup-Type-BackupVaultListMember-MaxRetentionDays"></a>
La configuración de bloqueo del AWS Backup almacén que especifica el período máximo de retención durante el que el almacén conserva sus puntos de recuperación. Si no se especifica este parámetro, el bloqueo de almacenes no impone un periodo de retención máximo en los puntos de recuperación del almacén (lo que permite un almacenamiento indefinido).  
Si se especifica, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o inferior al periodo de retención máximo. Si el periodo de retención del trabajo es superior a ese periodo de retención máximo, el almacén falla el trabajo de copia de seguridad o de copia de seguridad, y deberá modificar la configuración del ciclo de vida o utilizar un almacén diferente. Los puntos de recuperación ya almacenados en el almacén antes del bloqueo del mismo no se ven afectados.  
Tipo: largo  
Obligatorio: no

 ** MinRetentionDays **   <a name="Backup-Type-BackupVaultListMember-MinRetentionDays"></a>
La configuración de bloqueo del AWS Backup almacén que especifica el período mínimo de retención durante el que el almacén conserva sus puntos de recuperación. Si no se especifica este parámetro, el bloqueo del almacén no impondrá un periodo mínimo de retención.  
Si se especifica, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o superior al periodo de retención mínimo. Si el periodo de retención del trabajo es más breve que ese periodo de retención mínimo, el almacén dará error en el trabajo de copia de seguridad o copia, y deberá modificar la configuración del ciclo de vida o usar un almacén diferente. Los puntos de recuperación ya almacenados en el almacén antes del bloqueo del mismo no se ven afectados.  
Tipo: largo  
Obligatorio: no

 ** NumberOfRecoveryPoints **   <a name="Backup-Type-BackupVaultListMember-NumberOfRecoveryPoints"></a>
El número de puntos de recuperación que se almacenan en un almacén de copias de seguridad. El valor del recuento de puntos de recuperación que se muestra en la consola puede ser una aproximación.  
Tipo: largo  
Obligatorio: no

 ** VaultState **   <a name="Backup-Type-BackupVaultListMember-VaultState"></a>
El estado actual del almacén.  
Tipo: cadena  
Valores válidos: `CREATING | AVAILABLE | FAILED`   
Obligatorio: no

 ** VaultType **   <a name="Backup-Type-BackupVaultListMember-VaultType"></a>
El tipo de almacén en el que se guarda el punto de recuperación descrito.  
Tipo: cadena  
Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`   
Obligatorio: no

## Véase también
<a name="API_BackupVaultListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupVaultListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupVaultListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupVaultListMember) 

# CalculatedLifecycle
<a name="API_CalculatedLifecycle"></a>

Contiene las marcas de tiempo `MoveToColdStorageAt` y `DeleteAt`, que se utilizan para especificar el ciclo de vida de un punto de recuperación.

El ciclo de vida define el momento en que se migra un recurso protegido al almacenamiento en frío y cuándo dicho recurso vence. AWS Backup migra las copias de seguridad y las da por vencidas automáticamente en función del ciclo de vida que se defina.

Las copias de seguridad que se han migrado al almacenamiento en frío deben permanecer en él durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.

Los tipos de recursos que se pueden transferir al almacenamiento en frío se enumeran en la tabla [Disponibilidad de características por recurso.](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) AWS Backup omite esta expresión para otros tipos de recurso.

## Contenido
<a name="API_CalculatedLifecycle_Contents"></a>

 ** DeleteAt **   <a name="Backup-Type-CalculatedLifecycle-DeleteAt"></a>
Una marca de tiempo que especifica cuándo se debe eliminar un punto de recuperación.  
Tipo: marca temporal  
Obligatorio: no

 ** MoveToColdStorageAt **   <a name="Backup-Type-CalculatedLifecycle-MoveToColdStorageAt"></a>
Una marca de tiempo que especifica cuándo se debe realizar la transferencia de un punto de recuperación al almacenamiento en frío.  
Tipo: marca temporal  
Obligatorio: no

## Véase también
<a name="API_CalculatedLifecycle_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CalculatedLifecycle) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CalculatedLifecycle) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CalculatedLifecycle) 

# Condition
<a name="API_Condition"></a>

Contiene una matriz de triplos compuesta por un tipo de condición (como `StringEquals`), una clave y un valor. Se utiliza para filtrar los recursos mediante sus etiquetas y asignarlos a un plan de copia de seguridad. Distingue mayúsculas de minúsculas.

## Contenido
<a name="API_Condition_Contents"></a>

 ** ConditionKey **   <a name="Backup-Type-Condition-ConditionKey"></a>
La clave en un par de clave-valor. Por ejemplo, en la etiqueta `Department: Accounting`, la clave es `Department`.  
Tipo: cadena  
Obligatorio: sí

 ** ConditionType **   <a name="Backup-Type-Condition-ConditionType"></a>
Una operación que se aplica a un par clave-valor que se utiliza para asignar recursos a su plan de copia de seguridad. La condición solo es compatible con `StringEquals`. Si desea opciones de asignación más flexibles, incluida `StringLike` y la posibilidad de excluir recursos de su plan de copia de seguridad, utilice `Conditions` (con una “s” al final) para su plan [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BackupSelection.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BackupSelection.html).  
Tipo: cadena  
Valores válidos: `STRINGEQUALS`   
Obligatorio: sí

 ** ConditionValue **   <a name="Backup-Type-Condition-ConditionValue"></a>
El valor de un par clave-valor. Por ejemplo, en la etiqueta `Department: Accounting`, el valor es `Accounting`.  
Tipo: cadena  
Obligatorio: sí

## Véase también
<a name="API_Condition_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Condition) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Condition) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Condition) 

# ConditionParameter
<a name="API_ConditionParameter"></a>

Incluye información sobre las etiquetas que se definen para asignar recursos etiquetados a un plan de copia de seguridad.

Incluya el prefijo `aws:ResourceTag` en sus etiquetas. Por ejemplo, `"aws:ResourceTag/TagKey1": "Value1"`.

## Contenido
<a name="API_ConditionParameter_Contents"></a>

 ** ConditionKey **   <a name="Backup-Type-ConditionParameter-ConditionKey"></a>
La clave en un par de clave-valor. Por ejemplo, en la etiqueta `Department: Accounting`, la clave es `Department`.  
Tipo: cadena  
Requerido: no

 ** ConditionValue **   <a name="Backup-Type-ConditionParameter-ConditionValue"></a>
El valor de un par clave-valor. Por ejemplo, en la etiqueta `Department: Accounting`, el valor es `Accounting`.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ConditionParameter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ConditionParameter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ConditionParameter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ConditionParameter) 

# Conditions
<a name="API_Conditions"></a>

Contiene información acerca de los recursos que se deben incluir o excluir de un plan de copias de seguridad mediante sus etiquetas. Las condiciones distinguen entre mayúsculas y minúsculas.

## Contenido
<a name="API_Conditions_Contents"></a>

 ** StringEquals **   <a name="Backup-Type-Conditions-StringEquals"></a>
Filtra los valores de los recursos etiquetados solo para aquellos recursos que se etiquetaron con el mismo valor. También se denomina “coincidencia exacta”.  
Tipo: matriz de objetos [ConditionParameter](API_ConditionParameter.md)  
Obligatorio: no

 ** StringLike **   <a name="Backup-Type-Conditions-StringLike"></a>
Filtra los valores de los recursos etiquetados para que coincidan con los valores de etiqueta mediante el uso de un caracter comodín (\$1) en cualquier parte de la cadena. Por ejemplo, “prod\$1” o “\$1rod\$1” coinciden con el valor de etiqueta “production”.  
Tipo: matriz de objetos [ConditionParameter](API_ConditionParameter.md)  
Obligatorio: no

 ** StringNotEquals **   <a name="Backup-Type-Conditions-StringNotEquals"></a>
Filtra los valores de los recursos etiquetados solo para aquellos recursos que se etiquetaron y que no tienen el mismo valor. También se denomina “coincidencia negada”.  
Tipo: matriz de objetos [ConditionParameter](API_ConditionParameter.md)  
Obligatorio: no

 ** StringNotLike **   <a name="Backup-Type-Conditions-StringNotLike"></a>
Filtra los valores de los recursos etiquetados para detectar valores de etiqueta no coincidentes mediante el uso de un carácter comodín (\$1) en cualquier parte de la cadena.  
Tipo: matriz de objetos [ConditionParameter](API_ConditionParameter.md)  
Obligatorio: no

## Véase también
<a name="API_Conditions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Conditions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Conditions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Conditions) 

# ControlInputParameter
<a name="API_ControlInputParameter"></a>

Los parámetros para un control. Un control puede tener cero, uno o más parámetros. Un ejemplo de un control con dos parámetros es: “La frecuencia del plan de copia de seguridad es de al menos `daily` y el período de retención es de al menos `1 year`“. El primer parámetro es `daily`. El segundo parámetro es `1 year`.

## Contenido
<a name="API_ControlInputParameter_Contents"></a>

 ** ParameterName **   <a name="Backup-Type-ControlInputParameter-ParameterName"></a>
El nombre de un parámetro, por ejemplo, `BackupPlanFrequency`.  
Tipo: cadena  
Requerido: no

 ** ParameterValue **   <a name="Backup-Type-ControlInputParameter-ParameterValue"></a>
El valor del parámetro, por ejemplo, `hourly`.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ControlInputParameter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ControlInputParameter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ControlInputParameter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ControlInputParameter) 

# ControlScope
<a name="API_ControlScope"></a>

Un marco consta de uno o varios controles. Cada control tiene su propio alcance de control. El alcance de control puede incluir uno o varios tipos de recursos, una combinación de un valor y una clave de etiqueta, o una combinación de un tipo de recurso y un ID de recurso. Si no se especifica ningún alcance, las evaluaciones de la regla se activan cuando cambia la configuración de cualquier recurso del grupo de registro.

**nota**  
Para establecer un alcance de control que incluya todo un recurso en particular, deje `ControlScope` vacío o no lo pase cuando llame a `CreateFramework`.

## Contenido
<a name="API_ControlScope_Contents"></a>

 ** ComplianceResourceIds **   <a name="Backup-Type-ControlScope-ComplianceResourceIds"></a>
El ID del único recurso de AWS que desea que contenga el alcance de control.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 100 artículos.  
Obligatorio: no

 ** ComplianceResourceTypes **   <a name="Backup-Type-ControlScope-ComplianceResourceTypes"></a>
Describe si el alcance de control incluye uno o más tipos de recursos, como `EFS` o `RDS`.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** Tags **   <a name="Backup-Type-ControlScope-Tags"></a>
El par de clave-valor de etiqueta que se aplica a los recursos de AWS en los que desea activar una evaluación de una regla. Se puede proporcionar un máximo de un par de clave-valor. El valor de la etiqueta es opcional, pero no puede ser una cadena vacía si está creando o editando un marco desde la consola (aunque el valor puede ser una cadena vacía cuando se incluye en una plantilla de CloudFormation).  
La estructura para asignar una etiqueta es .: `[{"Key":"string","Value":"string"}]`.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Véase también
<a name="API_ControlScope_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ControlScope) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ControlScope) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ControlScope) 

# CopyAction
<a name="API_CopyAction"></a>

Los detalles de la operación de copia.

## Contenido
<a name="API_CopyAction_Contents"></a>

 ** DestinationBackupVaultArn **   <a name="Backup-Type-CopyAction-DestinationBackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva el almacén de copia de seguridad de destino para la copia de seguridad copiada. Por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Obligatorio: sí

 ** Lifecycle **   <a name="Backup-Type-CopyAction-Lifecycle"></a>
Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine.  
Las copias de seguridad que se han migrado al almacenamiento en frío deben permanecer en él durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que se pueden transferir al almacenamiento en frío se enumeran en la tabla [Disponibilidad de características por recurso.](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) AWS Backup omite esta expresión para otros tipos de recurso.  
Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

## Véase también
<a name="API_CopyAction_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CopyAction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CopyAction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CopyAction) 

# CopyJob
<a name="API_CopyJob"></a>

Contiene información detallada acerca de un trabajo de copia.

## Contenido
<a name="API_CopyJob_Contents"></a>

 ** AccountId **   <a name="Backup-Type-CopyJob-AccountId"></a>
El ID de la cuenta a la que pertenece el trabajo de copia.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** BackupSizeInBytes **   <a name="Backup-Type-CopyJob-BackupSizeInBytes"></a>
El tamaño de un trabajo de copia, en bytes.  
Tipo: largo  
Obligatorio: no

 ** ChildJobsInState **   <a name="Backup-Type-CopyJob-ChildJobsInState"></a>
Devuelve las estadísticas de los trabajos de copia secundarios (anidados) incluidos.  
Tipo: mapa de cadena a largo  
Claves válidas: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL`   
Obligatorio: no

 ** CompletionDate **   <a name="Backup-Type-CopyJob-CompletionDate"></a>
La fecha y la hora en que se completó el trabajo de copia, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CompositeMemberIdentifier **   <a name="Backup-Type-CopyJob-CompositeMemberIdentifier"></a>
El identificador de un recurso dentro de un grupo compuesto, como un punto de recuperación anidado (secundario) que pertenece a una pila compuesta (principal). El ID se transfiere desde el [ID lógico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) de una pila.  
Tipo: cadena  
Requerido: no

 ** CopyJobId **   <a name="Backup-Type-CopyJob-CopyJobId"></a>
Identifica de forma exclusiva un trabajo de copia.  
Tipo: cadena  
Requerido: no

 ** CreatedBy **   <a name="Backup-Type-CopyJob-CreatedBy"></a>
Contiene información sobre el plan de respaldo y la regla que AWS Backup se usaron para iniciar la copia de seguridad del punto de recuperación.  
Tipo: objeto [RecoveryPointCreator](API_RecoveryPointCreator.md)  
Obligatorio: no

 ** CreatedByBackupJobId **   <a name="Backup-Type-CopyJob-CreatedByBackupJobId"></a>
El identificador del trabajo de copia de seguridad que inició este trabajo de copia. Solo se aplica a los trabajos de copia programados y a los trabajos de copia automática a un almacén con huecos lógicos.  
Tipo: cadena  
Requerido: no

 ** CreationDate **   <a name="Backup-Type-CopyJob-CreationDate"></a>
La fecha y la hora en que se creó el trabajo de copia, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** DestinationBackupVaultArn **   <a name="Backup-Type-CopyJob-DestinationBackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad de destino al que copiar; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Requerido: no

 ** DestinationEncryptionKeyArn **   <a name="Backup-Type-CopyJob-DestinationEncryptionKeyArn"></a>
Es el nombre de recurso de Amazon (ARN) de la clave de KMS que se utiliza para cifrar la copia de seguridad copiada en el almacén de destino. Puede ser una clave gestionada por el cliente o una clave gestionada. AWS   
Tipo: cadena  
Requerido: no

 ** DestinationRecoveryPointArn **   <a name="Backup-Type-CopyJob-DestinationRecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación de destino; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** DestinationRecoveryPointLifecycle **   <a name="Backup-Type-CopyJob-DestinationRecoveryPointLifecycle"></a>
Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine.  
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.  
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** DestinationVaultLockState **   <a name="Backup-Type-CopyJob-DestinationVaultLockState"></a>
Es el estado de bloqueo del almacén de copias de seguridad de destino. En el caso de los almacenes aislados lógicamente, indica si el almacén está bloqueado en el modo de conformidad. Los valores válidos son `LOCKED` y `UNLOCKED`.  
Tipo: cadena  
Requerido: no

 ** DestinationVaultType **   <a name="Backup-Type-CopyJob-DestinationVaultType"></a>
Es el tipo de almacén de copias de seguridad de destino en el que se almacena el punto de recuperación copiado. Los valores válidos son `BACKUP_VAULT` para los almacenes de copias de seguridad estándar y `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` para los almacenes aislados lógicamente.  
Tipo: cadena  
Requerido: no

 ** IamRoleArn **   <a name="Backup-Type-CopyJob-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para copiar el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Requerido: no

 ** IsParent **   <a name="Backup-Type-CopyJob-IsParent"></a>
Se trata de un valor booleano que indica que es un trabajo de copia principal (compuesto).  
Tipo: Booleano  
Obligatorio: no

 ** MessageCategory **   <a name="Backup-Type-CopyJob-MessageCategory"></a>
Este parámetro es el recuento de trabajos de la categoría de mensajes especificada.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` y `InvalidParameters`. Consulte [Supervisión](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) para obtener una lista de MessageCategory cadenas.  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma  
Tipo: cadena  
Requerido: no

 ** NumberOfChildJobs **   <a name="Backup-Type-CopyJob-NumberOfChildJobs"></a>
El número de trabajos de copia secundarios (anidados).  
Tipo: largo  
Obligatorio: no

 ** ParentJobId **   <a name="Backup-Type-CopyJob-ParentJobId"></a>
Identifica de forma exclusiva una solicitud de AWS Backup para hacer una copia de un recurso. Se devolverá el ID del trabajo principal (compuesto).  
Tipo: cadena  
Requerido: no

 ** ResourceArn **   <a name="Backup-Type-CopyJob-ResourceArn"></a>
El AWS recurso que se va a copiar; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Tipo: cadena  
Requerido: no

 ** ResourceName **   <a name="Backup-Type-CopyJob-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-CopyJob-ResourceType"></a>
El tipo de AWS recurso que se va a copiar; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS).  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** SourceBackupVaultArn **   <a name="Backup-Type-CopyJob-SourceBackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de origen; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.   
Tipo: cadena  
Requerido: no

 ** SourceRecoveryPointArn **   <a name="Backup-Type-CopyJob-SourceRecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación de origen; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** State **   <a name="Backup-Type-CopyJob-State"></a>
El estado actual de un trabajo de copia.  
Tipo: cadena  
Valores válidos: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-CopyJob-StatusMessage"></a>
Un mensaje detallado que explica el estado del trabajo de copia de un recurso.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_CopyJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CopyJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CopyJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CopyJob) 

# CopyJobSummary
<a name="API_CopyJobSummary"></a>

Es un resumen de los trabajos de copia creados o en ejecución en los 30 últimos días.

El resumen devuelto puede contener lo siguiente: Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime y Count de trabajos incluidos.

## Contenido
<a name="API_CopyJobSummary_Contents"></a>

 ** AccountId **   <a name="Backup-Type-CopyJobSummary-AccountId"></a>
El ID de la cuenta propietaria de los trabajos del resumen.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** Count **   <a name="Backup-Type-CopyJobSummary-Count"></a>
El valor expresado como número de trabajos en un resumen de trabajos.  
Tipo: entero  
Obligatorio: no

 ** EndTime **   <a name="Backup-Type-CopyJobSummary-EndTime"></a>
El valor de hora en formato numérico de la hora de finalización de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** MessageCategory **   <a name="Backup-Type-CopyJobSummary-MessageCategory"></a>
Este parámetro es el recuento de trabajos de la categoría de mensajes especificada.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `Success` y `InvalidParameters`. Consulte en [Monitorización](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) una lista de cadenas de MessageCategory.  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.  
Tipo: cadena  
Requerido: no

 ** Region **   <a name="Backup-Type-CopyJobSummary-Region"></a>
Las regiones de AWS incluidas en el resumen del trabajo.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-CopyJobSummary-ResourceType"></a>
Este valor es el recuento de trabajos para el tipo de recurso especificado. La solicitud `GetSupportedResourceTypes` devuelve cadenas para los tipos de recursos compatibles  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** StartTime **   <a name="Backup-Type-CopyJobSummary-StartTime"></a>
El valor de hora en formato numérico de la hora de inicio de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** State **   <a name="Backup-Type-CopyJobSummary-State"></a>
Este valor es el recuento de trabajos con el estado especificado.  
Tipo: cadena  
Valores válidos: `CREATED | RUNNING | ABORTING | ABORTED | COMPLETING | COMPLETED | FAILING | FAILED | PARTIAL | AGGREGATE_ALL | ANY`   
Obligatorio: no

## Véase también
<a name="API_CopyJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CopyJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CopyJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CopyJobSummary) 

# DateRange
<a name="API_DateRange"></a>

Este es un filtro de recursos que contiene FromDate: DateTime y ToDate: DateTime. Ambos valores son obligatorios. No se permiten valores de DateTime futuros.

La fecha y la hora están en formato Unix y horario universal coordinado (UTC) y tienen una precisión de milisegundos (los milisegundos son opcionales). Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.

## Contenido
<a name="API_DateRange_Contents"></a>

 ** FromDate **   <a name="Backup-Type-DateRange-FromDate"></a>
Este valor es la fecha de inicio, inclusive.  
La fecha y la hora están en formato Unix y horario universal coordinado (UTC) y tienen una precisión de milisegundos (los milisegundos son opcionales).  
Tipo: marca temporal  
Obligatorio: sí

 ** ToDate **   <a name="Backup-Type-DateRange-ToDate"></a>
Este valor es la fecha de finalización, inclusive.  
La fecha y la hora están en formato Unix y horario universal coordinado (UTC) y tienen una precisión de milisegundos (los milisegundos son opcionales).  
Tipo: marca temporal  
Obligatorio: sí

## Véase también
<a name="API_DateRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DateRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DateRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DateRange) 

# Framework
<a name="API_Framework"></a>

Contiene información detallada acerca de un marco. Los marcos contienen controles que evalúan e informan sobre sus eventos y recursos de copia de seguridad. Los marcos generan resultados de conformidad diarios.

## Contenido
<a name="API_Framework_Contents"></a>

 ** CreationTime **   <a name="Backup-Type-Framework-CreationTime"></a>
La fecha y la hora en que se creó un marco con la norma ISO 8601. El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, 2020-07-10T15:00:00.000-08:00 representa el 10 de julio de 2020 a las 15:00 h, 8 horas menos que UTC.  
Tipo: marca temporal  
Obligatorio: no

 ** DeploymentStatus **   <a name="Backup-Type-Framework-DeploymentStatus"></a>
El estado de implementación de un marco. Los estados son:  
 `CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED`   
Tipo: cadena  
Requerido: no

 ** FrameworkArn **   <a name="Backup-Type-Framework-FrameworkArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** FrameworkDescription **   <a name="Backup-Type-Framework-FrameworkDescription"></a>
Una descripción opcional del marco con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** FrameworkName **   <a name="Backup-Type-Framework-FrameworkName"></a>
El nombre único de un marco. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: no

 ** NumberOfControls **   <a name="Backup-Type-Framework-NumberOfControls"></a>
El número de controles que contiene el marco.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_Framework_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Framework) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Framework) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Framework) 

# FrameworkControl
<a name="API_FrameworkControl"></a>

Contiene información detallada acerca de todos los controles de un marco. Cada marco debe contener al menos un control.

## Contenido
<a name="API_FrameworkControl_Contents"></a>

 ** ControlName **   <a name="Backup-Type-FrameworkControl-ControlName"></a>
El nombre de un control. Este nombre tiene entre 1 y 256 caracteres.  
Tipo: cadena  
Obligatorio: sí

 ** ControlInputParameters **   <a name="Backup-Type-FrameworkControl-ControlInputParameters"></a>
Los pares nombre-valor.  
Tipo: matriz de objetos [ControlInputParameter](API_ControlInputParameter.md)  
Obligatorio: no

 ** ControlScope **   <a name="Backup-Type-FrameworkControl-ControlScope"></a>
El alcance de un control. El alcance del control define lo que evaluará el control. Tres ejemplos de alcance de control son: un plan de copia de seguridad específico, todos los planes de copia de seguridad con una etiqueta específica o todos los planes de copia de seguridad.  
Para obtener más información, consulte [`ControlScope`.](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ControlScope.html)   
Tipo: objeto [ControlScope](API_ControlScope.md)  
Obligatorio: no

## Véase también
<a name="API_FrameworkControl_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/FrameworkControl) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/FrameworkControl) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/FrameworkControl) 

# IndexAction
<a name="API_IndexAction"></a>

Esta es una matriz opcional dentro de una BackupRule.

IndexAction consta de un ResourceTypes.

## Contenido
<a name="API_IndexAction_Contents"></a>

 ** ResourceTypes **   <a name="Backup-Type-IndexAction-ResourceTypes"></a>
Se aceptará una o ninguna acción de indexación por cada BackupRule.  
Valores válidos:  
+  `EBS` para Amazon Elastic Block Store (EBS)
+  `S3` para Amazon Simple Storage Service (Amazon S3)
Tipo: matriz de cadenas  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Véase también
<a name="API_IndexAction_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/IndexAction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/IndexAction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/IndexAction) 

# IndexedRecoveryPoint
<a name="API_IndexedRecoveryPoint"></a>

Se trata de un punto de recuperación que tiene un índice de copias de seguridad asociado.

En una búsqueda solo se pueden incluir puntos de recuperación con un índice de copias de seguridad.

## Contenido
<a name="API_IndexedRecoveryPoint_Contents"></a>

 ** BackupCreationDate **   <a name="Backup-Type-IndexedRecoveryPoint-BackupCreationDate"></a>
Es la fecha y la hora de creación de una copia de seguridad, expresadas en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** BackupVaultArn **   <a name="Backup-Type-IndexedRecoveryPoint-BackupVaultArn"></a>
Es un ARN que identifica de forma unívoca el almacén de copias de seguridad en el que se almacena el índice de puntos de recuperación.  
Por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Requerido: no

 ** IamRoleArn **   <a name="Backup-Type-IndexedRecoveryPoint-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para esta operación.  
Por ejemplo, arn:aws:iam::123456789012:role/S3Access  
Tipo: cadena  
Requerido: no

 ** IndexCreationDate **   <a name="Backup-Type-IndexedRecoveryPoint-IndexCreationDate"></a>
Es la fecha y la hora de creación de un índice de copias de seguridad, expresadas en formato Unix y en horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** IndexStatus **   <a name="Backup-Type-IndexedRecoveryPoint-IndexStatus"></a>
Este es el estado actual del índice de copias de seguridad asociado al punto de recuperación especificado.  
Los estados son: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Tipo: cadena  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING`   
Obligatorio: no

 ** IndexStatusMessage **   <a name="Backup-Type-IndexedRecoveryPoint-IndexStatusMessage"></a>
Es una cadena en forma de mensaje detallado que explica el estado del índice de copias de seguridad asociado al punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** RecoveryPointArn **   <a name="Backup-Type-IndexedRecoveryPoint-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.   
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-IndexedRecoveryPoint-ResourceType"></a>
Es el tipo de recurso del punto de recuperación indexado.  
+  `EBS` para Amazon Elastic Block Store (EBS)
+  `S3` para Amazon Simple Storage Service (Amazon S3)
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** SourceResourceArn **   <a name="Backup-Type-IndexedRecoveryPoint-SourceResourceArn"></a>
Es una cadena de un Nombre de recurso de Amazon (ARN) que identifica de forma unívoca un recurso de origen.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_IndexedRecoveryPoint_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/IndexedRecoveryPoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/IndexedRecoveryPoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/IndexedRecoveryPoint) 

# KeyValue
<a name="API_KeyValue"></a>

Par de dos cadenas relacionadas. Los caracteres permitidos son letras, espacios en blanco y números que se pueden representar en UTF-8, y los siguientes caracteres: ` + - = . _ : /`. 

## Contenido
<a name="API_KeyValue_Contents"></a>

 ** Key **   <a name="Backup-Type-KeyValue-Key"></a>
La clave de la etiqueta (cadena). La clave no pueden comenzar por `aws:`.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`   
Tipo: cadena  
Obligatorio: sí

 ** Value **   <a name="Backup-Type-KeyValue-Value"></a>
El valor de la clave.  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Tipo: cadena  
Obligatorio: sí

## Véase también
<a name="API_KeyValue_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/KeyValue) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/KeyValue) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/KeyValue) 

# LatestMpaApprovalTeamUpdate
<a name="API_LatestMpaApprovalTeamUpdate"></a>

Contiene información sobre la última actualización de la asociación del equipo de aprobación MPA.

## Contenido
<a name="API_LatestMpaApprovalTeamUpdate_Contents"></a>

 ** ExpiryDate **   <a name="Backup-Type-LatestMpaApprovalTeamUpdate-ExpiryDate"></a>
Fecha y hora en que caducará la actualización del equipo de aprobación MPA.  
Tipo: marca temporal  
Obligatorio: no

 ** InitiationDate **   <a name="Backup-Type-LatestMpaApprovalTeamUpdate-InitiationDate"></a>
Fecha y hora en que se inició la actualización del equipo de aprobación MPA.  
Tipo: marca temporal  
Obligatorio: no

 ** MpaSessionArn **   <a name="Backup-Type-LatestMpaApprovalTeamUpdate-MpaSessionArn"></a>
Es el ARN de la sesión de MPA asociada con esta actualización.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-LatestMpaApprovalTeamUpdate-Status"></a>
Es el estado actual de la actualización del equipo de aprobación MPA.  
Tipo: cadena  
Valores válidos: `PENDING | APPROVED | FAILED`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-LatestMpaApprovalTeamUpdate-StatusMessage"></a>
Es un mensaje que describe el estado actual de la actualización del equipo de aprobación MPA.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_LatestMpaApprovalTeamUpdate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/LatestMpaApprovalTeamUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/LatestMpaApprovalTeamUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/LatestMpaApprovalTeamUpdate) 

# LatestRevokeRequest
<a name="API_LatestRevokeRequest"></a>

Contiene información sobre la última solicitud para revocar el acceso a un almacén de copias de seguridad.

## Contenido
<a name="API_LatestRevokeRequest_Contents"></a>

 ** ExpiryDate **   <a name="Backup-Type-LatestRevokeRequest-ExpiryDate"></a>
Fecha y hora en que se caduca la solicitud de revocación.  
Tipo: marca temporal  
Obligatorio: no

 ** InitiationDate **   <a name="Backup-Type-LatestRevokeRequest-InitiationDate"></a>
Fecha y hora en que se inició la solicitud de revocación.  
Tipo: marca temporal  
Obligatorio: no

 ** MpaSessionArn **   <a name="Backup-Type-LatestRevokeRequest-MpaSessionArn"></a>
Es el ARN de la sesión de MPA asociada con esta solicitud de revocación.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-LatestRevokeRequest-Status"></a>
Es el estado actual de la solicitud de revocación.  
Tipo: cadena  
Valores válidos: `PENDING | FAILED`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-LatestRevokeRequest-StatusMessage"></a>
Es un mensaje que describe el estado actual de la solicitud de revocación.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_LatestRevokeRequest_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/LatestRevokeRequest) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/LatestRevokeRequest) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/LatestRevokeRequest) 

# LegalHold
<a name="API_LegalHold"></a>

Una retención legal es una herramienta administrativa que ayuda a evitar que las copias de seguridad se eliminen mientras están retenidas. Mientras la retención esté en vigor, las copias de seguridad retenidas no se pueden eliminar y las políticas de ciclo de vida que podrían alterar el estado de las copias de seguridad (como la transferencia al almacenamiento en frío) se retrasan hasta que se elimine la retención legal. Una copia de seguridad puede tener más de una retención legal. Las retenciones legales se aplican a una o más copias de seguridad (también se conocen como puntos de recuperación). Estas copias de seguridad se pueden filtrar por tipos de recursos y por ID de recursos.

## Contenido
<a name="API_LegalHold_Contents"></a>

 ** CancellationDate **   <a name="Backup-Type-LegalHold-CancellationDate"></a>
Hora a la que se canceló la retención legal.  
Tipo: marca temporal  
Obligatorio: no

 ** CreationDate **   <a name="Backup-Type-LegalHold-CreationDate"></a>
La hora en la que se creó la retención legal.  
Tipo: marca temporal  
Obligatorio: no

 ** Description **   <a name="Backup-Type-LegalHold-Description"></a>
La descripción de una cadena de la retención legal.  
Tipo: cadena  
Requerido: no

 ** LegalHoldArn **   <a name="Backup-Type-LegalHold-LegalHoldArn"></a>
El nombre de recurso de Amazon (ARN) de la retención legal; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** LegalHoldId **   <a name="Backup-Type-LegalHold-LegalHoldId"></a>
El identificador de la retención legal.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-LegalHold-Status"></a>
El estado de la retención legal.  
Tipo: cadena  
Valores válidos: `CREATING | ACTIVE | CANCELING | CANCELED`   
Obligatorio: no

 ** Title **   <a name="Backup-Type-LegalHold-Title"></a>
El título de una retención legal.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_LegalHold_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/LegalHold) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/LegalHold) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/LegalHold) 

# Lifecycle
<a name="API_Lifecycle"></a>

Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine.

Las copias de seguridad que se transfieran a cámaras frigoríficas deben almacenarse en cámaras frigoríficas durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.

Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.

Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`.

## Contenido
<a name="API_Lifecycle_Contents"></a>

 ** DeleteAfterDays **   <a name="Backup-Type-Lifecycle-DeleteAfterDays"></a>
El número de días después de la creación cuando se elimina un punto de recuperación. Este valor debe ser al menos 90 días posterior al número de días especificado en `MoveToColdStorageAfterDays`.  
Tipo: largo  
Obligatorio: no

 ** DeleteAfterEvent **   <a name="Backup-Type-Lifecycle-DeleteAfterEvent"></a>
El evento tras el cual se elimina un punto de recuperación. Un punto de recuperación con ambos `DeleteAfterDays` y `DeleteAfterEvent` se eliminará una vez que se cumpla primero la condición. No es válido como entrada.  
Tipo: cadena  
Valores válidos: `DELETE_AFTER_COPY`   
Obligatorio: no

 ** MoveToColdStorageAfterDays **   <a name="Backup-Type-Lifecycle-MoveToColdStorageAfterDays"></a>
El número de días después de la creación cuando un punto de recuperación pasa a almacenamiento en frío.  
Tipo: largo  
Obligatorio: no

 ** OptInToArchiveForSupportedResources **   <a name="Backup-Type-Lifecycle-OptInToArchiveForSupportedResources"></a>
Si el valor es true, su plan de copia de seguridad lleva a cabo la transición de los recursos compatibles al nivel de almacenamiento de archivo (en frío) de acuerdo con la configuración del ciclo de vida.  
Tipo: Booleano  
Obligatorio: no

## Véase también
<a name="API_Lifecycle_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Lifecycle) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Lifecycle) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Lifecycle) 

# ProtectedResource
<a name="API_ProtectedResource"></a>

Estructura que contiene información sobre un recurso del que se ha hecho una copia de seguridad.

## Contenido
<a name="API_ProtectedResource_Contents"></a>

 ** LastBackupTime **   <a name="Backup-Type-ProtectedResource-LastBackupTime"></a>
La fecha y la hora en que se realizó la última una copia de seguridad de un recurso, en formato Unix y horario universal coordinado (UTC). El valor de `LastBackupTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** LastBackupVaultArn **   <a name="Backup-Type-ProtectedResource-LastBackupVaultArn"></a>
El ARN (nombre de recurso de Amazon) del almacén de copias de seguridad que contiene el punto de recuperación de copia de seguridad más reciente.  
Tipo: cadena  
Requerido: no

 ** LastRecoveryPointArn **   <a name="Backup-Type-ProtectedResource-LastRecoveryPointArn"></a>
El ARN (nombre de recurso de Amazon) del punto de recuperación más reciente.  
Tipo: cadena  
Requerido: no

 ** ResourceArn **   <a name="Backup-Type-ProtectedResource-ResourceArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** ResourceName **   <a name="Backup-Type-ProtectedResource-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-ProtectedResource-ResourceType"></a>
El tipo de recurso de AWS; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS). Para las copias de seguridad de Windows Volume Shadow Copy Service (VSS), el único tipo de recurso admitido es Amazon EC2.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Véase también
<a name="API_ProtectedResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ProtectedResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ProtectedResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ProtectedResource) 

# ProtectedResourceConditions
<a name="API_ProtectedResourceConditions"></a>

La lista de condiciones que se define para los recursos del plan de prueba de restauración mediante etiquetas.

## Contenido
<a name="API_ProtectedResourceConditions_Contents"></a>

 ** StringEquals **   <a name="Backup-Type-ProtectedResourceConditions-StringEquals"></a>
Filtra los valores de los recursos etiquetados solo para aquellos recursos que se etiquetaron con el mismo valor. También se denomina “coincidencia exacta”.  
Tipo: matriz de objetos [KeyValue](API_KeyValue.md)  
Obligatorio: no

 ** StringNotEquals **   <a name="Backup-Type-ProtectedResourceConditions-StringNotEquals"></a>
Filtra los valores de los recursos etiquetados solo para aquellos recursos que se etiquetaron y que no tienen el mismo valor. También se denomina “coincidencia negada”.  
Tipo: matriz de objetos [KeyValue](API_KeyValue.md)  
Obligatorio: no

## Véase también
<a name="API_ProtectedResourceConditions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ProtectedResourceConditions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ProtectedResourceConditions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ProtectedResourceConditions) 

# RecoveryPointByBackupVault
<a name="API_RecoveryPointByBackupVault"></a>

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

## Contenido
<a name="API_RecoveryPointByBackupVault_Contents"></a>

 ** AggregatedScanResult **   <a name="Backup-Type-RecoveryPointByBackupVault-AggregatedScanResult"></a>
Contiene los resultados de escaneo más recientes contra el punto de recuperación y actualmente incluye`FailedScan`,`Findings`,`LastComputed`.  
Tipo: objeto [AggregatedScanResult](API_AggregatedScanResult.md)  
Obligatorio: no

 ** BackupSizeInBytes **   <a name="Backup-Type-RecoveryPointByBackupVault-BackupSizeInBytes"></a>
El tamaño de una copia de seguridad, en bytes.  
Tipo: largo  
Obligatorio: no

 ** BackupVaultArn **   <a name="Backup-Type-RecoveryPointByBackupVault-BackupVaultArn"></a>
Un ARN que identifica de forma exclusiva un almacén de copias de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Requerido: no

 ** BackupVaultName **   <a name="Backup-Type-RecoveryPointByBackupVault-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: no

 ** CalculatedLifecycle **   <a name="Backup-Type-RecoveryPointByBackupVault-CalculatedLifecycle"></a>
Un objeto `CalculatedLifecycle` que contiene las marcas temporales `MoveToColdStorageAt` y `DeleteAt`.  
Tipo: objeto [CalculatedLifecycle](API_CalculatedLifecycle.md)  
Obligatorio: no

 ** CompletionDate **   <a name="Backup-Type-RecoveryPointByBackupVault-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para restaurar un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CompositeMemberIdentifier **   <a name="Backup-Type-RecoveryPointByBackupVault-CompositeMemberIdentifier"></a>
El identificador de un recurso dentro de un grupo compuesto, como un punto de recuperación anidado (secundario) que pertenece a una pila compuesta (principal). El ID se transfiere desde el [ID lógico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) de una pila.  
Tipo: cadena  
Requerido: no

 ** CreatedBy **   <a name="Backup-Type-RecoveryPointByBackupVault-CreatedBy"></a>
Contiene información de identificación sobre la creación de un punto de recuperación, que incluye los valores de `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` y `BackupRuleId` del plan de copia de seguridad que se utilizó para crearlo.  
Tipo: objeto [RecoveryPointCreator](API_RecoveryPointCreator.md)  
Obligatorio: no

 ** CreationDate **   <a name="Backup-Type-RecoveryPointByBackupVault-CreationDate"></a>
La fecha y la hora en que se creó un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** EncryptionKeyArn **   <a name="Backup-Type-RecoveryPointByBackupVault-EncryptionKeyArn"></a>
La clave de cifrado en el servidor que se utiliza para proteger sus copias de seguridad; por ejemplo, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Tipo: cadena  
Requerido: no

 ** EncryptionKeyType **   <a name="Backup-Type-RecoveryPointByBackupVault-EncryptionKeyType"></a>
El tipo de clave de cifrado utilizada para el punto de recuperación. Los valores válidos son CUSTOMER\$1MANAGED\$1KMS\$1KEY para las claves administradas por el cliente o \$1OWNED\$1KMS\$1KEY para las claves propiedad del cliente. AWS AWS  
Tipo: cadena  
Valores válidos: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`   
Obligatorio: no

 ** IamRoleArn **   <a name="Backup-Type-RecoveryPointByBackupVault-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Requerido: no

 ** IndexStatus **   <a name="Backup-Type-RecoveryPointByBackupVault-IndexStatus"></a>
Este es el estado actual del índice de copias de seguridad asociado al punto de recuperación especificado.  
Los estados son: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Tipo: cadena  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING`   
Obligatorio: no

 ** IndexStatusMessage **   <a name="Backup-Type-RecoveryPointByBackupVault-IndexStatusMessage"></a>
Es una cadena en forma de mensaje detallado que explica el estado del índice de copias de seguridad asociado al punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** InitiationDate **   <a name="Backup-Type-RecoveryPointByBackupVault-InitiationDate"></a>
Fecha y hora en que se inició el trabajo de copia de seguridad que ha creado este punto de recuperación, expresadas en formato Unix y horario universal coordinado (UTC).  
Tipo: marca temporal  
Obligatorio: no

 ** IsEncrypted **   <a name="Backup-Type-RecoveryPointByBackupVault-IsEncrypted"></a>
Un valor booleano que se devuelve como `TRUE` si el punto de recuperación especificado está cifrado o como `FALSE` si el punto de recuperación no está cifrado.  
Tipo: Booleano  
Obligatorio: no

 ** IsParent **   <a name="Backup-Type-RecoveryPointByBackupVault-IsParent"></a>
Se trata de un valor booleano que indica que es un punto de recuperación principal (compuesto).  
Tipo: Booleano  
Obligatorio: no

 ** LastRestoreTime **   <a name="Backup-Type-RecoveryPointByBackupVault-LastRestoreTime"></a>
La fecha y hora en que se restauró por última vez un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `LastRestoreTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** Lifecycle **   <a name="Backup-Type-RecoveryPointByBackupVault-Lifecycle"></a>
El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup cambia y vence las copias de seguridad automáticamente de acuerdo con el ciclo de vida que usted defina.   
Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de “número de días tras los cuales migrará a almacenamiento en frío” no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío.   
Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos.  
Tipo: objeto [Lifecycle](API_Lifecycle.md)  
Obligatorio: no

 ** ParentRecoveryPointArn **   <a name="Backup-Type-RecoveryPointByBackupVault-ParentRecoveryPointArn"></a>
El nombre de recurso de Amazon (ARN) del punto de recuperación principal (compuesto).  
Tipo: cadena  
Requerido: no

 ** RecoveryPointArn **   <a name="Backup-Type-RecoveryPointByBackupVault-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** ResourceArn **   <a name="Backup-Type-RecoveryPointByBackupVault-ResourceArn"></a>
Un ARN que identifica de forma única a un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** ResourceName **   <a name="Backup-Type-RecoveryPointByBackupVault-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-RecoveryPointByBackupVault-ResourceType"></a>
El tipo de AWS recurso guardado como punto de recuperación; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS). Para las copias de seguridad de Windows Volume Shadow Copy Service (VSS), el único tipo de recurso compatible es Amazon EC2.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** SourceBackupVaultArn **   <a name="Backup-Type-RecoveryPointByBackupVault-SourceBackupVaultArn"></a>
El almacén de copias de seguridad desde el que se copió originalmente el punto de recuperación. Si el punto de recuperación se restaura en la misma cuenta, este valor será `null`.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-RecoveryPointByBackupVault-Status"></a>
Un código de estado que especifica el estado del punto de recuperación.  
Tipo: cadena  
Valores válidos: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-RecoveryPointByBackupVault-StatusMessage"></a>
Un mensaje que explica el estado actual del punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** VaultType **   <a name="Backup-Type-RecoveryPointByBackupVault-VaultType"></a>
El tipo de almacén en el que se guarda el punto de recuperación descrito.  
Tipo: cadena  
Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`   
Obligatorio: no

## Véase también
<a name="API_RecoveryPointByBackupVault_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointByBackupVault) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointByBackupVault) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointByBackupVault) 

# RecoveryPointByResource
<a name="API_RecoveryPointByResource"></a>

Contiene información detallada sobre un punto de recuperación guardado.

## Contenido
<a name="API_RecoveryPointByResource_Contents"></a>

 ** AggregatedScanResult **   <a name="Backup-Type-RecoveryPointByResource-AggregatedScanResult"></a>
Contiene los resultados de escaneo más recientes contra el punto de recuperación y actualmente incluye`FailedScan`,`Findings`,`LastComputed`.  
Tipo: objeto [AggregatedScanResult](API_AggregatedScanResult.md)  
Obligatorio: no

 ** BackupSizeBytes **   <a name="Backup-Type-RecoveryPointByResource-BackupSizeBytes"></a>
El tamaño de una copia de seguridad, en bytes.  
Tipo: largo  
Obligatorio: no

 ** BackupVaultName **   <a name="Backup-Type-RecoveryPointByResource-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: no

 ** CreationDate **   <a name="Backup-Type-RecoveryPointByResource-CreationDate"></a>
La fecha y la hora en que se creó un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** EncryptionKeyArn **   <a name="Backup-Type-RecoveryPointByResource-EncryptionKeyArn"></a>
La clave de cifrado en el servidor que se utiliza para proteger sus copias de seguridad; por ejemplo, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Tipo: cadena  
Requerido: no

 ** EncryptionKeyType **   <a name="Backup-Type-RecoveryPointByResource-EncryptionKeyType"></a>
El tipo de clave de cifrado utilizada para el punto de recuperación. Los valores válidos son CUSTOMER\$1MANAGED\$1KMS\$1KEY para las claves administradas por el cliente o \$1OWNED\$1KMS\$1KEY para las claves propiedad del cliente. AWS AWS  
Tipo: cadena  
Valores válidos: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`   
Obligatorio: no

 ** IndexStatus **   <a name="Backup-Type-RecoveryPointByResource-IndexStatus"></a>
Este es el estado actual del índice de copias de seguridad asociado al punto de recuperación especificado.  
Los estados son: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
En una búsqueda se puede incluir un punto de recuperación con un índice con el estado `ACTIVE`.  
Tipo: cadena  
Valores válidos: `PENDING | ACTIVE | FAILED | DELETING`   
Obligatorio: no

 ** IndexStatusMessage **   <a name="Backup-Type-RecoveryPointByResource-IndexStatusMessage"></a>
Es una cadena en forma de mensaje detallado que explica el estado del índice de copias de seguridad asociado al punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** IsParent **   <a name="Backup-Type-RecoveryPointByResource-IsParent"></a>
Se trata de un valor booleano que indica que es un punto de recuperación principal (compuesto).  
Tipo: Booleano  
Obligatorio: no

 ** ParentRecoveryPointArn **   <a name="Backup-Type-RecoveryPointByResource-ParentRecoveryPointArn"></a>
El nombre de recurso de Amazon (ARN) del punto de recuperación principal (compuesto).  
Tipo: cadena  
Requerido: no

 ** RecoveryPointArn **   <a name="Backup-Type-RecoveryPointByResource-RecoveryPointArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** ResourceName **   <a name="Backup-Type-RecoveryPointByResource-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-RecoveryPointByResource-Status"></a>
Un código de estado que especifica el estado del punto de recuperación.  
Tipo: cadena  
Valores válidos: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-RecoveryPointByResource-StatusMessage"></a>
Un mensaje que explica el estado actual del punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** VaultType **   <a name="Backup-Type-RecoveryPointByResource-VaultType"></a>
El tipo de almacén en el que se guarda el punto de recuperación descrito.  
Tipo: cadena  
Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`   
Obligatorio: no

## Véase también
<a name="API_RecoveryPointByResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos, consulta lo siguiente AWS SDKs:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointByResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointByResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointByResource) 

# RecoveryPointCreator
<a name="API_RecoveryPointCreator"></a>

Contiene información sobre el plan de copia de seguridad y la regla que AWS Backup utilizó para iniciar la copia de seguridad del punto de recuperación.

## Contenido
<a name="API_RecoveryPointCreator_Contents"></a>

 ** BackupPlanArn **   <a name="Backup-Type-RecoveryPointCreator-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena  
Requerido: no

 ** BackupPlanId **   <a name="Backup-Type-RecoveryPointCreator-BackupPlanId"></a>
Identifica de forma única un plan de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** BackupPlanName **   <a name="Backup-Type-RecoveryPointCreator-BackupPlanName"></a>
Nombre del plan de copia de seguridad que ha creado este punto de recuperación. Proporciona un contexto legible para las personas sobre qué plan de copia de seguridad ha sido responsable del trabajo de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** BackupPlanVersion **   <a name="Backup-Type-RecoveryPointCreator-BackupPlanVersion"></a>
Los ID de versión son cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. No es posible editarlos.  
Tipo: cadena  
Requerido: no

 ** BackupRuleCron **   <a name="Backup-Type-RecoveryPointCreator-BackupRuleCron"></a>
Es la expresión cron que define la programación de la regla de copia de seguridad. Muestra la frecuencia y el momento en que las copias de seguridad se activan de forma automática.  
Tipo: cadena  
Requerido: no

 ** BackupRuleId **   <a name="Backup-Type-RecoveryPointCreator-BackupRuleId"></a>
Identifica de forma exclusiva una regla utilizada para programar la copia de seguridad de una selección de recursos.  
Tipo: cadena  
Requerido: no

 ** BackupRuleName **   <a name="Backup-Type-RecoveryPointCreator-BackupRuleName"></a>
Nombre de la regla de copia de seguridad en el plan de copia de seguridad que ha creado este punto de recuperación. Esto ayuda a identificar qué regla específica ha activado el trabajo de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** BackupRuleTimezone **   <a name="Backup-Type-RecoveryPointCreator-BackupRuleTimezone"></a>
Es la zona horaria utilizada para la programación de las reglas de copia de seguridad. Esto proporciona un contexto para determinar cuándo se programa la ejecución de las copias de seguridad en la zona horaria especificada.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_RecoveryPointCreator_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointCreator) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointCreator) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointCreator) 

# RecoveryPointMember
<a name="API_RecoveryPointMember"></a>

Se trata de un punto de recuperación que es un punto de recuperación secundario (anidado) de un punto de recuperación principal (compuesto). Estos puntos de recuperación se pueden disociar de su punto de recuperación principal (compuesto), en cuyo caso dejarán de ser miembros.

## Contenido
<a name="API_RecoveryPointMember_Contents"></a>

 ** BackupVaultName **   <a name="Backup-Type-RecoveryPointMember-BackupVaultName"></a>
El nombre del almacén de copias de seguridad (el contenedor lógico en el que se almacenan las copias de seguridad).  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatorio: no

 ** RecoveryPointArn **   <a name="Backup-Type-RecoveryPointMember-RecoveryPointArn"></a>
El nombre de recurso de Amazon (ARN) del punto de recuperación principal (compuesto).  
Tipo: cadena  
Requerido: no

 ** ResourceArn **   <a name="Backup-Type-RecoveryPointMember-ResourceArn"></a>
El nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso guardado.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-RecoveryPointMember-ResourceType"></a>
El tipo de recurso de AWS que se guarda como punto de recuperación.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

## Véase también
<a name="API_RecoveryPointMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointMember) 

# RecoveryPointSelection
<a name="API_RecoveryPointSelection"></a>

Esto especifica criterios para asignar un conjunto de recursos, como los tipos de recursos o los almacenes de copias de seguridad.

## Contenido
<a name="API_RecoveryPointSelection_Contents"></a>

 ** DateRange **   <a name="Backup-Type-RecoveryPointSelection-DateRange"></a>
Este es un filtro de recursos que contiene FromDate: DateTime y ToDate: DateTime. Ambos valores son obligatorios. No se permiten valores de DateTime futuros.  
La fecha y la hora están en formato Unix y horario universal coordinado (UTC) y tienen una precisión de milisegundos (los milisegundos son opcionales). Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: objeto [DateRange](API_DateRange.md)  
Obligatorio: no

 ** ResourceIdentifiers **   <a name="Backup-Type-RecoveryPointSelection-ResourceIdentifiers"></a>
Estos son los recursos incluidos en la selección de recursos (incluidos los tipos de recursos y los almacenes).  
Tipo: matriz de cadenas  
Obligatorio: no

 ** VaultNames **   <a name="Backup-Type-RecoveryPointSelection-VaultNames"></a>
Estos son los nombres de los almacenes en los que se encuentran los puntos de recuperación seleccionados.  
Tipo: matriz de cadenas  
Obligatorio: no

## Véase también
<a name="API_RecoveryPointSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointSelection) 

# ReportDeliveryChannel
<a name="API_ReportDeliveryChannel"></a>

Contiene información del plan de informe sobre dónde entregar los informes, específicamente el nombre del bucket de Amazon S3, el prefijo de clave de S3 y los formatos de los informes.

## Contenido
<a name="API_ReportDeliveryChannel_Contents"></a>

 ** S3BucketName **   <a name="Backup-Type-ReportDeliveryChannel-S3BucketName"></a>
El nombre único del bucket de S3 que recibe los informes.  
Tipo: cadena  
Obligatorio: sí

 ** Formats **   <a name="Backup-Type-ReportDeliveryChannel-Formats"></a>
El formato de los informes: `CSV`, `JSON` o ambos. Si no se especifica, el formato predeterminado es `CSV`.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** S3KeyPrefix **   <a name="Backup-Type-ReportDeliveryChannel-S3KeyPrefix"></a>
El prefijo del lugar donde AWS Backup Audit Manager entrega los informes a Amazon S3. El prefijo es la parte que se indica en la siguiente ruta: s3://your-bucket-name/`prefix`/Backup/us-west-2/year/month/day/report-name. Si no se especifica, no hay prefijo.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ReportDeliveryChannel_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportDeliveryChannel) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportDeliveryChannel) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportDeliveryChannel) 

# ReportDestination
<a name="API_ReportDestination"></a>

Contiene información de su trabajo de informe sobre el destino de su informe.

## Contenido
<a name="API_ReportDestination_Contents"></a>

 ** S3BucketName **   <a name="Backup-Type-ReportDestination-S3BucketName"></a>
El nombre único del bucket de Amazon S3 que recibe los informes.  
Tipo: cadena  
Requerido: no

 ** S3Keys **   <a name="Backup-Type-ReportDestination-S3Keys"></a>
El nombre clave que identifica de forma exclusiva sus informes en el bucket de S3.  
Tipo: matriz de cadenas  
Obligatorio: no

## Véase también
<a name="API_ReportDestination_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportDestination) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportDestination) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportDestination) 

# ReportJob
<a name="API_ReportJob"></a>

Contiene información detallada acerca de un trabajo de informe. Un trabajo de informe compila un informe en función de un plan de informes y lo publica en Amazon S3.

## Contenido
<a name="API_ReportJob_Contents"></a>

 ** CompletionTime **   <a name="Backup-Type-ReportJob-CompletionTime"></a>
La fecha y la hora en que se completó el trabajo de informe, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreationTime **   <a name="Backup-Type-ReportJob-CreationTime"></a>
La fecha y la hora en que se creó un trabajo de informe, en formato Unix y horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** ReportDestination **   <a name="Backup-Type-ReportJob-ReportDestination"></a>
El nombre del bucket de S3 y las claves S3 del destino en el que el trabajo de informe publica el informe.  
Tipo: objeto [ReportDestination](API_ReportDestination.md)  
Obligatorio: no

 ** ReportJobId **   <a name="Backup-Type-ReportJob-ReportJobId"></a>
El identificador de un trabajo de informe. Una única cadena cifrada en UTF-8, Unicode, generada aleatoriamente que tiene como máximo una longitud de 1024 bytes. El ID del trabajo de informe no se puede editar.  
Tipo: cadena  
Requerido: no

 ** ReportPlanArn **   <a name="Backup-Type-ReportJob-ReportPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** ReportTemplate **   <a name="Backup-Type-ReportJob-ReportTemplate"></a>
Identifica la plantilla para el informe. Los informes se crean mediante una plantilla. Las plantillas de informes son:   
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`   
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-ReportJob-Status"></a>
El estado de un trabajo de informe. Los estados son:  
 `CREATED | RUNNING | COMPLETED | FAILED`   
 `COMPLETED` significa que el informe está disponible para su revisión en el destino designado. Si el estado es `FAILED`, revise el motivo en el `StatusMessage`.  
Tipo: cadena  
Requerido: no

 ** StatusMessage **   <a name="Backup-Type-ReportJob-StatusMessage"></a>
Un mensaje que explica el estado del trabajo de informe.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ReportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportJob) 

# ReportPlan
<a name="API_ReportPlan"></a>

Contiene información detallada acerca de un plan de informes.

## Contenido
<a name="API_ReportPlan_Contents"></a>

 ** CreationTime **   <a name="Backup-Type-ReportPlan-CreationTime"></a>
La fecha y la hora en que se creó el plan de informes, en formato Unix y horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** DeploymentStatus **   <a name="Backup-Type-ReportPlan-DeploymentStatus"></a>
Devuelve el estado de una implementación de un plan de informes. Los estados son:  
 `CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED`   
Tipo: cadena  
Requerido: no

 ** LastAttemptedExecutionTime **   <a name="Backup-Type-ReportPlan-LastAttemptedExecutionTime"></a>
La fecha y la hora en que se intentó ejecutar por última vez un trabajo de informe asociado a este plan de informes, en formato Unix y horario universal coordinado (UTC). El valor de `LastAttemptedExecutionTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** LastSuccessfulExecutionTime **   <a name="Backup-Type-ReportPlan-LastSuccessfulExecutionTime"></a>
La fecha y la hora en que se ejecutó por última vez con éxito un trabajo de informe asociado con este plan de informes, en formato Unix y horario universal coordinado (UTC). El valor de `LastSuccessfulExecutionTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** ReportDeliveryChannel **   <a name="Backup-Type-ReportPlan-ReportDeliveryChannel"></a>
Contiene información sobre dónde y cómo entregar sus informes, específicamente el nombre del bucket de Amazon S3, el prefijo de clave de S3 y los formatos de sus informes.  
Tipo: objeto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)  
Obligatorio: no

 ** ReportPlanArn **   <a name="Backup-Type-ReportPlan-ReportPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** ReportPlanDescription **   <a name="Backup-Type-ReportPlan-ReportPlanDescription"></a>
Una descripción opcional del plan de informes con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** ReportPlanName **   <a name="Backup-Type-ReportPlan-ReportPlanName"></a>
El nombre único del plan de informes. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: no

 ** ReportSetting **   <a name="Backup-Type-ReportPlan-ReportSetting"></a>
Identifica la plantilla para el informe. Los informes se crean mediante una plantilla. Las plantillas de informes son:  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`   
Si la plantilla de informe es `RESOURCE_COMPLIANCE_REPORT` o `CONTROL_COMPLIANCE_REPORT`, este recurso de la API también describe la cobertura de informes por Regiones de AWS y marcos.  
Tipo: objeto [ReportSetting](API_ReportSetting.md)  
Obligatorio: no

## Véase también
<a name="API_ReportPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportPlan) 

# ReportSetting
<a name="API_ReportSetting"></a>

Contiene información detallada acerca de la configuración de un informe.

## Contenido
<a name="API_ReportSetting_Contents"></a>

 ** ReportTemplate **   <a name="Backup-Type-ReportSetting-ReportTemplate"></a>
Identifica la plantilla para el informe. Los informes se crean mediante una plantilla. Las plantillas de informes son:  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT`   
Tipo: cadena  
Obligatorio: sí

 ** Accounts **   <a name="Backup-Type-ReportSetting-Accounts"></a>
Estas son las cuentas que se incluirán en el informe.  
Usa el valor de cadena de `ROOT` para incluir todas las unidades organizativas.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** FrameworkArns **   <a name="Backup-Type-ReportSetting-FrameworkArns"></a>
Los nombres de los recursos de Amazon (ARNs) de los marcos que cubre un informe.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** NumberOfFrameworks **   <a name="Backup-Type-ReportSetting-NumberOfFrameworks"></a>
El número de marcos que cubre un informe.  
Tipo: entero  
Obligatorio: no

 ** OrganizationUnits **   <a name="Backup-Type-ReportSetting-OrganizationUnits"></a>
Estas son las unidades organizativas que se incluirán en el informe.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** Regions **   <a name="Backup-Type-ReportSetting-Regions"></a>
Estas son las regiones que se incluirán en el informe.  
Usa el comodín como valor de cadena para incluir todas las regiones.  
Tipo: matriz de cadenas  
Obligatorio: no

## Véase también
<a name="API_ReportSetting_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportSetting) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportSetting) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportSetting) 

# ResourceSelection
<a name="API_ResourceSelection"></a>

Contiene metadatos sobre la selección de recursos para las configuraciones de estratificación.

Puede especificar hasta 5 selecciones de recursos diferentes por configuración de organización en niveles. Los datos trasladados a un nivel de menor coste permanecen allí hasta que se eliminen (transición unidireccional).

## Contenido
<a name="API_ResourceSelection_Contents"></a>

 ** Resources **   <a name="Backup-Type-ResourceSelection-Resources"></a>
Matriz de cadenas que contiene uno ARNs de los recursos asociados o un comodín `*` para especificar todos los recursos. Puede especificar hasta 100 recursos específicos por configuración de estratificación.  
Tipo: matriz de cadenas  
Obligatorio: sí

 ** ResourceType **   <a name="Backup-Type-ResourceSelection-ResourceType"></a>
El tipo de AWS recurso; por ejemplo, `S3` para Amazon S3. En el caso de las configuraciones por niveles, actualmente se limita a`S3`.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: sí

 ** TieringDownSettingsInDays **   <a name="Backup-Type-ResourceSelection-TieringDownSettingsInDays"></a>
El número de días transcurridos desde su creación en una bóveda de respaldo durante los cuales un objeto puede pasar a la capa de almacenamiento en caliente de bajo coste. Debe ser un número entero positivo comprendido entre 60 y 36500 días.  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 36500.  
Obligatorio: sí

## Véase también
<a name="API_ResourceSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ResourceSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ResourceSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ResourceSelection) 

# RestoreAccessBackupVaultListMember
<a name="API_RestoreAccessBackupVaultListMember"></a>

Contiene información sobre un almacén de copias de seguridad con acceso a la restauración.

## Contenido
<a name="API_RestoreAccessBackupVaultListMember_Contents"></a>

 ** ApprovalDate **   <a name="Backup-Type-RestoreAccessBackupVaultListMember-ApprovalDate"></a>
Fecha y hora en que se aprobó el almacén de copias de seguridad con acceso a la restauración.  
Tipo: marca temporal  
Obligatorio: no

 ** CreationDate **   <a name="Backup-Type-RestoreAccessBackupVaultListMember-CreationDate"></a>
Fecha y hora en que se creó el almacén de copias de seguridad con acceso a la restauración.  
Tipo: marca temporal  
Obligatorio: no

 ** LatestRevokeRequest **   <a name="Backup-Type-RestoreAccessBackupVaultListMember-LatestRevokeRequest"></a>
Información sobre la última solicitud para revocar el acceso a este almacén de copias de seguridad.  
Tipo: objeto [LatestRevokeRequest](API_LatestRevokeRequest.md)  
Obligatorio: no

 ** RestoreAccessBackupVaultArn **   <a name="Backup-Type-RestoreAccessBackupVaultListMember-RestoreAccessBackupVaultArn"></a>
Es el ARN del almacén de copias de seguridad con acceso a la restauración.  
Tipo: cadena  
Requerido: no

 ** VaultState **   <a name="Backup-Type-RestoreAccessBackupVaultListMember-VaultState"></a>
Es el estado actual del almacén de copias de seguridad con acceso a la restauración.  
Tipo: cadena  
Valores válidos: `CREATING | AVAILABLE | FAILED`   
Obligatorio: no

## Véase también
<a name="API_RestoreAccessBackupVaultListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreAccessBackupVaultListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreAccessBackupVaultListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreAccessBackupVaultListMember) 

# RestoreJobCreator
<a name="API_RestoreJobCreator"></a>

Contiene información sobre el plan de prueba de restauración que utilizó AWS Backup para iniciar el trabajo de restauración.

## Contenido
<a name="API_RestoreJobCreator_Contents"></a>

 ** RestoreTestingPlanArn **   <a name="Backup-Type-RestoreJobCreator-RestoreTestingPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un plan de prueba de restauración.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_RestoreJobCreator_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreJobCreator) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreJobCreator) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreJobCreator) 

# RestoreJobsListMember
<a name="API_RestoreJobsListMember"></a>

Contiene metadatos sobre un trabajo de restauración.

## Contenido
<a name="API_RestoreJobsListMember_Contents"></a>

 ** AccountId **   <a name="Backup-Type-RestoreJobsListMember-AccountId"></a>
El ID de la cuenta a la que pertenece el trabajo de restauración.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** BackupSizeInBytes **   <a name="Backup-Type-RestoreJobsListMember-BackupSizeInBytes"></a>
El tamaño del recurso restaurado, en bytes.  
Tipo: largo  
Obligatorio: no

 ** BackupVaultArn **   <a name="Backup-Type-RestoreJobsListMember-BackupVaultArn"></a>
Es el Nombre de recurso de Amazon (ARN) del almacén de copias de seguridad que contiene el punto de recuperación que se va a restaurar. Esto ayuda a identificar las políticas y los permisos de acceso al almacén.  
Tipo: cadena  
Requerido: no

 ** CompletionDate **   <a name="Backup-Type-RestoreJobsListMember-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para restaurar un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatedBy **   <a name="Backup-Type-RestoreJobsListMember-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de restauración.  
Tipo: objeto [RestoreJobCreator](API_RestoreJobCreator.md)  
Obligatorio: no

 ** CreatedResourceArn **   <a name="Backup-Type-RestoreJobsListMember-CreatedResourceArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena  
Requerido: no

 ** CreationDate **   <a name="Backup-Type-RestoreJobsListMember-CreationDate"></a>
La fecha y la hora en que se creó un trabajo de restauración, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** DeletionStatus **   <a name="Backup-Type-RestoreJobsListMember-DeletionStatus"></a>
Indica el estado de los datos generados por la prueba de restauración. El estado puede ser `Deleting`, `Failed` o `Successful`.  
Tipo: cadena  
Valores válidos: `DELETING | FAILED | SUCCESSFUL`   
Obligatorio: no

 ** DeletionStatusMessage **   <a name="Backup-Type-RestoreJobsListMember-DeletionStatusMessage"></a>
Describe el estado de eliminación del trabajo de restauración.  
Tipo: cadena  
Requerido: no

 ** ExpectedCompletionTimeMinutes **   <a name="Backup-Type-RestoreJobsListMember-ExpectedCompletionTimeMinutes"></a>
La cantidad de tiempo en minutos que se espera que tarde un trabajo de restauración de un punto de recuperación.  
Tipo: largo  
Obligatorio: no

 ** IamRoleArn **   <a name="Backup-Type-RestoreJobsListMember-IamRoleArn"></a>
El ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Requerido: no

 ** IsParent **   <a name="Backup-Type-RestoreJobsListMember-IsParent"></a>
Se trata de un valor booleano que indica si el trabajo de restauración es un trabajo de restauración principal (compuesto).  
Tipo: Booleano  
Obligatorio: no

 ** ParentJobId **   <a name="Backup-Type-RestoreJobsListMember-ParentJobId"></a>
Es el identificador único del trabajo de restauración principal del trabajo de restauración seleccionado.  
Tipo: cadena  
Requerido: no

 ** PercentDone **   <a name="Backup-Type-RestoreJobsListMember-PercentDone"></a>
Contiene el porcentaje estimado que se ha completado de un trabajo en el momento en que se consultó el estado del trabajo.  
Tipo: cadena  
Requerido: no

 ** RecoveryPointArn **   <a name="Backup-Type-RestoreJobsListMember-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena  
Requerido: no

 ** RecoveryPointCreationDate **   <a name="Backup-Type-RestoreJobsListMember-RecoveryPointCreationDate"></a>
La fecha en la que se creó un punto de recuperación.  
Tipo: marca temporal  
Obligatorio: no

 ** ResourceType **   <a name="Backup-Type-RestoreJobsListMember-ResourceType"></a>
El tipo de recurso de los trabajos de restauración enumerados; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos de Amazon Relational Database Service (Amazon RDS). Para las copias de seguridad de Windows Volume Shadow Copy Service (VSS), el único tipo de recurso compatible es Amazon EC2.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** RestoreJobId **   <a name="Backup-Type-RestoreJobsListMember-RestoreJobId"></a>
Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** SourceResourceArn **   <a name="Backup-Type-RestoreJobsListMember-SourceResourceArn"></a>
Es el Nombre de recurso de Amazon (ARN) del recurso original del que se ha realizado la copia de seguridad. Proporciona un contexto sobre el recurso que se está restaurando.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-RestoreJobsListMember-Status"></a>
Un código de estado que especifica el estado del trabajo iniciado AWS Backup para restaurar un punto de recuperación.  
Tipo: cadena  
Valores válidos: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-RestoreJobsListMember-StatusMessage"></a>
Un mensaje detallado que explica el estado del trabajo de restauración de un punto de recuperación.  
Tipo: cadena  
Requerido: no

 ** ValidationStatus **   <a name="Backup-Type-RestoreJobsListMember-ValidationStatus"></a>
El estado de la validación ejecutada en el trabajo de restauración indicado.  
Tipo: cadena  
Valores válidos: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`   
Obligatorio: no

 ** ValidationStatusMessage **   <a name="Backup-Type-RestoreJobsListMember-ValidationStatusMessage"></a>
Describe el estado de la validación ejecutada en el trabajo de restauración indicado.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_RestoreJobsListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreJobsListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreJobsListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreJobsListMember) 

# RestoreJobSummary
<a name="API_RestoreJobSummary"></a>

Es un resumen de los trabajos de restauración creados o en ejecución en los 30 últimos días.

El resumen devuelto puede contener lo siguiente: Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime y Count de trabajos incluidos.

## Contenido
<a name="API_RestoreJobSummary_Contents"></a>

 ** AccountId **   <a name="Backup-Type-RestoreJobSummary-AccountId"></a>
El ID de la cuenta propietaria de los trabajos del resumen.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** Count **   <a name="Backup-Type-RestoreJobSummary-Count"></a>
El valor expresado como número de trabajos en un resumen de trabajos.  
Tipo: entero  
Obligatorio: no

 ** EndTime **   <a name="Backup-Type-RestoreJobSummary-EndTime"></a>
El valor de hora en formato numérico de la hora de finalización de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** Region **   <a name="Backup-Type-RestoreJobSummary-Region"></a>
Las regiones de AWS incluidas en el resumen del trabajo.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-RestoreJobSummary-ResourceType"></a>
Este valor es el recuento de trabajos para el tipo de recurso especificado. La solicitud `GetSupportedResourceTypes` devuelve cadenas para los tipos de recursos compatibles.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** StartTime **   <a name="Backup-Type-RestoreJobSummary-StartTime"></a>
El valor de hora en formato numérico de la hora de inicio de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** State **   <a name="Backup-Type-RestoreJobSummary-State"></a>
Este valor es el recuento de trabajos con el estado especificado.  
Tipo: cadena  
Valores válidos: `CREATED | PENDING | RUNNING | ABORTED | COMPLETED | FAILED | AGGREGATE_ALL | ANY`   
Obligatorio: no

## Véase también
<a name="API_RestoreJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreJobSummary) 

# RestoreTestingPlanForCreate
<a name="API_RestoreTestingPlanForCreate"></a>

Contiene metadatos sobre un plan de prueba de restauración.

## Contenido
<a name="API_RestoreTestingPlanForCreate_Contents"></a>

 ** RecoveryPointSelection **   <a name="Backup-Type-RestoreTestingPlanForCreate-RecoveryPointSelection"></a>
 `RecoveryPointSelection` tiene cinco parámetros (tres obligatorios y dos opcionales). Los valores que especifique determinan qué punto de recuperación se incluye en la prueba de restauración. Debe indicar `Algorithm` si desea incluir el último punto de recuperación dentro del suyo `SelectionWindowDays` o si desea un punto de recuperación aleatorio, y debe indicar a través de `IncludeVaults` de qué bóvedas se pueden elegir los puntos de recuperación.  
 `Algorithm` (*obligatorio*) Valores válidos: "`LATEST_WITHIN_WINDOW`" o "`RANDOM_WITHIN_WINDOW`".  
 `Recovery point types` (*obligatorio*) Valores válidos: "`SNAPSHOT`" y/o "`CONTINUOUS`". Incluir `SNAPSHOT` para restaurar únicamente los puntos de recuperación de instantáneas; incluir `CONTINUOUS` para restaurar puntos de recuperación continua (restauración puntual o PITR); utilizar ambos para restaurar una instantánea o un punto de recuperación continua. El punto de recuperación vendrá determinado por el valor de `Algorithm`.  
 `IncludeVaults` (*obligatorio*). Debe incluir uno o más almacenes de copia de seguridad. Utilice el comodín ["\$1"] o ARN específicos.  
 `SelectionWindowDays` (*opcional*) El valor debe ser un número entero (en días) comprendido entre 1 y 365. Si no se incluye, el valor se establece de forma predeterminada en `30`.  
 `ExcludeVaults` (*opcional*). Puede optar por introducir uno o más ARN de almacenes de copia de seguridad específicos para impedir que el contenido de esos almacenes pueda restaurarse. O puede incluir una lista de selectores. Si este parámetro y su valor no están incluidos, el valor predeterminado es una lista vacía.  
Tipo: objeto [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md)  
Obligatorio: sí

 ** RestoreTestingPlanName **   <a name="Backup-Type-RestoreTestingPlanForCreate-RestoreTestingPlanName"></a>
RestoreTestingPlanName es una cadena única que es el nombre del plan de prueba de restauración. No se puede cambiar después de la creación y debe constar únicamente de caracteres alfanuméricos y guiones bajos.  
Tipo: cadena  
Obligatorio: sí

 ** ScheduleExpression **   <a name="Backup-Type-RestoreTestingPlanForCreate-ScheduleExpression"></a>
Una expresión CRON en la zona horaria especificada cuando se ejecuta un plan de prueba de restauración. Si no se proporciona ninguna expresión CRON, AWS Backup utilizará la expresión `cron(0 5 ? * * *)` predeterminada.  
Tipo: cadena  
Obligatorio: sí

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-RestoreTestingPlanForCreate-ScheduleExpressionTimezone"></a>
Opcional. La zona horaria en la que se establece la expresión de programación. De forma predeterminada, las ScheduleExpressions están en UTC. Puede modificar esto para una zona horaria específica.  
Tipo: cadena  
Requerido: no

 ** StartWindowHours **   <a name="Backup-Type-RestoreTestingPlanForCreate-StartWindowHours"></a>
El valor predeterminado es 24 horas.  
Un valor en horas después de una prueba de restauración programada para que se cancele el trabajo si no se ha iniciado correctamente. Este valor es opcional. Si se incluye este valor, este parámetro tiene un valor máximo de 168 horas (una semana).  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingPlanForCreate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForCreate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForCreate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForCreate) 

# RestoreTestingPlanForGet
<a name="API_RestoreTestingPlanForGet"></a>

Contiene metadatos sobre un plan de prueba de restauración.

## Contenido
<a name="API_RestoreTestingPlanForGet_Contents"></a>

 ** CreationTime **   <a name="Backup-Type-RestoreTestingPlanForGet-CreationTime"></a>
La fecha y la hora en que se creó un plan de prueba de restauración, en formato Unix y Hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: sí

 ** RecoveryPointSelection **   <a name="Backup-Type-RestoreTestingPlanForGet-RecoveryPointSelection"></a>
Los criterios especificados para asignar un conjunto de recursos, como tipos de punto de recuperación o almacenes de copias de seguridad.  
Tipo: objeto [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md)  
Obligatorio: sí

 ** RestoreTestingPlanArn **   <a name="Backup-Type-RestoreTestingPlanForGet-RestoreTestingPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un plan de prueba de restauración.  
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingPlanName **   <a name="Backup-Type-RestoreTestingPlanForGet-RestoreTestingPlanName"></a>
El nombre del plan de prueba de restauración.  
Tipo: cadena  
Obligatorio: sí

 ** ScheduleExpression **   <a name="Backup-Type-RestoreTestingPlanForGet-ScheduleExpression"></a>
Una expresión CRON en la zona horaria especificada cuando se ejecuta un plan de prueba de restauración. Si no se proporciona ninguna expresión CRON, AWS Backup utilizará la expresión `cron(0 5 ? * * *)` predeterminada.  
Tipo: cadena  
Obligatorio: sí

 ** CreatorRequestId **   <a name="Backup-Type-RestoreTestingPlanForGet-CreatorRequestId"></a>
Identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Si la solicitud incluye un `CreatorRequestId` que coincide con un plan de copia de seguridad existente, se devuelve ese plan. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** LastExecutionTime **   <a name="Backup-Type-RestoreTestingPlanForGet-LastExecutionTime"></a>
La última vez que se ejecutó una prueba de restauración con el plan de prueba de restauración especificado. Una fecha y hora, en formato Unix y horario universal coordinado (UTC). El valor de `LastExecutionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** LastUpdateTime **   <a name="Backup-Type-RestoreTestingPlanForGet-LastUpdateTime"></a>
La fecha y hora en que se actualizó el plan de prueba de restauración. Esta actualización está en formato Unix y horario universal coordinado (UTC). El valor de `LastUpdateTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-RestoreTestingPlanForGet-ScheduleExpressionTimezone"></a>
Opcional. La zona horaria en la que se establece la expresión de programación. De forma predeterminada, las ScheduleExpressions están en UTC. Puede modificar esto para una zona horaria específica.  
Tipo: cadena  
Requerido: no

 ** StartWindowHours **   <a name="Backup-Type-RestoreTestingPlanForGet-StartWindowHours"></a>
El valor predeterminado es 24 horas.  
Un valor en horas después de una prueba de restauración programada para que se cancele el trabajo si no se ha iniciado correctamente. Este valor es opcional. Si se incluye este valor, este parámetro tiene un valor máximo de 168 horas (una semana).  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingPlanForGet_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForGet) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForGet) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForGet) 

# RestoreTestingPlanForList
<a name="API_RestoreTestingPlanForList"></a>

Contiene metadatos sobre un plan de prueba de restauración.

## Contenido
<a name="API_RestoreTestingPlanForList_Contents"></a>

 ** CreationTime **   <a name="Backup-Type-RestoreTestingPlanForList-CreationTime"></a>
La fecha y la hora en que se creó un plan de prueba de restauración, en formato Unix y Hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: sí

 ** RestoreTestingPlanArn **   <a name="Backup-Type-RestoreTestingPlanForList-RestoreTestingPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un plan de prueba de restauración.  
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingPlanName **   <a name="Backup-Type-RestoreTestingPlanForList-RestoreTestingPlanName"></a>
El nombre del plan de prueba de restauración.  
Tipo: cadena  
Obligatorio: sí

 ** ScheduleExpression **   <a name="Backup-Type-RestoreTestingPlanForList-ScheduleExpression"></a>
Una expresión CRON en la zona horaria especificada cuando se ejecuta un plan de prueba de restauración. Si no se proporciona ninguna expresión CRON, AWS Backup utilizará la expresión `cron(0 5 ? * * *)` predeterminada.  
Tipo: cadena  
Obligatorio: sí

 ** LastExecutionTime **   <a name="Backup-Type-RestoreTestingPlanForList-LastExecutionTime"></a>
La última vez que se ejecutó una prueba de restauración con el plan de prueba de restauración especificado. Una fecha y hora, en formato Unix y horario universal coordinado (UTC). El valor de `LastExecutionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** LastUpdateTime **   <a name="Backup-Type-RestoreTestingPlanForList-LastUpdateTime"></a>
La fecha y hora en que se actualizó el plan de prueba de restauración. Esta actualización está en formato Unix y horario universal coordinado (UTC). El valor de `LastUpdateTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-RestoreTestingPlanForList-ScheduleExpressionTimezone"></a>
Opcional. La zona horaria en la que se establece la expresión de programación. De forma predeterminada, las ScheduleExpressions están en UTC. Puede modificar esto para una zona horaria específica.  
Tipo: cadena  
Requerido: no

 ** StartWindowHours **   <a name="Backup-Type-RestoreTestingPlanForList-StartWindowHours"></a>
El valor predeterminado es 24 horas.  
Un valor en horas después de una prueba de restauración programada para que se cancele el trabajo si no se ha iniciado correctamente. Este valor es opcional. Si se incluye este valor, este parámetro tiene un valor máximo de 168 horas (una semana).  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingPlanForList_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForList) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForList) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForList) 

# RestoreTestingPlanForUpdate
<a name="API_RestoreTestingPlanForUpdate"></a>

Contiene metadatos sobre un plan de prueba de restauración.

## Contenido
<a name="API_RestoreTestingPlanForUpdate_Contents"></a>

 ** RecoveryPointSelection **   <a name="Backup-Type-RestoreTestingPlanForUpdate-RecoveryPointSelection"></a>
Obligatorio: `Algorithm`; `RecoveryPointTypes`; `IncludeVaults` (*uno o varios*).  
Opcional: *SelectionWindowDays* (*'30' si no se especifica*); `ExcludeVaults` (si no se incluye ninguno, aparece una lista vacía de forma predeterminada).  
Tipo: objeto [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md)  
Obligatorio: no

 ** ScheduleExpression **   <a name="Backup-Type-RestoreTestingPlanForUpdate-ScheduleExpression"></a>
Una expresión CRON en la zona horaria especificada cuando se ejecuta un plan de prueba de restauración. Si no se proporciona ninguna expresión CRON, AWS Backup utilizará la expresión `cron(0 5 ? * * *)` predeterminada.  
Tipo: cadena  
Requerido: no

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-RestoreTestingPlanForUpdate-ScheduleExpressionTimezone"></a>
Opcional. La zona horaria en la que se establece la expresión de programación. De forma predeterminada, las ScheduleExpressions están en UTC. Puede modificar esto para una zona horaria específica.  
Tipo: cadena  
Requerido: no

 ** StartWindowHours **   <a name="Backup-Type-RestoreTestingPlanForUpdate-StartWindowHours"></a>
El valor predeterminado es 24 horas.  
Un valor en horas después de una prueba de restauración programada para que se cancele el trabajo si no se ha iniciado correctamente. Este valor es opcional. Si se incluye este valor, este parámetro tiene un valor máximo de 168 horas (una semana).  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingPlanForUpdate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForUpdate) 

# RestoreTestingRecoveryPointSelection
<a name="API_RestoreTestingRecoveryPointSelection"></a>

 `RecoveryPointSelection` tiene cinco parámetros (tres obligatorios y dos opcionales). Los valores que especifique determinan qué punto de recuperación se incluye en la prueba de restauración. Debe indicar `Algorithm` si desea incluir el último punto de recuperación dentro del suyo `SelectionWindowDays` o si desea un punto de recuperación aleatorio, y debe indicar a través de `IncludeVaults` de qué bóvedas se pueden elegir los puntos de recuperación.

 `Algorithm` (*obligatorio*) Valores válidos: "`LATEST_WITHIN_WINDOW`" o "`RANDOM_WITHIN_WINDOW`".

 `Recovery point types` (*obligatorio*) Valores válidos: "`SNAPSHOT`" y/o "`CONTINUOUS`". Incluir `SNAPSHOT` para restaurar únicamente los puntos de recuperación de instantáneas; incluir `CONTINUOUS` para restaurar puntos de recuperación continua (restauración puntual o PITR); utilizar ambos para restaurar una instantánea o un punto de recuperación continua. El punto de recuperación vendrá determinado por el valor de `Algorithm`.

 `IncludeVaults` (*obligatorio*) Debe incluir uno o más almacenes de copia de seguridad. Utilice el comodín ["\$1"] o ARN específicos.

 `SelectionWindowDays` (*opcional*) El valor debe ser un número entero (en días) comprendido entre 1 y 365. Si no se incluye, el valor se establece de forma predeterminada en `30`.

 `ExcludeVaults` (*opcional*). Puede optar por introducir uno o más ARN de almacenes de copia de seguridad específicos para impedir que el contenido de esos almacenes pueda restaurarse. O puede incluir una lista de selectores. Si este parámetro y su valor no están incluidos, el valor predeterminado es una lista vacía.

## Contenido
<a name="API_RestoreTestingRecoveryPointSelection_Contents"></a>

 ** Algorithm **   <a name="Backup-Type-RestoreTestingRecoveryPointSelection-Algorithm"></a>
Los valores aceptables son "LATEST\$1WITHIN\$1WINDOW" o "RANDOM\$1WITHIN\$1WINDOW"  
Tipo: cadena  
Valores válidos: `LATEST_WITHIN_WINDOW | RANDOM_WITHIN_WINDOW`   
Obligatorio: no

 ** ExcludeVaults **   <a name="Backup-Type-RestoreTestingRecoveryPointSelection-ExcludeVaults"></a>
Los valores aceptados son ARN específicos o una lista de selectores. Si no se incluye ninguno, aparece una lista vacía de forma predeterminada.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** IncludeVaults **   <a name="Backup-Type-RestoreTestingRecoveryPointSelection-IncludeVaults"></a>
Los valores aceptados son el comodín ["\$1"] o ARN específicos o sustitución de comodín ARN ["arn:aws:backup:us-west-2:123456789012:backup-vault:asdf", ...] ["arn:aws:backup:\$1:\$1:backup-vault:asdf-\$1", ...]  
Tipo: matriz de cadenas  
Obligatorio: no

 ** RecoveryPointTypes **   <a name="Backup-Type-RestoreTestingRecoveryPointSelection-RecoveryPointTypes"></a>
Son los tipos de puntos de recuperación.  
Incluir `SNAPSHOT` para restaurar únicamente los puntos de recuperación de instantáneas; incluir `CONTINUOUS` para restaurar puntos de recuperación continua (restauración puntual o PITR); utilizar ambos para restaurar una instantánea o un punto de recuperación continua. El punto de recuperación vendrá determinado por el valor de `Algorithm`.  
Tipo: matriz de cadenas  
Valores válidos: `CONTINUOUS | SNAPSHOT`   
Obligatorio: no

 ** SelectionWindowDays **   <a name="Backup-Type-RestoreTestingRecoveryPointSelection-SelectionWindowDays"></a>
Los valores aceptados son números enteros de 1 a 365.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingRecoveryPointSelection_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingRecoveryPointSelection) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingRecoveryPointSelection) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingRecoveryPointSelection) 

# RestoreTestingSelectionForCreate
<a name="API_RestoreTestingSelectionForCreate"></a>

Contiene metadatos sobre una selección de pruebas de restauración específica.

ProtectedResourceType es obligatorio, como Amazon EBS o Amazon EC2.

Consta de `RestoreTestingSelectionName`, `ProtectedResourceType` y uno de los siguientes elementos:
+  `ProtectedResourceArns` 
+  `ProtectedResourceConditions` 

Cada tipo de recurso protegido puede tener un único valor.

Una selección de pruebas de restauración puede incluir un valor comodín ("\$1") como `ProtectedResourceArns` junto con `ProtectedResourceConditions`. Como alternativa, puede incluir hasta 30 recursos ARNs protegidos específicos. `ProtectedResourceArns`

 `StringEquals` y `StringNotEquals` son ejemplos de `ProtectedResourceConditions`.

## Contenido
<a name="API_RestoreTestingSelectionForCreate_Contents"></a>

 ** IamRoleArn **   <a name="Backup-Type-RestoreTestingSelectionForCreate-IamRoleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de IAM que AWS Backup utiliza para crear el recurso de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.   
Tipo: cadena  
Obligatorio: sí

 ** ProtectedResourceType **   <a name="Backup-Type-RestoreTestingSelectionForCreate-ProtectedResourceType"></a>
El tipo de AWS recurso incluido en una selección de pruebas de restauración; por ejemplo, un volumen de Amazon EBS o una base de datos de Amazon RDS.  
Los tipos de recursos admitidos son:  
+  `Aurora` para Amazon Aurora
+  `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
+  `S3` para Amazon S3
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingSelectionName **   <a name="Backup-Type-RestoreTestingSelectionForCreate-RestoreTestingSelectionName"></a>
El nombre único de la selección de pruebas de restauración que pertenece al plan de prueba de restauración.  
El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena  
Obligatorio: sí

 ** ProtectedResourceArns **   <a name="Backup-Type-RestoreTestingSelectionForCreate-ProtectedResourceArns"></a>
Cada recurso protegido se puede filtrar por su valor específico ARNs, como `ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]` por ejemplo un comodín:`ProtectedResourceArns: ["*"]`, pero no por ambos.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** ProtectedResourceConditions **   <a name="Backup-Type-RestoreTestingSelectionForCreate-ProtectedResourceConditions"></a>
Si ha incluido el comodín ProtectedResourceArns, puede incluir las condiciones del recurso, por ejemplo. `ProtectedResourceConditions: { StringEquals: [{ key: "XXXX", value: "YYYY" }]`  
Tipo: objeto [ProtectedResourceConditions](API_ProtectedResourceConditions.md)  
Obligatorio: no

 ** RestoreMetadataOverrides **   <a name="Backup-Type-RestoreTestingSelectionForCreate-RestoreMetadataOverrides"></a>
Puede anular determinadas claves de metadatos de restauración incluyendo el parámetro `RestoreMetadataOverrides` en el cuerpo de `RestoreTestingSelection`. Los valores de clave no distinguen mayúsculas y minúsculas.  
Consulte la lista completa de [metadatos inferidos de pruebas de restauración](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html).  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** ValidationWindowHours **   <a name="Backup-Type-RestoreTestingSelectionForCreate-ValidationWindowHours"></a>
Es la cantidad de horas (de 0 a 168) disponibles para ejecutar un script de validación de los datos. Los datos se eliminarán al finalizar el script de validación o al final del periodo de retención especificado, lo que ocurra primero.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingSelectionForCreate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForCreate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForCreate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForCreate) 

# RestoreTestingSelectionForGet
<a name="API_RestoreTestingSelectionForGet"></a>

Contiene metadatos sobre una selección de pruebas de restauración.

## Contenido
<a name="API_RestoreTestingSelectionForGet_Contents"></a>

 ** CreationTime **   <a name="Backup-Type-RestoreTestingSelectionForGet-CreationTime"></a>
La fecha y la hora en que se creó una selección de pruebas de restauración, en formato Unix y Hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: sí

 ** IamRoleArn **   <a name="Backup-Type-RestoreTestingSelectionForGet-IamRoleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de IAM que AWS Backup utiliza para crear el recurso de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Obligatorio: sí

 ** ProtectedResourceType **   <a name="Backup-Type-RestoreTestingSelectionForGet-ProtectedResourceType"></a>
El tipo de AWS recurso incluido en una selección de pruebas de recursos; por ejemplo, un volumen de Amazon EBS o una base de datos de Amazon RDS.  
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingPlanName **   <a name="Backup-Type-RestoreTestingSelectionForGet-RestoreTestingPlanName"></a>
 RestoreTestingPlanName Es una cadena única que es el nombre del plan de pruebas de restauración.  
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingSelectionName **   <a name="Backup-Type-RestoreTestingSelectionForGet-RestoreTestingSelectionName"></a>
El nombre único de la selección de pruebas de restauración que pertenece al plan de prueba de restauración.  
El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena  
Obligatorio: sí

 ** CreatorRequestId **   <a name="Backup-Type-RestoreTestingSelectionForGet-CreatorRequestId"></a>
Identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Si la solicitud incluye un `CreatorRequestId` que coincide con un plan de copia de seguridad existente, se devuelve ese plan. Este parámetro es opcional.  
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** ProtectedResourceArns **   <a name="Backup-Type-RestoreTestingSelectionForGet-ProtectedResourceArns"></a>
Puede incluir un carácter específico ARNs, como por ejemplo, `ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]` o puede incluir un comodín:`ProtectedResourceArns: ["*"]`, pero no ambos.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** ProtectedResourceConditions **   <a name="Backup-Type-RestoreTestingSelectionForGet-ProtectedResourceConditions"></a>
En una selección de pruebas de recursos, este parámetro filtra por condiciones específicas, como `StringEquals` o `StringNotEquals`.  
Tipo: objeto [ProtectedResourceConditions](API_ProtectedResourceConditions.md)  
Obligatorio: no

 ** RestoreMetadataOverrides **   <a name="Backup-Type-RestoreTestingSelectionForGet-RestoreMetadataOverrides"></a>
Puede anular determinadas claves de metadatos de restauración incluyendo el parámetro `RestoreMetadataOverrides` en el cuerpo de `RestoreTestingSelection`. Los valores de clave no distinguen mayúsculas y minúsculas.  
Consulte la lista completa de [metadatos inferidos de pruebas de restauración](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html).  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** ValidationWindowHours **   <a name="Backup-Type-RestoreTestingSelectionForGet-ValidationWindowHours"></a>
Es el número de horas (de 1 a 168) disponibles para ejecutar un script de validación de los datos. Los datos se eliminarán al finalizar el script de validación o al final del periodo de retención especificado, lo que ocurra primero.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingSelectionForGet_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForGet) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForGet) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForGet) 

# RestoreTestingSelectionForList
<a name="API_RestoreTestingSelectionForList"></a>

Contiene metadatos sobre una selección de pruebas de restauración.

## Contenido
<a name="API_RestoreTestingSelectionForList_Contents"></a>

 ** CreationTime **   <a name="Backup-Type-RestoreTestingSelectionForList-CreationTime"></a>
La fecha y la hora en que se creó una selección de pruebas de restauración, en formato Unix y Hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: sí

 ** IamRoleArn **   <a name="Backup-Type-RestoreTestingSelectionForList-IamRoleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de IAM que AWS Backup utiliza para crear el recurso de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Obligatorio: sí

 ** ProtectedResourceType **   <a name="Backup-Type-RestoreTestingSelectionForList-ProtectedResourceType"></a>
El tipo de AWS recurso incluido en una selección de pruebas de restauración; por ejemplo, un volumen de Amazon EBS o una base de datos de Amazon RDS.  
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingPlanName **   <a name="Backup-Type-RestoreTestingSelectionForList-RestoreTestingPlanName"></a>
Cadena única que es el nombre del plan de prueba de restauración.  
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena  
Obligatorio: sí

 ** RestoreTestingSelectionName **   <a name="Backup-Type-RestoreTestingSelectionForList-RestoreTestingSelectionName"></a>
Nombre único de la selección de pruebas de restauración.  
El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 50.  
Tipo: cadena  
Obligatorio: sí

 ** ValidationWindowHours **   <a name="Backup-Type-RestoreTestingSelectionForList-ValidationWindowHours"></a>
Este valor representa el tiempo, en horas, que se retienen los datos después de una prueba de restauración para poder completar la validación opcional.  
El valor aceptado es un entero entre 0 y 168 (el equivalente en horas a siete días).  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingSelectionForList_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForList) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForList) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForList) 

# RestoreTestingSelectionForUpdate
<a name="API_RestoreTestingSelectionForUpdate"></a>

Contiene metadatos sobre una selección de pruebas de restauración.

## Contenido
<a name="API_RestoreTestingSelectionForUpdate_Contents"></a>

 ** IamRoleArn **   <a name="Backup-Type-RestoreTestingSelectionForUpdate-IamRoleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de IAM que AWS Backup utiliza para crear el recurso de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena  
Requerido: no

 ** ProtectedResourceArns **   <a name="Backup-Type-RestoreTestingSelectionForUpdate-ProtectedResourceArns"></a>
Puede incluir una lista de ARN específicos, por ejemplo, `ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]`, o incluir un comodín: `ProtectedResourceArns: ["*"]`, pero no ambos.  
Tipo: matriz de cadenas  
Obligatorio: no

 ** ProtectedResourceConditions **   <a name="Backup-Type-RestoreTestingSelectionForUpdate-ProtectedResourceConditions"></a>
La lista de condiciones que se define para los recursos del plan de prueba de restauración mediante etiquetas.  
Tipo: objeto [ProtectedResourceConditions](API_ProtectedResourceConditions.md)  
Obligatorio: no

 ** RestoreMetadataOverrides **   <a name="Backup-Type-RestoreTestingSelectionForUpdate-RestoreMetadataOverrides"></a>
Puede anular determinadas claves de metadatos de restauración incluyendo el parámetro `RestoreMetadataOverrides` en el cuerpo de `RestoreTestingSelection`. Los valores de clave no distinguen mayúsculas y minúsculas.  
Consulte la lista completa de [metadatos inferidos de pruebas de restauración](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html).  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** ValidationWindowHours **   <a name="Backup-Type-RestoreTestingSelectionForUpdate-ValidationWindowHours"></a>
Este valor representa el tiempo, en horas, que se retienen los datos después de una prueba de restauración para poder completar la validación opcional.  
El valor aceptado es un entero entre 0 y 168 (el equivalente en horas a siete días).  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_RestoreTestingSelectionForUpdate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForUpdate) 

# ScanAction
<a name="API_ScanAction"></a>

Define una acción de análisis que especifica el escáner de malware y el modo de análisis que se van a utilizar.

## Contenido
<a name="API_ScanAction_Contents"></a>

 ** MalwareScanner **   <a name="Backup-Type-ScanAction-MalwareScanner"></a>
El escáner de malware que se utilizará para la acción de escaneo. En la actualidad, solo se admite `GUARDDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY`   
Obligatorio: no

 ** ScanMode **   <a name="Backup-Type-ScanAction-ScanMode"></a>
El modo de escaneo que se utilizará para la acción de escaneo.  
Valores válidos: `FULL_SCAN` \$1 `INCREMENTAL_SCAN`.  
Tipo: cadena  
Valores válidos: `FULL_SCAN | INCREMENTAL_SCAN`   
Obligatorio: no

## Véase también
<a name="API_ScanAction_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanAction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanAction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanAction) 

# ScanJob
<a name="API_ScanJob"></a>

Contiene metadatos sobre un trabajo de digitalización, incluida información sobre el proceso de digitalización, los resultados y los recursos asociados.

## Contenido
<a name="API_ScanJob_Contents"></a>

 ** AccountId **   <a name="Backup-Type-ScanJob-AccountId"></a>
El ID de cuenta propietario del trabajo de escaneo.  
Tipo: cadena  
Obligatorio: sí

 ** BackupVaultArn **   <a name="Backup-Type-ScanJob-BackupVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: cadena  
Obligatorio: sí

 ** BackupVaultName **   <a name="Backup-Type-ScanJob-BackupVaultName"></a>
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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.  
Tipo: cadena  
Obligatorio: sí

 ** CreatedBy **   <a name="Backup-Type-ScanJob-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de escaneo.  
Tipo: objeto [ScanJobCreator](API_ScanJobCreator.md)  
Obligatorio: sí

 ** CreationDate **   <a name="Backup-Type-ScanJob-CreationDate"></a>
La fecha y la hora en que se crea un trabajo de escaneo, en formato Unix y en hora universal coordinada (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: sí

 ** IamRoleArn **   <a name="Backup-Type-ScanJob-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el trabajo de escaneo; por ejemplo,. `arn:aws:iam::123456789012:role/S3Access`  
Tipo: cadena  
Obligatorio: sí

 ** MalwareScanner **   <a name="Backup-Type-ScanJob-MalwareScanner"></a>
El motor de escaneo utilizado para el trabajo de escaneo. En la actualidad, solo se admite `GUARDDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY`   
Obligatorio: sí

 ** RecoveryPointArn **   <a name="Backup-Type-ScanJob-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva el punto de recuperación que se está escaneando; por ejemplo,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`  
Tipo: cadena  
Obligatorio: sí

 ** ResourceArn **   <a name="Backup-Type-ScanJob-ResourceArn"></a>
Un ARN que identifica de forma exclusiva el recurso de origen del punto de recuperación que se está escaneando.  
Tipo: cadena  
Obligatorio: sí

 ** ResourceName **   <a name="Backup-Type-ScanJob-ResourceName"></a>
El nombre no exclusivo del recurso que pertenece a la copia de seguridad especificada.  
Tipo: cadena  
Obligatorio: sí

 ** ResourceType **   <a name="Backup-Type-ScanJob-ResourceType"></a>
El tipo de AWS recurso que se está escaneando; por ejemplo, un volumen de Amazon Elastic Block Store (Amazon EBS) o una base de datos del Amazon Relational Database Service (Amazon RDS).  
Tipo: cadena  
Valores válidos: `EBS | EC2 | S3`   
Obligatorio: sí

 ** ScanJobId **   <a name="Backup-Type-ScanJob-ScanJobId"></a>
El identificador único con el que se identifica la solicitud de trabajo de escaneo. AWS Backup  
Tipo: cadena  
Obligatorio: sí

 ** ScanMode **   <a name="Backup-Type-ScanJob-ScanMode"></a>
Especifica el tipo de escaneo que se utilizará para el trabajo de escaneo.  
Incluye:  
 `FULL_SCAN`escaneará todo el linaje de datos de la copia de seguridad.  
 `INCREMENTAL_SCAN`escaneará la diferencia de datos entre el punto de recuperación objetivo y el ARN del punto de recuperación base.  
Tipo: cadena  
Valores válidos: `FULL_SCAN | INCREMENTAL_SCAN`   
Obligatorio: sí

 ** ScannerRoleArn **   <a name="Backup-Type-ScanJob-ScannerRoleArn"></a>
Especifica el ARN del rol de IAM del escáner que se utiliza para el trabajo de escaneo.  
Tipo: cadena  
Obligatorio: sí

 ** CompletionDate **   <a name="Backup-Type-ScanJob-CompletionDate"></a>
La fecha y la hora en que se completa un trabajo de escaneo, en formato Unix y en hora universal coordinada (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** ScanBaseRecoveryPointArn **   <a name="Backup-Type-ScanJob-ScanBaseRecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva el punto de recuperación base para el escaneo. Este campo se rellena cuando se realiza un trabajo de escaneo incremental.  
Tipo: cadena  
Requerido: no

 ** ScanId **   <a name="Backup-Type-ScanJob-ScanId"></a>
El ID de escaneo generado por el escáner de malware para el trabajo de escaneo correspondiente.  
Tipo: cadena  
Requerido: no

 ** ScanResult **   <a name="Backup-Type-ScanJob-ScanResult"></a>
Contiene la información de los resultados del análisis, incluido el estado de las amenazas detectadas durante el análisis.  
Tipo: objeto [ScanResultInfo](API_ScanResultInfo.md)  
Obligatorio: no

 ** State **   <a name="Backup-Type-ScanJob-State"></a>
El estado actual del trabajo de escaneo.  
Valores válidos: `CREATED` \$1 `RUNNING` \$1 `COMPLETED` \$1 `COMPLETED_WITH_ISSUES` \$1 `FAILED` \$1`CANCELED`.  
Tipo: cadena  
Valores válidos: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-ScanJob-StatusMessage"></a>
Un mensaje detallado que explica el estado del trabajo de escaneo.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ScanJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanJob) 

# ScanJobCreator
<a name="API_ScanJobCreator"></a>

Contiene información de identificación sobre la creación de un trabajo de escaneo, incluido el plan de respaldo y la regla que inició el escaneo.

## Contenido
<a name="API_ScanJobCreator_Contents"></a>

 ** BackupPlanArn **   <a name="Backup-Type-ScanJobCreator-BackupPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma única un plan de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.  
Tipo: cadena  
Obligatorio: sí

 ** BackupPlanId **   <a name="Backup-Type-ScanJobCreator-BackupPlanId"></a>
El ID del plan de copia de seguridad.  
Tipo: cadena  
Obligatorio: sí

 ** BackupPlanVersion **   <a name="Backup-Type-ScanJobCreator-BackupPlanVersion"></a>
Cadenas cifradas en UTF-8, Unicode, únicas, generadas aleatoriamente que tienen como máximo una longitud de 1024 bytes. La versión IDs no se puede editar.  
Tipo: cadena  
Obligatorio: sí

 ** BackupRuleId **   <a name="Backup-Type-ScanJobCreator-BackupRuleId"></a>
Identifica de forma exclusiva la regla de copia de seguridad que inició el trabajo de escaneo.  
Tipo: cadena  
Obligatorio: sí

## Véase también
<a name="API_ScanJobCreator_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanJobCreator) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanJobCreator) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanJobCreator) 

# ScanJobSummary
<a name="API_ScanJobSummary"></a>

Contiene información resumida sobre los trabajos de escaneo, incluidos los recuentos y los metadatos para un período de tiempo y criterios específicos.

## Contenido
<a name="API_ScanJobSummary_Contents"></a>

 ** AccountId **   <a name="Backup-Type-ScanJobSummary-AccountId"></a>
El ID de cuenta propietario de los trabajos de digitalización incluidos en este resumen.  
Tipo: cadena  
Patrón: `^[0-9]{12}$`   
Obligatorio: no

 ** Count **   <a name="Backup-Type-ScanJobSummary-Count"></a>
El número de trabajos de escaneo que cumplen los criterios especificados.  
Tipo: entero  
Obligatorio: no

 ** EndTime **   <a name="Backup-Type-ScanJobSummary-EndTime"></a>
El valor de hora en formato numérico de la hora de finalización de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** MalwareScanner **   <a name="Backup-Type-ScanJobSummary-MalwareScanner"></a>
Especifica el escáner de malware utilizado durante el trabajo de escaneo. Actualmente solo es compatible`GUARDDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY`   
Obligatorio: no

 ** Region **   <a name="Backup-Type-ScanJobSummary-Region"></a>
La AWS región en la que se ejecutaron los trabajos de escaneo.  
Tipo: cadena  
Requerido: no

 ** ResourceType **   <a name="Backup-Type-ScanJobSummary-ResourceType"></a>
El tipo de AWS recurso para los trabajos de escaneo incluidos en este resumen.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** ScanResultStatus **   <a name="Backup-Type-ScanJobSummary-ScanResultStatus"></a>
El estado de los resultados del escaneo para los trabajos de escaneo incluidos en este resumen.  
Valores válidos: `THREATS_FOUND` \$1 `NO_THREATS_FOUND`.  
Tipo: cadena  
Valores válidos: `NO_THREATS_FOUND | THREATS_FOUND`   
Obligatorio: no

 ** StartTime **   <a name="Backup-Type-ScanJobSummary-StartTime"></a>
El valor de hora en formato numérico de la hora de inicio de un trabajo.  
Este valor es la hora en formato Unix, Hora universal coordinada (UTC) y tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** State **   <a name="Backup-Type-ScanJobSummary-State"></a>
El estado de los trabajos de escaneo incluidos en este resumen.  
Valores válidos: `CREATED` \$1 `RUNNING` \$1 `COMPLETED` \$1 `COMPLETED_WITH_ISSUES` \$1 `FAILED` \$1`CANCELED`.  
Tipo: cadena  
Valores válidos: `CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY`   
Obligatorio: no

## Véase también
<a name="API_ScanJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanJobSummary) 

# ScanResult
<a name="API_ScanResult"></a>

Contiene los resultados de un análisis de seguridad, incluida la información del escáner, el estado del análisis y cualquier hallazgo descubierto.

## Contenido
<a name="API_ScanResult_Contents"></a>

 ** Findings **   <a name="Backup-Type-ScanResult-Findings"></a>
Conjunto de hallazgos descubiertos durante el escaneo.  
Tipo: matriz de cadenas  
Valores válidos: `MALWARE`   
Obligatorio: no

 ** LastScanTimestamp **   <a name="Backup-Type-ScanResult-LastScanTimestamp"></a>
La marca de tiempo en la que se realizó el último escaneo, en formato Unix y en hora universal coordinada (UTC).  
Tipo: marca temporal  
Obligatorio: no

 ** MalwareScanner **   <a name="Backup-Type-ScanResult-MalwareScanner"></a>
El escáner de malware utilizado para realizar el análisis. En la actualidad, solo se admite `GUARDDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY`   
Obligatorio: no

 ** ScanJobState **   <a name="Backup-Type-ScanResult-ScanJobState"></a>
El estado final del trabajo de escaneo.  
Valores válidos: `COMPLETED` \$1 `FAILED` \$1 `CANCELED`.  
Tipo: cadena  
Valores válidos: `COMPLETED | COMPLETED_WITH_ISSUES | FAILED | CANCELED`   
Obligatorio: no

## Véase también
<a name="API_ScanResult_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanResult) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanResult) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanResult) 

# ScanResultInfo
<a name="API_ScanResultInfo"></a>

Contiene información sobre los resultados de un trabajo de escaneo.

## Contenido
<a name="API_ScanResultInfo_Contents"></a>

 ** ScanResultStatus **   <a name="Backup-Type-ScanResultInfo-ScanResultStatus"></a>
El estado de los resultados del escaneo.  
Valores válidos: `THREATS_FOUND` \$1 `NO_THREATS_FOUND`.  
Tipo: cadena  
Valores válidos: `NO_THREATS_FOUND | THREATS_FOUND`   
Obligatorio: sí

## Véase también
<a name="API_ScanResultInfo_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanResultInfo) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanResultInfo) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanResultInfo) 

# ScanSetting
<a name="API_ScanSetting"></a>

Contiene los ajustes de configuración para el análisis de malware, incluidos el tipo de escáner, los tipos de recursos de destino y la función del escáner.

## Contenido
<a name="API_ScanSetting_Contents"></a>

 ** MalwareScanner **   <a name="Backup-Type-ScanSetting-MalwareScanner"></a>
El escáner de malware que se utilizará para escanear. En la actualidad, solo se admite `GUARDDUTY`.  
Tipo: cadena  
Valores válidos: `GUARDDUTY`   
Obligatorio: no

 ** ResourceTypes **   <a name="Backup-Type-ScanSetting-ResourceTypes"></a>
Una variedad de tipos de recursos para analizar en busca de malware.  
Tipo: matriz de cadenas  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatorio: no

 ** ScannerRoleArn **   <a name="Backup-Type-ScanSetting-ScannerRoleArn"></a>
El nombre de recurso de Amazon (ARN) de la función de IAM que utiliza el escáner para acceder a los recursos; por ejemplo,. `arn:aws:iam::123456789012:role/ScannerRole`  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ScanSetting_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanSetting) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanSetting) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanSetting) 

# ScheduledPlanExecutionMember
<a name="API_ScheduledPlanExecutionMember"></a>

Contiene información sobre la ejecución programada de un plan de copia de seguridad, incluida la hora de ejecución, el tipo de regla y el identificador de la regla asociado.

## Contenido
<a name="API_ScheduledPlanExecutionMember_Contents"></a>

 ** ExecutionTime **   <a name="Backup-Type-ScheduledPlanExecutionMember-ExecutionTime"></a>
Fecha y hora en que se ha programado la ejecución de la copia de seguridad, expresadas en formato Unix y horario universal coordinado (UTC). El valor tiene una precisión de milisegundos.  
Tipo: marca temporal  
Obligatorio: no

 ** RuleExecutionType **   <a name="Backup-Type-ScheduledPlanExecutionMember-RuleExecutionType"></a>
Es el tipo de ejecución de la regla de copia de seguridad. Los valores válidos son `CONTINUOUS` (recuperación en un momento dado), `SNAPSHOTS` (copias de seguridad de instantáneas) o `CONTINUOUS_AND_SNAPSHOTS` (ambos tipos combinados).  
Tipo: cadena  
Valores válidos: `CONTINUOUS | SNAPSHOTS | CONTINUOUS_AND_SNAPSHOTS`   
Obligatorio: no

 ** RuleId **   <a name="Backup-Type-ScheduledPlanExecutionMember-RuleId"></a>
Es el identificador unívoco de la regla de copia de seguridad que se ejecutará a la hora programada.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_ScheduledPlanExecutionMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScheduledPlanExecutionMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScheduledPlanExecutionMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScheduledPlanExecutionMember) 

# TieringConfiguration
<a name="API_TieringConfiguration"></a>

Contiene metadatos sobre una configuración de estratificación.

## Contenido
<a name="API_TieringConfiguration_Contents"></a>

 ** BackupVaultName **   <a name="Backup-Type-TieringConfiguration-BackupVaultName"></a>
El nombre del almacén de respaldo al que se aplica la configuración de estratificación. Se usa `*` para aplicarlo a todos los almacenes de respaldo.  
Tipo: cadena  
Patrón: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`   
Obligatorio: sí

 ** ResourceSelection **   <a name="Backup-Type-TieringConfiguration-ResourceSelection"></a>
Conjunto de objetos de selección de recursos que especifican qué recursos se incluyen en la configuración de organización por niveles y sus ajustes de organización por niveles.  
Tipo: matriz de objetos [ResourceSelection](API_ResourceSelection.md)  
Obligatorio: sí

 ** TieringConfigurationName **   <a name="Backup-Type-TieringConfiguration-TieringConfigurationName"></a>
El nombre exclusivo de la configuración de organización por niveles. No se puede cambiar después de la creación y debe constar únicamente de caracteres alfanuméricos y guiones bajos.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9_]{1,200}$`   
Obligatorio: sí

 ** CreationTime **   <a name="Backup-Type-TieringConfiguration-CreationTime"></a>
La fecha y la hora en que se creó una configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatorRequestId **   <a name="Backup-Type-TieringConfiguration-CreatorRequestId"></a>
Se trata de una cadena única que identifica la solicitud y permite volver a intentar las solicitudes fallidas sin correr el riesgo de ejecutar la operación dos veces.  
Tipo: cadena  
Requerido: no

 ** LastUpdatedTime **   <a name="Backup-Type-TieringConfiguration-LastUpdatedTime"></a>
Fecha y hora en que se actualizó una configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `LastUpdatedTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** TieringConfigurationArn **   <a name="Backup-Type-TieringConfiguration-TieringConfigurationArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva la configuración de organización en niveles.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_TieringConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfiguration) 

# TieringConfigurationInputForCreate
<a name="API_TieringConfigurationInputForCreate"></a>

Contiene metadatos sobre una configuración de organización por niveles para las operaciones de creación.

## Contenido
<a name="API_TieringConfigurationInputForCreate_Contents"></a>

 ** BackupVaultName **   <a name="Backup-Type-TieringConfigurationInputForCreate-BackupVaultName"></a>
El nombre del almacén de respaldo en el que se aplica la configuración de organización por niveles. Se usa `*` para aplicarlo a todos los almacenes de respaldo.  
Tipo: cadena  
Patrón: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`   
Obligatorio: sí

 ** ResourceSelection **   <a name="Backup-Type-TieringConfigurationInputForCreate-ResourceSelection"></a>
Conjunto de objetos de selección de recursos que especifican qué recursos se incluyen en la configuración de organización por niveles y sus ajustes de organización por niveles.  
Tipo: matriz de objetos [ResourceSelection](API_ResourceSelection.md)  
Obligatorio: sí

 ** TieringConfigurationName **   <a name="Backup-Type-TieringConfigurationInputForCreate-TieringConfigurationName"></a>
El nombre exclusivo de la configuración de organización por niveles. No se puede cambiar después de la creación y debe constar únicamente de caracteres alfanuméricos y guiones bajos.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9_]{1,200}$`   
Obligatorio: sí

## Véase también
<a name="API_TieringConfigurationInputForCreate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfigurationInputForCreate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfigurationInputForCreate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfigurationInputForCreate) 

# TieringConfigurationInputForUpdate
<a name="API_TieringConfigurationInputForUpdate"></a>

Contiene metadatos sobre una configuración por niveles para las operaciones de actualización.

## Contenido
<a name="API_TieringConfigurationInputForUpdate_Contents"></a>

 ** BackupVaultName **   <a name="Backup-Type-TieringConfigurationInputForUpdate-BackupVaultName"></a>
El nombre del almacén de respaldo en el que se aplica la configuración de organización por niveles. Se usa `*` para aplicarlo a todos los almacenes de respaldo.  
Tipo: cadena  
Patrón: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`   
Obligatorio: sí

 ** ResourceSelection **   <a name="Backup-Type-TieringConfigurationInputForUpdate-ResourceSelection"></a>
Conjunto de objetos de selección de recursos que especifican qué recursos se incluyen en la configuración de organización por niveles y sus ajustes de organización por niveles.  
Tipo: matriz de objetos [ResourceSelection](API_ResourceSelection.md)  
Obligatorio: sí

## Véase también
<a name="API_TieringConfigurationInputForUpdate_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfigurationInputForUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfigurationInputForUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfigurationInputForUpdate) 

# TieringConfigurationsListMember
<a name="API_TieringConfigurationsListMember"></a>

Contiene metadatos sobre una configuración de estratificación devuelta en una lista.

## Contenido
<a name="API_TieringConfigurationsListMember_Contents"></a>

 ** BackupVaultName **   <a name="Backup-Type-TieringConfigurationsListMember-BackupVaultName"></a>
El nombre del almacén de respaldo en el que se aplica la configuración de organización por niveles. Se usa `*` para aplicarlo a todos los almacenes de respaldo.  
Tipo: cadena  
Patrón: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`   
Obligatorio: no

 ** CreationTime **   <a name="Backup-Type-TieringConfigurationsListMember-CreationTime"></a>
Fecha y hora en que se creó una configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** LastUpdatedTime **   <a name="Backup-Type-TieringConfigurationsListMember-LastUpdatedTime"></a>
Fecha y hora en que se actualizó la configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `LastUpdatedTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal  
Obligatorio: no

 ** TieringConfigurationArn **   <a name="Backup-Type-TieringConfigurationsListMember-TieringConfigurationArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva la configuración de organización en niveles.  
Tipo: cadena  
Requerido: no

 ** TieringConfigurationName **   <a name="Backup-Type-TieringConfigurationsListMember-TieringConfigurationName"></a>
El nombre exclusivo de la configuración de estratificación.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9_]{1,200}$`   
Obligatorio: no

## Véase también
<a name="API_TieringConfigurationsListMember_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfigurationsListMember) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfigurationsListMember) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfigurationsListMember) 

# AWS Backup gateway
<a name="API_Types_AWS_Backup_Gateway"></a>

AWS Backup gateway admite los siguientes tipos de datos:
+  [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md) 
+  [Gateway](API_BGW_Gateway.md) 
+  [GatewayDetails](API_BGW_GatewayDetails.md) 
+  [Hypervisor](API_BGW_Hypervisor.md) 
+  [HypervisorDetails](API_BGW_HypervisorDetails.md) 
+  [MaintenanceStartTime](API_BGW_MaintenanceStartTime.md) 
+  [Tag](API_BGW_Tag.md) 
+  [VirtualMachine](API_BGW_VirtualMachine.md) 
+  [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md) 
+  [VmwareTag](API_BGW_VmwareTag.md) 
+  [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md) 

# BandwidthRateLimitInterval
<a name="API_BGW_BandwidthRateLimitInterval"></a>

Describe un intervalo de límite de velocidad de ancho de banda para una puerta de enlace. Un programa de límite de velocidad de ancho de banda consta de uno o más intervalos de límite de velocidad de ancho de banda. Un intervalo de límite de velocidad de ancho de banda define un período de tiempo en uno o más días de la semana, durante el cual se especifican los límites de velocidad de ancho de banda para la carga.

## Contenido
<a name="API_BGW_BandwidthRateLimitInterval_Contents"></a>

 ** DaysOfWeek **   <a name="Backup-Type-BGW_BandwidthRateLimitInterval-DaysOfWeek"></a>
El componente de días de la semana del intervalo límite de velocidad de ancho de banda, se representa como números ordinales del 0 al 6, donde 0 representa el domingo y 6 representa el sábado.  
Tipo: Matriz de números enteros  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 7 elementos.  
Rango válido: valor mínimo de 0. Valor máximo de 6.  
Obligatorio: sí

 ** EndHourOfDay **   <a name="Backup-Type-BGW_BandwidthRateLimitInterval-EndHourOfDay"></a>
La hora del día en que finaliza el intervalo de límite de velocidad de ancho de banda.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 23.  
Obligatorio: sí

 ** EndMinuteOfHour **   <a name="Backup-Type-BGW_BandwidthRateLimitInterval-EndMinuteOfHour"></a>
El minuto de la hora en que finaliza el intervalo de límite de velocidad de ancho de banda.  
El intervalo de límite de velocidad de ancho de banda finaliza al final del minuto. Para finalizar un intervalo al final de una hora, utilice el valor`59`.
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 59.  
Obligatorio: sí

 ** StartHourOfDay **   <a name="Backup-Type-BGW_BandwidthRateLimitInterval-StartHourOfDay"></a>
La hora del día en que comienza el intervalo de límite de velocidad de ancho de banda.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 23.  
Obligatorio: sí

 ** StartMinuteOfHour **   <a name="Backup-Type-BGW_BandwidthRateLimitInterval-StartMinuteOfHour"></a>
El minuto de la hora en que comienza el intervalo de límite de velocidad de ancho de banda. El intervalo comienza al principio de ese minuto. Para comenzar un intervalo exactamente al principio de la hora, utilice el valor `0`.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 59.  
Obligatorio: sí

 ** AverageUploadRateLimitInBitsPerSec **   <a name="Backup-Type-BGW_BandwidthRateLimitInterval-AverageUploadRateLimitInBitsPerSec"></a>
El componente de límite de velocidad de carga promedio del intervalo de límite de velocidad de ancho de banda, en bits por segundo. Este campo no aparece en la respuesta si no se ha establecido el límite de velocidad de carga.  
Tipo: largo  
Rango válido: valor mínimo de 51 200. Valor máximo de 8 000 000 000 000  
Obligatorio: no

## Véase también
<a name="API_BGW_BandwidthRateLimitInterval_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/BandwidthRateLimitInterval) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/BandwidthRateLimitInterval) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/BandwidthRateLimitInterval) 

# Gateway
<a name="API_BGW_Gateway"></a>

Una puerta de enlace es un dispositivo de AWS Backup Gateway que se ejecuta en la red del cliente para proporcionar una conectividad perfecta al almacenamiento de copias de seguridad en la nube de AWS.

## Contenido
<a name="API_BGW_Gateway_Contents"></a>

 ** GatewayArn **   <a name="Backup-Type-BGW_Gateway-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la operación `ListGateways` para devolver una lista de puertas de enlace para su cuenta y Región de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

 ** GatewayDisplayName **   <a name="Backup-Type-BGW_Gateway-GatewayDisplayName"></a>
El nombre de visualización de la puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** GatewayType **   <a name="Backup-Type-BGW_Gateway-GatewayType"></a>
El tipo de puerta de enlace.  
Tipo: cadena  
Valores válidos: `BACKUP_VM`   
Obligatorio: no

 ** HypervisorId **   <a name="Backup-Type-BGW_Gateway-HypervisorId"></a>
El ID de hipervisor de la puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Obligatorio: no

 ** LastSeenTime **   <a name="Backup-Type-BGW_Gateway-LastSeenTime"></a>
La última vez que la puerta de enlace de AWS Backup se comunicó con la puerta de enlace, en formato Unix y en hora UTC.  
Tipo: marca temporal  
Obligatorio: no

## Véase también
<a name="API_BGW_Gateway_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/Gateway) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/Gateway) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/Gateway) 

# GatewayDetails
<a name="API_BGW_GatewayDetails"></a>

Los detalles de la puerta de enlace.

## Contenido
<a name="API_BGW_GatewayDetails_Contents"></a>

 ** DeprecationDate **   <a name="Backup-Type-BGW_GatewayDetails-DeprecationDate"></a>
Fecha después de la cual esta puerta de enlace no recibirá actualizaciones de software para nuevas funciones y correcciones de errores.  
Tipo: marca temporal  
Obligatorio: no

 ** GatewayArn **   <a name="Backup-Type-BGW_GatewayDetails-GatewayArn"></a>
El nombre de recurso de Amazon (ARN) de la puerta de enlace. Utilice la operación `ListGateways` para devolver una lista de puertas de enlace para su cuenta y Región de AWS.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 180 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

 ** GatewayDisplayName **   <a name="Backup-Type-BGW_GatewayDetails-GatewayDisplayName"></a>
El nombre de visualización de la puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** GatewayType **   <a name="Backup-Type-BGW_GatewayDetails-GatewayType"></a>
El tipo de puerta de enlace.  
Tipo: cadena  
Valores válidos: `BACKUP_VM`   
Obligatorio: no

 ** HypervisorId **   <a name="Backup-Type-BGW_GatewayDetails-HypervisorId"></a>
El ID de hipervisor de la puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Obligatorio: no

 ** LastSeenTime **   <a name="Backup-Type-BGW_GatewayDetails-LastSeenTime"></a>
Detalles que muestran la última vez que AWS Backup Gateway se comunicó con la nube, en formato Unix y en horario UTC.  
Tipo: marca temporal  
Obligatorio: no

 ** MaintenanceStartTime **   <a name="Backup-Type-BGW_GatewayDetails-MaintenanceStartTime"></a>
Devuelve la hora de inicio del mantenimiento semanal de la puerta de enlace, incluido el día y la hora de la semana. Tenga en cuenta que los valores están expresados en términos de la zona horaria de la puerta de enlace. Puede ser semanal o mensual.  
Tipo: objeto [MaintenanceStartTime](API_BGW_MaintenanceStartTime.md)  
Obligatorio: no

 ** NextUpdateAvailabilityTime **   <a name="Backup-Type-BGW_GatewayDetails-NextUpdateAvailabilityTime"></a>
Detalles que muestran la hora de disponibilidad de la próxima actualización de la puerta de enlace.  
Tipo: marca temporal  
Obligatorio: no

 ** SoftwareVersion **   <a name="Backup-Type-BGW_GatewayDetails-SoftwareVersion"></a>
El número de versión del software que se ejecuta en el dispositivo de puerta de enlace.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** VpcEndpoint **   <a name="Backup-Type-BGW_GatewayDetails-VpcEndpoint"></a>
El nombre de DNS del punto de conexión de la nube privada virtual (VPC) que utiliza la puerta de enlace para conectarse a la nube como puerta de enlace de copia de seguridad.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.  
Obligatorio: no

## Véase también
<a name="API_BGW_GatewayDetails_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GatewayDetails) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GatewayDetails) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GatewayDetails) 

# Hypervisor
<a name="API_BGW_Hypervisor"></a>

Representa los permisos del hipervisor a los que se conectará la puerta de enlace.

Un hipervisor es un hardware, software o firmware que crea y administra máquinas virtuales y les asigna recursos.

## Contenido
<a name="API_BGW_Hypervisor_Contents"></a>

 ** Host **   <a name="Backup-Type-BGW_Hypervisor-Host"></a>
El host del servidor del hipervisor. Puede ser una dirección IP o un nombre de dominio completo (FQDN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 128.  
Patrón: `.+`   
Obligatorio: no

 ** HypervisorArn **   <a name="Backup-Type-BGW_Hypervisor-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

 ** KmsKeyArn **   <a name="Backup-Type-BGW_Hypervisor-KmsKeyArn"></a>
El nombre de recurso de Amazon (ARN) de la clave de AWS Key Management Service (KMS) que se utiliza para cifrar el hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`   
Obligatorio: no

 ** Name **   <a name="Backup-Type-BGW_Hypervisor-Name"></a>
El nombre del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** State **   <a name="Backup-Type-BGW_Hypervisor-State"></a>
El estado del hipervisor.  
Tipo: cadena  
Valores válidos: `PENDING | ONLINE | OFFLINE | ERROR`   
Obligatorio: no

## Véase también
<a name="API_BGW_Hypervisor_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/Hypervisor) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/Hypervisor) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/Hypervisor) 

# HypervisorDetails
<a name="API_BGW_HypervisorDetails"></a>

Estos son los detalles del hipervisor especificado. Un hipervisor es un hardware, software o firmware que crea y administra máquinas virtuales y les asigna recursos.

## Contenido
<a name="API_BGW_HypervisorDetails_Contents"></a>

 ** Host **   <a name="Backup-Type-BGW_HypervisorDetails-Host"></a>
El host del servidor del hipervisor. Puede ser una dirección IP o un nombre de dominio completo (FQDN).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 128.  
Patrón: `.+`   
Obligatorio: no

 ** HypervisorArn **   <a name="Backup-Type-BGW_HypervisorDetails-HypervisorArn"></a>
El nombre de recurso de Amazon (ARN) del hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

 ** KmsKeyArn **   <a name="Backup-Type-BGW_HypervisorDetails-KmsKeyArn"></a>
El nombre de recurso de Amazon (ARN) de la clave de AWS KMS (KMS) que se utiliza para cifrar el hipervisor.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`   
Obligatorio: no

 ** LastSuccessfulMetadataSyncTime **   <a name="Backup-Type-BGW_HypervisorDetails-LastSuccessfulMetadataSyncTime"></a>
Este es el momento en que se produjo la última sincronización correcta de los metadatos.  
Tipo: marca temporal  
Obligatorio: no

 ** LatestMetadataSyncStatus **   <a name="Backup-Type-BGW_HypervisorDetails-LatestMetadataSyncStatus"></a>
Este es el estado más reciente de la sincronización de metadatos indicada.  
Tipo: cadena  
Valores válidos: `CREATED | RUNNING | FAILED | PARTIALLY_FAILED | SUCCEEDED`   
Obligatorio: no

 ** LatestMetadataSyncStatusMessage **   <a name="Backup-Type-BGW_HypervisorDetails-LatestMetadataSyncStatusMessage"></a>
Este es el estado más reciente de la sincronización de metadatos indicada.  
Tipo: cadena  
Requerido: no

 ** LogGroupArn **   <a name="Backup-Type-BGW_HypervisorDetails-LogGroupArn"></a>
El nombre de recurso de Amazon (ARN) de grupo de puertas de enlace dentro del registro solicitado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0 caracteres. La longitud máxima es de 2048 caracteres.  
Patrón: `$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*`   
Obligatorio: no

 ** Name **   <a name="Backup-Type-BGW_HypervisorDetails-Name"></a>
Este es el nombre del hipervisor especificado.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** State **   <a name="Backup-Type-BGW_HypervisorDetails-State"></a>
Este es el estado actual del hipervisor especificado.  
Los estados posibles son `PENDING`, `ONLINE`, `OFFLINE` o `ERROR`.  
Tipo: cadena  
Valores válidos: `PENDING | ONLINE | OFFLINE | ERROR`   
Obligatorio: no

## Véase también
<a name="API_BGW_HypervisorDetails_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/HypervisorDetails) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/HypervisorDetails) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/HypervisorDetails) 

# MaintenanceStartTime
<a name="API_BGW_MaintenanceStartTime"></a>

Es la hora de inicio del mantenimiento semanal de la puerta de enlace, incluido el día y la hora de la semana. Tenga en cuenta que los valores están expresados en términos de la zona horaria de la puerta de enlace. Puede ser semanal o mensual.

## Contenido
<a name="API_BGW_MaintenanceStartTime_Contents"></a>

 ** HourOfDay **   <a name="Backup-Type-BGW_MaintenanceStartTime-HourOfDay"></a>
El componente de horas de la hora de inicio del mantenimiento se representa como *hh*, donde *hh* es la hora (de 0 a 23). La hora del día corresponde a la zona horaria de la puerta de enlace.  
Tipo: número entero  
Rango válido: valor mínimo de 0. Valor máximo de 23.  
Obligatorio: sí

 ** MinuteOfHour **   <a name="Backup-Type-BGW_MaintenanceStartTime-MinuteOfHour"></a>
El componente de minutos de la hora de inicio del mantenimiento se representa como *mm*, donde *mm* es el minuto (de 0 a 59). El minuto de la hora corresponde a la zona horaria de la puerta de enlace.  
Tipo: número entero  
Rango válido: valor mínimo de 0. Valor máximo de 59.  
Obligatorio: sí

 ** DayOfMonth **   <a name="Backup-Type-BGW_MaintenanceStartTime-DayOfMonth"></a>
El componente del día del mes de la hora de inicio del mantenimiento representado como un número ordinal de 1 a 28, donde 1 representa el primer día del mes y 28 representa el último día del mes.  
Tipo: número entero  
Rango válido: valor mínimo de 1. Valor máximo de 31.  
Obligatorio: no

 ** DayOfWeek **   <a name="Backup-Type-BGW_MaintenanceStartTime-DayOfWeek"></a>
Número ordinal entre 0 y 6 que representa el día de la semana, donde 0 representa el domingo y 6 representa el sábado. El día de la semana corresponde a la zona horaria de la puerta de enlace.  
Tipo: número entero  
Rango válido: valor mínimo de 0. Valor máximo de 6.  
Obligatorio: no

## Véase también
<a name="API_BGW_MaintenanceStartTime_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/MaintenanceStartTime) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/MaintenanceStartTime) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/MaintenanceStartTime) 

# Tag
<a name="API_BGW_Tag"></a>

Un par clave-valor que puede utilizar para administrar, filtrar y buscar sus recursos. Los caracteres permitidos son los números y letras en UTF-8, además de los siguientes caracteres especiales: \$1 - = . Los caracteres de espaciado \$1 : /. no se permiten en los valores de las etiquetas.

## Contenido
<a name="API_BGW_Tag_Contents"></a>

 ** Key **   <a name="Backup-Type-BGW_Tag-Key"></a>
La parte de clave del par clave-valor de la etiqueta. La clave no pueden comenzar por `aws:`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`   
Obligatorio: sí

 ** Value **   <a name="Backup-Type-BGW_Tag-Value"></a>
La parte de valor del par clave-valor de la etiqueta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `[^\x00]*`   
Obligatorio: sí

## Véase también
<a name="API_BGW_Tag_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/Tag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/Tag) 

# VirtualMachine
<a name="API_BGW_VirtualMachine"></a>

Una máquina virtual que se encuentra en un hipervisor.

## Contenido
<a name="API_BGW_VirtualMachine_Contents"></a>

 ** HostName **   <a name="Backup-Type-BGW_VirtualMachine-HostName"></a>
El nombre del host de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** HypervisorId **   <a name="Backup-Type-BGW_VirtualMachine-HypervisorId"></a>
El ID del hipervisor de la máquina virtual.  
Tipo: cadena  
Requerido: no

 ** LastBackupDate **   <a name="Backup-Type-BGW_VirtualMachine-LastBackupDate"></a>
La fecha más reciente en la que se realizó una copia de seguridad de una máquina virtual, en formato Unix y en hora UTC.  
Tipo: marca temporal  
Obligatorio: no

 ** Name **   <a name="Backup-Type-BGW_VirtualMachine-Name"></a>
Nombre de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** Path **   <a name="Backup-Type-BGW_VirtualMachine-Path"></a>
La ruta de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 4096 caracteres.  
Patrón: `[^\x00]+`   
Obligatorio: no

 ** ResourceArn **   <a name="Backup-Type-BGW_VirtualMachine-ResourceArn"></a>
El nombre de recurso de Amazon (ARN) de la máquina virtual. Por ejemplo, `arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

## Véase también
<a name="API_BGW_VirtualMachine_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VirtualMachine) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VirtualMachine) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VirtualMachine) 

# VirtualMachineDetails
<a name="API_BGW_VirtualMachineDetails"></a>

Sus objetos `VirtualMachine`, ordenados por sus nombres de recurso de Amazon (ARN).

## Contenido
<a name="API_BGW_VirtualMachineDetails_Contents"></a>

 ** HostName **   <a name="Backup-Type-BGW_VirtualMachineDetails-HostName"></a>
El nombre del host de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** HypervisorId **   <a name="Backup-Type-BGW_VirtualMachineDetails-HypervisorId"></a>
El ID del hipervisor de la máquina virtual.  
Tipo: cadena  
Requerido: no

 ** LastBackupDate **   <a name="Backup-Type-BGW_VirtualMachineDetails-LastBackupDate"></a>
La fecha más reciente en la que se realizó una copia de seguridad de una máquina virtual, en formato Unix y en hora UTC.  
Tipo: marca temporal  
Obligatorio: no

 ** Name **   <a name="Backup-Type-BGW_VirtualMachineDetails-Name"></a>
Nombre de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.  
Patrón: `[a-zA-Z0-9-]*`   
Obligatorio: no

 ** Path **   <a name="Backup-Type-BGW_VirtualMachineDetails-Path"></a>
La ruta de la máquina virtual.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 4096 caracteres.  
Patrón: `[^\x00]+`   
Obligatorio: no

 ** ResourceArn **   <a name="Backup-Type-BGW_VirtualMachineDetails-ResourceArn"></a>
El nombre de recurso de Amazon (ARN) de la máquina virtual. Por ejemplo, `arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.  
Patrón: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obligatorio: no

 ** VmwareTags **   <a name="Backup-Type-BGW_VirtualMachineDetails-VmwareTags"></a>
Estos son los detalles de las etiquetas de VMware asociadas a la máquina virtual especificada.  
Tipo: matriz de objetos [VmwareTag](API_BGW_VmwareTag.md)  
Obligatorio: no

## Véase también
<a name="API_BGW_VirtualMachineDetails_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VirtualMachineDetails) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VirtualMachineDetails) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VirtualMachineDetails) 

# VmwareTag
<a name="API_BGW_VmwareTag"></a>

Una etiqueta de VMware es una etiqueta asociada a una máquina virtual específica. Una [etiqueta](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_Tag.html) es un par clave-valor que puede utilizar para administrar, filtrar y buscar sus recursos.

El contenido de las etiquetas de VMware puede corresponderse con las etiquetas de AWS.

## Contenido
<a name="API_BGW_VmwareTag_Contents"></a>

 ** VmwareCategory **   <a name="Backup-Type-BGW_VmwareTag-VmwareCategory"></a>
Esta es la categoría de VMware.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 80.  
Obligatorio: no

 ** VmwareTagDescription **   <a name="Backup-Type-BGW_VmwareTag-VmwareTagDescription"></a>
Es una descripción definida por el usuario de una etiqueta de VMware.  
Tipo: cadena  
Requerido: no

 ** VmwareTagName **   <a name="Backup-Type-BGW_VmwareTag-VmwareTagName"></a>
Es el nombre definido por el usuario de una etiqueta de VMware.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 80.  
Obligatorio: no

## Véase también
<a name="API_BGW_VmwareTag_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VmwareTag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VmwareTag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VmwareTag) 

# VmwareToAwsTagMapping
<a name="API_BGW_VmwareToAwsTagMapping"></a>

Esto muestra la asignación de VMware etiquetas a las AWS etiquetas correspondientes.

## Contenido
<a name="API_BGW_VmwareToAwsTagMapping_Contents"></a>

 ** AwsTagKey **   <a name="Backup-Type-BGW_VmwareToAwsTagMapping-AwsTagKey"></a>
La parte clave del par clave-valor de la AWS etiqueta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`   
Obligatorio: sí

 ** AwsTagValue **   <a name="Backup-Type-BGW_VmwareToAwsTagMapping-AwsTagValue"></a>
La parte de valores del par clave-valor de la AWS etiqueta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `[^\x00]*`   
Obligatorio: sí

 ** VmwareCategory **   <a name="Backup-Type-BGW_VmwareToAwsTagMapping-VmwareCategory"></a>
Es la categoría de. VMware  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 80.  
Obligatorio: sí

 ** VmwareTagName **   <a name="Backup-Type-BGW_VmwareToAwsTagMapping-VmwareTagName"></a>
Es el nombre de una VMware etiqueta definido por el usuario.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 80.  
Obligatorio: sí

## Véase también
<a name="API_BGW_VmwareToAwsTagMapping_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VmwareToAwsTagMapping) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VmwareToAwsTagMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VmwareToAwsTagMapping) 

# Búsqueda de AWS Backup
<a name="API_Types_AWS_Backup_Search"></a>

Los siguientes tipos de datos son compatibles con Búsqueda de AWS Backup:
+  [BackupCreationTimeFilter](API_BKS_BackupCreationTimeFilter.md) 
+  [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md) 
+  [EBSItemFilter](API_BKS_EBSItemFilter.md) 
+  [EBSResultItem](API_BKS_EBSResultItem.md) 
+  [ExportJobSummary](API_BKS_ExportJobSummary.md) 
+  [ExportSpecification](API_BKS_ExportSpecification.md) 
+  [ItemFilters](API_BKS_ItemFilters.md) 
+  [LongCondition](API_BKS_LongCondition.md) 
+  [ResultItem](API_BKS_ResultItem.md) 
+  [S3ExportSpecification](API_BKS_S3ExportSpecification.md) 
+  [S3ItemFilter](API_BKS_S3ItemFilter.md) 
+  [S3ResultItem](API_BKS_S3ResultItem.md) 
+  [SearchJobBackupsResult](API_BKS_SearchJobBackupsResult.md) 
+  [SearchJobSummary](API_BKS_SearchJobSummary.md) 
+  [SearchScope](API_BKS_SearchScope.md) 
+  [SearchScopeSummary](API_BKS_SearchScopeSummary.md) 
+  [StringCondition](API_BKS_StringCondition.md) 
+  [TimeCondition](API_BKS_TimeCondition.md) 

# BackupCreationTimeFilter
<a name="API_BKS_BackupCreationTimeFilter"></a>

Esto filtra por puntos de recuperación dentro de las CreatedBefore marcas de tiempo CreatedAfter y.

## Contenido
<a name="API_BKS_BackupCreationTimeFilter_Contents"></a>

 ** CreatedAfter **   <a name="Backup-Type-BKS_BackupCreationTimeFilter-CreatedAfter"></a>
Esta marca temporal solo incluye los puntos de recuperación que se crean después del tiempo especificado.  
Tipo: marca temporal  
Obligatorio: no

 ** CreatedBefore **   <a name="Backup-Type-BKS_BackupCreationTimeFilter-CreatedBefore"></a>
Esta marca temporal solo incluye los puntos de recuperación que se crean antes del tiempo especificado.  
Tipo: marca temporal  
Obligatorio: no

## Véase también
<a name="API_BKS_BackupCreationTimeFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/BackupCreationTimeFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/BackupCreationTimeFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/BackupCreationTimeFilter) 

# CurrentSearchProgress
<a name="API_BKS_CurrentSearchProgress"></a>

Contiene los resultados de información obtenidos de un trabajo de búsqueda que puede que no se haya completado.

## Contenido
<a name="API_BKS_CurrentSearchProgress_Contents"></a>

 ** ItemsMatchedCount **   <a name="Backup-Type-BKS_CurrentSearchProgress-ItemsMatchedCount"></a>
Este número es la suma de todos los elementos que coinciden con los filtros de elementos de un trabajo de búsqueda en curso.  
Tipo: largo  
Obligatorio: no

 ** ItemsScannedCount **   <a name="Backup-Type-BKS_CurrentSearchProgress-ItemsScannedCount"></a>
Este número es la suma de todos los elementos que se han escaneado hasta ahora durante un trabajo de búsqueda.  
Tipo: largo  
Obligatorio: no

 ** RecoveryPointsScannedCount **   <a name="Backup-Type-BKS_CurrentSearchProgress-RecoveryPointsScannedCount"></a>
Este número es la suma de todas las copias de seguridad que se han escaneado hasta ahora durante un trabajo de búsqueda.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_BKS_CurrentSearchProgress_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/CurrentSearchProgress) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/CurrentSearchProgress) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/CurrentSearchProgress) 

# EBSItemFilter
<a name="API_BKS_EBSItemFilter"></a>

Contiene matrices de objetos, que pueden incluir objetos de condiciones de CreationTimes tiempo, objetos de FilePaths cadenas, objetos de condiciones de LastModificationTimes tiempo, 

## Contenido
<a name="API_BKS_EBSItemFilter_Contents"></a>

 ** CreationTimes **   <a name="Backup-Type-BKS_EBSItemFilter-CreationTimes"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados devolverán solo los elementos que coincidan.  
Si se incluye más de uno, los resultados devolverán todos los elementos que coincidan con alguno de los valores incluidos.  
Tipo: Matriz de [TimeCondition](API_BKS_TimeCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** FilePaths **   <a name="Backup-Type-BKS_EBSItemFilter-FilePaths"></a>
Puede incluir entre uno y diez valores.  
Si se incluye una ruta de archivo, los resultados devolverán solo los elementos que coincidan con la ruta de archivo.  
Si se incluye más de una ruta de archivo, los resultados devolverán todos los elementos que coincidan con alguna ruta de archivo.  
Tipo: Matriz de [StringCondition](API_BKS_StringCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** LastModificationTimes **   <a name="Backup-Type-BKS_EBSItemFilter-LastModificationTimes"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados devolverán solo los elementos que coincidan.  
Si se incluye más de uno, los resultados devolverán todos los elementos que coincidan con alguno de los valores incluidos.  
Tipo: Matriz de [TimeCondition](API_BKS_TimeCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** Sizes **   <a name="Backup-Type-BKS_EBSItemFilter-Sizes"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados devolverán solo los elementos que coincidan.  
Si se incluye más de uno, los resultados devolverán todos los elementos que coincidan con alguno de los valores incluidos.  
Tipo: Matriz de [LongCondition](API_BKS_LongCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

## Véase también
<a name="API_BKS_EBSItemFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/EBSItemFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/EBSItemFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/EBSItemFilter) 

# EBSResultItem
<a name="API_BKS_EBSResultItem"></a>

Estos son los elementos devueltos en los resultados de una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.

## Contenido
<a name="API_BKS_EBSResultItem_Contents"></a>

 ** BackupResourceArn **   <a name="Backup-Type-BKS_EBSResultItem-BackupResourceArn"></a>
Se trata de uno o más elementos de los resultados que coinciden con los valores del nombre de recurso de Amazon (ARN) de los puntos de recuperación devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: cadena  
Requerido: no

 ** BackupVaultName **   <a name="Backup-Type-BKS_EBSResultItem-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad.  
Tipo: cadena  
Requerido: no

 ** CreationTime **   <a name="Backup-Type-BKS_EBSResultItem-CreationTime"></a>
Se trata de uno o más elementos de los resultados que coinciden con los valores de los tiempos de creación devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: marca temporal  
Obligatorio: no

 ** FilePath **   <a name="Backup-Type-BKS_EBSResultItem-FilePath"></a>
Se trata de uno o más elementos de los resultados que coinciden con las rutas de archivo devueltas por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: cadena  
Requerido: no

 ** FileSize **   <a name="Backup-Type-BKS_EBSResultItem-FileSize"></a>
Se trata de uno o más elementos de los resultados que coinciden con los valores de los tamaños de archivo devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: largo  
Obligatorio: no

 ** FileSystemIdentifier **   <a name="Backup-Type-BKS_EBSResultItem-FileSystemIdentifier"></a>
Se trata de uno o más elementos de los resultados que coinciden con los valores de los sistemas de archivo devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: cadena  
Requerido: no

 ** LastModifiedTime **   <a name="Backup-Type-BKS_EBSResultItem-LastModifiedTime"></a>
Se trata de uno o más elementos de los resultados que coinciden con los valores de Hora de la última modificación devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: marca temporal  
Obligatorio: no

 ** SourceResourceArn **   <a name="Backup-Type-BKS_EBSResultItem-SourceResourceArn"></a>
Se trata de uno o más elementos de los resultados que coinciden con los valores del nombre de recurso de Amazon (ARN) de los recursos de origen devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon EBS.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BKS_EBSResultItem_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/EBSResultItem) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/EBSResultItem) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/EBSResultItem) 

# ExportJobSummary
<a name="API_BKS_ExportJobSummary"></a>

Es el resumen de un trabajo de exportación.

## Contenido
<a name="API_BKS_ExportJobSummary_Contents"></a>

 ** ExportJobIdentifier **   <a name="Backup-Type-BKS_ExportJobSummary-ExportJobIdentifier"></a>
Esta es la cadena unívoca que identifica un trabajo de exportación específico.  
Tipo: cadena  
Obligatorio: sí

 ** CompletionTime **   <a name="Backup-Type-BKS_ExportJobSummary-CompletionTime"></a>
Es una marca temporal de la hora en que se completó el trabajo de exportación.  
Tipo: marca temporal  
Obligatorio: no

 ** CreationTime **   <a name="Backup-Type-BKS_ExportJobSummary-CreationTime"></a>
Es una marca temporal de la hora en que se creó el trabajo de exportación.  
Tipo: marca temporal  
Obligatorio: no

 ** ExportJobArn **   <a name="Backup-Type-BKS_ExportJobSummary-ExportJobArn"></a>
Este es el ARN (nombre de recurso de Amazon) exclusivo que pertenece al nuevo trabajo de exportación.  
Tipo: cadena  
Requerido: no

 ** SearchJobArn **   <a name="Backup-Type-BKS_ExportJobSummary-SearchJobArn"></a>
Cadena única que identifica el nombre de recurso de Amazon (ARN) del trabajo de búsqueda especificado.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-BKS_ExportJobSummary-Status"></a>
El estado del trabajo de exportación puede ser uno de los siguientes:  
 `CREATED`; `RUNNING``FAILED`; o`COMPLETED`.  
Tipo: cadena  
Valores válidos: `RUNNING | FAILED | COMPLETED`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-BKS_ExportJobSummary-StatusMessage"></a>
Un mensaje de estado es una cadena que se devuelve para un trabajo de exportación.  
El mensaje de estado se incluye para cualquier estado que no sea `COMPLETED` sin problemas.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BKS_ExportJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ExportJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ExportJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ExportJobSummary) 

# ExportSpecification
<a name="API_BKS_ExportSpecification"></a>

Contiene el objeto de especificación de exportación.

## Contenido
<a name="API_BKS_ExportSpecification_Contents"></a>

**importante**  
Este tipo de datos es una unión, por lo que solo se puede especificar uno de los siguientes miembros cuando se usa o se devuelve.

 ** s3ExportSpecification **   <a name="Backup-Type-BKS_ExportSpecification-s3ExportSpecification"></a>
Especifica el bucket de Amazon S3 de destino para el trabajo de exportación. Y, si se incluye, también especifica el prefijo de destino.  
Tipo: objeto [S3ExportSpecification](API_BKS_S3ExportSpecification.md)  
Obligatorio: no

## Véase también
<a name="API_BKS_ExportSpecification_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ExportSpecification) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ExportSpecification) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ExportSpecification) 

# ItemFilters
<a name="API_BKS_ItemFilters"></a>

Son los filtros de elementos que representan todas las propiedades de los elementos de entrada especificados al crear la búsqueda.

Contiene EBSItem filtros o S3 ItemFilters

## Contenido
<a name="API_BKS_ItemFilters_Contents"></a>

 ** EBSItemFilters **   <a name="Backup-Type-BKS_ItemFilters-EBSItemFilters"></a>
Esta matriz puede contener objetos CreationTimes FilePaths, LastModificationTimes, o Sizes.  
Tipo: matriz de objetos [EBSItemFilter](API_BKS_EBSItemFilter.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.  
Obligatorio: no

 ** S3ItemFilters **   <a name="Backup-Type-BKS_ItemFilters-S3ItemFilters"></a>
Esta matriz puede contener CreationTimes ETags, ObjectKeys, tamaños u VersionIds objetos.  
Tipo: matriz de objetos [S3ItemFilter](API_BKS_S3ItemFilter.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.  
Obligatorio: no

## Véase también
<a name="API_BKS_ItemFilters_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ItemFilters) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ItemFilters) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ItemFilters) 

# LongCondition
<a name="API_BKS_LongCondition"></a>

La condición larga contiene un `Value` y, opcionalmente, puede contener un `Operator`.

## Contenido
<a name="API_BKS_LongCondition_Contents"></a>

 ** Value **   <a name="Backup-Type-BKS_LongCondition-Value"></a>
Es el valor de un elemento incluido en uno de los filtros de elementos de búsqueda.  
Tipo: largo  
Obligatorio: sí

 ** Operator **   <a name="Backup-Type-BKS_LongCondition-Operator"></a>
Es una cadena que define los valores que se devolverán.  
Si se incluye, evite las combinaciones de operadores que devuelvan todos los valores posibles. Por ejemplo, si se incluyen `EQUALS_TO` y `NOT_EQUALS_TO` con el valor `4`, se devolverán todos los valores.  
Tipo: cadena  
Valores válidos: `EQUALS_TO | NOT_EQUALS_TO | LESS_THAN_EQUAL_TO | GREATER_THAN_EQUAL_TO`   
Obligatorio: no

## Véase también
<a name="API_BKS_LongCondition_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/LongCondition) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/LongCondition) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/LongCondition) 

# ResultItem
<a name="API_BKS_ResultItem"></a>

Se trata de un objeto que representa el elemento devuelto en los resultados de la búsqueda de un tipo de recurso específico.

## Contenido
<a name="API_BKS_ResultItem_Contents"></a>

**importante**  
Este tipo de datos es una unión, por lo que solo se puede especificar uno de los siguientes miembros cuando se usa o se devuelve.

 ** EBSResultItem **   <a name="Backup-Type-BKS_ResultItem-EBSResultItem"></a>
Estos son los elementos devueltos en los resultados de una búsqueda en Amazon EBS.  
Tipo: objeto [EBSResultItem](API_BKS_EBSResultItem.md)  
Obligatorio: no

 ** S3ResultItem **   <a name="Backup-Type-BKS_ResultItem-S3ResultItem"></a>
Estos son los elementos devueltos en los resultados de una búsqueda en Amazon S3.  
Tipo: objeto [S3ResultItem](API_BKS_S3ResultItem.md)  
Obligatorio: no

## Véase también
<a name="API_BKS_ResultItem_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ResultItem) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ResultItem) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ResultItem) 

# S3ExportSpecification
<a name="API_BKS_S3ExportSpecification"></a>

Esta especificación contiene una cadena obligatoria del bucket de destino; si lo desea, puede incluir el prefijo de destino.

## Contenido
<a name="API_BKS_S3ExportSpecification_Contents"></a>

 ** DestinationBucket **   <a name="Backup-Type-BKS_S3ExportSpecification-DestinationBucket"></a>
Especifica el bucket de Amazon S3 de destino para el trabajo de exportación.  
Tipo: cadena  
Obligatorio: sí

 ** DestinationPrefix **   <a name="Backup-Type-BKS_S3ExportSpecification-DestinationPrefix"></a>
Especifica el prefijo del bucket de Amazon S3 de destino para el trabajo de exportación.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BKS_S3ExportSpecification_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/S3ExportSpecification) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/S3ExportSpecification) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/S3ExportSpecification) 

# S3ItemFilter
<a name="API_BKS_S3ItemFilter"></a>

Contiene matrices de objetos, que pueden incluir tamaños ObjectKeys CreationTimes VersionIds, etiquetas and/or .

## Contenido
<a name="API_BKS_S3ItemFilter_Contents"></a>

 ** CreationTimes **   <a name="Backup-Type-BKS_S3ItemFilter-CreationTimes"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados solo devolverán los elementos que coincidan con el valor.  
Si se incluye más de un valor, los resultados devolverán todos los elementos que coincidan con alguno de los valores.  
Tipo: Matriz de [TimeCondition](API_BKS_TimeCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** ETags **   <a name="Backup-Type-BKS_S3ItemFilter-ETags"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados solo devolverán los elementos que coincidan con el valor.  
Si se incluye más de un valor, los resultados devolverán todos los elementos que coincidan con alguno de los valores.  
Tipo: Matriz de [StringCondition](API_BKS_StringCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** ObjectKeys **   <a name="Backup-Type-BKS_S3ItemFilter-ObjectKeys"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados solo devolverán los elementos que coincidan con el valor.  
Si se incluye más de un valor, los resultados devolverán todos los elementos que coincidan con alguno de los valores.  
Tipo: Matriz de [StringCondition](API_BKS_StringCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** Sizes **   <a name="Backup-Type-BKS_S3ItemFilter-Sizes"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados solo devolverán los elementos que coincidan con el valor.  
Si se incluye más de un valor, los resultados devolverán todos los elementos que coincidan con alguno de los valores.  
Tipo: Matriz de [LongCondition](API_BKS_LongCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

 ** VersionIds **   <a name="Backup-Type-BKS_S3ItemFilter-VersionIds"></a>
Puede incluir entre uno y diez valores.  
Si se incluye uno, los resultados solo devolverán los elementos que coincidan con el valor.  
Si se incluye más de un valor, los resultados devolverán todos los elementos que coincidan con alguno de los valores.  
Tipo: Matriz de [StringCondition](API_BKS_StringCondition.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.  
Obligatorio: no

## Véase también
<a name="API_BKS_S3ItemFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/S3ItemFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/S3ItemFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/S3ItemFilter) 

# S3ResultItem
<a name="API_BKS_S3ResultItem"></a>

Estos son los elementos devueltos en los resultados de una búsqueda en los metadatos de las copias de seguridad de Amazon S3.

## Contenido
<a name="API_BKS_S3ResultItem_Contents"></a>

 ** BackupResourceArn **   <a name="Backup-Type-BKS_S3ResultItem-BackupResourceArn"></a>
Se trata de elementos de los resultados que coinciden con la entrada del nombre de recurso de Amazon (ARN) de los puntos de recuperación devueltos por una búsqueda en los metadatos de las copias de seguridad de Amazon S3.  
Tipo: cadena  
Requerido: no

 ** BackupVaultName **   <a name="Backup-Type-BKS_S3ResultItem-BackupVaultName"></a>
Es el nombre del almacén de copias de seguridad.  
Tipo: cadena  
Requerido: no

 ** CreationTime **   <a name="Backup-Type-BKS_S3ResultItem-CreationTime"></a>
Se trata de uno o más elementos de los resultados devueltos que coinciden con los valores de la entrada del tiempo de creación de los elementos en una búsqueda en los metadatos de las copias de seguridad de Amazon S3.  
Tipo: marca temporal  
Obligatorio: no

 ** ETag **   <a name="Backup-Type-BKS_S3ResultItem-ETag"></a>
Se trata de uno o más elementos de los resultados devueltos que coinciden con los valores ETags introducidos durante una búsqueda en los metadatos de las copias de seguridad de Amazon S3.  
Tipo: cadena  
Requerido: no

 ** ObjectKey **   <a name="Backup-Type-BKS_S3ResultItem-ObjectKey"></a>
Se trata de uno o más elementos devueltos en los resultados de una búsqueda en los metadatos de las copias de seguridad de Amazon S3 que coinciden con los valores indicados en la clave del objeto.  
Tipo: cadena  
Requerido: no

 ** ObjectSize **   <a name="Backup-Type-BKS_S3ResultItem-ObjectSize"></a>
Se trata de los elementos de los resultados devueltos que coinciden con los valores de la entrada del tamaño de un objeto en una búsqueda en los metadatos de las copias de seguridad de Amazon S3.  
Tipo: largo  
Obligatorio: no

 ** SourceResourceArn **   <a name="Backup-Type-BKS_S3ResultItem-SourceResourceArn"></a>
Se trata de los elementos de los resultados devueltos que coinciden con la entrada del nombre de recurso de Amazon (ARN) de origen en una búsqueda en los metadatos de las copias de seguridad de Amazon S3.  
Tipo: cadena  
Requerido: no

 ** VersionId **   <a name="Backup-Type-BKS_S3ResultItem-VersionId"></a>
Se trata de uno o más elementos de los resultados devueltos que coinciden con los valores de la IDs entrada de la versión durante una búsqueda en los metadatos de las copias de seguridad de Amazon S3.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BKS_S3ResultItem_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/S3ResultItem) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/S3ResultItem) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/S3ResultItem) 

# SearchJobBackupsResult
<a name="API_BKS_SearchJobBackupsResult"></a>

Contiene la información sobre los puntos de recuperación devueltos en los resultados de un trabajo de búsqueda.

## Contenido
<a name="API_BKS_SearchJobBackupsResult_Contents"></a>

 ** BackupCreationTime **   <a name="Backup-Type-BKS_SearchJobBackupsResult-BackupCreationTime"></a>
Es la hora de creación de la copia de seguridad (punto de recuperación).  
Tipo: marca temporal  
Obligatorio: no

 ** BackupResourceArn **   <a name="Backup-Type-BKS_SearchJobBackupsResult-BackupResourceArn"></a>
Es el nombre de recurso de Amazon (ARN) que identifica de forma unívoca los recursos de copia de seguridad.  
Tipo: cadena  
Requerido: no

 ** IndexCreationTime **   <a name="Backup-Type-BKS_SearchJobBackupsResult-IndexCreationTime"></a>
Es la hora de creación del índice de copias de seguridad.  
Tipo: marca temporal  
Obligatorio: no

 ** ResourceType **   <a name="Backup-Type-BKS_SearchJobBackupsResult-ResourceType"></a>
Este es el tipo de recurso de la búsqueda.  
Tipo: cadena  
Valores válidos: `S3 | EBS`   
Obligatorio: no

 ** SourceResourceArn **   <a name="Backup-Type-BKS_SearchJobBackupsResult-SourceResourceArn"></a>
Es el nombre de recurso de Amazon (ARN) que identifica de forma unívoca los recursos de origen.  
Tipo: cadena  
Requerido: no

 ** Status **   <a name="Backup-Type-BKS_SearchJobBackupsResult-Status"></a>
Este es el estado del resultado de la copia de seguridad del trabajo de búsqueda.  
Tipo: cadena  
Valores válidos: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-BKS_SearchJobBackupsResult-StatusMessage"></a>
Este es el mensaje de estado que se incluye con los resultados.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BKS_SearchJobBackupsResult_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchJobBackupsResult) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchJobBackupsResult) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchJobBackupsResult) 

# SearchJobSummary
<a name="API_BKS_SearchJobSummary"></a>

Esta es la información relacionada con un trabajo de búsqueda.

## Contenido
<a name="API_BKS_SearchJobSummary_Contents"></a>

 ** CompletionTime **   <a name="Backup-Type-BKS_SearchJobSummary-CompletionTime"></a>
Este es el tiempo de finalización del trabajo de búsqueda.  
Tipo: marca temporal  
Obligatorio: no

 ** CreationTime **   <a name="Backup-Type-BKS_SearchJobSummary-CreationTime"></a>
Este es el tiempo de creación del trabajo de búsqueda.  
Tipo: marca temporal  
Obligatorio: no

 ** Name **   <a name="Backup-Type-BKS_SearchJobSummary-Name"></a>
Este es el nombre del trabajo de búsqueda.  
Tipo: cadena  
Requerido: no

 ** SearchJobArn **   <a name="Backup-Type-BKS_SearchJobSummary-SearchJobArn"></a>
Cadena única que identifica el nombre de recurso de Amazon (ARN) del trabajo de búsqueda especificado.  
Tipo: cadena  
Requerido: no

 ** SearchJobIdentifier **   <a name="Backup-Type-BKS_SearchJobSummary-SearchJobIdentifier"></a>
Cadena unívoca que especifica el trabajo de búsqueda.  
Tipo: cadena  
Requerido: no

 ** SearchScopeSummary **   <a name="Backup-Type-BKS_SearchJobSummary-SearchScopeSummary"></a>
Devuelve un resumen del ámbito del trabajo de búsqueda especificado, que incluye:   
+ TotalBackupsToScanCount, el número de puntos de recuperación devueltos por la búsqueda.
+ TotalItemsToScanCount, el número de elementos devueltos por la búsqueda.
Tipo: objeto [SearchScopeSummary](API_BKS_SearchScopeSummary.md)  
Obligatorio: no

 ** Status **   <a name="Backup-Type-BKS_SearchJobSummary-Status"></a>
Este es el estado del trabajo de búsqueda.  
Tipo: cadena  
Valores válidos: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`   
Obligatorio: no

 ** StatusMessage **   <a name="Backup-Type-BKS_SearchJobSummary-StatusMessage"></a>
Se devolverá un mensaje de estado para cada trabajo de búsqueda con un estado `ERRORED` o un estado de trabajos `COMPLETED` con problemas.  
Por ejemplo, un mensaje puede indicar que una búsqueda contiene puntos de recuperación que no se han podido analizar debido a un problema con permisos.  
Tipo: cadena  
Requerido: no

## Véase también
<a name="API_BKS_SearchJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchJobSummary) 

# SearchScope
<a name="API_BKS_SearchScope"></a>

Ámbito de búsqueda que incluye todas las propiedades de copia de seguridad introducidas en una búsqueda.

## Contenido
<a name="API_BKS_SearchScope_Contents"></a>

 ** BackupResourceTypes **   <a name="Backup-Type-BKS_SearchScope-BackupResourceTypes"></a>
Tipos de recursos incluidos en una búsqueda.  
Los tipos de recursos elegibles son S3 y EBS.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Valores válidos: `S3 | EBS`   
Obligatorio: sí

 ** BackupResourceArns **   <a name="Backup-Type-BKS_SearchScope-BackupResourceArns"></a>
Es el nombre de recurso de Amazon (ARN) que identifica de forma unívoca los recursos de copia de seguridad.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** BackupResourceCreationTime **   <a name="Backup-Type-BKS_SearchScope-BackupResourceCreationTime"></a>
Es el momento en que se creó el recurso de copia de seguridad.  
Tipo: objeto [BackupCreationTimeFilter](API_BKS_BackupCreationTimeFilter.md)  
Obligatorio: no

 ** BackupResourceTags **   <a name="Backup-Type-BKS_SearchScope-BackupResourceTags"></a>
Se trata de una o más etiquetas en la copia de seguridad (punto de recuperación).  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** SourceResourceArns **   <a name="Backup-Type-BKS_SearchScope-SourceResourceArns"></a>
Es el nombre de recurso de Amazon (ARN) que identifica de forma unívoca los recursos de origen.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

## Véase también
<a name="API_BKS_SearchScope_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchScope) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchScope) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchScope) 

# SearchScopeSummary
<a name="API_BKS_SearchScopeSummary"></a>

Resumen del ámbito del trabajo de búsqueda especificado, que incluye: 
+ TotalBackupsToScanCount, el número de puntos de recuperación devueltos por la búsqueda.
+ TotalItemsToScanCount, el número de elementos devueltos por la búsqueda.

## Contenido
<a name="API_BKS_SearchScopeSummary_Contents"></a>

 ** TotalItemsToScanCount **   <a name="Backup-Type-BKS_SearchScopeSummary-TotalItemsToScanCount"></a>
Es el recuento del número total de elementos que se escaneará en una búsqueda.  
Tipo: largo  
Obligatorio: no

 ** TotalRecoveryPointsToScanCount **   <a name="Backup-Type-BKS_SearchScopeSummary-TotalRecoveryPointsToScanCount"></a>
Es el recuento del número total de copias de seguridad que se escaneará en una búsqueda.  
Tipo: entero  
Obligatorio: no

## Véase también
<a name="API_BKS_SearchScopeSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchScopeSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchScopeSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchScopeSummary) 

# StringCondition
<a name="API_BKS_StringCondition"></a>

Contiene el valor de la cadena y puede incluir uno o más operadores.

## Contenido
<a name="API_BKS_StringCondition_Contents"></a>

 ** Value **   <a name="Backup-Type-BKS_StringCondition-Value"></a>
Es el valor de la cadena.  
Tipo: cadena  
Obligatorio: sí

 ** Operator **   <a name="Backup-Type-BKS_StringCondition-Operator"></a>
Es una cadena que define los valores que se devolverán.  
Si se incluye, evite las combinaciones de operadores que devuelvan todos los valores posibles. Por ejemplo, si se incluyen `EQUALS_TO` y `NOT_EQUALS_TO` con el valor `4`, se devolverán todos los valores.  
Tipo: cadena  
Valores válidos: `EQUALS_TO | NOT_EQUALS_TO | CONTAINS | DOES_NOT_CONTAIN | BEGINS_WITH | ENDS_WITH | DOES_NOT_BEGIN_WITH | DOES_NOT_END_WITH`   
Obligatorio: no

## Véase también
<a name="API_BKS_StringCondition_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StringCondition) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StringCondition) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StringCondition) 

# TimeCondition
<a name="API_BKS_TimeCondition"></a>

Una condición de tiempo indica la hora de creación, la hora de la última modificación u otra hora.

## Contenido
<a name="API_BKS_TimeCondition_Contents"></a>

 ** Value **   <a name="Backup-Type-BKS_TimeCondition-Value"></a>
Es el valor de la marca temporal de la condición de tiempo.  
Tipo: marca temporal  
Obligatorio: sí

 ** Operator **   <a name="Backup-Type-BKS_TimeCondition-Operator"></a>
Es una cadena que define los valores que se devolverán.  
Si se incluye, evite las combinaciones de operadores que devuelvan todos los valores posibles. Por ejemplo, si se incluyen `EQUALS_TO` y `NOT_EQUALS_TO` con el valor `4`, se devolverán todos los valores.  
Tipo: cadena  
Valores válidos: `EQUALS_TO | NOT_EQUALS_TO | LESS_THAN_EQUAL_TO | GREATER_THAN_EQUAL_TO`   
Obligatorio: no

## Véase también
<a name="API_BKS_TimeCondition_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/TimeCondition) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/TimeCondition) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/TimeCondition) 

# Parámetros comunes
<a name="CommonParameters"></a>

La siguiente lista contiene los parámetros que utilizan todas las acciones para firmar solicitudes de Signature Version 4 con una cadena de consulta. Los parámetros específicos de acción se enumeran en el tema correspondiente a la acción. Para obtener más información sobre la versión 4 de Signature, consulte [Firmar solicitudes de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
El algoritmo de hash que utilizó para crear la solicitud de firma.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Valores válidos: `AWS4-HMAC-SHA256`   
Obligatorio: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
El valor del ámbito de la credencial, que es una cadena que incluye la clave de acceso, la fecha, la región a la que se dirige, el servicio que solicita y una cadena de terminación (“aws4\$1request”). El valor se expresa en el siguiente formato: *access\$1key*/*AAAAMMDD*/*region*/*service*/aws4\$1request.  
Para obtener más información, consulte [Crear una solicitud de AWS API firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la Guía del *usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La fecha utilizada para crear la firma. El formato debe ser ISO 8601 formato básico (AAAAMMDD‘T’HHMMSS‘Z’). Por ejemplo, la siguiente fecha y hora es un X-Amz-Date valor válido:`20120325T120000Z`.  
Condición: X-Amz-Date es opcional en todas las solicitudes; puede utilizarse para anular la fecha empleada para firmar solicitudes. Si el encabezado de fecha se especifica en el formato básico ISO 8601, no X-Amz-Date es obligatorio. Cuando X-Amz-Date se usa, siempre anula el valor del encabezado de fecha. Para obtener más información, consulte [Elementos de la firma de una solicitud de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) en la Guía del *usuario de IAM*.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
El token de seguridad temporal que se obtuvo mediante una llamada a AWS Security Token Service (AWS STS). Para obtener una lista de servicios compatibles con las credenciales de seguridad temporales de AWS STS, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la *Guía del usuario de IAM*.  
Condición: si utilizas credenciales de seguridad temporales de AWS STS, debes incluir el token de seguridad.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica la firma codificada hexadecimal que se calculó a partir de la cadena que se va a firmar y la clave de firma derivada.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos los encabezados HTTP que se incluyeron como parte de la solicitud canónica. Para obtener más información sobre cómo especificar encabezados firmados, consulte [Crear una solicitud de AWS API firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la Guía del *usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

# Tipos de errores comunes
<a name="CommonErrors"></a>

En esta sección se enumeran los tipos de errores más comunes que puede devolver este AWS servicio. No todos los servicios devuelven todos los tipos de errores que se indican aquí. En el caso de los errores específicos de una acción de la API de este servicio, consulte el tema de dicha acción de la API.

 **AccessDeniedException**   <a name="CommonErrors-AccessDeniedException"></a>
No tiene permiso para realizar esta acción. Compruebe que su política de IAM incluya los permisos necesarios.  
Código de estado HTTP: 403

 **ExpiredTokenException**   <a name="CommonErrors-ExpiredTokenException"></a>
El token de seguridad incluido en la solicitud ha caducado. Solicita un nuevo token de seguridad e inténtalo de nuevo.  
Código de estado HTTP: 403

 **IncompleteSignature**   <a name="CommonErrors-IncompleteSignature"></a>
La firma de la solicitud no cumple con los AWS estándares. Comprueba que utilizas AWS credenciales válidas y que tu solicitud tiene el formato correcto. Si utilizas un SDK, asegúrate de que esté actualizado.  
Código de estado HTTP: 403

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
La solicitud no se puede procesar en este momento debido a un problema interno del servidor. Inténtelo de nuevo más tarde. Si el problema persiste, ponte en contacto con AWS Support.  
Código de estado HTTP: 500

 **MalformedHttpRequestException**   <a name="CommonErrors-MalformedHttpRequestException"></a>
No se puede procesar el cuerpo de la solicitud. Esto suele ocurrir cuando el cuerpo de la solicitud no se puede descomprimir mediante el algoritmo de codificación de contenido especificado. Compruebe que el encabezado de codificación del contenido coincide con el formato de compresión utilizado.  
Código de estado HTTP: 400

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
No tienes permisos para realizar esta acción. Compruebe que su política de IAM incluya los permisos necesarios.  
Código de estado HTTP: 401

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
Tu AWS cuenta necesita una suscripción a este servicio. Comprueba que has activado el servicio en tu cuenta.  
Código de estado HTTP: 403

 **RequestAbortedException**   <a name="CommonErrors-RequestAbortedException"></a>
La solicitud se canceló antes de que se pudiera devolver una respuesta. Esto suele ocurrir cuando el cliente cierra la conexión.  
Código de estado HTTP: 400

 **RequestEntityTooLargeException**   <a name="CommonErrors-RequestEntityTooLargeException"></a>
La entidad de solicitud es demasiado grande. Reduce el tamaño del cuerpo de la solicitud e inténtalo de nuevo.  
Código de estado HTTP: 413

 **RequestTimeoutException**   <a name="CommonErrors-RequestTimeoutException"></a>
Se agotó el tiempo de espera de la solicitud. El servidor no recibió la solicitud completa en el plazo previsto. Inténtelo de nuevo.  
Código de estado HTTP: 408

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
El servicio no está disponible temporalmente. Inténtelo de nuevo más tarde.  
Código de estado HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
Tu porcentaje de solicitudes es demasiado alto. Reintentan AWS SDKs automáticamente las solicitudes que reciben esta excepción. Reduzca la frecuencia de las solicitudes.  
Código de estado HTTP: 400

 **UnknownOperationException**   <a name="CommonErrors-UnknownOperationException"></a>
No se reconoce la acción o la operación. Comprueba que el nombre de la acción está escrito correctamente y que es compatible con la versión de API que utilizas.  
Código de estado HTTP: 404

 **UnrecognizedClientException**   <a name="CommonErrors-UnrecognizedClientException"></a>
El identificador de clave de AWS acceso o certificado X.509 que has proporcionado no existe en nuestros registros. Compruebe que utiliza credenciales válidas y que no hayan caducado.  
Código de estado HTTP: 403

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
La entrada no cumple con el formato o las restricciones requeridos. Compruebe que se incluyen todos los parámetros necesarios y que los valores son válidos.  
Código de estado HTTP: 400