Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# AWS Backup API
Oltre a utilizzare la console, puoi utilizzare le azioni e i tipi di dati dell' AWS Backup API per configurare e gestire a livello di codice AWS Backup e le relative risorse. In questa sezione vengono descritte le azioni e tipi di dati di AWS Backup . Contiene il riferimento API per. AWS Backup
**AWS Backup API**
+ [AWS Backup Operazioni](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_Operations.html)
+ [AWS Backup Tipi di dati](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_Types.html)
# Azioni
Le seguenti azioni sono supportate da 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)
Le seguenti azioni sono supportate da 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)
Le seguenti azioni sono supportate da Ricerca 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
Le seguenti azioni sono supportate da 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
Associa un team di approvazione MPA a un archivio di backup.
## Sintassi della richiesta
```
PUT /backup-vaults/backupVaultName/mpaApprovalTeam HTTP/1.1
Content-type: application/json
{
"MpaApprovalTeamArn": "string",
"RequesterComment": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **
Il nome dell'archivio di backup da associare al team di approvazione MPA.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [MpaApprovalTeamArn](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **
L'Amazon Resource Name (ARN) del team di approvazione MPA da associare al backup vault.
Tipo: stringa
Obbligatorio: sì
** [RequesterComment](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **
Un commento fornito dal richiedente che spiega la richiesta di associazione.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/AssociateBackupVaultMpaApprovalTeam)
# CancelLegalHold
Rimuove il blocco legale specificato su un punto di ripristino. Questa azione può essere eseguita solo da un utente con autorizzazioni sufficienti.
## Sintassi della richiesta
```
DELETE /legal-holds/legalHoldId?cancelDescription=CancelDescription&retainRecordInDays=RetainRecordInDays HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [CancelDescription](#API_CancelLegalHold_RequestSyntax) **
Una stringa che descrive il motivo della rimozione del blocco a fini legali.
Obbligatorio: sì
** [legalHoldId](#API_CancelLegalHold_RequestSyntax) **
L'ID del blocco a fini legali.
Obbligatorio: sì
** [RetainRecordInDays](#API_CancelLegalHold_RequestSyntax) **
L'importo intero, in giorni, dopo il quale rimuovere la conservazione legale.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 201
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 201 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidResourceStateException **
AWS Backup sta già eseguendo un'azione su questo punto di ripristino. Non può eseguire l'azione richiesta fino al termine della prima azione. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CancelLegalHold)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CancelLegalHold)
# CreateBackupPlan
Crea un piano di backup utilizzando il nome del piano di backup e le regole di backup. Un piano di backup è un documento che contiene informazioni che vengono AWS Backup utilizzate per pianificare attività che creano punti di ripristino per le risorse.
Se chiami `CreateBackupPlan` con un piano già esistente, ricevi un'eccezione `AlreadyExistsException`.
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) **
Il corpo di un piano di backup. Include un `BackupPlanName` e uno o più set di `Rules`.
Tipo: oggetto [BackupPlanInput](API_BackupPlanInput.md)
Obbligatorio: sì
** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) **
I tag da assegnare al piano di backup.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) **
Identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Se la richiesta include un `CreatorRequestId` che corrisponde a un piano di backup esistente, tale piano viene restituito. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string" : "string"
},
"ResourceType": "string"
}
],
"BackupPlanArn": "string",
"BackupPlanId": "string",
"CreationDate": number,
"VersionId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AdvancedBackupSettings](#API_CreateBackupPlan_ResponseSyntax) **
Le impostazioni per un tipo di risorsa. Questa opzione è disponibile solo per i processi di backup di Windows Volume Shadow Copy Service (VSS).
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)
** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
Tipo: String
** [BackupPlanId](#API_CreateBackupPlan_ResponseSyntax) **
L'ID del piano di backup.
Tipo: String
** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) **
La data e l'ora di creazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [VersionId](#API_CreateBackupPlan_ResponseSyntax) **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. e non possono essere modificati.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupPlan)
# CreateBackupSelection
Crea un documento JSON che specifica un set di risorse da assegnare a un piano di backup. Per esempi, consulta [Assegnazione di risorse a livello di codice](https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json).
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_CreateBackupSelection_RequestSyntax) **
L'ID del piano di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupSelection](#API_CreateBackupSelection_RequestSyntax) **
Il corpo di una richiesta di assegnazione di un set di risorse a un piano di backup.
Tipo: oggetto [BackupSelection](API_BackupSelection.md)
Obbligatorio: sì
** [CreatorRequestId](#API_CreateBackupSelection_RequestSyntax) **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPlanId": "string",
"CreationDate": number,
"SelectionId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanId](#API_CreateBackupSelection_ResponseSyntax) **
L'ID del piano di backup.
Tipo: String
** [CreationDate](#API_CreateBackupSelection_ResponseSyntax) **
La data e l'ora di creazione di una selezione di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [SelectionId](#API_CreateBackupSelection_ResponseSyntax) **
Identifica in modo univoco il corpo di una richiesta per assegnare un set di risorse a un piano di backup.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupSelection)
# CreateBackupVault
Crea un container logico in cui vengono archiviati i backup. Una richiesta `CreateBackupVault` include un nome, facoltativamente uno o più tag delle risorse, una chiave di crittografia e un ID della richiesta.
**Nota**
Non includere i dati riservati, ad esempio i numeri di passaporto, nel nome di un vault di backup.
## Sintassi della richiesta
```
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"EncryptionKeyArn": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_CreateBackupVault_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati. Consistono in lettere, numeri e trattini.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupVaultTags](#API_CreateBackupVault_RequestSyntax) **
I tag da assegnare al vault di backup.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [CreatorRequestId](#API_CreateBackupVault_RequestSyntax) **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** [EncryptionKeyArn](#API_CreateBackupVault_RequestSyntax) **
La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_CreateBackupVault_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [BackupVaultName](#API_CreateBackupVault_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati. Consistono di minuscole, numeri e trattini.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [CreationDate](#API_CreateBackupVault_ResponseSyntax) **
La data e l'ora di creazione di un vault di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupVault)
# CreateFramework
Crea un framework con uno o più controlli. Un framework è una raccolta di controlli che è possibile utilizzare per valutare le procedure di backup. Utilizzando controlli personalizzabili predefiniti per definire le policy, è possibile valutare se le procedure di backup sono conformi alle policy e quali risorse non sono ancora conformi.
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [FrameworkControls](#API_CreateFramework_RequestSyntax) **
I controlli che compongono il framework. Ogni controllo nell'elenco dispone di nome, parametri di input e ambito.
Tipo: matrice di oggetti [FrameworkControl](API_FrameworkControl.md)
Obbligatorio: sì
** [FrameworkDescription](#API_CreateFramework_RequestSyntax) **
Una descrizione facoltativa del framework, con un massimo di 1.024 caratteri.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
Obbligatorio: no
** [FrameworkName](#API_CreateFramework_RequestSyntax) **
Il nome univoco del framework. Il nome deve essere compreso tra 1 e 256 caratteri, deve iniziare con una lettera ed essere costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
** [FrameworkTags](#API_CreateFramework_RequestSyntax) **
I tag da assegnare al framework.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [IdempotencyToken](#API_CreateFramework_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `CreateFrameworkInput`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"FrameworkArn": "string",
"FrameworkName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [FrameworkArn](#API_CreateFramework_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [FrameworkName](#API_CreateFramework_ResponseSyntax) **
Il nome univoco del framework. Il nome deve essere compreso tra 1 e 256 caratteri, deve iniziare con una lettera ed essere costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateFramework)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateFramework)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateFramework)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateFramework)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateFramework)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateFramework)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateFramework)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateFramework)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateFramework)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateFramework)
# CreateLegalHold
Crea un blocco legale su un punto di ripristino (backup). Un blocco a fini legali è una limitazione alla modifica o eliminazione di un backup fino a quando un utente autorizzato non annulla il blocco a fini legali. Qualsiasi azione volta a eliminare o dissociare un punto di ripristino non andrà a buon fine e genererà un errore se sul punto di ripristino sono presenti uno o più blocchi a fini legali attivi.
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Description](#API_CreateLegalHold_RequestSyntax) **
La descrizione della conservazione legale.
Tipo: stringa
Obbligatorio: sì
** [IdempotencyToken](#API_CreateLegalHold_RequestSyntax) **
Questa è una stringa scelta dall'utente utilizzata per distinguere tra chiamate altrimenti identiche. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [RecoveryPointSelection](#API_CreateLegalHold_RequestSyntax) **
I criteri per assegnare un insieme di risorse, ad esempio i tipi di risorse o gli archivi di backup.
Tipo: oggetto [RecoveryPointSelection](API_RecoveryPointSelection.md)
Obbligatorio: no
** [Tags](#API_CreateLegalHold_RequestSyntax) **
Tag opzionali da includere. Un tag è una coppia chiave-valore che puoi utilizzare per gestire, filtrare e cercare le risorse. I caratteri consentiti includono lettere UTF-8, numeri, spazi e i caratteri seguenti: \$1 - = . \$1 : /.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [Title](#API_CreateLegalHold_RequestSyntax) **
Il titolo della custodia legale.
Tipo: stringa
Obbligatorio: sì
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationDate](#API_CreateLegalHold_ResponseSyntax) **
L'ora in cui è stata creata la custodia legale.
Tipo: Timestamp
** [Description](#API_CreateLegalHold_ResponseSyntax) **
La descrizione del blocco legale.
Tipo: String
** [LegalHoldArn](#API_CreateLegalHold_ResponseSyntax) **
L'Amazon Resource Name (ARN) della custodia legale.
Tipo: String
** [LegalHoldId](#API_CreateLegalHold_ResponseSyntax) **
L'ID del blocco a fini legali.
Tipo: String
** [RecoveryPointSelection](#API_CreateLegalHold_ResponseSyntax) **
I criteri da assegnare a un insieme di risorse, ad esempio i tipi di risorse o gli archivi di backup.
Tipo: oggetto [RecoveryPointSelection](API_RecoveryPointSelection.md)
** [Status](#API_CreateLegalHold_ResponseSyntax) **
Lo stato della custodia legale.
Tipo: String
Valori validi: `CREATING | ACTIVE | CANCELING | CANCELED`
** [Title](#API_CreateLegalHold_ResponseSyntax) **
Il titolo della custodia legale.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateLegalHold)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateLegalHold)
# CreateLogicallyAirGappedBackupVault
Crea un contenitore logico in cui è possibile copiare i backup.
Questa richiesta include un nome, la regione, il numero massimo di giorni di conservazione, il numero minimo di giorni di conservazione e, facoltativamente, può includere tag e un ID richiesta dell'autore.
**Nota**
Non includere i dati riservati, ad esempio i numeri di passaporto, nel nome di un vault di backup.
## Sintassi della richiesta
```
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
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup con isolamento logico air gap sono identificati da nomi univoci per l'account utilizzato per crearli e per la regione in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupVaultTags](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **
I tag da assegnare al vault.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [CreatorRequestId](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **
L'ID della richiesta di creazione.
Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** [EncryptionKeyArn](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **
L'ARN della chiave KMS gestita dal cliente da utilizzare per crittografare il vault di backup logicamente isolato. Se non specificato, il vault verrà crittografato con una chiave di AWS proprietà gestita da Backup AWS .
▬Tipo: stringa
Obbligatorio: no
** [MaxRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **
Il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino.
Tipo: long
Obbligatorio: sì
** [MinRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **
Questa impostazione specifica il periodo di conservazione minimo durante il quale il vault mantiene i punti di ripristino.
Il valore minimo accettato è 7 giorni.
Tipo: long
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **
L'ARN (Amazon Resource Name) del vault.
Tipo: String
** [BackupVaultName](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup con isolamento logico air gap sono identificati da nomi univoci per l'account utilizzato per crearli e per la regione in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [CreationDate](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **
La data e l'ora di creazione del vault.
Questo valore è in formato Unix, ora Coordinated Universal Time (UTC) ed è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [VaultState](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **
Lo stato attuale del vault.
Tipo: String
Valori validi: `CREATING | AVAILABLE | FAILED`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateLogicallyAirGappedBackupVault)
# CreateReportPlan
Crea un piano di report. Un piano di segnalazione è un documento che contiene informazioni sul contenuto del rapporto e su dove AWS Backup verrà consegnato.
Se chiami `CreateReportPlan` con un piano già esistente, ricevi un'eccezione `AlreadyExistsException`.
## Sintassi della richiesta
```
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"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `CreateReportPlanInput`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [ReportDeliveryChannel](#API_CreateReportPlan_RequestSyntax) **
Una struttura contenente informazioni su dove e come consegnare i report, in particolare il nome del bucket Amazon S3, il prefisso della chiave S3 e i formati dei report.
Tipo: oggetto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)
Obbligatorio: sì
** [ReportPlanDescription](#API_CreateReportPlan_RequestSyntax) **
Una descrizione facoltativa del piano di report, con un massimo di 1.024 caratteri.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
Obbligatorio: no
** [ReportPlanName](#API_CreateReportPlan_RequestSyntax) **
Il nome univoco del piano di report. Il nome deve essere compreso tra 1 e 256 caratteri, deve iniziare con una lettera ed essere costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
** [ReportPlanTags](#API_CreateReportPlan_RequestSyntax) **
I tag da assegnare al piano di report.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **
Identifica il modello di report per il report. I report vengono creati utilizzando un modello di report. I modelli di report sono:
`RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT `
Se il modello di report è `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, questa risorsa API descrive anche la copertura del report Regioni AWS e i framework.
Tipo: oggetto [ReportSetting](API_ReportSetting.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"ReportPlanArn": "string",
"ReportPlanName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_CreateReportPlan_ResponseSyntax) **
La data e l'ora di creazione di un vault di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [ReportPlanArn](#API_CreateReportPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [ReportPlanName](#API_CreateReportPlan_ResponseSyntax) **
Il nome univoco del piano di report.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateReportPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateReportPlan)
# CreateRestoreAccessBackupVault
Crea un archivio di backup per l'accesso al ripristino che fornisce l'accesso temporaneo ai punti di ripristino in un archivio di backup con accesso logico, soggetto all'approvazione MPA.
## Sintassi della richiesta
```
PUT /restore-access-backup-vaults HTTP/1.1
Content-type: application/json
{
"BackupVaultName": "string",
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"RequesterComment": "string",
"SourceBackupVaultArn": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupVaultName](#API_CreateRestoreAccessBackupVault_RequestSyntax) **
Il nome del deposito di backup da associare a un team di approvazione MPA.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: no
** [BackupVaultTags](#API_CreateRestoreAccessBackupVault_RequestSyntax) **
Tag opzionali da assegnare al repository di backup per l'accesso al ripristino.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [CreatorRequestId](#API_CreateRestoreAccessBackupVault_RequestSyntax) **
Una stringa univoca che identifica la richiesta e consente di ritentare le richieste non riuscite senza il rischio di eseguire l'operazione due volte.
▬Tipo: stringa
Obbligatorio: no
** [RequesterComment](#API_CreateRestoreAccessBackupVault_RequestSyntax) **
Un commento che spiega il motivo della richiesta di ripristino dell'accesso al backup vault.
▬Tipo: stringa
Obbligatorio: no
** [SourceBackupVaultArn](#API_CreateRestoreAccessBackupVault_RequestSyntax) **
L'ARN dell'archivio di backup di origine contenente i punti di ripristino a cui è richiesto l'accesso temporaneo.
Tipo: stringa
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationDate": number,
"RestoreAccessBackupVaultArn": "string",
"RestoreAccessBackupVaultName": "string",
"VaultState": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationDate](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **
>Data e ora di creazione del repository di backup per l'accesso al ripristino, in formato Unix e Coordinated Universal Time
Tipo: Timestamp
** [RestoreAccessBackupVaultArn](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **
L'ARN che identifica in modo univoco l'archivio di backup di accesso al ripristino creato.
Tipo: String
** [RestoreAccessBackupVaultName](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **
Il nome del repository di backup per l'accesso di ripristino creato.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [VaultState](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **
Lo stato attuale del repository di backup per l'accesso al ripristino.
Tipo: String
Valori validi: `CREATING | AVAILABLE | FAILED`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreAccessBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreAccessBackupVault)
# CreateRestoreTestingPlan
Crea un piano di test di ripristino.
Il primo dei due passaggi per creare un piano di test di ripristino. Dopo che questa richiesta è andata a buon fine, completa la procedura utilizzando CreateRestoreTestingSelection.
## Sintassi della richiesta
```
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"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [CreatorRequestId](#API_CreateRestoreTestingPlan_RequestSyntax) **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** [RestoreTestingPlan](#API_CreateRestoreTestingPlan_RequestSyntax) **
Un piano di test di ripristino deve contenere una stringa `RestoreTestingPlanName` univoca creata dall'utente e un cron `ScheduleExpression`. Facoltativamente, puoi includere un numero intero per `StartWindowHours` e una stringa `CreatorRequestId`.
`RestoreTestingPlanName` è una stringa univoca che identifica il nome del piano di test di ripristino. Non può essere modificato dopo la creazione e deve essere composto solo da caratteri alfanumerici e caratteri di sottolineatura.
Tipo: oggetto [RestoreTestingPlanForCreate](API_RestoreTestingPlanForCreate.md)
Obbligatorio: sì
** [Tags](#API_CreateRestoreTestingPlan_RequestSyntax) **
I tag da assegnare al piano di test di ripristino.
Tipo: mappatura stringa a stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 201
Content-type: application/json
{
"CreationTime": number,
"RestoreTestingPlanArn": "string",
"RestoreTestingPlanName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_CreateRestoreTestingPlan_ResponseSyntax) **
La data e l'ora di creazione di un piano di test di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
** [RestoreTestingPlanArn](#API_CreateRestoreTestingPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco il piano di test di ripristino creato.
Tipo: String
** [RestoreTestingPlanName](#API_CreateRestoreTestingPlan_ResponseSyntax) **
Questa stringa univoca costituisce il nome del piano di test di ripristino.
Il nome non può essere modificato dopo la creazione. Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreTestingPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreTestingPlan)
# CreateRestoreTestingSelection
Questa richiesta può essere inviata dopo che la CreateRestoreTestingPlan richiesta è stata restituita correttamente. È la seconda parte della creazione di un piano di test delle risorse e deve essere completata in sequenza.
Consiste in `RestoreTestingSelectionName`, `ProtectedResourceType` e uno dei seguenti parametri:
+ `ProtectedResourceArns`
+ `ProtectedResourceConditions`
Ogni tipo di risorsa protetta può avere un solo valore.
Una selezione di test di ripristino può includere un valore jolly ("\$1") per `ProtectedResourceArns` insieme a `ProtectedResourceConditions`. In alternativa, puoi includere fino a 30 risorse protette specifiche ARNs in`ProtectedResourceArns`.
Non è possibile selezionare sia per tipi di risorse protette che per tipi specifici ARNs. Se entrambi sono inclusi, la richiesta avrà esito negativo.
## Sintassi della richiesta
```
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
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_RequestSyntax) **
Immettere il nome del piano di test di ripristino restituito dalla CreateRestoreTestingPlan richiesta correlata.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [CreatorRequestId](#API_CreateRestoreTestingSelection_RequestSyntax) **
Una stringa univoca facoltativa che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** [RestoreTestingSelection](#API_CreateRestoreTestingSelection_RequestSyntax) **
Consiste in `RestoreTestingSelectionName`, `ProtectedResourceType` e uno dei seguenti parametri:
+ `ProtectedResourceArns`
+ `ProtectedResourceConditions`
Ogni tipo di risorsa protetta può avere un solo valore.
Una selezione di test di ripristino può includere un valore jolly ("\$1") per `ProtectedResourceArns` insieme a `ProtectedResourceConditions`. In alternativa, puoi includere fino a 30 risorse protette specifiche ARNs in`ProtectedResourceArns`.
Tipo: oggetto [RestoreTestingSelectionForCreate](API_RestoreTestingSelectionForCreate.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 201
Content-type: application/json
{
"CreationTime": number,
"RestoreTestingPlanArn": "string",
"RestoreTestingPlanName": "string",
"RestoreTestingSelectionName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_CreateRestoreTestingSelection_ResponseSyntax) **
L'ora in cui è stata creata la selezione per il test delle risorse.
Tipo: Timestamp
** [RestoreTestingPlanArn](#API_CreateRestoreTestingSelection_ResponseSyntax) **
L'ARN del piano di test di ripristino a cui è associata la selezione del test di ripristino.
Tipo: String
** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_ResponseSyntax) **
Il nome del piano di test di ripristino.
Il nome non può essere modificato dopo la creazione. Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: String
** [RestoreTestingSelectionName](#API_CreateRestoreTestingSelection_ResponseSyntax) **
Il nome della selezione del test di ripristino per il relativo piano di test di ripristino.
Il nome non può essere modificato dopo la creazione. Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateRestoreTestingSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateRestoreTestingSelection)
# CreateTieringConfiguration
Crea una configurazione a più livelli.
Una configurazione a più livelli consente lo spostamento automatico dei dati di backup su un livello di storage più economico in base all'età degli oggetti di backup nel backup vault.
Ogni archivio può avere solo una configurazione su più livelli specifica del vault, oltre a qualsiasi configurazione globale che si applica a tutti gli archivi.
## Sintassi della richiesta
```
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"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **
Si tratta di una stringa univoca che identifica la richiesta e consente di ritentare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **
Una configurazione a più livelli deve contenere una `TieringConfigurationName` stringa univoca creata dall'utente e deve contenere una e. `BackupVaultName` `ResourceSelection` Facoltativamente, puoi includere una `CreatorRequestId` stringa.
`TieringConfigurationName`è una stringa univoca che è il nome della configurazione di tiering. Non può essere modificato dopo la creazione e deve essere composto solo da caratteri alfanumerici e caratteri di sottolineatura.
Tipo: oggetto [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md)
Obbligatorio: sì
** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **
I tag da assegnare alla configurazione a più livelli.
Tipo: mappatura stringa a stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"TieringConfigurationArn": "string",
"TieringConfigurationName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_CreateTieringConfiguration_ResponseSyntax) **
Data e ora di creazione di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering creata.
Tipo: String
** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **
Questa stringa univoca è il nome della configurazione di tiering.
Il nome non può essere modificato dopo la creazione. Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 200.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateTieringConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateTieringConfiguration)
# DeleteBackupPlan
Elimina un piano di backup. È possibile eliminare un piano di backup solo dopo che tutte le selezioni di risorse associate sono state eliminate. L'eliminazione di un piano di backup elimina la versione corrente del piano. Le versioni precedenti, se presenti, continueranno a esistere.
## Sintassi della richiesta
```
DELETE /backup/plans/backupPlanId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_DeleteBackupPlan_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPlanArn": "string",
"BackupPlanId": "string",
"DeletionDate": number,
"VersionId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanArn](#API_DeleteBackupPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
Tipo: String
** [BackupPlanId](#API_DeleteBackupPlan_ResponseSyntax) **
Identifica in modo univoco un piano di backup.
Tipo: String
** [DeletionDate](#API_DeleteBackupPlan_ResponseSyntax) **
La data e l'ora di eliminazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `DeletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [VersionId](#API_DeleteBackupPlan_ResponseSyntax) **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. La versione IDs non può essere modificata.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupPlan)
# DeleteBackupSelection
Elimina la selezione delle risorse associate a un piano di backup specificato da `SelectionId`.
## Sintassi della richiesta
```
DELETE /backup/plans/backupPlanId/selections/selectionId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_DeleteBackupSelection_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
** [selectionId](#API_DeleteBackupSelection_RequestSyntax) **
Identifica in modo univoco il corpo di una richiesta per assegnare un set di risorse a un piano di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupSelection)
# DeleteBackupVault
Elimina il vault di backup identificato dal relativo nome. Un vault può essere eliminato solo se è vuoto.
## Sintassi della richiesta
```
DELETE /backup-vaults/backupVaultName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DeleteBackupVault_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVault)
# DeleteBackupVaultAccessPolicy
Elimina il documento di policy che gestisce le autorizzazioni su un vault di backup.
## Sintassi della richiesta
```
DELETE /backup-vaults/backupVaultName/access-policy HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DeleteBackupVaultAccessPolicy_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati. Consistono di minuscole, numeri e trattini.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVaultAccessPolicy)
# DeleteBackupVaultLockConfiguration
Elimina AWS Backup Vault Lock da un archivio di backup specificato dal nome di un archivio di backup.
Se la configurazione di Vault Lock è immutabile, non è possibile eliminare Vault Lock utilizzando le operazioni API; in caso contrario, si riceverà un `InvalidRequestException`. *Per ulteriori informazioni, consulta [Vault Lock](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html) nella Guida per gli sviluppatori. AWS Backup *
## Sintassi della richiesta
```
DELETE /backup-vaults/backupVaultName/vault-lock HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DeleteBackupVaultLockConfiguration_RequestSyntax) **
Il nome del vault di backup da cui eliminare AWS Backup Vault Lock.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVaultLockConfiguration)
# DeleteBackupVaultNotifications
Elimina le notifiche degli eventi per il vault di backup specificato.
## Sintassi della richiesta
```
DELETE /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DeleteBackupVaultNotifications_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteBackupVaultNotifications)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteBackupVaultNotifications)
# DeleteFramework
Elimina il framework specificato da un nome framework.
## Sintassi della richiesta
```
DELETE /audit/frameworks/frameworkName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [frameworkName](#API_DeleteFramework_RequestSyntax) **
Il nome univoco di un framework.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non completa l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteFramework)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteFramework)
# DeleteRecoveryPoint
Elimina il punto di ripristino specificato da un ID del punto di ripristino.
Se l'ID del punto di ripristino appartiene a un backup continuo, la chiamata di questo endpoint elimina il backup continuo esistente e interrompe backup continui futuri.
Quando le autorizzazioni di un ruolo IAM non sono sufficienti per chiamare questa API, il servizio restituisce una risposta HTTP 200 con un corpo HTTP vuoto, ma il punto di ripristino non viene eliminato. Al contrario, viene attivato uno stato `EXPIRED`.
I punti di ripristino `EXPIRED` possono essere eliminati con questa API quando il ruolo IAM dispone dell'azione `iam:CreateServiceLinkedRole`. Per ulteriori informazioni sull'aggiunta di questo ruolo, consulta [Risoluzione dei problemi relativi alle eliminazioni manuali](https://docs.aws.amazon.com/aws-backup/latest/devguide/deleting-backups.html#deleting-backups-troubleshooting).
Se l'utente o il ruolo viene eliminato o l'autorizzazione all'interno del ruolo viene rimossa, l'eliminazione non andrà a buon fine e verrà attivato uno stato `EXPIRED`.
## Sintassi della richiesta
```
DELETE /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DeleteRecoveryPoint_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_DeleteRecoveryPoint_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidResourceStateException **
AWS Backup sta già eseguendo un'azione su questo punto di ripristino. Non può eseguire l'azione richiesta fino al termine della prima azione. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteRecoveryPoint)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteRecoveryPoint)
# DeleteReportPlan
Elimina il piano di report specificato dal nome di un piano di report.
## Sintassi della richiesta
```
DELETE /audit/report-plans/reportPlanName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [reportPlanName](#API_DeleteReportPlan_RequestSyntax) **
Il nome univoco di un piano di report.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non completa l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteReportPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteReportPlan)
# DeleteRestoreTestingPlan
Questa richiesta elimina il piano di test di ripristino specificato.
L'eliminazione può essere completata solo se vengono eliminate prima tutte le selezioni associate al test di ripristino.
## Sintassi della richiesta
```
DELETE /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_DeleteRestoreTestingPlan_RequestSyntax) **
Nome univoco richiesto del piano di test di ripristino che si desidera eliminare.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteRestoreTestingPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteRestoreTestingPlan)
# DeleteRestoreTestingSelection
Inserisci il nome del piano di test di ripristino e il nome della selezione per il test di ripristino.
Tutte le selezioni di test associate a un piano di test di ripristino devono essere eliminate prima di poter eliminare il piano di test di ripristino.
## Sintassi della richiesta
```
DELETE /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_DeleteRestoreTestingSelection_RequestSyntax) **
Nome univoco obbligatorio del piano di test di ripristino che contiene la selezione per il test di ripristino che si desidera eliminare.
Obbligatorio: sì
** [RestoreTestingSelectionName](#API_DeleteRestoreTestingSelection_RequestSyntax) **
Nome univoco obbligatorio della selezione per il test di ripristino che si desidera eliminare.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteRestoreTestingSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteRestoreTestingSelection)
# DeleteTieringConfiguration
Elimina la configurazione di livelli specificata da un nome di configurazione di livelli.
## Sintassi della richiesta
```
DELETE /tiering-configurations/tieringConfigurationName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [tieringConfigurationName](#API_DeleteTieringConfiguration_RequestSyntax) **
Il nome univoco di una configurazione a più livelli.
Modello: `^[a-zA-Z0-9_]{1,200}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DeleteTieringConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DeleteTieringConfiguration)
# DescribeBackupJob
Restituisce i dettagli del processo di backup per il `BackupJobId` specificato.
## Sintassi della richiesta
```
GET /backup-jobs/backupJobId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupJobId](#API_DescribeBackupJob_RequestSyntax) **
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AccountId](#API_DescribeBackupJob_ResponseSyntax) **
Restituisce l'ID account proprietario del processo di backup.
Tipo: stringa
Modello: `^[0-9]{12}$`
** [BackupJobId](#API_DescribeBackupJob_ResponseSyntax) **
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.
Tipo: String
** [BackupOptions](#API_DescribeBackupJob_ResponseSyntax) **
Rappresenta le opzioni specificate come parte del piano di backup o del processo di backup on demand.
Tipo: mappatura stringa a stringa
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
Modello di valore: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [BackupSizeInBytes](#API_DescribeBackupJob_ResponseSyntax) **
La dimensione, in byte, di un backup (punto di ripristino).
Questo valore può essere riprodotto in modo diverso a seconda del tipo di risorsa, poiché AWS Backup estrae informazioni sui dati da altri AWS servizi. Ad esempio, il valore restituito può mostrare un valore di`0`, che può differire dal valore previsto.
Il comportamento previsto per i valori per tipo di risorsa è descritto come segue:
+ Amazon Aurora, Amazon DocumentDB e Amazon Neptune non hanno questo valore compilato dall'operazione. `GetBackupJobStatus`
+ Per Amazon DynamoDB con funzionalità avanzate, questo valore si riferisce alla dimensione del punto di ripristino (backup).
+ Amazon EC2 e Amazon EBS mostrano la dimensione del volume (storage fornito) restituita come parte di questo valore. Amazon EBS non restituisce informazioni sulle dimensioni del backup; la dimensione dello snapshot avrà lo stesso valore della risorsa originale di cui è stato eseguito il backup.
+ Per Amazon EFS, questo valore si riferisce ai delta byte trasferiti durante un backup.
+ Per Amazon EKS, questo valore si riferisce alla dimensione del punto di ripristino EKS annidato.
+ Amazon FSx non inserisce questo valore nell'operazione `GetBackupJobStatus` per i FSx file system.
+ Un'istanza Amazon RDS verrà visualizzata come`0`.
+ Per le macchine virtuali in esecuzione VMware, questo valore viene passato AWS Backup attraverso un flusso di lavoro asincrono, il che può significare che questo valore visualizzato può sottorappresentare la dimensione effettiva del backup.
Tipo: long
** [BackupType](#API_DescribeBackupJob_ResponseSyntax) **
Rappresenta il tipo di backup effettivo selezionato per un processo di backup. Ad esempio, se è stato eseguito correttamente un backup di Windows VSS (Volume Shadow Copy Service), `BackupType` restituisce `"WindowsVSS"`. Se `BackupType` è vuoto, significa che il tipo di backup è stato un backup normale.
Tipo: String
** [BackupVaultArn](#API_DescribeBackupJob_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [BackupVaultName](#API_DescribeBackupJob_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [BytesTransferred](#API_DescribeBackupJob_ResponseSyntax) **
La dimensione in byte trasferiti in un vault di backup nel momento in cui è stata richiesta la verifica dello stato del processo.
Tipo: long
** [ChildJobsInState](#API_DescribeBackupJob_ResponseSyntax) **
Ciò restituisce le statistiche dei processi di backup figlio (nidificati) inclusi.
Tipo: mappatura stringa a intero lungo
Chiavi valide: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL`
** [CompletionDate](#API_DescribeBackupJob_ResponseSyntax) **
La data e l'ora di complemento di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreatedBy](#API_DescribeBackupJob_ResponseSyntax) **
Contiene informazioni di identificazione sulla creazione di un processo di backup, tra cui `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` e `BackupRuleId` del piano backup utilizzato per crearlo.
Tipo: oggetto [RecoveryPointCreator](API_RecoveryPointCreator.md)
** [CreationDate](#API_DescribeBackupJob_ResponseSyntax) **
La data e l'ora di creazione di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [EncryptionKeyArn](#API_DescribeBackupJob_ResponseSyntax) **
L'Amazon Resource Name (ARN) della chiave KMS utilizzata per crittografare il backup. Può essere una chiave gestita dal cliente o una chiave gestita, AWS a seconda della configurazione del vault.
Tipo: String
** [ExpectedCompletionDate](#API_DescribeBackupJob_ResponseSyntax) **
La data e l'ora prevista di complemento di un processo di backup delle risorse, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `ExpectedCompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IamRoleArn](#API_DescribeBackupJob_ResponseSyntax) **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.
Tipo: String
** [InitiationDate](#API_DescribeBackupJob_ResponseSyntax) **
La data di avvio di un processo di backup.
Tipo: Timestamp
** [IsEncrypted](#API_DescribeBackupJob_ResponseSyntax) **
Un valore booleano che indica se il backup è crittografato. Tutti i backup in entrata AWS Backup sono crittografati, ma questo campo indica lo stato della crittografia per motivi di trasparenza.
Tipo: Booleano
** [IsParent](#API_DescribeBackupJob_ResponseSyntax) **
Ciò restituisce il valore booleano di cui un processo di backup è un processo principale (composito).
Tipo: Booleano
** [MessageCategory](#API_DescribeBackupJob_ResponseSyntax) **
Il numero di lavori per la categoria di messaggi specificata.
Stringhe di esempio possono essere `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` e `INVALIDPARAMETERS`. Visualizza [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco di MessageCategory stringhe accettate.
Tipo: String
** [NumberOfChildJobs](#API_DescribeBackupJob_ResponseSyntax) **
Ciò restituisce il numero di processi di backup figlio (nidificati).
Tipo: long
** [ParentJobId](#API_DescribeBackupJob_ResponseSyntax) **
Ciò restituisce l'ID del processo di backup della risorsa principale (composito).
Tipo: String
** [PercentDone](#API_DescribeBackupJob_ResponseSyntax) **
Contiene una percentuale stimata di completamento di un processo nel momento in cui è stato richiesto lo stato del processo.
Tipo: String
** [RecoveryPointArn](#API_DescribeBackupJob_ResponseSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
** [RecoveryPointLifecycle](#API_DescribeBackupJob_ResponseSyntax) **
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
** [ResourceArn](#API_DescribeBackupJob_ResponseSyntax) **
Un ARN identifica in modo univoco una risorsa salvata. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [ResourceName](#API_DescribeBackupJob_ResponseSyntax) **
Il nome non univoco della risorsa che appartiene al backup specificato.
Tipo: String
** [ResourceType](#API_DescribeBackupJob_ResponseSyntax) **
Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [StartBy](#API_DescribeBackupJob_ResponseSyntax) **
Specifica l'ora in formato Unix e UTC (Coordinated Universal Time) in cui è necessario avviare un processo di backup prima che venga annullato. Il valore viene calcolato aggiungendo la finestra di avvio all'ora pianificata. Pertanto, se l'ora pianificata era le 18:00 e la finestra di avvia è di 2 ore, l'ora `StartBy` sarebbe le 20:00 della data specificata. Il valore di `StartBy` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [State](#API_DescribeBackupJob_ResponseSyntax) **
Lo stato corrente di un processo di backup.
Tipo: String
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL`
** [StatusMessage](#API_DescribeBackupJob_ResponseSyntax) **
Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.
Tipo: String
** [VaultLockState](#API_DescribeBackupJob_ResponseSyntax) **
Lo stato di blocco del vault di backup. Per i vault con intercapedine logiche, indica se il deposito è bloccato in modalità di conformità. I valori validi includono `LOCKED` e `UNLOCKED`.
Tipo: String
** [VaultType](#API_DescribeBackupJob_ResponseSyntax) **
Il tipo di archivio di backup in cui è archiviato il punto di ripristino. I valori validi sono `BACKUP_VAULT` per gli archivi di backup standard e `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` per gli archivi con intercapedine logiche.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** DependencyFailureException **
Un AWS servizio o una risorsa dipendente ha restituito un errore al AWS Backup servizio e l'azione non può essere completata.
** Context **
** Type **
Codice di stato HTTP: 500
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupJob)
# DescribeBackupVault
Restituisce i metadati relativi a un vault di backup specificato in base al nome.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) **
L'ID dell'account del vault di backup specificato.
** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [BackupVaultName](#API_DescribeBackupVault_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
Tipo: String
** [CreationDate](#API_DescribeBackupVault_ResponseSyntax) **
La data e l'ora di creazione di un vault di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
Tipo: String
** [EncryptionKeyArn](#API_DescribeBackupVault_ResponseSyntax) **
La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
Tipo: String
** [EncryptionKeyType](#API_DescribeBackupVault_ResponseSyntax) **
Il tipo di chiave di crittografia utilizzata per l'archivio di backup. I valori validi sono CUSTOMER\$1MANAGED\$1KMS\$1KEY per le chiavi gestite dal cliente o \$1OWNED\$1KMS\$1KEY per le chiavi di proprietà. AWS AWS
Tipo: String
Valori validi: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`
** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) **
Informazioni sull'ultimo aggiornamento dell'associazione del team di approvazione MPA per questo archivio di backup.
Tipo: oggetto [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md)
** [LockDate](#API_DescribeBackupVault_ResponseSyntax) **
La data e l'ora in cui la configurazione di AWS Backup Vault Lock non può essere modificata o eliminata.
Se hai applicato Vault Lock al vault senza specificare una data di blocco, puoi modificare qualsiasi impostazione di Vault Lock o eliminare completamente Vault Lock dal vault, in qualsiasi momento.
Questo valore è in formato Unix, ora Coordinated Universal Time (UTC) ed è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [Locked](#API_DescribeBackupVault_ResponseSyntax) **
Un valore booleano che indica se AWS Backup Vault Lock sta attualmente proteggendo l'archivio di backup. `True`significa che Vault Lock causa il fallimento delle operazioni di eliminazione o aggiornamento sui punti di ripristino archiviati nel vault.
Tipo: Booleano
** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) **
L'impostazione AWS Backup Vault Lock che specifica il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione massimo sui punti di ripristino nel vault (consentendo lo storage a tempo indeterminato).
Se specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o inferiore al periodo di conservazione massimo. Se il periodo di conservazione del processo è più lungo del periodo di conservazione massimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. I punti di ripristino già archiviati nel vault prima di Vault Lock non sono interessati.
Tipo: long
** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) **
L'impostazione AWS Backup Vault Lock che specifica il periodo di conservazione minimo durante il quale il vault conserva i propri punti di ripristino. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione minimo.
Se specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o superiore al periodo di conservazione minimo. Se il periodo di conservazione del processo è più breve del periodo di conservazione minimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. I punti di ripristino già archiviati nel vault prima di Vault Lock non sono interessati.
Tipo: long
** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) **
L'ARN del team di approvazione MPA associato a questo archivio di backup.
Tipo: String
** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) **
L'ARN della sessione MPA associata a questo archivio di backup.
Tipo: String
** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) **
Il numero di punti di ripristino archiviati in un vault di backup.
Il valore del conteggio dei punti di ripristino visualizzato nella console può essere un’approssimazione. Utilizzare l’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) per ottenere il conteggio esatto.
Tipo: long
** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) **
L'ARN dell'archivio di backup di origine da cui è stato creato questo archivio di backup per l'accesso di ripristino.
Tipo: String
** [VaultState](#API_DescribeBackupVault_ResponseSyntax) **
Lo stato attuale del vault. ->
Tipo: String
Valori validi: `CREATING | AVAILABLE | FAILED`
** [VaultType](#API_DescribeBackupVault_ResponseSyntax) **
Il tipo di deposito descritto.
Tipo: String
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupVault)
# DescribeCopyJob
Restituisce i metadati associati alla creazione di una copia di una risorsa.
## Sintassi della richiesta
```
GET /copy-jobs/copyJobId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [copyJobId](#API_DescribeCopyJob_RequestSyntax) **
Identifica in modo univoco un processo di copia.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CopyJob](#API_DescribeCopyJob_ResponseSyntax) **
Contiene informazioni dettagliate su un processo di copia.
Tipo: oggetto [CopyJob](API_CopyJob.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeCopyJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeCopyJob)
# DescribeFramework
Restituisce i dettagli del framework per il `FrameworkName` specificato.
## Sintassi della richiesta
```
GET /audit/frameworks/frameworkName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [frameworkName](#API_DescribeFramework_RequestSyntax) **
Il nome univoco di un framework.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_DescribeFramework_ResponseSyntax) **
La data e l'ora di creazione del framework, nella rappresentazione ISO 8601. Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, 2020-07-10T15:00:00.000-08:00 rappresenta il 10 luglio 2020 alle 15:00 8 ore indietro rispetto all'UTC.
Tipo: Timestamp
** [DeploymentStatus](#API_DescribeFramework_ResponseSyntax) **
Lo stato di implementazione di un framework. Gli stati sono:
`CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED`
Tipo: String
** [FrameworkArn](#API_DescribeFramework_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [FrameworkControls](#API_DescribeFramework_ResponseSyntax) **
I controlli che compongono il framework. Ogni controllo nell'elenco dispone di nome, parametri di input e ambito.
Tipo: matrice di oggetti [FrameworkControl](API_FrameworkControl.md)
** [FrameworkDescription](#API_DescribeFramework_ResponseSyntax) **
Una descrizione facoltativa del framework.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
** [FrameworkName](#API_DescribeFramework_ResponseSyntax) **
Il nome univoco di un framework.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
** [FrameworkStatus](#API_DescribeFramework_ResponseSyntax) **
Un framework consiste in uno o più controlli. Ogni controllo regola una risorsa, ad esempio piani di backup, selezioni di backup, vault di backup o punti di ripristino. È inoltre possibile attivare o disattivare la registrazione AWS Config per ciascuna risorsa. Gli stati sono:
+ `ACTIVE` quando la registrazione è attivata per tutte le risorse amministrate dal framework.
+ `PARTIALLY_ACTIVE` quando la registrazione è disattivata per almeno una risorsa amministrata dal framework.
+ `INACTIVE` quando la registrazione è disattivata per tutte le risorse amministrate dal framework.
+ `UNAVAILABLE`quando non AWS Backup è in grado di convalidare lo stato della registrazione in questo momento.
Tipo: String
** [IdempotencyToken](#API_DescribeFramework_ResponseSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `DescribeFrameworkOutput`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeFramework)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeFramework)
# DescribeGlobalSettings
Descrive se l' AWS account ha abilitato diverse opzioni di gestione tra account, tra cui il backup tra account, l'approvazione di più parti e l'amministratore delegato. Restituisce un errore se l'account non è un membro di un'organizzazione Organizations. Ad esempio: `describe-global-settings --region us-west-2`
## Sintassi della richiesta
```
GET /global-settings HTTP/1.1
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"GlobalSettings": {
"string" : "string"
},
"LastUpdateTime": number
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GlobalSettings](#API_DescribeGlobalSettings_ResponseSyntax) **
Lo stato dei flag`isCrossAccountBackupEnabled`, `isMpaEnabled` («Mpa» si riferisce all'approvazione multipartitica) e. `isDelegatedAdministratorEnabled`
+ `isCrossAccountBackupEnabled`: consenti agli account della tua organizzazione di copiare i backup su altri account.
+ `isMpaEnabled`: Aggiungete l'accesso da più account alla vostra organizzazione con l'opzione di assegnare un team di approvazione composto da più parti a un vault con sistema logico.
+ `isDelegatedAdministratorEnabled`: consente a Backup di sincronizzare automaticamente le autorizzazioni degli amministratori delegati con Organizations.
Tipo: mappatura stringa a stringa
** [LastUpdateTime](#API_DescribeGlobalSettings_ResponseSyntax) **
Data e ora dell'ultimo aggiornamento dei flag supportati. Questo aggiornamento è in formato Unix e nell'ora Coordinated Universal Time (UTC). Il valore di `LastUpdateTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeGlobalSettings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeGlobalSettings)
# DescribeProtectedResource
Restituisce informazioni su una risorsa salvata, inclusa l'ultima volta in cui è stato eseguito il backup, il suo Amazon Resource Name (ARN) e il tipo di AWS servizio della risorsa salvata.
## Sintassi della richiesta
```
GET /resources/resourceArn HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [resourceArn](#API_DescribeProtectedResource_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [LastBackupTime](#API_DescribeProtectedResource_ResponseSyntax) **
La data e l'ora di esecuzione dell'ultimo backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `LastBackupTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [LastBackupVaultArn](#API_DescribeProtectedResource_ResponseSyntax) **
L'ARN (Amazon Resource Name) dell'archivio di backup che contiene il punto di ripristino di backup più recente.
Tipo: String
** [LastRecoveryPointArn](#API_DescribeProtectedResource_ResponseSyntax) **
L'ARN (Amazon Resource Name) del punto di ripristino più recente.
Tipo: String
** [LatestRestoreExecutionTimeMinutes](#API_DescribeProtectedResource_ResponseSyntax) **
Il tempo, in minuti, impiegato per il completamento del processo di ripristino più recente.
Tipo: long
** [LatestRestoreJobCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **
La data di creazione del processo di ripristino più recente.
Tipo: Timestamp
** [LatestRestoreRecoveryPointCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **
La data di creazione del punto di ripristino più recente.
Tipo: Timestamp
** [ResourceArn](#API_DescribeProtectedResource_ResponseSyntax) **
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [ResourceName](#API_DescribeProtectedResource_ResponseSyntax) **
Il nome della risorsa che appartiene al backup specificato.
Tipo: String
** [ResourceType](#API_DescribeProtectedResource_ResponseSyntax) **
Il tipo di AWS risorsa salvata come punto di ripristino, ad esempio un volume Amazon EBS o un database Amazon RDS.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeProtectedResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeProtectedResource)
# DescribeRecoveryPoint
Restituisce i metadati associati a un punto di ripristino, inclusi ID, stato, crittografia e ciclo di vita.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) **
L'ID dell'account del vault di backup specificato.
Modello: `^[0-9]{12}$`
** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_DescribeRecoveryPoint_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupSizeInBytes](#API_DescribeRecoveryPoint_ResponseSyntax) **
La dimensione, in byte, di un backup.
Tipo: long
** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un ARN che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [BackupVaultName](#API_DescribeRecoveryPoint_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [CalculatedLifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un oggetto `CalculatedLifecycle` contenente i timestamp `DeleteAt` e `MoveToColdStorageAt`.
Tipo: oggetto [CalculatedLifecycle](API_CalculatedLifecycle.md)
** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) **
La data e l'ora di completamento del processo di creazione di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CompositeMemberIdentifier](#API_DescribeRecoveryPoint_ResponseSyntax) **
L'identificatore di una risorsa all'interno di un gruppo composito, ad esempio un punto di ripristino annidato (figlio) appartenente a uno stack composito (principale). L'ID viene trasferito dall'[ID logico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) all'interno di uno stack.
Tipo: String
** [CreatedBy](#API_DescribeRecoveryPoint_ResponseSyntax) **
Contiene informazioni di identificazione sulla creazione di un punto di ripristino, tra cui `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` e `BackupRuleId` del piano backup utilizzato per crearlo.
Tipo: oggetto [RecoveryPointCreator](API_RecoveryPointCreator.md)
** [CreationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **
La data e l'ora di creazione di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [EncryptionKeyArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
Tipo: String
** [EncryptionKeyType](#API_DescribeRecoveryPoint_ResponseSyntax) **
Il tipo di chiave di crittografia utilizzata per il punto di ripristino. I valori validi sono CUSTOMER\$1MANAGED\$1KMS\$1KEY per le chiavi gestite dal cliente o \$1OWNED\$1KMS\$1KEY per le chiavi di proprietà. AWS AWS
Tipo: String
Valori validi: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`
** [IamRoleArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.
Tipo: String
** [IndexStatus](#API_DescribeRecoveryPoint_ResponseSyntax) **
Questo è lo stato corrente dell'indice di backup associato al punto di ripristino specificato.
Gli stati sono: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Tipo: String
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
** [IndexStatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **
Una stringa sotto forma di messaggio dettagliato che spiega lo stato di un indice di backup associato al punto di ripristino.
Tipo: String
** [InitiationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **
La data e l'ora in cui è stato avviato il processo di backup che ha creato questo punto di ripristino, in formato Unix e Coordinated Universal Time (UTC).
Tipo: Timestamp
** [IsEncrypted](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un valore booleano che viene restituito come `TRUE` se il punto di ripristino specificato è crittografato o `FALSE` se il punto di ripristino non è crittografato.
Tipo: Booleano
** [IsParent](#API_DescribeRecoveryPoint_ResponseSyntax) **
Ciò restituisce il valore booleano di cui un punto di ripristino è un processo padre (composito).
Tipo: Booleano
** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) **
La data e l'ora dell'ultimo ripristino di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `LastRestoreTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [Lifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup che vengono trasferiti allo storage dei dati inattivi devono essere archiviati nello storage per un minimo di 90 giorni. Pertanto, l'impostazione "conservazione" deve essere 90 giorni maggiore dell'impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle [funzionalità](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
** [ParentRecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
Questo è un ARN che identifica in modo univoco un punto di ripristino (composito) padre, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
** [RecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
** [ResourceArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un ARN identifica in modo univoco una risorsa salvata. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) **
Il nome della risorsa che appartiene al backup specificato.
Tipo: String
** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) **
Il tipo di AWS risorsa da salvare come punto di ripristino; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [ScanResults](#API_DescribeRecoveryPoint_ResponseSyntax) **
Contiene i risultati di scansione più recenti rispetto al punto di ripristino e attualmente include`MalwareScanner`,, `ScanJobState` e `Findings` `LastScanTimestamp`
Tipo: matrice di oggetti [ScanResult](API_ScanResult.md)
Membri dell'array: numero minimo di 0 elementi. Numero massimo 5 elementi.
** [SourceBackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco il vault di origine in cui è stato originariamente eseguito il backup della risorsa, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Se il ripristino viene ripristinato sullo stesso AWS account o regione, questo valore sarà`null`.
Tipo: String
** [Status](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un codice di stato che specifica lo stato del punto di ripristino. Per ulteriori informazioni, consulta [lo stato del punto di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/applicationstackbackups.html#cfnrecoverypointstatus) nella *Guida per gli AWS Backup sviluppatori*.
+ `CREATING`lo stato indica che è stato avviato un AWS Backup lavoro per una risorsa. Il processo di backup è iniziato e sta elaborando attivamente un job di backup per il punto di ripristino associato.
+ `AVAILABLE`lo stato indica che il backup è stato creato correttamente per il punto di ripristino. Il processo di backup è stato completato senza problemi e il punto di ripristino è ora pronto per l'uso.
+ `PARTIAL`lo stato indica che un punto di ripristino composito ha uno o più punti di ripristino annidati che non erano presenti nel backup.
+ `EXPIRED`lo stato indica che il punto di ripristino ha superato il periodo di conservazione, ma non AWS Backup dispone dell'autorizzazione o non è altrimenti in grado di eliminarlo. Per eliminare manualmente questi punti di ripristino, consulta [Passaggio 3: Eliminare i punti di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups) nella sezione *Pulizia delle risorse* di *Nozioni di base*.
+ Lo stato `STOPPED` si verifica in un backup continuo in cui un utente ha eseguito alcune azioni che causano la disabilitazione del backup continuo. Ciò può essere causato dalla rimozione delle autorizzazioni, dalla disattivazione del controllo delle versioni, dalla disattivazione degli eventi a EventBridge cui vengono inviati o dalla disabilitazione delle EventBridge regole messe in atto da. AWS Backup Per i punti di ripristino delle risorse Amazon S3, Amazon RDS e Amazon Aurora, questo stato si verifica quando viene modificato il periodo di conservazione di una regola di backup continuo.
Per risolvere lo stato `STOPPED`, assicurati che tutte le autorizzazioni richieste siano in essere e che il controllo delle versioni sia abilitato sul bucket S3. Una volta soddisfatte queste condizioni, l'istanza successiva di una regola di backup in esecuzione comporterà la creazione di un nuovo punto di ripristino continuo. Non è necessario eliminare i punti di ripristino con stato STOPPED.
Per SAP HANA su Amazon EC2 `STOPPED` lo stato si verifica a causa dell'azione dell'utente, di un'errata configurazione dell'applicazione o di un errore di backup. Per garantire il successo dei backup continui futuri, fai riferimento allo stato del punto di ripristino e controlla SAP HANA per i dettagli.
Tipo: String
Valori validi: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING`
** [StatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **
Un messaggio di stato che spiega lo stato del punto di ripristino.
Tipo: String
** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) **
Specifica la classe di storage del punto di ripristino. I valori validi sono `WARM` e `COLD`.
Tipo: String
Valori validi: `WARM | COLD | DELETED`
** [VaultType](#API_DescribeRecoveryPoint_ResponseSyntax) **
Il tipo di archivio in cui è archiviato il punto di ripristino descritto.
Tipo: String
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRecoveryPoint)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRecoveryPoint)
# DescribeRegionSettings
Restituisce le attuali impostazioni opt-in del servizio per la regione. Se l'opt-in del servizio è abilitato per un servizio, AWS Backup tenta di proteggere le risorse di quel servizio in questa regione, quando la risorsa è inclusa in un piano di backup su richiesta o pianificato. In caso contrario, AWS Backup non tenta di proteggere le risorse di tale servizio in questa regione.
## Sintassi della richiesta
```
GET /account-settings HTTP/1.1
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceTypeManagementPreference": {
"string" : boolean
},
"ResourceTypeOptInPreference": {
"string" : boolean
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ResourceTypeManagementPreference](#API_DescribeRegionSettings_ResponseSyntax) **
Indica se gestisce AWS Backup completamente i backup per un tipo di risorsa.
Per i vantaggi della AWS Backup gestione completa, vedere [AWS Backup Gestione completa](https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#full-management).
Per un elenco dei tipi di risorse e per sapere se ciascuno supporta la AWS Backup gestione completa, consulta la tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource).
Se`"DynamoDB":false`, puoi abilitare la AWS Backup gestione completa del backup di DynamoDB abilitando le funzionalità di backup [avanzate AWS Backup di DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli).
Tipo: mappatura da stringa a matrice
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
** [ResourceTypeOptInPreference](#API_DescribeRegionSettings_ResponseSyntax) **
I servizi insieme alle preferenze di attivazione nella regione.
Tipo: mappatura da stringa a matrice
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRegionSettings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRegionSettings)
# DescribeReportJob
Restituisce i dettagli associati alla creazione di un report come specificato da `ReportJobId`.
## Sintassi della richiesta
```
GET /audit/report-jobs/reportJobId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [reportJobId](#API_DescribeReportJob_RequestSyntax) **
L'identificatore del processo di report. Stringa con codifica UTF-8 Unicode univoca generata casualmente con lunghezza massima di 1.024 byte. L'ID processo report non può essere modificato.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ReportJob](#API_DescribeReportJob_ResponseSyntax) **
Le informazioni su un processo di report, inclusi i tempi di completamento e creazione, la destinazione del report, l'ID univoco del processo di report, Amazon Resource Name (ARN), il modello di report, lo stato e il messaggio di stato.
Tipo: oggetto [ReportJob](API_ReportJob.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeReportJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeReportJob)
# DescribeReportPlan
Restituisce un elenco di tutti i piani di report per un Account AWS and Regione AWS.
## Sintassi della richiesta
```
GET /audit/report-plans/reportPlanName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [reportPlanName](#API_DescribeReportPlan_RequestSyntax) **
Il nome univoco di un piano di report.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ReportPlan](#API_DescribeReportPlan_ResponseSyntax) **
Restituisce i dettagli sul piano di report specificato in base al relativo nome. Questi dettagli includono il nome della risorsa Amazon (ARN) del piano di report, la descrizione, le impostazioni, il canale di distribuzione, lo stato di implementazione, l'ora di creazione e le ore ultimo tentativo ed esecuzione completata.
Tipo: oggetto [ReportPlan](API_ReportPlan.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeReportPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeReportPlan)
# DescribeRestoreJob
Restituisce i metadati associati a un processo di ripristino specificato da un ID processo.
## Sintassi della richiesta
```
GET /restore-jobs/restoreJobId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [restoreJobId](#API_DescribeRestoreJob_RequestSyntax) **
Identifica in modo univoco il processo che ripristina un punto di ripristino.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AccountId](#API_DescribeRestoreJob_ResponseSyntax) **
Restituisce l'ID account proprietario del processo di ripristino.
Tipo: stringa
Modello: `^[0-9]{12}$`
** [BackupSizeInBytes](#API_DescribeRestoreJob_ResponseSyntax) **
La dimensione, in byte, della risorsa ripristinata.
Tipo: long
** [BackupVaultArn](#API_DescribeRestoreJob_ResponseSyntax) **
L'Amazon Resource Name (ARN) del vault di backup contenente il punto di ripristino da ripristinare. Questo aiuta a identificare le politiche e le autorizzazioni di accesso al vault.
Tipo: String
** [CompletionDate](#API_DescribeRestoreJob_ResponseSyntax) **
La data e l'ora di completamento del processo di ripristino di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreatedBy](#API_DescribeRestoreJob_ResponseSyntax) **
Contiene informazioni di identificazione sulla creazione di un processo di ripristino.
Tipo: oggetto [RestoreJobCreator](API_RestoreJobCreator.md)
** [CreatedResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **
L'Amazon Resource Name (ARN) della risorsa creata dal processo di ripristino.
Il formato dell'ARN dipende dal tipo della risorsa di cui si esegue il backup.
Tipo: String
** [CreationDate](#API_DescribeRestoreJob_ResponseSyntax) **
La data e l'ora in cui è stato creato il processo di ripristino, nel formato orario Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [DeletionStatus](#API_DescribeRestoreJob_ResponseSyntax) **
Lo stato dei dati generati dal test di ripristino.
Tipo: String
Valori validi: `DELETING | FAILED | SUCCESSFUL`
** [DeletionStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **
Descrive lo stato di eliminazione del processo di ripristino.
Tipo: String
** [ExpectedCompletionTimeMinutes](#API_DescribeRestoreJob_ResponseSyntax) **
La quantità di tempo in minuti prevista per l’esecuzione del processo di ripristino di un punto di ripristino.
Tipo: long
** [IamRoleArn](#API_DescribeRestoreJob_ResponseSyntax) **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.
Tipo: String
** [IsParent](#API_DescribeRestoreJob_ResponseSyntax) **
Si tratta di un valore booleano che indica se il processo di ripristino è un processo di ripristino principale (composito).
Tipo: Booleano
** [ParentJobId](#API_DescribeRestoreJob_ResponseSyntax) **
Questo è l'identificatore univoco del processo di ripristino principale per il processo di ripristino selezionato.
Tipo: String
** [PercentDone](#API_DescribeRestoreJob_ResponseSyntax) **
Contiene una percentuale stimata di completamento di un processo nel momento in cui è stato richiesto lo stato del processo.
Tipo: String
** [RecoveryPointArn](#API_DescribeRestoreJob_ResponseSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
** [RecoveryPointCreationDate](#API_DescribeRestoreJob_ResponseSyntax) **
La data di creazione del punto di ripristino creato dal processo di ripristino specificato.
Tipo: Timestamp
** [ResourceType](#API_DescribeRestoreJob_ResponseSyntax) **
Restituisce i metadati associati a un processo di ripristino elencati per tipo di risorsa.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [RestoreJobId](#API_DescribeRestoreJob_ResponseSyntax) **
Identifica in modo univoco il processo che ripristina un punto di ripristino.
Tipo: String
** [SourceResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **
L'Amazon Resource Name (ARN) della risorsa originale di cui è stato eseguito il backup. Ciò fornisce un contesto su quale risorsa viene ripristinata.
Tipo: String
** [Status](#API_DescribeRestoreJob_ResponseSyntax) **
Codice di stato che specifica lo stato del processo avviato da AWS Backup per ripristinare un punto di ripristino.
Tipo: String
Valori validi: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED`
** [StatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **
Un messaggio che mostra lo stato di un processo per ripristinare un punto di ripristino.
Tipo: String
** [ValidationStatus](#API_DescribeRestoreJob_ResponseSyntax) **
Lo stato di convalida eseguito sul processo di ripristino indicato.
Tipo: String
Valori validi: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`
** [ValidationStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **
Il messaggio sullo stato.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** DependencyFailureException **
Un AWS servizio o una risorsa dipendente ha restituito un errore al AWS Backup servizio e l'azione non può essere completata.
** Context **
** Type **
Codice di stato HTTP: 500
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRestoreJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRestoreJob)
# DescribeScanJob
Restituisce i dettagli del processo di scansione per l' ScanJobID specificato.
## Sintassi della richiesta
```
GET /scan/jobs/ScanJobId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ScanJobId](#API_DescribeScanJob_RequestSyntax) **
Identifica in modo univoco una richiesta di scansione AWS Backup di una risorsa.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AccountId](#API_DescribeScanJob_ResponseSyntax) **
Restituisce l'ID dell'account proprietario del processo di scansione.
Modello: `^[0-9]{12}$`
Tipo: String
** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) **
Un Amazon Resource Name (ARN) che identifica in modo univoco un archivio di backup; ad esempio, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`
Tipo: String
** [BackupVaultName](#API_DescribeScanJob_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati.
Modello: `^[a-zA-Z0-9\-\_\.]{2,50}$`
Tipo: String
** [CompletionDate](#API_DescribeScanJob_ResponseSyntax) **
Data e ora di completamento della creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreatedBy](#API_DescribeScanJob_ResponseSyntax) **
Contiene informazioni identificative sulla creazione di un processo di scansione, inclusi il piano di backup e la regola che ha avviato la scansione.
Tipo: oggetto [ScanJobCreator](API_ScanJobCreator.md)
** [CreationDate](#API_DescribeScanJob_ResponseSyntax) **
Data e ora di completamento della creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IamRoleArn](#API_DescribeScanJob_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: String
** [MalwareScanner](#API_DescribeScanJob_ResponseSyntax) **
Il motore di scansione utilizzato per il processo di scansione corrispondente. Attualmento solo `GUARDUTY` è supportato.
Tipo: String
Valori validi: `GUARDDUTY`
** [RecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **
Un ARN che identifica in modo univoco il punto di ripristino di destinazione per la scansione.; ad esempio,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`
Tipo: String
** [ResourceArn](#API_DescribeScanJob_ResponseSyntax) **
Un ARN che identifica in modo univoco la risorsa di origine dell'ARN del punto di ripristino corrispondente.
Tipo: String
** [ResourceName](#API_DescribeScanJob_ResponseSyntax) **
Il nome non univoco della risorsa che appartiene al backup specificato.
Tipo: String
** [ResourceType](#API_DescribeScanJob_ResponseSyntax) **
Il tipo di AWS risorsa di cui eseguire il backup, ad esempio un volume Amazon Elastic Block Store (Amazon EBS).
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Tipo: String
Valori validi: `EBS | EC2 | S3`
** [ScanBaseRecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **
Un ARN che identifica in modo univoco il punto di ripristino di base per la scansione. Questo campo verrà compilato solo quando viene eseguito un processo di scansione incrementale.
Tipo: String
** [ScanId](#API_DescribeScanJob_ResponseSyntax) **
L'ID di scansione generato da Amazon GuardDuty per la richiesta Scan Job ID corrispondente da AWS Backup.
Tipo: String
** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) **
L'ID del processo di scansione a cui è stata identificata in modo univoco la AWS Backup richiesta.
Tipo: String
** [ScanMode](#API_DescribeScanJob_ResponseSyntax) **
Speciifica il tipo di scansione utilizzato per il processo di scansione.
Tipo: String
Valori validi: `FULL_SCAN | INCREMENTAL_SCAN`
** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) **
Specifica il ruolo IAM dello scanner utilizzato dall'ARN per il processo di scansione.
Tipo: String
** [ScanResult](#API_DescribeScanJob_ResponseSyntax) **
Contiene il codice `ScanResultsStatus` per il lavoro di scansione e i resi `THREATS_FOUND` o `NO_THREATS_FOUND` per i lavori completati.
Tipo: oggetto [ScanResultInfo](API_ScanResultInfo.md)
** [State](#API_DescribeScanJob_ResponseSyntax) **
Lo stato corrente di un processo di scansione.
Tipo: String
Valori validi: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING`
** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) **
Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeScanJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeScanJob)
# DisassociateBackupVaultMpaApprovalTeam
Rimuove l'associazione tra un team di approvazione MPA e un archivio di backup, disabilitando il flusso di lavoro di approvazione MPA per le operazioni di ripristino.
## Sintassi della richiesta
```
POST /backup-vaults/backupVaultName/mpaApprovalTeam?delete HTTP/1.1
Content-type: application/json
{
"RequesterComment": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **
Il nome dell'archivio di backup da cui dissociare il team di approvazione MPA.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [RequesterComment](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **
Un commento facoltativo che spiega il motivo della dissociazione del team di approvazione MPA dal backup vault.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DisassociateBackupVaultMpaApprovalTeam)
# DisassociateRecoveryPoint
Elimina il punto di ripristino del backup continuo specificato AWS Backup e rilascia il controllo di tale backup continuo sul servizio di origine, ad esempio Amazon RDS. Il servizio di origine continuerà a creare e mantenere backup continui utilizzando il ciclo di vita specificato nel piano di backup originale.
Non supporta i punti di ripristino del backup snapshot.
## Sintassi della richiesta
```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/disassociate HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DisassociateRecoveryPoint_RequestSyntax) **
Il nome univoco di un AWS Backup vault.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_DisassociateRecoveryPoint_RequestSyntax) **
Un Amazon Resource Name (ARN) che identifica in modo univoco un punto di ripristino. AWS Backup
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidResourceStateException **
AWS Backup sta già eseguendo un'azione su questo punto di ripristino. Non può eseguire l'azione richiesta fino al termine della prima azione. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DisassociateRecoveryPoint)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DisassociateRecoveryPoint)
# DisassociateRecoveryPointFromParent
Questa azione su un punto di ripristino (nidificato) figlio specifico rimuove la relazione tra il punto di ripristino specificato e il relativo punto di ripristino (composito) padre.
## Sintassi della richiesta
```
DELETE /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/parentAssociation HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_DisassociateRecoveryPointFromParent_RequestSyntax) **
Il nome di un contenitore logico in cui è memorizzato il punto di ripristino secondario (annidato). Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_DisassociateRecoveryPointFromParent_RequestSyntax) **
L'Amazon Resource Name (ARN) che identifica in modo univoco il punto di ripristino secondario (annidato); ad esempio, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DisassociateRecoveryPointFromParent)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DisassociateRecoveryPointFromParent)
# ExportBackupPlanTemplate
Restituisce il piano di backup specificato dall'ID del piano come un modello di backup.
## Sintassi della richiesta
```
GET /backup/plans/backupPlanId/toTemplate/ HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_ExportBackupPlanTemplate_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPlanTemplateJson": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanTemplateJson](#API_ExportBackupPlanTemplate_ResponseSyntax) **
Il corpo di un modello del piano di backup in formato JSON.
Si tratta di un documento JSON firmato che non può essere modificato prima di essere passato a `GetBackupPlanFromJSON.`
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ExportBackupPlanTemplate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ExportBackupPlanTemplate)
# GetBackupPlan
Restituisce i dettagli `BackupPlan` per il `BackupPlanId` specificato. I dettagli sono il corpo di un piano di backup in formato JSON, in aggiunta ai metadati del piano.
## Sintassi della richiesta
```
GET /backup/plans/backupPlanId/?MaxScheduledRunsPreview=MaxScheduledRunsPreview&versionId=VersionId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_GetBackupPlan_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
** [MaxScheduledRunsPreview](#API_GetBackupPlan_RequestSyntax) **
Numero di future esecuzioni di backup pianificate da visualizzare in anteprima. Se impostato su 0 (impostazione predefinita), nella risposta non è inclusa alcuna anteprima delle esecuzioni pianificate. L'intervallo valido è 0-10.
Intervallo valido: valore minimo di 0. Valore massimo di 10.
** [VersionId](#API_GetBackupPlan_RequestSyntax) **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. La versione IDs non può essere modificata.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AdvancedBackupSettings](#API_GetBackupPlan_ResponseSyntax) **
Contiene un elenco di `BackupOptions` per ogni tipo di risorsa. L'elenco viene compilato solo se l'opzione avanzata è impostata per il piano di backup.
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)
** [BackupPlan](#API_GetBackupPlan_ResponseSyntax) **
Specifica il corpo di un piano di backup. Include un `BackupPlanName` e uno o più set di `Rules`.
Tipo: oggetto [BackupPlan](API_BackupPlan.md)
** [BackupPlanArn](#API_GetBackupPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
Tipo: String
** [BackupPlanId](#API_GetBackupPlan_ResponseSyntax) **
Identifica in modo univoco un piano di backup.
Tipo: String
** [CreationDate](#API_GetBackupPlan_ResponseSyntax) **
La data e l'ora di creazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreatorRequestId](#API_GetBackupPlan_ResponseSyntax) **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte.
Tipo: String
** [DeletionDate](#API_GetBackupPlan_ResponseSyntax) **
La data e ora di eliminazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `DeletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [LastExecutionDate](#API_GetBackupPlan_ResponseSyntax) **
L'ultima volta che è stato eseguito questo piano di backup. Una data e ora, in formato UNIX e nell'ora Universal Coordinated Time (UTC). Il valore di `LastExecutionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [ScheduledRunsPreview](#API_GetBackupPlan_ResponseSyntax) **
Elenco delle prossime esecuzioni di backup pianificate. Incluso solo quando `MaxScheduledRunsPreview` il parametro è maggiore di 0. Contiene fino a 10 future esecuzioni di backup con i tempi pianificati, i tipi di esecuzione e le regole IDs associate.
Tipo: matrice di oggetti [ScheduledPlanExecutionMember](API_ScheduledPlanExecutionMember.md)
** [VersionId](#API_GetBackupPlan_ResponseSyntax) **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. La versione IDs non può essere modificata.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupPlan)
# GetBackupPlanFromJSON
Restituisce un documento JSON valido che specifica un piano di backup o un errore.
## Sintassi della richiesta
```
POST /backup/template/json/toPlan HTTP/1.1
Content-type: application/json
{
"BackupPlanTemplateJson": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupPlanTemplateJson](#API_GetBackupPlanFromJSON_RequestSyntax) **
Un documento del piano di backup fornito dal cliente in formato JSON.
Tipo: stringa
Obbligatorio: sì
## Sintassi della risposta
```
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"
}
]
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlan](#API_GetBackupPlanFromJSON_ResponseSyntax) **
Specifica il corpo di un piano di backup. Include un `BackupPlanName` e uno o più set di `Rules`.
Tipo: oggetto [BackupPlan](API_BackupPlan.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupPlanFromJSON)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupPlanFromJSON)
# GetBackupPlanFromTemplate
Restituisce il modello specificato dal relativo `templateId` come un piano di backup.
## Sintassi della richiesta
```
GET /backup/template/plans/templateId/toPlan HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [templateId](#API_GetBackupPlanFromTemplate_RequestSyntax) **
Identifica in modo univoco un modello di piano di backup archiviato.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanDocument](#API_GetBackupPlanFromTemplate_ResponseSyntax) **
Restituisce il corpo di un piano di backup basato sul modello di destinazione, inclusi il nome, le regole e il vault di backup del piano.
Tipo: oggetto [BackupPlan](API_BackupPlan.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupPlanFromTemplate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupPlanFromTemplate)
# GetBackupSelection
Restituisce i metadati di selezione e un documento in formato JSON che specifica un elenco di risorse associate a un piano di backup.
## Sintassi della richiesta
```
GET /backup/plans/backupPlanId/selections/selectionId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_GetBackupSelection_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
** [selectionId](#API_GetBackupSelection_RequestSyntax) **
Identifica in modo univoco il corpo di una richiesta per assegnare un set di risorse a un piano di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanId](#API_GetBackupSelection_ResponseSyntax) **
Identifica in modo univoco un piano di backup.
Tipo: String
** [BackupSelection](#API_GetBackupSelection_ResponseSyntax) **
Specifica il corpo di una richiesta per assegnare un set di risorse a un piano di backup.
Tipo: oggetto [BackupSelection](API_BackupSelection.md)
** [CreationDate](#API_GetBackupSelection_ResponseSyntax) **
La data e l'ora di creazione di una selezione di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreatorRequestId](#API_GetBackupSelection_ResponseSyntax) **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte.
Tipo: String
** [SelectionId](#API_GetBackupSelection_ResponseSyntax) **
Identifica in modo univoco il corpo di una richiesta per assegnare un set di risorse a un piano di backup.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupSelection)
# GetBackupVaultAccessPolicy
Restituisce il documento relativo alla policy di accesso associato al vault di backup denominato.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName/access-policy HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_GetBackupVaultAccessPolicy_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"Policy": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [BackupVaultName](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [Policy](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **
Il documento relativo alla policy di accesso del vault di backup in formato JSON.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupVaultAccessPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupVaultAccessPolicy)
# GetBackupVaultNotifications
Restituisce le notifiche degli eventi per il vault di backup specificato.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_GetBackupVaultNotifications_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultEvents": [ "string" ],
"BackupVaultName": "string",
"SNSTopicArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_GetBackupVaultNotifications_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [BackupVaultEvents](#API_GetBackupVaultNotifications_ResponseSyntax) **
Un array di eventi che indica lo stato dei processi per il backup delle per il vault di backup.
Tipo: array di stringhe
Valori validi: `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) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [SNSTopicArn](#API_GetBackupVaultNotifications_ResponseSyntax) **
Un ARN che identifica in modo univoco un argomento Amazon Simple Notification Service (Amazon SNS); ad esempio, `arn:aws:sns:us-west-2:111122223333:MyTopic`.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetBackupVaultNotifications)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetBackupVaultNotifications)
# GetLegalHold
Questa azione restituisce i dettagli per un blocco ai fini legali specificato. I dettagli sono il corpo di un blocco ai fini legali in formato JSON, in aggiunta ai metadati.
## Sintassi della richiesta
```
GET /legal-holds/legalHoldId/ HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [legalHoldId](#API_GetLegalHold_RequestSyntax) **
L'ID del deposito legale.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CancelDescription](#API_GetLegalHold_ResponseSyntax) **
Il motivo per cui è stata rimossa la sospensione legale.
Tipo: String
** [CancellationDate](#API_GetLegalHold_ResponseSyntax) **
L'ora in cui il blocco legale è stato annullato.
Tipo: Timestamp
** [CreationDate](#API_GetLegalHold_ResponseSyntax) **
L'ora in cui è stata creata la conservazione legale.
Tipo: Timestamp
** [Description](#API_GetLegalHold_ResponseSyntax) **
La descrizione della custodia legale.
Tipo: String
** [LegalHoldArn](#API_GetLegalHold_ResponseSyntax) **
L'ARN del framework per la conservazione legale specificata. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [LegalHoldId](#API_GetLegalHold_ResponseSyntax) **
L'ID del deposito legale.
Tipo: String
** [RecoveryPointSelection](#API_GetLegalHold_ResponseSyntax) **
I criteri per assegnare un set di risorse, ad esempio i tipi di risorse o gli archivi di backup.
Tipo: oggetto [RecoveryPointSelection](API_RecoveryPointSelection.md)
** [RetainRecordUntil](#API_GetLegalHold_ResponseSyntax) **
La data e l'ora fino alle quali viene conservato il record di conservazione legale.
Tipo: Timestamp
** [Status](#API_GetLegalHold_ResponseSyntax) **
Lo stato della custodia legale.
Tipo: String
Valori validi: `CREATING | ACTIVE | CANCELING | CANCELED`
** [Title](#API_GetLegalHold_ResponseSyntax) **
Il titolo del deposito legale.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetLegalHold)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetLegalHold)
# GetRecoveryPointIndexDetails
Questa operazione restituisce i metadati e i dettagli specifici dell'indice di backup associato al punto di ripristino specificato.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_GetRecoveryPointIndexDetails_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
I caratteri accettati includono lettere minuscole, numeri e trattini.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_GetRecoveryPointIndexDetails_RequestSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Un ARN che identifica in modo univoco l'archivio di backup in cui è archiviato l'indice del punto di ripristino.
Ad esempio, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [IndexCompletionDate](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Data e ora di completamento della creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IndexCreationDate](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Data e ora di creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IndexDeletionDate](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Data e ora di eliminazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IndexStatus](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Questo è lo stato corrente dell'indice di backup associato al punto di ripristino specificato.
Gli stati sono: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Tipo: String
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
** [IndexStatusMessage](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Un messaggio dettagliato che spiega lo stato di un indice di backup associato al punto di ripristino.
Tipo: String
** [RecoveryPointArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
** [SourceResourceArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Una stringa di Amazon Resource Name (ARN) che identifica in modo univoco la risorsa di origine.
Tipo: String
** [TotalItemsIndexed](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **
Numero di elementi all'interno dell'indice di backup associato al punto di ripristino.
Tipo: long
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRecoveryPointIndexDetails)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRecoveryPointIndexDetails)
# GetRecoveryPointRestoreMetadata
Restituisce un set di coppie chiave-valore che sono state utilizzate per creare il backup.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/restore-metadata?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [BackupVaultAccountId](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **
L'ID dell'account del vault di backup specificato.
Modello: `^[0-9]{12}$`
** [backupVaultName](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"RecoveryPointArn": "string",
"ResourceType": "string",
"RestoreMetadata": {
"string" : "string"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **
Un ARN che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [RecoveryPointArn](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
** [ResourceType](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **
Il tipo di risorsa del punto di ripristino.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [RestoreMetadata](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **
Il set di coppie chiave-valore dei metadati che descrivono la configurazione originale della risorsa di cui è stato eseguito il backup. Questi valori variano a seconda del servizio che viene ripristinato.
Tipo: mappatura stringa a stringa
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRecoveryPointRestoreMetadata)
# GetRestoreJobMetadata
Questa richiesta restituisce i metadati per il processo di ripristino specificato.
## Sintassi della richiesta
```
GET /restore-jobs/restoreJobId/metadata HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [restoreJobId](#API_GetRestoreJobMetadata_RequestSyntax) **
Si tratta di un identificatore univoco di un processo di ripristino all'interno AWS Backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Metadata": {
"string" : "string"
},
"RestoreJobId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Metadata](#API_GetRestoreJobMetadata_ResponseSyntax) **
Contiene i metadati del processo di backup specificato.
Tipo: mappatura stringa a stringa
** [RestoreJobId](#API_GetRestoreJobMetadata_ResponseSyntax) **
Si tratta di un identificatore univoco di un processo di ripristino all'interno di. AWS Backup
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreJobMetadata)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreJobMetadata)
# GetRestoreTestingInferredMetadata
Questa richiesta restituisce il set minimo di metadati necessario per avviare un processo di ripristino con impostazioni predefinite sicure. `BackupVaultName` e `RecoveryPointArn` sono parametri obbligatori. `BackupVaultAccountId` è un parametro facoltativo.
## Sintassi della richiesta
```
GET /restore-testing/inferred-metadata?BackupVaultAccountId=BackupVaultAccountId&BackupVaultName=BackupVaultName&RecoveryPointArn=RecoveryPointArn HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [BackupVaultAccountId](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **
L'ID dell'account del vault di backup specificato.
** [BackupVaultName](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati. Consistono in lettere, numeri e trattini.
Obbligatorio: sì
** [RecoveryPointArn](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"InferredMetadata": {
"string" : "string"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [InferredMetadata](#API_GetRestoreTestingInferredMetadata_ResponseSyntax) **
Questa è una mappa di stringhe dei metadati dedotti dalla richiesta.
Tipo: mappatura stringa a stringa
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreTestingInferredMetadata)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreTestingInferredMetadata)
# GetRestoreTestingPlan
Restituisce i dettagli `RestoreTestingPlan` per il `RestoreTestingPlanName` specificato. I dettagli sono il corpo di un piano di test di ripristino in formato JSON, in aggiunta ai metadati del piano.
## Sintassi della richiesta
```
GET /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_GetRestoreTestingPlan_RequestSyntax) **
Il nome univoco richiesto del piano di test di ripristino.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [RestoreTestingPlan](#API_GetRestoreTestingPlan_ResponseSyntax) **
Specifica il corpo di un piano di test di ripristino. Include `RestoreTestingPlanName`.
Tipo: oggetto [RestoreTestingPlanForGet](API_RestoreTestingPlanForGet.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreTestingPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreTestingPlan)
# GetRestoreTestingSelection
Restituisce RestoreTestingSelection, che mostra le risorse e gli elementi del piano di test di ripristino.
## Sintassi della richiesta
```
GET /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_GetRestoreTestingSelection_RequestSyntax) **
Il nome univoco richiesto del piano di test di ripristino.
Obbligatorio: sì
** [RestoreTestingSelectionName](#API_GetRestoreTestingSelection_RequestSyntax) **
Il nome univoco richiesto della selezione del test di ripristino.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [RestoreTestingSelection](#API_GetRestoreTestingSelection_ResponseSyntax) **
Nome univoco della selezione del test di ripristino.
Tipo: oggetto [RestoreTestingSelectionForGet](API_RestoreTestingSelectionForGet.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetRestoreTestingSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetRestoreTestingSelection)
# GetSupportedResourceTypes
Restituisce i tipi di AWS risorse supportati da AWS Backup.
## Sintassi della richiesta
```
GET /supported-resource-types HTTP/1.1
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceTypes": [ "string" ]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ResourceTypes](#API_GetSupportedResourceTypes_ResponseSyntax) **
Contiene una stringa con i tipi di AWS risorse supportati:
+ `Aurora` per Amazon Aurora
+ `CloudFormation`per AWS CloudFormation
+ `DocumentDB` per Amazon DocumentDB (compatibile con MongoDB)
+ `DynamoDB` per Amazon DynamoDB
+ `EBS` per Amazon Elastic Block Store
+ `EC2` per Amazon Elastic Compute Cloud
+ `EFS` per Amazon Elastic File System
+ `EKS`per Amazon Elastic Kubernetes Service
+ `FSx`per Amazon FSx
+ `Neptune` per Amazon Neptune
+ `RDS` per Amazon Relational Database Service
+ `Redshift` per Amazon Redshift
+ `S3`per Amazon Simple Storage Service (Amazon S3)
+ `SAP HANA on Amazon EC2`per database SAP HANA su istanze Amazon Elastic Compute Cloud
+ `Storage Gateway`per Gateway di archiviazione AWS
+ `Timestream` per Amazon Timestream
+ `VirtualMachine`per macchine VMware virtuali
Tipo: array di stringhe
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetSupportedResourceTypes)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetSupportedResourceTypes)
# GetTieringConfiguration
Restituisce i dettagli `TieringConfiguration` per il `TieringConfigurationName` specificato. I dettagli sono il corpo di una configurazione a più livelli in formato JSON, oltre ai metadati di configurazione.
## Sintassi della richiesta
```
GET /tiering-configurations/tieringConfigurationName HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [tieringConfigurationName](#API_GetTieringConfiguration_RequestSyntax) **
Il nome univoco di una configurazione a più livelli.
Modello: `^[a-zA-Z0-9_]{1,200}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [TieringConfiguration](#API_GetTieringConfiguration_ResponseSyntax) **
Speciifica il corpo di una configurazione a più livelli. Include `TieringConfigurationName`.
Tipo: oggetto [TieringConfiguration](API_TieringConfiguration.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/GetTieringConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/GetTieringConfiguration)
# ListBackupJobs
Restituisce un elenco di processi di backup esistenti per un account autenticato negli ultimi 30 giorni. Per un periodo di tempo più lungo, prendere in considerazione l'utilizzo di questi [strumenti di monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html).
## Sintassi della richiesta
```
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
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByAccountId](#API_ListBackupJobs_RequestSyntax) **
L'ID account da cui elencare i processi. Restituisce solo i processi di backup associati all'ID account specificato.
Se utilizzato da un account di AWS Organizations gestione, pass `*` restituisce tutti i lavori all'interno dell'organizzazione.
Modello: `^[0-9]{12}$`
** [ByBackupVaultName](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup che verranno archiviati nel vault di backup specificato. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [ByCompleteAfter](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup completati dopo una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByCompleteBefore](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByCreatedAfter](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup creati dopo la data specificata.
** [ByCreatedBefore](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup creati prima della data specificata.
** [ByMessageCategory](#API_ListBackupJobs_RequestSyntax) **
Si tratta di un parametro opzionale che può essere utilizzato per filtrare i lavori con un valore MessageCategory che corrisponde al valore immesso.
Stringhe di esempio possono essere `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` e `InvalidParameters`.
Consulta [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html).
Il carattere jolly () restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
** [ByParentJobId](#API_ListBackupJobs_RequestSyntax) **
Si tratta di un filtro per elencare i processi (nidificati) figlio in base all'ID del processo padre.
** [ByResourceArn](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup che corrispondono alla al nome della risorsa Amazon (ARN) specificata.
** [ByResourceType](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup per le risorse specificate:
+ `Aurora` per Amazon Aurora
+ `CloudFormation`per AWS CloudFormation
+ `DocumentDB` per Amazon DocumentDB (compatibile con MongoDB)
+ `DynamoDB` per Amazon DynamoDB
+ `EBS` per Amazon Elastic Block Store
+ `EC2` per Amazon Elastic Compute Cloud
+ `EFS` per Amazon Elastic File System
+ `EKS`per Amazon Elastic Kubernetes Service
+ `FSx`per Amazon FSx
+ `Neptune` per Amazon Neptune
+ `RDS` per Amazon Relational Database Service
+ `Redshift` per Amazon Redshift
+ `S3`per Amazon Simple Storage Service (Amazon S3)
+ `SAP HANA on Amazon EC2`per database SAP HANA su istanze Amazon Elastic Compute Cloud
+ `Storage Gateway`per Gateway di archiviazione AWS
+ `Timestream` per Amazon Timestream
+ `VirtualMachine`per macchine VMware virtuali
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [ByState](#API_ListBackupJobs_RequestSyntax) **
Restituisce solo i processi di backup che si trovano nello stato specificato.
`Completed with issues` è uno stato specifico della console AWS Backup . Per l'API, questo stato si riferisce ai processi `COMPLETED` e a `MessageCategory` con un valore diverso da `SUCCESS`, vale a dire, lo stato è completato ma è accompagnato da un messaggio di stato.
Per ottenere il numero di processi per `Completed with issues`, esegui due richieste GET e sottrai il secondo numero più piccolo:
GET /backup-jobs/?state=COMPLETED
GET /backup-jobs/?messageCategory=SUCCESS&state=COMPLETED
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL`
** [MaxResults](#API_ListBackupJobs_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListBackupJobs_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupJobs](#API_ListBackupJobs_ResponseSyntax) **
Un array di strutture contenenti metadati sui processi di backup restituiti in formato JSON.
Tipo: matrice di oggetti [BackupJob](API_BackupJob.md)
** [NextToken](#API_ListBackupJobs_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupJobs)
# ListBackupJobSummaries
È la richiesta di riepilogo dei processi di backup creati o eseguiti negli ultimi 30 giorni. È possibile includere i parametri AccountID, State,, ResourceType, MessageCategory AggregationPeriod MaxResults, o NextToken per filtrare i risultati.
Questa richiesta restituisce un riepilogo che contiene Regione, Account ResourceType, Stato MessageCategory, StartTime, EndTime, e Numero di lavori inclusi.
## Sintassi della richiesta
```
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccountId](#API_ListBackupJobSummaries_RequestSyntax) **
Restituisce il numero di processi per l'account specificato.
Se la richiesta viene inviata da un account membro o da un account che non fa parte di AWS Organizations, verranno restituiti i lavori all'interno dell'account del richiedente.
Gli account root, amministratore e amministratore delegato possono utilizzare il valore ANY per restituire il numero di processi di ogni account dell'organizzazione.
`AGGREGATE_ALL` aggrega i numeri dei processi di tutti gli account dell'organizzazione autenticata, quindi restituisce la somma.
Modello: `^[0-9]{12}$`
** [AggregationPeriod](#API_ListBackupJobSummaries_RequestSyntax) **
Periodo per i risultati restituiti.
+ `ONE_DAY`- Il numero di lavori giornalieri per i 14 giorni precedenti.
+ `SEVEN_DAYS`- Il numero aggregato dei lavori per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`- Il numero aggregato dei lavori per i 14 giorni precedenti.
Valori validi: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS`
** [MaxResults](#API_ListBackupJobSummaries_RequestSyntax) **
Il numero massimo di elementi da restituire.
Il valore è un numero intero. L'intervallo di valori validi è compreso tra 1 e 500.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [MessageCategory](#API_ListBackupJobSummaries_RequestSyntax) **
Questo parametro restituisce il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio valide sono `AccessDenied`, `Success` e `InvalidParameters`. Vedi [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco delle MessageCategory stringhe accettate.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
** [NextToken](#API_ListBackupJobSummaries_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [ResourceType](#API_ListBackupJobSummaries_RequestSyntax) **
Restituisce il numero di processi per il tipo di risorsa specificato. Usa la richiesta `GetSupportedResourceTypes` per ottenere le stringhe per i tipi di risorsa supportati.
Il valore ANY restituisce il conteggio di tutti i tipi di risorse.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti i tipi di risorsa e restituisce la somma.
Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [State](#API_ListBackupJobSummaries_RequestSyntax) **
Questo parametro restituisce il numero di processi con lo stato specificato.
Il valore ANY restituisce il conteggio di tutti gli stati.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti gli stati e restituisce la somma.
`Completed with issues` è uno stato specifico della console AWS Backup . Per l'API, questo stato si riferisce ai processi `COMPLETED` e a `MessageCategory` con un valore diverso da `SUCCESS`, vale a dire, lo stato è completato ma è accompagnato da un messaggio di stato. Per ottenere il numero di processi per `Completed with issues`, esegui due richieste GET e sottrai il secondo numero più piccolo:
OTTIENI /audit/? backup-job-summaries AggregationPeriod=fourteen\$1days&state=Completato
OTTIENI /audit/? backup-job-summaries AggregationPeriod=QUATTORDICI GIORNI& =successo&state=Completato MessageCategory
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AggregationPeriod](#API_ListBackupJobSummaries_ResponseSyntax) **
Il periodo per i risultati restituiti.
+ `ONE_DAY`- Il numero di lavori giornalieri per i 14 giorni precedenti.
+ `SEVEN_DAYS`- Il numero aggregato dei lavori per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`- Il numero aggregato dei lavori per i 14 giorni precedenti.
Tipo: String
** [BackupJobSummaries](#API_ListBackupJobSummaries_ResponseSyntax) **
Le informazioni di riepilogo.
Tipo: matrice di oggetti [BackupJobSummary](API_BackupJobSummary.md)
** [NextToken](#API_ListBackupJobSummaries_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupJobSummaries)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupJobSummaries)
# ListBackupPlans
Elenca i piani di backup attivi per l'account.
## Sintassi della richiesta
```
GET /backup/plans/?includeDeleted=IncludeDeleted&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [IncludeDeleted](#API_ListBackupPlans_RequestSyntax) **
Un valore booleano con un valore predefinito di `FALSE` che restituisce i piani di backup eliminati se impostato su `TRUE`.
** [MaxResults](#API_ListBackupPlans_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListBackupPlans_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlansList](#API_ListBackupPlans_ResponseSyntax) **
Informazioni sui piani di backup.
Tipo: matrice di oggetti [BackupPlansListMember](API_BackupPlansListMember.md)
** [NextToken](#API_ListBackupPlans_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupPlans)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupPlans)
# ListBackupPlanTemplates
Elenca i modelli del piano di backup.
## Sintassi della richiesta
```
GET /backup/template/plans?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListBackupPlanTemplates_RequestSyntax) **
Il numero massimo di articoli da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListBackupPlanTemplates_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPlanTemplatesList": [
{
"BackupPlanTemplateId": "string",
"BackupPlanTemplateName": "string"
}
],
"NextToken": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanTemplatesList](#API_ListBackupPlanTemplates_ResponseSyntax) **
Un array di elementi dell'elenco di modelli contenenti i metadati sui modelli salvati.
Tipo: matrice di oggetti [BackupPlanTemplatesListMember](API_BackupPlanTemplatesListMember.md)
** [NextToken](#API_ListBackupPlanTemplates_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupPlanTemplates)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupPlanTemplates)
# ListBackupPlanVersions
Restituisce i metadati della versione dei tuoi piani di backup, inclusi Amazon Resource Names (ARNs), piano di backup IDs, date di creazione ed eliminazione, nomi dei piani e versione IDs.
## Sintassi della richiesta
```
GET /backup/plans/backupPlanId/versions/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_ListBackupPlanVersions_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
** [MaxResults](#API_ListBackupPlanVersions_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListBackupPlanVersions_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupPlanVersionsList](#API_ListBackupPlanVersions_ResponseSyntax) **
Un array di elementi dell'elenco delle versioni contenenti i metadati relativi ai piani di backup.
Tipo: matrice di oggetti [BackupPlansListMember](API_BackupPlansListMember.md)
** [NextToken](#API_ListBackupPlanVersions_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupPlanVersions)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupPlanVersions)
# ListBackupSelections
Restituisce un array contenente i metadati delle risorse associate al piano di backup di destinazione.
## Sintassi della richiesta
```
GET /backup/plans/backupPlanId/selections/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_ListBackupSelections_RequestSyntax) **
Identifica in modo univoco un piano di backup.
Obbligatorio: sì
** [MaxResults](#API_ListBackupSelections_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListBackupSelections_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupSelectionsList": [
{
"BackupPlanId": "string",
"CreationDate": number,
"CreatorRequestId": "string",
"IamRoleArn": "string",
"SelectionId": "string",
"SelectionName": "string"
}
],
"NextToken": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupSelectionsList](#API_ListBackupSelections_ResponseSyntax) **
Un array di elementi dell'elenco di selezione di backup contenente metadati relativi a ciascuna risorsa dell'elenco.
Tipo: matrice di oggetti [BackupSelectionsListMember](API_BackupSelectionsListMember.md)
** [NextToken](#API_ListBackupSelections_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupSelections)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupSelections)
# ListBackupVaults
Restituisce un elenco di container di storage dei punti di ripristino insieme alle informazioni su di essi.
## Sintassi della richiesta
```
GET /backup-vaults/?maxResults=MaxResults&nextToken=NextToken&shared=ByShared&vaultType=ByVaultType HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByShared](#API_ListBackupVaults_RequestSyntax) **
Questo parametro ordinerà l'elenco di vault in base ai vault condivisi.
** [ByVaultType](#API_ListBackupVaults_RequestSyntax) **
Questo parametro ordinerà l'elenco di vault in base al tipo di vault.
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`
** [MaxResults](#API_ListBackupVaults_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListBackupVaults_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultList](#API_ListBackupVaults_ResponseSyntax) **
Un array di membri dell'elenco dei vault di backup contenenti metadati di vault, inclusi nome della risorsa Amazon (ARN), nome visualizzato, data di creazione, numero di punti di ripristino salvati e informazioni di crittografia se le risorse salvate nel vault di backup sono crittografate.
Tipo: matrice di oggetti [BackupVaultListMember](API_BackupVaultListMember.md)
** [NextToken](#API_ListBackupVaults_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupVaults)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupVaults)
# ListCopyJobs
Restituisce i metadati relativi ai processi di copia.
## Sintassi della richiesta
```
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
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByAccountId](#API_ListCopyJobs_RequestSyntax) **
L'ID account da cui elencare i processi. Restituisce solo i processi di copia associati all'ID account specificato.
Modello: `^[0-9]{12}$`
** [ByCompleteAfter](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di copia completati dopo una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByCompleteBefore](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di copia completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByCreatedAfter](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di copia creati dopo la data specificata.
** [ByCreatedBefore](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di copia creati prima della data specificata.
** [ByDestinationVaultArn](#API_ListCopyJobs_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup di origine da cui copiare, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
** [ByMessageCategory](#API_ListCopyJobs_RequestSyntax) **
Questo è un parametro opzionale che può essere utilizzato per filtrare i lavori con un valore MessageCategory che corrisponde al valore immesso.
Stringhe di esempio possono essere `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` e `INVALIDPARAMETERS`.
Visualizza [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco di stringhe accettate.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
** [ByParentJobId](#API_ListCopyJobs_RequestSyntax) **
Si tratta di un filtro per elencare i processi (nidificati) figlio in base all'ID del processo padre.
** [ByResourceArn](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di copia che corrispondono al nome della risorsa Amazon (ARN) specificata.
** [ByResourceType](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di backup per le risorse specificate:
+ `Aurora` per Amazon Aurora
+ `CloudFormation`per AWS CloudFormation
+ `DocumentDB` per Amazon DocumentDB (compatibile con MongoDB)
+ `DynamoDB` per Amazon DynamoDB
+ `EBS` per Amazon Elastic Block Store
+ `EC2` per Amazon Elastic Compute Cloud
+ `EFS` per Amazon Elastic File System
+ `EKS`per Amazon Elastic Kubernetes Service
+ `FSx`per Amazon FSx
+ `Neptune` per Amazon Neptune
+ `RDS` per Amazon Relational Database Service
+ `Redshift` per Amazon Redshift
+ `S3`per Amazon Simple Storage Service (Amazon S3)
+ `SAP HANA on Amazon EC2`per database SAP HANA su istanze Amazon Elastic Compute Cloud
+ `Storage Gateway`per Gateway di archiviazione AWS
+ `Timestream` per Amazon Timestream
+ `VirtualMachine`per macchine VMware virtuali
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [BySourceRecoveryPointArn](#API_ListCopyJobs_RequestSyntax) **
Filtra i lavori di copia in base al punto di ripristino di origine specificato ARN.
** [ByState](#API_ListCopyJobs_RequestSyntax) **
Restituisce solo i processi di copia che si trovano nello stato specificato.
Valori validi: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL`
** [MaxResults](#API_ListCopyJobs_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListCopyJobs_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire un MaxResults numero di elementi, NextToken consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CopyJobs](#API_ListCopyJobs_ResponseSyntax) **
Un array di strutture contenenti metadati sui processi di copia restituiti in formato JSON.
Tipo: matrice di oggetti [CopyJob](API_CopyJob.md)
** [NextToken](#API_ListCopyJobs_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta di restituzione di un MaxResults numero di articoli, NextToken consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobs)
# ListCopyJobSummaries
Questa richiesta ottiene un elenco di processi di copia creati o eseguiti negli ultimi 30 giorni. È possibile includere i parametri AccountID, State,, ResourceType, MessageCategory AggregationPeriod MaxResults, o NextToken per filtrare i risultati.
Questa richiesta restituisce un riepilogo che contiene Regione, Account RestourceType, Stato MessageCategory, StartTime, EndTime, e Numero di lavori inclusi.
## Sintassi della richiesta
```
GET /audit/copy-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccountId](#API_ListCopyJobSummaries_RequestSyntax) **
Restituisce il numero di processi per l'account specificato.
Se la richiesta viene inviata da un account membro o da un account che non fa parte di AWS Organizations, verranno restituiti i lavori all'interno dell'account del richiedente.
Gli account root, amministratore e amministratore delegato possono utilizzare il valore ANY per restituire il numero di processi di ogni account dell'organizzazione.
`AGGREGATE_ALL` aggrega i numeri dei processi di tutti gli account dell'organizzazione autenticata, quindi restituisce la somma.
Modello: `^[0-9]{12}$`
** [AggregationPeriod](#API_ListCopyJobSummaries_RequestSyntax) **
Periodo per i risultati restituiti.
+ `ONE_DAY`- Il numero di lavori giornalieri per i 14 giorni precedenti.
+ `SEVEN_DAYS`- Il numero aggregato dei lavori per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`- Il numero aggregato dei lavori per i 14 giorni precedenti.
Valori validi: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS`
** [MaxResults](#API_ListCopyJobSummaries_RequestSyntax) **
Questo parametro imposta il numero massimo di elementi da restituire.
Il valore è un numero intero. L'intervallo di valori validi è compreso tra 1 e 500.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [MessageCategory](#API_ListCopyJobSummaries_RequestSyntax) **
Questo parametro restituisce il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio valide sono `AccessDenied`, `Success` e `InvalidParameters`. Vedi [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco delle MessageCategory stringhe accettate.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
** [NextToken](#API_ListCopyJobSummaries_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [ResourceType](#API_ListCopyJobSummaries_RequestSyntax) **
Restituisce il numero di processi per il tipo di risorsa specificato. Usa la richiesta `GetSupportedResourceTypes` per ottenere le stringhe per i tipi di risorsa supportati.
Il valore ANY restituisce il conteggio di tutti i tipi di risorse.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti i tipi di risorsa e restituisce la somma.
Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [State](#API_ListCopyJobSummaries_RequestSyntax) **
Questo parametro restituisce il numero di processi con lo stato specificato.
Il valore ANY restituisce il conteggio di tutti gli stati.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti gli stati e restituisce la somma.
Valori validi: `CREATED | RUNNING | ABORTING | ABORTED | COMPLETING | COMPLETED | FAILING | FAILED | PARTIAL | AGGREGATE_ALL | ANY`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AggregationPeriod](#API_ListCopyJobSummaries_ResponseSyntax) **
Il periodo per i risultati restituiti.
+ `ONE_DAY`- Il numero di lavori giornalieri per i 14 giorni precedenti.
+ `SEVEN_DAYS`- Il numero aggregato dei lavori per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`- Il numero aggregato dei lavori per i 14 giorni precedenti.
Tipo: String
** [CopyJobSummaries](#API_ListCopyJobSummaries_ResponseSyntax) **
Questo risultato mostra un riepilogo che contiene la regione, l'account, lo stato ResourceType MessageCategory, StartTime EndTime, e il numero di lavori inclusi.
Tipo: matrice di oggetti [CopyJobSummary](API_CopyJobSummary.md)
** [NextToken](#API_ListCopyJobSummaries_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobSummaries)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobSummaries)
# ListFrameworks
Restituisce un elenco di tutti i framework per un Account AWS and. Regione AWS
## Sintassi della richiesta
```
GET /audit/frameworks?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListFrameworks_RequestSyntax) **
Il numero di risultati desiderato è compreso tra 1 e 1.000. Opzionale. Se non specificato, la query restituirà 1 MB di dati.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListFrameworks_RequestSyntax) **
Un identificatore restituito dalla precedente chiamata a questa operazione, che può essere utilizzato per restituire il successivo set di elementi nell'elenco.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Frameworks": [
{
"CreationTime": number,
"DeploymentStatus": "string",
"FrameworkArn": "string",
"FrameworkDescription": "string",
"FrameworkName": "string",
"NumberOfControls": number
}
],
"NextToken": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Frameworks](#API_ListFrameworks_ResponseSyntax) **
I framework con i dettagli per ogni framework, tra cui il nome del framework, Amazon Resource Name (ARN), la descrizione, il numero di controlli, l'ora di creazione e lo stato della distribuzione.
Tipo: matrice di oggetti [Framework](API_Framework.md)
** [NextToken](#API_ListFrameworks_ResponseSyntax) **
Un identificatore restituito dalla precedente chiamata a questa operazione, che può essere utilizzato per restituire il successivo set di elementi nell'elenco.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListFrameworks)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListFrameworks)
# ListIndexedRecoveryPoints
Questa operazione restituisce un elenco di punti di ripristino a cui è associato un indice appartenente all'account specificato.
I parametri opzionali che è possibile includere sono: MaxResults NextToken SourceResourceArns;; CreatedBefore; CreatedAfter; e ResourceType.
## Sintassi della richiesta
```
GET /indexes/recovery-point/?createdAfter=CreatedAfter&createdBefore=CreatedBefore&indexStatus=IndexStatus&maxResults=MaxResults&nextToken=NextToken&resourceType=ResourceType&sourceResourceArn=SourceResourceArn HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [CreatedAfter](#API_ListIndexedRecoveryPoints_RequestSyntax) **
Restituisce solo i punti di ripristino indicizzati che sono stati creati dopo la data specificata.
** [CreatedBefore](#API_ListIndexedRecoveryPoints_RequestSyntax) **
Restituisce solo punti di ripristino indicizzati creati prima della data specificata.
** [IndexStatus](#API_ListIndexedRecoveryPoints_RequestSyntax) **
Includi questo parametro per filtrare l'elenco restituito in base agli stati indicati.
Valori accettati: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
** [MaxResults](#API_ListIndexedRecoveryPoints_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListIndexedRecoveryPoints_RequestSyntax) **
L'elemento successivo dopo un elenco parziale dei punti di ripristino restituiti.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di punti di ripristino indicizzati, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
** [ResourceType](#API_ListIndexedRecoveryPoints_RequestSyntax) **
Restituisce un elenco di punti di ripristino indicizzati per i tipi di risorse specificati.
I valori accettati includono:
+ `EBS` per Amazon Elastic Block Store
+ `S3`per Amazon Simple Storage Service (Amazon S3)
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [SourceResourceArn](#API_ListIndexedRecoveryPoints_RequestSyntax) **
Una stringa di Amazon Resource Name (ARN) che identifica in modo univoco la risorsa di origine.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [IndexedRecoveryPoints](#API_ListIndexedRecoveryPoints_ResponseSyntax) **
Questo è un elenco di punti di ripristino a cui è associato un indice appartenente all'account specificato.
Tipo: matrice di oggetti [IndexedRecoveryPoint](API_IndexedRecoveryPoint.md)
** [NextToken](#API_ListIndexedRecoveryPoints_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale dei punti di ripristino restituiti.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di punti di ripristino indicizzati, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListIndexedRecoveryPoints)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListIndexedRecoveryPoints)
# ListLegalHolds
Questa azione restituisce i metadati relativi ai blocchi a fini legali attivi e precedenti.
## Sintassi della richiesta
```
GET /legal-holds/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListLegalHolds_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListLegalHolds_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [LegalHolds](#API_ListLegalHolds_ResponseSyntax) **
Si tratta di un array di blocchi a fini legali restituiti, attivi e precedenti.
Tipo: matrice di oggetti [LegalHold](API_LegalHold.md)
** [NextToken](#API_ListLegalHolds_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListLegalHolds)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListLegalHolds)
# ListProtectedResources
Restituisce una serie di risorse con punti di ripristino creati da AWS Backup (indipendentemente dallo [stato](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRecoveryPoint.html#Backup-DescribeRecoveryPoint-response-Status) del punto di ripristino), tra cui l'ora in cui la risorsa è stata salvata, un Amazon Resource Name (ARN) della risorsa e un tipo di risorsa.
## Sintassi della richiesta
```
GET /resources/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListProtectedResources_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListProtectedResources_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Results": [
{
"LastBackupTime": number,
"LastBackupVaultArn": "string",
"LastRecoveryPointArn": "string",
"ResourceArn": "string",
"ResourceName": "string",
"ResourceType": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListProtectedResources_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [Results](#API_ListProtectedResources_ResponseSyntax) **
Una serie di risorse di cui è stato eseguito correttamente il backup, AWS Backup includendo l'ora in cui la risorsa è stata salvata, un Amazon Resource Name (ARN) della risorsa e un tipo di risorsa.
Tipo: matrice di oggetti [ProtectedResource](API_ProtectedResource.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListProtectedResources)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListProtectedResources)
# ListProtectedResourcesByBackupVault
Questa richiesta elenca le risorse protette corrispondenti a ciascun vault di backup.
## Sintassi della richiesta
```
GET /backup-vaults/backupVaultName/resources/?backupVaultAccountId=BackupVaultAccountId&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [BackupVaultAccountId](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **
L'elenco delle risorse protette dall'archivio di backup all'interno degli archivi specificati in base all'ID dell'account.
Modello: `^[0-9]{12}$`
** [backupVaultName](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **
L'elenco delle risorse protette dall'archivio di backup all'interno degli archivi specificati per nome.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [MaxResults](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Results": [
{
"LastBackupTime": number,
"LastBackupVaultArn": "string",
"LastRecoveryPointArn": "string",
"ResourceArn": "string",
"ResourceName": "string",
"ResourceType": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListProtectedResourcesByBackupVault_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [Results](#API_ListProtectedResourcesByBackupVault_ResponseSyntax) **
Questi sono i risultati restituiti per la richiesta. ListProtectedResourcesByBackupVault
Tipo: matrice di oggetti [ProtectedResource](API_ProtectedResource.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListProtectedResourcesByBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListProtectedResourcesByBackupVault)
# ListRecoveryPointsByBackupVault
Restituisce informazioni dettagliate sui punti di ripristino archiviati in un vault di backup.
## Sintassi della richiesta
```
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
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [BackupVaultAccountId](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Questo parametro ordina l'elenco dei punti di ripristino in base all'ID account.
Modello: `^[0-9]{12}$`
** [backupVaultName](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
È possibile che il nome del vault di backup non sia disponibile quando un servizio supportato crea il backup.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [ByBackupPlanId](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Restituisce solo i punti di ripristino che corrispondono all'ID del piano di backup specificato.
** [ByCreatedAfter](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Restituisce solo i punti di ripristino creati dopo il timestamp specificato.
** [ByCreatedBefore](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Restituisce solo i punti di ripristino creati prima del timestamp specificato.
** [ByParentRecoveryPointArn](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Ciò restituisce solo i punti di ripristino che corrispondono al nome della risorsa Amazon (ARN) del punto di ripristino (composito) padre.
** [ByResourceArn](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Restituisce solo i processi di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.
** [ByResourceType](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Restituisce solo i punti di ripristino che corrispondono ai tipi di risorsa specificati.
+ `Aurora` per Amazon Aurora
+ `CloudFormation`per AWS CloudFormation
+ `DocumentDB` per Amazon DocumentDB (compatibile con MongoDB)
+ `DynamoDB` per Amazon DynamoDB
+ `EBS` per Amazon Elastic Block Store
+ `EC2` per Amazon Elastic Compute Cloud
+ `EFS` per Amazon Elastic File System
+ `EKS`per Amazon Elastic Kubernetes Service
+ `FSx`per Amazon FSx
+ `Neptune` per Amazon Neptune
+ `RDS` per Amazon Relational Database Service
+ `Redshift` per Amazon Redshift
+ `S3`per Amazon Simple Storage Service (Amazon S3)
+ `SAP HANA on Amazon EC2`per database SAP HANA su istanze Amazon Elastic Compute Cloud
+ `Storage Gateway`per Gateway di archiviazione AWS
+ `Timestream` per Amazon Timestream
+ `VirtualMachine`per macchine VMware virtuali
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [MaxResults](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRecoveryPointsByBackupVault_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RecoveryPoints](#API_ListRecoveryPointsByBackupVault_ResponseSyntax) **
Un array di oggetti contenenti informazioni dettagliate sui punti di ripristino salvati in un vault di backup.
Tipo: matrice di oggetti [RecoveryPointByBackupVault](API_RecoveryPointByBackupVault.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByBackupVault)
# ListRecoveryPointsByLegalHold
Questa azione restituisce il punto di ripristino ARNs (Amazon Resource Names) della conservazione legale specificata.
## Sintassi della richiesta
```
GET /legal-holds/legalHoldId/recovery-points?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [legalHoldId](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **
L'ID del blocco a fini legali.
Obbligatorio: sì
** [MaxResults](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"RecoveryPoints": [
{
"BackupVaultName": "string",
"RecoveryPointArn": "string",
"ResourceArn": "string",
"ResourceType": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite.
Tipo: String
** [RecoveryPoints](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **
I punti di ripristino.
Tipo: matrice di oggetti [RecoveryPointMember](API_RecoveryPointMember.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByLegalHold)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByLegalHold)
# ListRecoveryPointsByResource
Le informazioni sui punti di ripristino del tipo specificato da una risorsa Amazon Resource Name (ARN).
**Nota**
Per Amazon EFS e Amazon EC2, questa azione elenca solo i punti di ripristino creati da AWS Backup.
## Sintassi della richiesta
```
GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ManagedByAWSBackupOnly](#API_ListRecoveryPointsByResource_RequestSyntax) **
Questo attributo filtra i punti di ripristino in base alla proprietà.
Se è impostato su`TRUE`, la risposta conterrà i punti di ripristino associati alle risorse selezionate gestite da AWS Backup.
Se è impostato su`FALSE`, la risposta conterrà tutti i punti di ripristino associati alla risorsa selezionata.
Tipo: Booleano
** [MaxResults](#API_ListRecoveryPointsByResource_RequestSyntax) **
Il numero massimo di elementi da restituire.
Amazon RDS richiede un valore pari almeno 20.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRecoveryPointsByResource_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [resourceArn](#API_ListRecoveryPointsByResource_RequestSyntax) **
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRecoveryPointsByResource_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RecoveryPoints](#API_ListRecoveryPointsByResource_ResponseSyntax) **
Un array di oggetti contenente informazioni dettagliate sui punti di ripristino del tipo di risorsa specificato.
Restituiscono solo i punti di EC2 ripristino Amazon EFS e Amazon BackupVaultName.
Tipo: matrice di oggetti [RecoveryPointByResource](API_RecoveryPointByResource.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByResource)
# ListReportJobs
Restituisce i dettagli relativi ai processi di report.
## Sintassi della richiesta
```
GET /audit/report-jobs?CreationAfter=ByCreationAfter&CreationBefore=ByCreationBefore&MaxResults=MaxResults&NextToken=NextToken&ReportPlanName=ByReportPlanName&Status=ByStatus HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByCreationAfter](#API_ListReportJobs_RequestSyntax) **
Restituisce solo i processi di report che sono stati creati dopo la data e l'ora specificati nel formato Unix e nell'ora UTC (Coordinated Universal Time). Ad esempio, il valore 1516925490 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.
** [ByCreationBefore](#API_ListReportJobs_RequestSyntax) **
Restituisce solo i processi di report che sono stati creati prima della data e ora specificati nel formato Unix e nell'ora UTC (Coordinated Universal Time). Ad esempio, il valore 1516925490 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.
** [ByReportPlanName](#API_ListReportJobs_RequestSyntax) **
Restituisce solo i processi di report con il nome del piano di report specificato.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
** [ByStatus](#API_ListReportJobs_RequestSyntax) **
Restituisce solo i processi di report che si trovano nello stato specificato. Gli stati sono:
`CREATED | RUNNING | COMPLETED | FAILED | COMPLETED_WITH_ISSUES`
Tieni presente che solo i lavori di scansione terminano con lo stato completato con problemi. Per i processi di backup, si tratta dell'interpretazione da console di un processo che termina nello stato di completamento e presenta un messaggio di stato.
** [MaxResults](#API_ListReportJobs_RequestSyntax) **
Il numero di risultati desiderato è compreso tra 1 e 1.000. Opzionale. Se non specificato, la query restituirà 1 MB di dati.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListReportJobs_RequestSyntax) **
Un identificatore restituito dalla precedente chiamata a questa operazione, che può essere utilizzato per restituire il successivo set di elementi nell'elenco.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListReportJobs_ResponseSyntax) **
Un identificatore restituito dalla precedente chiamata a questa operazione, che può essere utilizzato per restituire il successivo set di elementi nell'elenco.
Tipo: String
** [ReportJobs](#API_ListReportJobs_ResponseSyntax) **
I dettagli relativi ai processi di report in formato JSON.
Tipo: matrice di oggetti [ReportJob](API_ReportJob.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListReportJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListReportJobs)
# ListReportPlans
Restituisce un elenco dei piani di report. Per informazioni dettagliate su un singolo piano di report, utilizzare `DescribeReportPlan`.
## Sintassi della richiesta
```
GET /audit/report-plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListReportPlans_RequestSyntax) **
Il numero di risultati desiderato è compreso tra 1 e 1.000. Opzionale. Se non specificato, la query restituirà 1 MB di dati.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListReportPlans_RequestSyntax) **
Un identificatore restituito dalla precedente chiamata a questa operazione, che può essere utilizzato per restituire il successivo set di elementi nell'elenco.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListReportPlans_ResponseSyntax) **
Un identificatore restituito dalla precedente chiamata a questa operazione, che può essere utilizzato per restituire il successivo set di elementi nell'elenco.
Tipo: String
** [ReportPlans](#API_ListReportPlans_ResponseSyntax) **
I piani del rapporto con informazioni dettagliate per ogni piano. Queste informazioni includono il nome della risorsa Amazon (ARN), il nome del piano di report, la descrizione, le impostazioni, il canale di distribuzione, lo stato di implementazione, l'ora di creazione e le ore ultimo tentativo ed esecuzione completata.
Tipo: matrice di oggetti [ReportPlan](API_ReportPlan.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListReportPlans)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListReportPlans)
# ListRestoreAccessBackupVaults
Restituisce un elenco di archivi di backup per l'accesso al ripristino associati a un archivio di backup specificato.
## Sintassi della richiesta
```
GET /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_ListRestoreAccessBackupVaults_RequestSyntax) **
Il nome dell'archivio di backup per il quale elencare gli archivi di backup associati all'accesso di ripristino.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [MaxResults](#API_ListRestoreAccessBackupVaults_RequestSyntax) **
Il numero massimo di elementi da restituire nella risposta.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRestoreAccessBackupVaults_RequestSyntax) **
Il token di impaginazione di una richiesta precedente per recuperare il set successivo di risultati.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **
Il token di impaginazione da utilizzare in una richiesta successiva per recuperare il successivo set di risultati.
Tipo: String
** [RestoreAccessBackupVaults](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **
Un elenco di archivi di backup per l'accesso al ripristino associati all'archivio di backup specificato.
Tipo: matrice di oggetti [RestoreAccessBackupVaultListMember](API_RestoreAccessBackupVaultListMember.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreAccessBackupVaults)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreAccessBackupVaults)
# ListRestoreJobs
Restituisce un elenco di processi AWS Backup avviati per ripristinare una risorsa salvata, inclusi i dettagli sul processo di ripristino.
## Sintassi della richiesta
```
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
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByAccountId](#API_ListRestoreJobs_RequestSyntax) **
L'ID account da cui elencare i processi. Restituisce solo i processi di ripristino associati all'ID account specificato.
Modello: `^[0-9]{12}$`
** [ByCompleteAfter](#API_ListRestoreJobs_RequestSyntax) **
Restituisce solo i processi di copia completati dopo una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByCompleteBefore](#API_ListRestoreJobs_RequestSyntax) **
Restituisce solo i processi di copia completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByCreatedAfter](#API_ListRestoreJobs_RequestSyntax) **
Restituisce solo i processi di ripristino creati dopo la data specificata.
** [ByCreatedBefore](#API_ListRestoreJobs_RequestSyntax) **
Restituisce solo i processi di ripristino creati prima della data specificata.
** [ByParentJobId](#API_ListRestoreJobs_RequestSyntax) **
Si tratta di un filtro per elencare i processi di ripristino secondari (annidati) in base all'ID del processo di ripristino principale.
** [ByResourceType](#API_ListRestoreJobs_RequestSyntax) **
Includi questo parametro per restituire solo i processi di ripristino per le risorse specificate:
+ `Aurora` per Amazon Aurora
+ `CloudFormation`per AWS CloudFormation
+ `DocumentDB` per Amazon DocumentDB (compatibile con MongoDB)
+ `DynamoDB` per Amazon DynamoDB
+ `EBS` per Amazon Elastic Block Store
+ `EC2` per Amazon Elastic Compute Cloud
+ `EFS` per Amazon Elastic File System
+ `EKS`per Amazon Elastic Kubernetes Service
+ `FSx`per Amazon FSx
+ `Neptune` per Amazon Neptune
+ `RDS` per Amazon Relational Database Service
+ `Redshift` per Amazon Redshift
+ `S3`per Amazon Simple Storage Service (Amazon S3)
+ `SAP HANA on Amazon EC2`per database SAP HANA su istanze Amazon Elastic Compute Cloud
+ `Storage Gateway`per Gateway di archiviazione AWS
+ `Timestream` per Amazon Timestream
+ `VirtualMachine`per macchine VMware virtuali
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [ByRestoreTestingPlanArn](#API_ListRestoreJobs_RequestSyntax) **
Restituisce solo i processi di test di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.
** [ByStatus](#API_ListRestoreJobs_RequestSyntax) **
Restituisce solo i processi di ripristino associati allo stato processo specificato.
Valori validi: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED`
** [MaxResults](#API_ListRestoreJobs_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRestoreJobs_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRestoreJobs_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RestoreJobs](#API_ListRestoreJobs_ResponseSyntax) **
Un array di oggetti contenenti informazioni dettagliate sui processi per ripristinare le risorse salvate.
Tipo: matrice di oggetti [RestoreJobsListMember](API_RestoreJobsListMember.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobs)
# ListRestoreJobsByProtectedResource
Restituisce i processi di ripristino che contengono la risorsa protetta specificata.
È necessario includere `ResourceArn`. Facoltativamente, puoi includere `NextToken`, `ByStatus`, `MaxResults`, `ByRecoveryPointCreationDateAfter` e `ByRecoveryPointCreationDateBefore`.
## Sintassi della richiesta
```
GET /resources/resourceArn/restore-jobs/?maxResults=MaxResults&nextToken=NextToken&recoveryPointCreationDateAfter=ByRecoveryPointCreationDateAfter&recoveryPointCreationDateBefore=ByRecoveryPointCreationDateBefore&status=ByStatus HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByRecoveryPointCreationDateAfter](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **
Restituisce solo i processi di ripristino dei punti di ripristino creati dopo la data specificata.
** [ByRecoveryPointCreationDateBefore](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **
Restituisce solo i processi di ripristino dei punti di ripristino creati prima della data specificata.
** [ByStatus](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **
Restituisce solo i processi di ripristino associati allo stato processo specificato.
Valori validi: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED`
** [MaxResults](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [resourceArn](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **
Restituisce solo i processi di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRestoreJobsByProtectedResource_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RestoreJobs](#API_ListRestoreJobsByProtectedResource_ResponseSyntax) **
Un array di oggetti contenenti informazioni dettagliate sui processi per ripristinare le risorse salvate.
Tipo: matrice di oggetti [RestoreJobsListMember](API_RestoreJobsListMember.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobsByProtectedResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobsByProtectedResource)
# ListRestoreJobSummaries
Questa richiesta ottiene un riepilogo dei processi di ripristino creati o eseguiti negli ultimi 30 giorni. È possibile includere i parametri AccountID, State,, ResourceType AggregationPeriod MaxResults, o NextToken per filtrare i risultati.
Questa richiesta restituisce un riepilogo che contiene Regione, Account RestourceType, Stato MessageCategory, StartTime, EndTime, e Numero di lavori inclusi.
## Sintassi della richiesta
```
GET /audit/restore-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccountId](#API_ListRestoreJobSummaries_RequestSyntax) **
Restituisce il numero di processi per l'account specificato.
Se la richiesta viene inviata da un account membro o da un account che non fa parte di AWS Organizations, verranno restituiti i lavori all'interno dell'account del richiedente.
Gli account root, amministratore e amministratore delegato possono utilizzare il valore ANY per restituire il numero di processi di ogni account dell'organizzazione.
`AGGREGATE_ALL` aggrega i numeri dei processi di tutti gli account dell'organizzazione autenticata, quindi restituisce la somma.
Modello: `^[0-9]{12}$`
** [AggregationPeriod](#API_ListRestoreJobSummaries_RequestSyntax) **
Periodo per i risultati restituiti.
+ `ONE_DAY`- Il numero di lavori giornalieri per i 14 giorni precedenti.
+ `SEVEN_DAYS`- Il numero aggregato dei lavori per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`- Il numero aggregato dei lavori per i 14 giorni precedenti.
Valori validi: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS`
** [MaxResults](#API_ListRestoreJobSummaries_RequestSyntax) **
Questo parametro imposta il numero massimo di elementi da restituire.
Il valore è un numero intero. L'intervallo di valori validi è compreso tra 1 e 500.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRestoreJobSummaries_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [ResourceType](#API_ListRestoreJobSummaries_RequestSyntax) **
Restituisce il numero di processi per il tipo di risorsa specificato. Usa la richiesta `GetSupportedResourceTypes` per ottenere le stringhe per i tipi di risorsa supportati.
Il valore ANY restituisce il conteggio di tutti i tipi di risorse.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti i tipi di risorsa e restituisce la somma.
Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [State](#API_ListRestoreJobSummaries_RequestSyntax) **
Questo parametro restituisce il numero di processi con lo stato specificato.
Il valore ANY restituisce il conteggio di tutti gli stati.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti gli stati e restituisce la somma.
Valori validi: `CREATED | PENDING | RUNNING | ABORTED | COMPLETED | FAILED | AGGREGATE_ALL | ANY`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AggregationPeriod](#API_ListRestoreJobSummaries_ResponseSyntax) **
Il periodo per i risultati restituiti.
+ `ONE_DAY`- Il numero di lavori giornalieri per i 14 giorni precedenti.
+ `SEVEN_DAYS`- Il numero aggregato dei lavori per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`- Il numero aggregato dei lavori per i 14 giorni precedenti.
Tipo: String
** [NextToken](#API_ListRestoreJobSummaries_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RestoreJobSummaries](#API_ListRestoreJobSummaries_ResponseSyntax) **
Questo risultato contiene un riepilogo che contiene la regione, l'account, lo stato ResourceType MessageCategory, StartTime EndTime, e il numero di lavori inclusi.
Tipo: matrice di oggetti [RestoreJobSummary](API_RestoreJobSummary.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobSummaries)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobSummaries)
# ListRestoreTestingPlans
Restituisce un elenco di piani di test di ripristino.
## Sintassi della richiesta
```
GET /restore-testing/plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListRestoreTestingPlans_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRestoreTestingPlans_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRestoreTestingPlans_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RestoreTestingPlans](#API_ListRestoreTestingPlans_ResponseSyntax) **
È l'elenco dei piani di test di ripristino restituito.
Tipo: matrice di oggetti [RestoreTestingPlanForList](API_RestoreTestingPlanForList.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreTestingPlans)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreTestingPlans)
# ListRestoreTestingSelections
Restituisce un elenco di selezioni del test di ripristino. Può essere filtrato per `MaxResults` e `RestoreTestingPlanName`.
## Sintassi della richiesta
```
GET /restore-testing/plans/RestoreTestingPlanName/selections?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListRestoreTestingSelections_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListRestoreTestingSelections_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [RestoreTestingPlanName](#API_ListRestoreTestingSelections_RequestSyntax) **
Restituisce le selezioni del test di ripristino in base al nome del piano di test di ripristino specificato.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"RestoreTestingSelections": [
{
"CreationTime": number,
"IamRoleArn": "string",
"ProtectedResourceType": "string",
"RestoreTestingPlanName": "string",
"RestoreTestingSelectionName": "string",
"ValidationWindowHours": number
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListRestoreTestingSelections_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [RestoreTestingSelections](#API_ListRestoreTestingSelections_ResponseSyntax) **
Le selezioni del test di ripristino restituite associate al piano di test di ripristino.
Tipo: matrice di oggetti [RestoreTestingSelectionForList](API_RestoreTestingSelectionForList.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreTestingSelections)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreTestingSelections)
# ListScanJobs
Restituisce un elenco di processi di scansione esistenti per un account autenticato negli ultimi 30 giorni.
## Sintassi della richiesta
```
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
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByAccountId](#API_ListScanJobs_RequestSyntax) **
L'ID account da cui elencare i processi. Restituisce solo i processi di backup associati all'ID account specificato.
Se utilizzato da un account di gestione di AWS Organizations, pass `*` restituisce tutti i lavori all'interno dell'organizzazione.
Modello: `^[0-9]{12}$`
** [ByBackupVaultName](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i lavori di scansione che verranno archiviati nell'archivio di backup specificato. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati.
Modello: `^[a-zA-Z0-9\-\_\.]{2,50}$`
** [ByCompleteAfter](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i lavori di scansione completati dopo una data espressa in formato Unix e Coordinated Universal Time (UTC).
** [ByCompleteBefore](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i processi di backup completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
** [ByMalwareScanner](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i processi di scansione per lo scanner antimalware specificato. Attualmente supporta solo`GUARDDUTY`.
Valori validi: `GUARDDUTY`
** [ByRecoveryPointArn](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i processi di scansione eseguiti sul punto di ripristino specificato.
** [ByResourceArn](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i processi di scansione che corrispondono alla risorsa Amazon Resource Name (ARN) specificata.
** [ByResourceType](#API_ListScanJobs_RequestSyntax) **
Restituisce le selezioni del test di ripristino in base al nome del piano di test di ripristino specificato.
+ `EBS`per Amazon Elastic Block Store
+ `EC2`per Amazon Elastic Compute Cloud
+ `S3`per Amazon Simple Storage Service (Amazon S3)
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Valori validi: `EBS | EC2 | S3`
** [ByScanResultStatus](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i lavori di scansione per i risultati di scansione specificati:
+ `THREATS_FOUND`
+ `NO_THREATS_FOUND`
Valori validi: `NO_THREATS_FOUND | THREATS_FOUND`
** [ByState](#API_ListScanJobs_RequestSyntax) **
Restituisce solo i lavori di scansione per lo stato del lavoro di scansione specificato.
Valori validi: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING`
** [MaxResults](#API_ListScanJobs_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListScanJobs_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListScanJobs_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [ScanJobs](#API_ListScanJobs_ResponseSyntax) **
Una serie di strutture contenenti metadati sui lavori di scansione restituiti in formato JSON.
Tipo: matrice di oggetti [ScanJob](API_ScanJob.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobs)
# ListScanJobSummaries
Si tratta di una richiesta di riepilogo dei processi di scansione creati o in esecuzione negli ultimi 30 giorni.
## Sintassi della richiesta
```
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [AccountId](#API_ListScanJobSummaries_RequestSyntax) **
Restituisce il numero di processi per l'account specificato.
Se la richiesta viene inviata da un account membro o da un account che non fa parte di AWS Organizations, verranno restituiti i lavori all'interno dell'account del richiedente.
Gli account root, admin e amministratore delegato possono utilizzare il valore `ANY` per restituire il numero di job da ogni account dell'organizzazione.
`AGGREGATE_ALL` aggrega i numeri dei processi di tutti gli account dell'organizzazione autenticata, quindi restituisce la somma.
Modello: `^[0-9]{12}$`
** [AggregationPeriod](#API_ListScanJobSummaries_RequestSyntax) **
Periodo per i risultati restituiti.
+ `ONE_DAY`Il numero di lavori giornalieri per il giorno precedente.
+ `SEVEN_DAYS`Il numero di lavori giornalieri per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`Il numero di lavori giornalieri per i 14 giorni precedenti.
Valori validi: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS`
** [MalwareScanner](#API_ListScanJobSummaries_RequestSyntax) **
Restituisce solo i processi di scansione per lo scanner antimalware specificato. Attualmente l'unico MalwareScanner è`GUARDDUTY`. Ma il campo supporta anche`ANY`, e`AGGREGATE_ALL`.
Valori validi: `GUARDDUTY`
** [MaxResults](#API_ListScanJobSummaries_RequestSyntax) **
Il numero massimo di elementi da restituire.
Il valore è un numero intero. L'intervallo di valori validi è compreso tra 1 e 500.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListScanJobSummaries_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [ResourceType](#API_ListScanJobSummaries_RequestSyntax) **
Restituisce il numero di processi per il tipo di risorsa specificato. Usa la richiesta `GetSupportedResourceTypes` per ottenere le stringhe per i tipi di risorsa supportati.
Il valore `ANY` restituisce il conteggio di tutti i tipi di risorse.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutti i tipi di risorsa e restituisce la somma.
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
** [ScanResultStatus](#API_ListScanJobSummaries_RequestSyntax) **
Restituisce solo i lavori di scansione per i risultati di scansione specificati.
Valori validi: `NO_THREATS_FOUND | THREATS_FOUND`
** [State](#API_ListScanJobSummaries_RequestSyntax) **
Restituisce solo i lavori di scansione per lo stato del lavoro di scansione specificato.
Valori validi: `CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AggregationPeriod](#API_ListScanJobSummaries_ResponseSyntax) **
Il periodo per i risultati restituiti.
+ `ONE_DAY`Il numero di lavori giornalieri per il giorno precedente.
+ `SEVEN_DAYS`Il numero di lavori giornalieri per i 7 giorni precedenti.
+ `FOURTEEN_DAYS`Il numero di lavori giornalieri per i 14 giorni precedenti.
Valori validi: `'ONE_DAY'` \$1 `'SEVEN_DAYS'` \$1 `'FOURTEEN_DAYS'`
Tipo: String
** [NextToken](#API_ListScanJobSummaries_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [ScanJobSummaries](#API_ListScanJobSummaries_ResponseSyntax) **
Le informazioni di riepilogo.
Tipo: matrice di oggetti [ScanJobSummary](API_ScanJobSummary.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobSummaries)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobSummaries)
# ListTags
Restituisce i tag assegnati alla risorsa, ad esempio un punto di ripristino di destinazione, un piano di backup o un archivio di backup.
Questa operazione restituisce risultati in base al tipo di risorsa utilizzato nel valore di`resourceArn`. Ad esempio, i punti di ripristino di Amazon DynamoDB con impostazioni avanzate hanno un ARN (Amazon Resource Name) che inizia con. `arn:aws:backup` I punti di ripristino (backup) di DynamoDB senza impostazioni avanzate abilitate hanno un ARN che inizia con. `arn:aws:dynamodb`
Quando questa operazione viene chiamata e quando si includono valori con un ARN diverso da`arn:aws:backup`, può restituire una delle eccezioni elencate di seguito. `resourceArn` Per evitare questa eccezione, includi solo i valori che rappresentano i tipi di risorse completamente gestiti da. AWS Backup Questi hanno un ARN che inizia `arn:aws:backup` e sono indicati nella tabella [Feature availability by resource](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource).
## Sintassi della richiesta
```
GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListTags_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListTags_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
** [resourceArn](#API_ListTags_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa. Destinazioni valide per `ListTags` sono punti di ripristino, piani di backup e vault di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Tags": {
"string" : "string"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListTags_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [Tags](#API_ListTags_ResponseSyntax) **
Informazioni sui tag.
Tipo: mappatura stringa a stringa
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListTags)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListTags)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListTags)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListTags)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListTags)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListTags)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListTags)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListTags)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListTags)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListTags)
# ListTieringConfigurations
Restituisce un elenco di configurazioni di tiering.
## Sintassi della richiesta
```
GET /tiering-configurations/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_ListTieringConfigurations_RequestSyntax) **
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_ListTieringConfigurations_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"TieringConfigurations": [
{
"BackupVaultName": "string",
"CreationTime": number,
"LastUpdatedTime": number,
"TieringConfigurationArn": "string",
"TieringConfigurationName": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_ListTieringConfigurations_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di elementi, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [TieringConfigurations](#API_ListTieringConfigurations_ResponseSyntax) **
Una serie di configurazioni di tiering restituite dalla chiamata. `ListTieringConfigurations`
Tipo: matrice di oggetti [TieringConfigurationsListMember](API_TieringConfigurationsListMember.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListTieringConfigurations)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListTieringConfigurations)
# PutBackupVaultAccessPolicy
Imposta una policy basate sulle risorse, che viene utilizzata per gestire le autorizzazioni di accesso al vault di backup di destinazione. Richiede un nome del vault di backup e un documento sulla policy di accesso in formato JSON.
## Sintassi della richiesta
```
PUT /backup-vaults/backupVaultName/access-policy HTTP/1.1
Content-type: application/json
{
"Policy": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_PutBackupVaultAccessPolicy_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Policy](#API_PutBackupVaultAccessPolicy_RequestSyntax) **
Il documento relativo alla policy di accesso del vault di backup in formato JSON.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultAccessPolicy)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultAccessPolicy)
# PutBackupVaultLockConfiguration
Applica AWS Backup Vault Lock a un archivio di backup, impedendo i tentativi di eliminare qualsiasi punto di ripristino archiviato o creato in un archivio di backup. Vault Lock impedisce inoltre i tentativi di aggiornare la policy del ciclo di vita che controlla il periodo di conservazione di qualsiasi punto di ripristino attualmente archiviato in un vault di backup. Se specificato, Vault Lock impone un periodo di conservazione minimo e massimo per i processi di backup e copia futuri destinati a un vault di backup.
**Nota**
AWS Backup Vault Lock è stato valutato da Cohasset Associates per l'utilizzo in ambienti soggetti alle normative SEC 17a-4, CFTC e FINRA. [Per ulteriori informazioni su come AWS Backup Vault Lock si rapporta a queste normative, consulta la valutazione della conformità di Cohasset Associates.](https://docs.aws.amazon.com/aws-backup/latest/devguide/samples/cohassetreport.zip)
Per ulteriori informazioni, consulta [Vault Lock di AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html).
## Sintassi della richiesta
```
PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1
Content-type: application/json
{
"ChangeableForDays": number,
"MaxRetentionDays": number,
"MinRetentionDays": number
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_PutBackupVaultLockConfiguration_RequestSyntax) **
La configurazione AWS Backup Vault Lock che specifica il nome dell'archivio di backup che protegge.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ChangeableForDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **
La configurazione AWS Backup Vault Lock che specifica il numero di giorni prima della data di blocco. Ad esempio, impostare `ChangeableForDays` su 30 del 1 gennaio 2022 alle 20:00 UTC imposterà la data di blocco su 31 gennaio 2022 alle 20:00 UTC.
AWS Backup impone un periodo di riflessione di 72 ore prima che Vault Lock abbia effetto e diventi immutabile. Pertanto, devi impostare `ChangeableForDays` su 3 o su un valore maggiore.
Il valore massimo che puoi specificare è 36.500 giorni (circa 100 anni).
Prima della data di blocco, puoi eliminare Vault Lock dal vault utilizzando `DeleteBackupVaultLockConfiguration` o modificare la configurazione di Vault Lock utilizzando `PutBackupVaultLockConfiguration`. A partire dalla data di blocco, Vault Lock diventa immutabile e non può essere modificato o eliminato.
Se questo parametro non è specificato, puoi eliminare Vault Lock dal vault utilizzando `DeleteBackupVaultLockConfiguration` o modificare la configurazione di Vault Lock utilizzando `PutBackupVaultLockConfiguration` in qualsiasi momento.
Tipo: long
Obbligatorio: no
** [MaxRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **
La configurazione AWS Backup Vault Lock che specifica il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino. Questa impostazione può essere utile se, ad esempio, le policy dell'organizzazione richiedono la distruzione di determinati dati dopo averli conservati per quattro anni (1460 giorni).
Se questo parametro non è incluso, Vault Lock non applica un periodo di conservazione massimo sui punti di ripristino nel vault. Se questo parametro è incluso senza un valore, Vault Lock non applica un periodo di conservazione massimo.
Se questo parametro è specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o inferiore al periodo di conservazione massimo. Se il periodo di conservazione del processo è più lungo del periodo di conservazione massimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. Il periodo di conservazione massimo più lungo che è possibile specificare è di 36500 giorni (circa 100 anni). I punti di ripristino già salvati nel vault prima dell'applicazione del Vault Lock di non sono interessati.
Tipo: long
Obbligatorio: no
** [MinRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **
La configurazione AWS Backup Vault Lock che specifica il periodo di conservazione minimo durante il quale il vault conserva i propri punti di ripristino. Questa impostazione può essere utile se, ad esempio, le policy dell'organizzazione richiedono la conservazione di determinati dati per almeno sette anni (2555 giorni).
Questo parametro è obbligatorio quando viene creato un blocco del vault AWS CloudFormation; in caso contrario, questo parametro è facoltativo. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione minimo.
Se questo parametro è specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o superiore al periodo di conservazione minimo. Se il periodo di conservazione del processo è più breve del periodo di conservazione minimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. Il periodo di conservazione minimo più breve che è possibile specificare è di 1 giorno. I punti di ripristino già salvati nel vault prima dell'applicazione del Vault Lock di non sono interessati.
Tipo: long
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultLockConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultLockConfiguration)
# PutBackupVaultNotifications
Attiva le notifiche su un vault di backup per l'argomento e gli eventi specificati.
## Sintassi della richiesta
```
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json
{
"BackupVaultEvents": [ "string" ],
"SNSTopicArn": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_PutBackupVaultNotifications_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupVaultEvents](#API_PutBackupVaultNotifications_RequestSyntax) **
Un array di eventi che indica lo stato dei processi per il backup delle per il vault di backup. Per l'elenco degli eventi supportati, dei casi d'uso comuni e degli esempi di codice, consulta [Opzioni di notifica con AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-notifications.html).
L'elenco seguente include sia gli eventi supportati che gli eventi obsoleti che non sono più in uso (come riferimento). Gli eventi obsoleti non restituiscono stati o notifiche.
Tipo: array di stringhe
Valori validi: `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`
Obbligatorio: sì
** [SNSTopicArn](#API_PutBackupVaultNotifications_RequestSyntax) **
Il nome della risorsa Amazon (ARN) che specifica l'argomento per gli eventi di un vault di backup, ad esempio `arn:aws:sns:us-west-2:111122223333:MyVaultTopic`.
Tipo: stringa
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultNotifications)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultNotifications)
# PutRestoreValidationResult
Questa richiesta consente di inviare i risultati della convalida del test di ripristino indipendente a esecuzione automatica. `RestoreJobId` e `ValidationStatus` sono obbligatori. Facoltativamente, puoi specificare `ValidationStatusMessage`.
## Sintassi della richiesta
```
PUT /restore-jobs/restoreJobId/validations HTTP/1.1
Content-type: application/json
{
"ValidationStatus": "string",
"ValidationStatusMessage": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [restoreJobId](#API_PutRestoreValidationResult_RequestSyntax) **
Si tratta di un identificatore univoco di un processo di ripristino all'interno AWS Backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ValidationStatus](#API_PutRestoreValidationResult_RequestSyntax) **
Lo stato della convalida del ripristino.
Tipo: String
Valori validi: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`
Obbligatorio: sì
** [ValidationStatusMessage](#API_PutRestoreValidationResult_RequestSyntax) **
È una stringa di messaggio opzionale che puoi inserire per descrivere lo stato della convalida del test di ripristino.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 204
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutRestoreValidationResult)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutRestoreValidationResult)
# RevokeRestoreAccessBackupVault
Revoca l'accesso a un archivio di backup con accesso al ripristino, eliminando la possibilità di eseguire il ripristino dai relativi punti di ripristino ed eliminando definitivamente il vault.
## Sintassi della richiesta
```
DELETE /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/restoreAccessBackupVaultArn?requesterComment=RequesterComment HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **
Il nome dell'archivio di backup di origine associato all'archivio di backup con accesso di ripristino da revocare.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [RequesterComment](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **
Un commento che spiega il motivo della revoca dell'accesso al repository di backup per l'accesso di ripristino.
** [restoreAccessBackupVaultArn](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **
L'ARN del repository di backup per l'accesso al ripristino da revocare.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/RevokeRestoreAccessBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RevokeRestoreAccessBackupVault)
# StartBackupJob
Avvia un processo di backup on demand per la risorsa specificata.
## Sintassi della richiesta
```
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
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupOptions](#API_StartBackupJob_RequestSyntax) **
L'opzione di backup per una risorsa selezionata. Questa opzione è disponibile solo per i processi di backup di Windows Volume Shadow Copy Service (VSS).
Valori validi: imposta su `"WindowsVSS":"enabled"` per abilitare l'opzione di backup `WindowsVSS` e creare un backup di Windows VSS. Imposta su `"WindowsVSS""disabled"` per creare un backup regolare. Per impostazione predefinita, l'opzione `WindowsVSS` non è abilitata.
Tipo: mappatura stringa a stringa
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
Modello di valore: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** [BackupVaultName](#API_StartBackupJob_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [CompleteWindowMinutes](#API_StartBackupJob_RequestSyntax) **
Un valore in minuti durante il quale un backup avviato correttamente deve essere completato. In caso contrario, il processo verrà annullato da AWS Backup . Questo valore è facoltativo. Questo valore inizia il conto alla rovescia a partire dalla pianificazione del backup. Non aggiunge ulteriore tempo per `StartWindowMinutes` o se il backup è iniziato più tardi del previsto.
Analogamente a `StartWindowMinutes`, questo parametro ha un valore massimo di 100 anni (52.560.000 minuti).
Tipo: long
Obbligatorio: no
** [IamRoleArn](#API_StartBackupJob_RequestSyntax) **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.
Tipo: stringa
Obbligatorio: sì
** [IdempotencyToken](#API_StartBackupJob_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartBackupJob`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [Index](#API_StartBackupJob_RequestSyntax) **
Includi questo parametro per abilitare la creazione dell'indice se il job di backup ha un tipo di risorsa che supporta gli indici di backup.
I tipi di risorse che supportano gli indici di backup includono:
+ `EBS` per Amazon Elastic Block Store
+ `S3`per Amazon Simple Storage Service (Amazon S3)
L'indice può avere 1 dei 2 valori possibili, uno `ENABLED` o `DISABLED` l'altro.
Per creare un indice di backup per un punto di `ACTIVE` ripristino idoneo che non dispone ancora di un indice di backup, imposta il valore su`ENABLED`.
Per eliminare un indice di backup, imposta il valore su`DISABLED`.
Tipo: String
Valori validi: `ENABLED | DISABLED`
Campo obbligatorio: no
** [Lifecycle](#API_StartBackupJob_RequestSyntax) **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup eseguirà automaticamente la transizione e la scadenza dei backup in base al ciclo di vita definito.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Questo parametro ha un valore massimo di 100 anni (36.5000 giorni).
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** [LogicallyAirGappedBackupVaultArn](#API_StartBackupJob_RequestSyntax) **
L'ARN di un caveau con intercapedine logiche. L'ARN deve trovarsi nello stesso account e nella stessa regione. Se fornite, le risorse completamente gestite supportate eseguono il backup direttamente nel vault logicamente separato, mentre altre risorse supportate creano un'istantanea temporanea (fatturabile) nel vault di backup, quindi la copiano in un archivio con sistema logico. Le risorse non supportate eseguono il backup solo nell'archivio di backup specificato.
▬Tipo: stringa
Obbligatorio: no
** [RecoveryPointTags](#API_StartBackupJob_RequestSyntax) **
I tag da assegnare alle risorse.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** [ResourceArn](#API_StartBackupJob_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: stringa
Obbligatorio: sì
** [StartWindowMinutes](#API_StartBackupJob_RequestSyntax) **
Un valore in minuti dopo la pianificazione di un backup prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo e l'impostazione predefinita è 8 ore. Se questo valore è incluso, devono essere necessari almeno 60 minuti per evitare errori.
Il valore massimo di questo parametro è 100 anni (52.560.000 minuti).
Durante la finestra di avvio, il processo di backup rimane in stato `CREATED` finché non viene avviato correttamente o fino alla scadenza della finestra di avvio. Se all'interno della finestra di avvio AWS Backup viene visualizzato un errore che consente di riprovare il lavoro, AWS Backup riproverà automaticamente a iniziare il processo almeno ogni 10 minuti fino all'avvio corretto del backup (lo stato del lavoro cambia in`RUNNING`) o fino a quando lo stato del lavoro non cambia a `EXPIRED` (cosa che dovrebbe verificarsi al termine della finestra di avvio).
Tipo: long
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupJobId": "string",
"CreationDate": number,
"IsParent": boolean,
"RecoveryPointArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupJobId](#API_StartBackupJob_ResponseSyntax) **
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.
Tipo: String
** [CreationDate](#API_StartBackupJob_ResponseSyntax) **
La data e l'ora di creazione di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IsParent](#API_StartBackupJob_ResponseSyntax) **
Questo è un valore booleano restituito che indica che si tratta di un processo di backup (composito) padre.
Tipo: Booleano
** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) **
*Nota: questo campo viene restituito solo per le risorse Amazon EFS e Advanced DynamoDB.*
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartBackupJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartBackupJob)
# StartCopyJob
Avvia un processo per creare una copia univoca della risorsa specificata.
Non supporta backup continui.
Vedi [Copia nuovo tentativo di lavoro](https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry) per informazioni su come i nuovi AWS Backup tentativi di copiare le operazioni di lavoro.
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup di destinazione in cui copiare; ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: stringa
Obbligatorio: sì
** [IamRoleArn](#API_StartCopyJob_RequestSyntax) **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: stringa
Obbligatorio: sì
** [IdempotencyToken](#API_StartCopyJob_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartCopyJob`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [Lifecycle](#API_StartCopyJob_RequestSyntax) **
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** [RecoveryPointArn](#API_StartCopyJob_RequestSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino da utilizzare per il processo di copia; ad esempio, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 B5E7-9EB0-435A-A80B-108B488B0D45. EB3
Tipo: stringa
Obbligatorio: sì
** [SourceBackupVaultName](#API_StartCopyJob_RequestSyntax) **
Il nome di un container di origine logico in cui vengono archiviati i backup. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CopyJobId": "string",
"CreationDate": number,
"IsParent": boolean
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CopyJobId](#API_StartCopyJob_ResponseSyntax) **
Identifica in modo univoco un processo di copia.
Tipo: String
** [CreationDate](#API_StartCopyJob_ResponseSyntax) **
La data e l'ora di creazione di un processo di copia, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [IsParent](#API_StartCopyJob_ResponseSyntax) **
Questo è un valore booleano restituito che indica che si tratta di un processo di copia (composito) padre.
Tipo: Booleano
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartCopyJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartCopyJob)
# StartReportJob
Avvia un processo di report on demand per il piano di report specificato.
## Sintassi della richiesta
```
POST /audit/report-jobs/reportPlanName HTTP/1.1
Content-type: application/json
{
"IdempotencyToken": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [reportPlanName](#API_StartReportJob_RequestSyntax) **
Il nome univoco di un piano di report.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [IdempotencyToken](#API_StartReportJob_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartReportJobInput`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ReportJobId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ReportJobId](#API_StartReportJob_ResponseSyntax) **
L'identificatore del processo di report. Stringa con codifica UTF-8 Unicode univoca generata casualmente con lunghezza massima di 1.024 byte. L'ID processo report non può essere modificato.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartReportJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartReportJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartReportJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartReportJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartReportJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartReportJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartReportJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartReportJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartReportJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartReportJob)
# StartRestoreJob
Recupera la risorsa salvata identificata da un nome della risorsa Amazon (ARN).
## Sintassi della richiesta
```
PUT /restore-jobs HTTP/1.1
Content-type: application/json
{
"CopySourceTagsToRestoredResource": boolean,
"IamRoleArn": "string",
"IdempotencyToken": "string",
"Metadata": {
"string" : "string"
},
"RecoveryPointArn": "string",
"ResourceType": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) **
Si tratta di un parametro facoltativo. Se questo è uguale a `True`, i tag inclusi nel backup verranno copiati nella risorsa ripristinata.
Questo può essere applicato solo ai backup creati tramite AWS Backup.
Tipo: Booleano
Obbligatorio: no
** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) **
L'Amazon Resource Name (ARN) del ruolo IAM AWS Backup utilizzato per creare la risorsa di destinazione; ad esempio:. `arn:aws:iam::123456789012:role/S3Access`
▬Tipo: stringa
Obbligatorio: no
** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartRestoreJob`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [Metadata](#API_StartRestoreJob_RequestSyntax) **
Un set di coppie chiave-valore di metadati.
Puoi ottenere i metadati di configurazione relativi a una risorsa al momento del backup chiamando `GetRecoveryPointRestoreMetadata`. Tuttavia, per ripristinare una risorsa potrebbero essere necessari altri valori oltre a quelli forniti da `GetRecoveryPointRestoreMetadata`. Ad esempio, potrebbe essere necessario fornire un nuovo nome di risorsa se l'originale esiste già.
Per ulteriori informazioni sui metadati per ogni risorsa, consulta quanto segue:
+ [Metadati per Amazon Aurora](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli)
+ [Metadati per Amazon DocumentDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli)
+ [Metadati per AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli)
+ [Metadati per Amazon DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli)
+ [Metadati per Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli)
+ [Metadati per Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli)
+ [Metadati per Amazon EFS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli)
+ [Metadati per Amazon EKS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section)
+ [Metadati per Amazon FSx](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli)
+ [Metadati per Amazon Neptune](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli)
+ [Metadati per Amazon RDS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli)
+ [Metadati per Amazon Redshift](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api)
+ [Metadati per Gateway di archiviazione AWS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli)
+ [Metadati per Amazon S3](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli)
+ [Metadati per Amazon Timestream](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api)
+ [Metadati per macchine virtuali](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli)
Tipo: mappatura stringa a stringa
Obbligatorio: sì
** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: stringa
Obbligatorio: sì
** [ResourceType](#API_StartRestoreJob_RequestSyntax) **
Avvia un processo per ripristinare un punto di ripristino per una delle seguenti risorse:
+ `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`- Servizio Amazon Elastic Kubernetes
+ `FSx`- Amazon FSx
+ `Neptune`- Amazon Neptune
+ `RDS`- Amazon Relational Database Service
+ `Redshift`- Amazon Redshift
+ `Storage Gateway` - Gateway di archiviazione AWS
+ `S3`- Servizio Amazon Simple Storage
+ `Timestream`- Amazon Timestream
+ `VirtualMachine`- Macchine virtuali
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"RestoreJobId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) **
Identifica in modo univoco il processo che ripristina un punto di ripristino.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob)
# StartScanJob
Avvia la scansione dei lavori per risorse specifiche.
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupVaultName](#API_StartScanJob_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Tipo: stringa
Obbligatorio: sì
** [IamRoleArn](#API_StartScanJob_RequestSyntax) **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.
Tipo: stringa
Obbligatorio: sì
** [IdempotencyToken](#API_StartScanJob_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartScanJob`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [MalwareScanner](#API_StartScanJob_RequestSyntax) **
Speciifica lo scanner antimalware utilizzato durante il processo di scansione. Attualmente supporta `GUARDDUTY` solo.
Tipo: String
Valori validi: `GUARDDUTY`
Obbligatorio: sì
** [RecoveryPointArn](#API_StartScanJob_RequestSyntax) **
Un Amazon Resource Name (ARN) che identifica in modo univoco un punto di ripristino. Questo è il punto di ripristino di destinazione per una scansione completa. Se si esegue una scansione incrementale, questo sarà il punto di ripristino creato dopo la selezione del punto di ripristino di base.
Tipo: stringa
Obbligatorio: sì
** [ScanBaseRecoveryPointArn](#API_StartScanJob_RequestSyntax) **
Un ARN che identifica in modo univoco il punto di ripristino di base da utilizzare per la scansione incrementale.
▬Tipo: stringa
Obbligatorio: no
** [ScanMode](#API_StartScanJob_RequestSyntax) **
Speciifica il tipo di scansione utilizzato per il processo di scansione.
Include:
+ `FULL_SCAN`eseguirà la scansione dell'intera sequenza di dati all'interno del backup.
+ `INCREMENTAL_SCAN`eseguirà la scansione della differenza di dati tra il punto di ripristino di destinazione e l'ARN del punto di ripristino di base.
Tipo: String
Valori validi: `FULL_SCAN | INCREMENTAL_SCAN`
Obbligatorio: sì
** [ScannerRoleArn](#API_StartScanJob_RequestSyntax) **
Specificato l'ARN del ruolo dello scanner IAM.
Tipo: stringa
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 201
Content-type: application/json
{
"CreationDate": number,
"ScanJobId": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationDate](#API_StartScanJob_ResponseSyntax) **
La data e l'ora di creazione di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [ScanJobId](#API_StartScanJob_ResponseSyntax) **
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartScanJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartScanJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartScanJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartScanJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartScanJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartScanJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartScanJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartScanJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartScanJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartScanJob)
# StopBackupJob
Tenta di annullare un processo per creare un backup univoco di una risorsa.
Questa azione non è supportata per i seguenti servizi:
+ Amazon Aurora
+ Amazon DocumentDB (compatibile con MongoDB)
+ Amazon FSx per Lustre
+ Amazon FSx per NetApp ONTAP
+ Amazon FSx per OpenZFS
+ File server Amazon FSx per Windows
+ Amazon Neptune
+ Database SAP HANA su istanze Amazon EC2
+ Amazon RDS
## Sintassi della richiesta
```
POST /backup-jobs/backupJobId HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupJobId](#API_StopBackupJob_RequestSyntax) **
Identifica in modo univoco una richiesta di backup di AWS Backup una risorsa.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StopBackupJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StopBackupJob)
# TagResource
Assegna un insieme di coppie chiave-valore a una risorsa.
## Sintassi della richiesta
```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json
{
"Tags": {
"string" : "string"
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [resourceArn](#API_TagResource_RequestSyntax) **
L'ARN che identifica in modo univoco la risorsa.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Tags](#API_TagResource_RequestSyntax) **
Coppie chiave-valore utilizzate per semplificare l'organizzazione delle risorse. Puoi assegnare i tuoi metadati alle risorse create. Per chiarezza, questa è la struttura per assegnare i tag: `[{"Key":"string","Value":"string"}]`.
Tipo: mappatura stringa a stringa
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/TagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/TagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/TagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/TagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/TagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/TagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/TagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TagResource)
# UntagResource
Rimuove un set di coppie chiave-valore da un punto di ripristino, un piano di backup o un vault di backup identificato da un nome della risorsa Amazon (ARN)
Questa API non è supportata per i punti di ripristino per tipi di risorse tra cui Aurora, Amazon DocumentDB. Amazon EBS, Amazon FSx, Neptune e Amazon RDS.
## Sintassi della richiesta
```
POST /untag/resourceArn HTTP/1.1
Content-type: application/json
{
"TagKeyList": [ "string" ]
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [resourceArn](#API_UntagResource_RequestSyntax) **
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo della risorsa con tag.
ARNs quelli che non includono `backup` sono incompatibili con l'etichettatura. `TagResource`e `UntagResource` con invalid ARNs verrà generato un errore. I contenuti ARN accettabili possono includere. `arn:aws:backup:us-east` Potrebbe apparire un contenuto ARN non valido. `arn:aws:ec2:us-east`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [TagKeyList](#API_UntagResource_RequestSyntax) **
Le chiavi per identificare quali tag chiave-valore rimuovere da una risorsa.
Tipo: array di stringhe
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UntagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UntagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UntagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UntagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UntagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UntagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UntagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UntagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UntagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UntagResource)
# UpdateBackupPlan
Aggiorna il piano di backup specificato. La nuova versione è identificata in modo univoco dal relativo ID.
## Sintassi della richiesta
```
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"
}
]
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupPlanId](#API_UpdateBackupPlan_RequestSyntax) **
L'ID del piano di backup.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [BackupPlan](#API_UpdateBackupPlan_RequestSyntax) **
Il corpo di un piano di backup. Include un `BackupPlanName` e uno o più set di `Rules`.
Tipo: oggetto [BackupPlanInput](API_BackupPlanInput.md)
Obbligatorio: sì
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AdvancedBackupSettings](#API_UpdateBackupPlan_ResponseSyntax) **
Contiene un elenco di `BackupOptions` per ogni tipo di risorsa.
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)
** [BackupPlanArn](#API_UpdateBackupPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
Tipo: String
** [BackupPlanId](#API_UpdateBackupPlan_ResponseSyntax) **
Identifica in modo univoco un piano di backup.
Tipo: String
** [CreationDate](#API_UpdateBackupPlan_ResponseSyntax) **
La data e l'ora di creazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [ScanSettings](#API_UpdateBackupPlan_ResponseSyntax) **
Contiene la configurazione di scansione per il piano di backup e include lo scanner Malware, le risorse selezionate e il ruolo dello scanner.
Tipo: matrice di oggetti [ScanSetting](API_ScanSetting.md)
** [VersionId](#API_UpdateBackupPlan_ResponseSyntax) **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. Gli Id della versione non possono essere modificati.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateBackupPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateBackupPlan)
# UpdateFramework
Aggiorna il framework specificato.
## Sintassi della richiesta
```
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"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [frameworkName](#API_UpdateFramework_RequestSyntax) **
Il nome univoco di un framework. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [FrameworkControls](#API_UpdateFramework_RequestSyntax) **
I controlli che compongono il framework. Ogni controllo nell'elenco dispone di nome, parametri di input e ambito.
Tipo: matrice di oggetti [FrameworkControl](API_FrameworkControl.md)
Obbligatorio: no
** [FrameworkDescription](#API_UpdateFramework_RequestSyntax) **
Descrizione facoltativa del framework, per un massimo di 1.024 caratteri.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
Obbligatorio: no
** [IdempotencyToken](#API_UpdateFramework_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `UpdateFrameworkInput`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"FrameworkArn": "string",
"FrameworkName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_UpdateFramework_ResponseSyntax) **
La data e l'ora di creazione del framework, nella rappresentazione ISO 8601. Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, 2020-07-10T15:00:00.000-08:00 rappresenta il 10 luglio 2020 alle 15:00 8 ore indietro rispetto all'UTC.
Tipo: Timestamp
** [FrameworkArn](#API_UpdateFramework_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [FrameworkName](#API_UpdateFramework_ResponseSyntax) **
Il nome univoco di un framework. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateFramework)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateFramework)
# UpdateGlobalSettings
Aggiorna se l' AWS account ha abilitato diverse opzioni di gestione tra account, tra cui il backup tra account, l'approvazione multipartitica e l'amministratore delegato. Restituisce un errore se l'account non è un account di gestione Organizations. Utilizza l'API `DescribeGlobalSettings` per determinare le impostazioni correnti.
## Sintassi della richiesta
```
PUT /global-settings HTTP/1.1
Content-type: application/json
{
"GlobalSettings": {
"string" : "string"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [GlobalSettings](#API_UpdateGlobalSettings_RequestSyntax) **
Gli input possono includere:
Un valore per`isCrossAccountBackupEnabled`. I valori possono essere veri o falsi. Esempio: `update-global-settings --global-settings isCrossAccountBackupEnabled=false`.
Un valore per l'approvazione multipartitica, con lo stile. `isMpaEnabled` I valori possono essere veri o falsi. Esempio: `update-global-settings --global-settings isMpaEnabled=false`.
Un valore per la creazione di ruoli collegati al servizio di Backup, con lo stile. `isDelegatedAdministratorEnabled` I valori possono essere veri o falsi. Esempio: `update-global-settings --global-settings isDelegatedAdministratorEnabled=false`.
Tipo: mappatura stringa a stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateGlobalSettings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateGlobalSettings)
# UpdateRecoveryPointIndexSettings
Questa operazione aggiorna le impostazioni di un indice dei punti di ripristino.
Obbligatorio: BackupVaultName RecoveryPointArn, e IAMRole Arn
## Sintassi della richiesta
```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json
{
"IamRoleArn": "string",
"Index": "string"
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
I caratteri accettati includono lettere minuscole, numeri e trattini.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [IamRoleArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **
Questo specifica l'ARN del ruolo IAM utilizzato per questa operazione.
Ad esempio, arn:aws:iam: :123456789012:role/s3access
▬Tipo: stringa
Obbligatorio: no
** [Index](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **
L'indice può avere 1 dei 2 valori possibili, oppure. `ENABLED` `DISABLED`
Per creare un indice di backup per un punto di `ACTIVE` ripristino idoneo che non dispone ancora di un indice di backup, imposta il valore su`ENABLED`.
Per eliminare un indice di backup, imposta il valore su`DISABLED`.
Tipo: String
Valori validi: `ENABLED | DISABLED`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultName": "string",
"Index": "string",
"IndexStatus": "string",
"RecoveryPointArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultName](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
** [Index](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **
L'indice può avere 1 dei 2 valori possibili, `ENABLED` oppure`DISABLED`.
Un valore di `ENABLED` indica che è stato creato un indice di backup per un punto di `ACTIVE` ripristino idoneo.
Un valore di `DISABLED` indica che un indice di backup è stato eliminato.
Tipo: String
Valori validi: `ENABLED | DISABLED`
** [IndexStatus](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **
Questo è lo stato corrente dell'indice di backup associato al punto di ripristino specificato.
Gli stati sono: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Tipo: String
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
** [RecoveryPointArn](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings)
# UpdateRecoveryPointLifecycle
Imposta il ciclo di vita delle transizioni di un punto di ripristino.
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle [funzionalità](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
**Importante**
Se il tuo ciclo di vita utilizza attualmente i parametri`MoveToColdStorageAfterDays`, includi questi parametri `DeleteAfterDays` e i relativi valori quando richiami questa operazione. La loro mancata inclusione può comportare l'aggiornamento del piano con valori nulli.
Questa operazione non supporta backup continui.
## Sintassi della richiesta
```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json
{
"Lifecycle": {
"DeleteAfterDays": number,
"DeleteAfterEvent": "string",
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [backupVaultName](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** [recoveryPointArn](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Lifecycle](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BackupVaultArn](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **
Un ARN che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: String
** [CalculatedLifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **
Un oggetto `CalculatedLifecycle` contenente i timestamp `DeleteAt` e `MoveToColdStorageAt`.
Tipo: oggetto [CalculatedLifecycle](API_CalculatedLifecycle.md)
** [Lifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
** [RecoveryPointArn](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidRequestException **
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRecoveryPointLifecycle)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRecoveryPointLifecycle)
# UpdateRegionSettings
Aggiorna le attuali impostazioni opt-in del servizio per la regione.
Utilizza l'API `DescribeRegionSettings` per determinare i tipi di risorse supportati.
## Sintassi della richiesta
```
PUT /account-settings HTTP/1.1
Content-type: application/json
{
"ResourceTypeManagementPreference": {
"string" : boolean
},
"ResourceTypeOptInPreference": {
"string" : boolean
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ResourceTypeManagementPreference](#API_UpdateRegionSettings_RequestSyntax) **
Abilita o disabilita la AWS Backup gestione completa dei backup per un tipo di risorsa. [Per abilitare la AWS Backup gestione completa di DynamoDB insieme alle funzionalità di backup [avanzate AWS Backup di DynamoDB, segui la procedura per abilitare il backup avanzato di DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html) a livello di codice.](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli)
Tipo: mappatura da stringa a matrice
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** [ResourceTypeOptInPreference](#API_UpdateRegionSettings_RequestSyntax) **
Aggiorna l'elenco di servizi insieme alle preferenze opt-in per la regione.
Se le assegnazioni delle risorse si basano solo sui tag, vengono applicate le impostazioni opt-in del servizio. Se un tipo di risorsa viene assegnato in modo esplicito a un piano di backup, come Amazon S3, EC2 Amazon o Amazon RDS, verrà incluso nel backup anche se l'opt-in non è abilitato per quel particolare servizio. Se in un'assegnazione di risorse sono specificati un tipo di risorsa e i tag, il tipo di risorsa specificato nel piano di backup ha la priorità sulla condizione associata al tag. Le impostazioni opt-in del servizio vengono ignorate in questa situazione.
Tipo: mappatura da stringa a matrice
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRegionSettings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRegionSettings)
# UpdateReportPlan
Aggiorna il piano di report specificato.
## Sintassi della richiesta
```
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"
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [reportPlanName](#API_UpdateReportPlan_RequestSyntax) **
Il nome univoco del piano di report. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [IdempotencyToken](#API_UpdateReportPlan_RequestSyntax) **
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `UpdateReportPlanInput`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
** [ReportDeliveryChannel](#API_UpdateReportPlan_RequestSyntax) **
Le informazioni su dove inviare i report, in particolare il nome del bucket Amazon S3, il prefisso della chiave S3 e i formati dei report.
Tipo: oggetto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)
Obbligatorio: no
** [ReportPlanDescription](#API_UpdateReportPlan_RequestSyntax) **
Descrizione facoltativa del piano di report, per un massimo di 1.024 caratteri.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
Obbligatorio: no
** [ReportSetting](#API_UpdateReportPlan_RequestSyntax) **
Il modello di report per il report. I report vengono creati utilizzando un modello di report. I modelli di report sono:
`RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`
Se il modello di report è `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, questa risorsa API descrive anche la copertura del report Regioni AWS e i framework.
Tipo: oggetto [ReportSetting](API_ReportSetting.md)
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"ReportPlanArn": "string",
"ReportPlanName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_UpdateReportPlan_ResponseSyntax) **
La data e l'ora di creazione di un piano di report, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [ReportPlanArn](#API_UpdateReportPlan_ResponseSyntax) **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: String
** [ReportPlanName](#API_UpdateReportPlan_ResponseSyntax) **
Il nome univoco del piano di report.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateReportPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateReportPlan)
# UpdateRestoreTestingPlan
Questa richiesta invia le modifiche al piano di test di ripristino specificato. Non è possibile aggiornare `RestoreTestingPlanName` dopo la creazione.
`RecoveryPointSelection` può contenere:
+ `Algorithm`
+ `ExcludeVaults`
+ `IncludeVaults`
+ `RecoveryPointTypes`
+ `SelectionWindowDays`
## Sintassi della richiesta
```
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
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_RequestSyntax) **
Il nome del piano di test di ripristino.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [RestoreTestingPlan](#API_UpdateRestoreTestingPlan_RequestSyntax) **
Specifica il corpo di un piano di test di ripristino.
Tipo: oggetto [RestoreTestingPlanForUpdate](API_RestoreTestingPlanForUpdate.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"RestoreTestingPlanArn": "string",
"RestoreTestingPlanName": "string",
"UpdateTime": number
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_UpdateRestoreTestingPlan_ResponseSyntax) **
L'ora in cui è stato creato il piano di test delle risorse.
Tipo: Timestamp
** [RestoreTestingPlanArn](#API_UpdateRestoreTestingPlan_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) univoco del piano di test di ripristino.
Tipo: String
** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_ResponseSyntax) **
Il nome non può essere modificato dopo la creazione. Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: String
** [UpdateTime](#API_UpdateRestoreTestingPlan_ResponseSyntax) **
L'ora in cui è stato completato l'aggiornamento del piano di test di ripristino.
Tipo: Timestamp
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRestoreTestingPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRestoreTestingPlan)
# UpdateRestoreTestingSelection
Aggiorna la selezione del test di ripristino specificata.
Con questa richiesta è possibile aggiornare la maggior parte degli elementi tranne `RestoreTestingSelectionName`.
È possibile utilizzare risorse ARNs o condizioni protette, ma non entrambe.
## Sintassi della richiesta
```
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
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_RequestSyntax) **
Il nome del piano di test di ripristino è necessario per aggiornare il piano di test indicato.
Obbligatorio: sì
** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_RequestSyntax) **
La selezione del test di ripristino richiesta (nome della selezione del test di ripristino che si desidera aggiornare).
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [RestoreTestingSelection](#API_UpdateRestoreTestingSelection_RequestSyntax) **
Per aggiornare la selezione dei test di ripristino, puoi utilizzare la risorsa ARNs o le condizioni protette, ma non entrambe. In altre parole, se la selezione è `ProtectedResourceArns`, la richiesta di aggiornamento con il parametro `ProtectedResourceConditions` non ha esito positivo.
Tipo: oggetto [RestoreTestingSelectionForUpdate](API_RestoreTestingSelectionForUpdate.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"RestoreTestingPlanArn": "string",
"RestoreTestingPlanName": "string",
"RestoreTestingSelectionName": "string",
"UpdateTime": number
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **
L'ora in cui la selezione per il test delle risorse è stata aggiornata correttamente.
Tipo: Timestamp
** [RestoreTestingPlanArn](#API_UpdateRestoreTestingSelection_ResponseSyntax) **
Stringa univoca che costituisce il nome del piano di test di ripristino.
Tipo: String
** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **
Il piano di test di ripristino a cui è associata la selezione aggiornata del test di ripristino.
Tipo: String
** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **
Il nome della selezione del test di ripristino restituito.
Tipo: String
** [UpdateTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **
L'ora in cui è stato completato l'aggiornamento per la selezione del test di ripristino.
Tipo: Timestamp
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRestoreTestingSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRestoreTestingSelection)
# UpdateTieringConfiguration
Questa richiesta invierà modifiche alla configurazione di tiering specificata. `TieringConfigurationName`non può essere aggiornato dopo la creazione.
`ResourceSelection` può contenere:
+ `Resources`
+ `TieringDownSettingsInDays`
+ `ResourceType`
## Sintassi della richiesta
```
PUT /tiering-configurations/tieringConfigurationName HTTP/1.1
Content-type: application/json
{
"TieringConfiguration": {
"BackupVaultName": "string",
"ResourceSelection": [
{
"Resources": [ "string" ],
"ResourceType": "string",
"TieringDownSettingsInDays": number
}
]
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [tieringConfigurationName](#API_UpdateTieringConfiguration_RequestSyntax) **
Il nome di una configurazione a più livelli da aggiornare.
Modello: `^[a-zA-Z0-9_]{1,200}$`
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [TieringConfiguration](#API_UpdateTieringConfiguration_RequestSyntax) **
Speciifica il corpo di una configurazione a più livelli.
Tipo: oggetto [TieringConfigurationInputForUpdate](API_TieringConfigurationInputForUpdate.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"LastUpdatedTime": number,
"TieringConfigurationArn": "string",
"TieringConfigurationName": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_UpdateTieringConfiguration_ResponseSyntax) **
Data e ora di creazione di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
** [LastUpdatedTime](#API_UpdateTieringConfiguration_ResponseSyntax) **
Data e ora di aggiornamento di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `LastUpdatedTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
** [TieringConfigurationArn](#API_UpdateTieringConfiguration_ResponseSyntax) **
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering aggiornata.
Tipo: String
** [TieringConfigurationName](#API_UpdateTieringConfiguration_ResponseSyntax) **
Questa stringa univoca è il nome della configurazione di tiering.
Tipo: stringa
Modello: `^[a-zA-Z0-9_]{1,200}$`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AlreadyExistsException **
La risorsa richiesta esiste già.
** Arn **
** Context **
** CreatorRequestId **
** Type **
Codice di stato HTTP: 400
** ConflictException **
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
** Context **
** Type **
Codice di stato HTTP: 400
** InvalidParameterValueException **
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
** Context **
** Type **
Codice di stato HTTP: 400
** LimitExceededException **
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
** Context **
** Type **
Codice di stato HTTP: 400
** MissingParameterValueException **
Indica che manca un parametro obbligatorio.
** Context **
** Type **
Codice di stato HTTP: 400
** ResourceNotFoundException **
Una risorsa necessaria per l'azione non esiste.
** Context **
** Type **
Codice di stato HTTP: 400
** ServiceUnavailableException **
La richiesta non è riuscita a causa di un errore temporaneo del server.
** Context **
** Type **
Codice di stato HTTP: 500
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateTieringConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateTieringConfiguration)
# AWS Backup gateway
Le seguenti azioni sono supportate da 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)
# AssociateGatewayToServer
Associa un gateway di backup al server. Dopo aver completato il processo di associazione, è possibile eseguire il backup e il ripristino VMs tramite il gateway.
## Sintassi della richiesta
```
{
"GatewayArn": "string",
"ServerArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_AssociateGatewayToServer_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway. Utilizza l'`ListGateways`operazione per restituire un elenco di gateway per il tuo account e Regione AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [ServerArn](#API_BGW_AssociateGatewayToServer_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del server che ospita le macchine virtuali.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_AssociateGatewayToServer_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) di un gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/AssociateGatewayToServer)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/AssociateGatewayToServer)
# CreateGateway
Crea un gateway di backup. Dopo aver creato un gateway, puoi associarlo a un server utilizzando l'operazione `AssociateGatewayToServer`.
## Sintassi della richiesta
```
{
"ActivationKey": "string",
"GatewayDisplayName": "string",
"GatewayType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [ActivationKey](#API_BGW_CreateGateway_RequestSyntax) **
La chiave di attivazione del gateway creato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Modello: `[0-9a-zA-Z\-]+`
Obbligatorio: sì
** [GatewayDisplayName](#API_BGW_CreateGateway_RequestSyntax) **
Il nome visualizzato del gateway creato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Obbligatorio: sì
** [GatewayType](#API_BGW_CreateGateway_RequestSyntax) **
Il tipo di gateway creato.
Tipo: String
Valori validi: `BACKUP_VM`
Obbligatorio: sì
** [Tags](#API_BGW_CreateGateway_RequestSyntax) **
Un elenco di massimo 50 tag da assegnare al gateway. Ogni tag è una coppia chiave-valore.
Tipo: matrice di oggetti [Tag](API_BGW_Tag.md)
Obbligatorio: no
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_CreateGateway_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway creato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/CreateGateway)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/CreateGateway)
# DeleteGateway
Elimina un gateway di backup.
## Sintassi della richiesta
```
{
"GatewayArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_DeleteGateway_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway da eliminare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_DeleteGateway_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway eliminato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DeleteGateway)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DeleteGateway)
# DeleteHypervisor
Elimina un hypervisor.
## Sintassi della richiesta
```
{
"HypervisorArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [HypervisorArn](#API_BGW_DeleteHypervisor_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor da eliminare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"HypervisorArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [HypervisorArn](#API_BGW_DeleteHypervisor_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor eliminato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non può continuare perché le autorizzazioni non sono sufficienti.
** ErrorCode **
Una descrizione del motivo per cui le autorizzazioni sono insufficienti.
Codice di stato HTTP: 400
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DeleteHypervisor)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DeleteHypervisor)
# DisassociateGatewayFromServer
Annulla l'associazione di un gateway di backup dal server specificato. Al termine del processo di annullamento dell'associazione, il gateway non può più accedere alle macchine virtuali sul server.
## Sintassi della richiesta
```
{
"GatewayArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_DisassociateGatewayFromServer_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway da dissociare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_DisassociateGatewayFromServer_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway dissociato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer)
# GetBandwidthRateLimitSchedule
Recupera la pianificazione del limite di velocità della larghezza di banda per un gateway specificato. Per impostazione predefinita, i gateway non dispongono di pianificazioni relative ai limiti di velocità della larghezza di banda, il che significa che non è in vigore alcuna limitazione della velocità della larghezza di banda. Utilizzarlo per ottenere la pianificazione del limiti di velocità della larghezza di banda di un gateway.
## Sintassi della richiesta
```
{
"GatewayArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_GetBandwidthRateLimitSchedule_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway. Usa l'[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)operazione per restituire un elenco di gateway per il tuo account e Regione AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"BandwidthRateLimitIntervals": [
{
"AverageUploadRateLimitInBitsPerSec": number,
"DaysOfWeek": [ number ],
"EndHourOfDay": number,
"EndMinuteOfHour": number,
"StartHourOfDay": number,
"StartMinuteOfHour": number
}
],
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [BandwidthRateLimitIntervals](#API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax) **
Un array contenente gli intervalli di pianificazione del limite di velocità della larghezza di banda per un gateway. Quando nessun intervallo del limite di velocità della larghezza di banda è stato pianificato, l'array è vuoto.
Tipo: matrice di oggetti [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md)
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.
** [GatewayArn](#API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway. Usa l'[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)operazione per restituire un elenco di gateway per il tuo account e Regione AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule)
# GetGateway
Fornendo l'ARN (Amazon Resource Name), questa API restituisce il gateway.
## Sintassi della richiesta
```
{
"GatewayArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_GetGateway_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"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"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Gateway](#API_BGW_GetGateway_ResponseSyntax) **
Fornendo l'ARN (Amazon Resource Name), questa API restituisce il gateway.
Tipo: oggetto [GatewayDetails](API_BGW_GatewayDetails.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetGateway)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetGateway)
# GetHypervisor
Questa azione richiede informazioni sull'hypervisor specificato a cui si connetterà il gateway. Un hypervisor è un hardware, software o firmware che crea e gestisce macchine virtuali e alloca risorse alle stesse.
## Sintassi della richiesta
```
{
"HypervisorArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [HypervisorArn](#API_BGW_GetHypervisor_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"Hypervisor": {
"Host": "string",
"HypervisorArn": "string",
"KmsKeyArn": "string",
"LastSuccessfulMetadataSyncTime": number,
"LatestMetadataSyncStatus": "string",
"LatestMetadataSyncStatusMessage": "string",
"LogGroupArn": "string",
"Name": "string",
"State": "string"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Hypervisor](#API_BGW_GetHypervisor_ResponseSyntax) **
Dettagli relativi all'hypervisor richiesto.
Tipo: oggetto [HypervisorDetails](API_BGW_HypervisorDetails.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetHypervisor)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetHypervisor)
# GetHypervisorPropertyMappings
Questa azione recupera le mappature delle proprietà per l'hypervisor specificato. Una mappatura delle proprietà dell'hypervisor mostra la relazione tra le proprietà dell'entità disponibili dall'hypervisor e le proprietà disponibili in. AWS
## Sintassi della richiesta
```
{
"HypervisorArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [HypervisorArn](#API_BGW_GetHypervisorPropertyMappings_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"HypervisorArn": "string",
"IamRoleArn": "string",
"VmwareToAwsTagMappings": [
{
"AwsTagKey": "string",
"AwsTagValue": "string",
"VmwareCategory": "string",
"VmwareTagName": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [HypervisorArn](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `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) **
L'Amazon Resource Name (ARN) del ruolo IAM.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):iam::([0-9]+):role/(\S+)`
** [VmwareToAwsTagMappings](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **
Questa è una visualizzazione delle mappature dei tag ai tag. VMware AWS
Tipo: matrice di oggetti [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings)
# GetVirtualMachine
Se si fornisce l'ARN (Amazon Resource Name), questa API restituisce la macchina virtuale.
## Sintassi della richiesta
```
{
"ResourceArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [ResourceArn](#API_BGW_GetVirtualMachine_RequestSyntax) **
Il nome della risorsa Amazon (ARN) della macchina virtuale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"VirtualMachine": {
"HostName": "string",
"HypervisorId": "string",
"LastBackupDate": number,
"Name": "string",
"Path": "string",
"ResourceArn": "string",
"VmwareTags": [
{
"VmwareCategory": "string",
"VmwareTagDescription": "string",
"VmwareTagName": "string"
}
]
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [VirtualMachine](#API_BGW_GetVirtualMachine_ResponseSyntax) **
Questo oggetto contiene gli attributi di base di `VirtualMachine` contenuti dall'output di `GetVirtualMachine`
Tipo: oggetto [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetVirtualMachine)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetVirtualMachine)
# ImportHypervisorConfiguration
Esegui la connessione a un hypervisor importando la relativa configurazione.
## Sintassi della richiesta
```
{
"Host": "string",
"KmsKeyArn": "string",
"Name": "string",
"Password": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"Username": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [Host](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **
L'host del server dell'hypervisor. Può essere un indirizzo IP o un nome dominio completo (FQDN).
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 128 caratteri.
Modello: `.+`
Obbligatorio: sì
** [KmsKeyArn](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **
Il AWS Key Management Service per l'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`
Obbligatorio: no
** [Name](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **
Il nome dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Obbligatorio: sì
** [Password](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **
La password dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[ -~]+`
Obbligatorio: no
** [Tags](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **
Tag della configurazione dell'hypervisor da importare.
Tipo: matrice di oggetti [Tag](API_BGW_Tag.md)
Obbligatorio: no
** [Username](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **
Il nome utente dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`
Obbligatorio: no
## Sintassi della risposta
```
{
"HypervisorArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [HypervisorArn](#API_BGW_ImportHypervisorConfiguration_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor dissociato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non può continuare perché le autorizzazioni non sono sufficienti.
** ErrorCode **
Una descrizione del motivo per cui le autorizzazioni sono insufficienti.
Codice di stato HTTP: 400
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration)
# ListGateways
Elenca i gateway di backup di proprietà di un Account AWS Regione AWS utente interno. L'elenco restituito è ordinato per Amazon Resource Name (ARN) del gateway.
## Sintassi della richiesta
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [MaxResults](#API_BGW_ListGateways_RequestSyntax) **
Il numero massimo di gateway da elencare.
Tipo: numero intero
Intervallo valido: valore minimo di 1.
Obbligatorio: no
** [NextToken](#API_BGW_ListGateways_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `MaxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.
Modello: `.+`
Obbligatorio: no
## Sintassi della risposta
```
{
"Gateways": [
{
"GatewayArn": "string",
"GatewayDisplayName": "string",
"GatewayType": "string",
"HypervisorId": "string",
"LastSeenTime": number
}
],
"NextToken": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Gateways](#API_BGW_ListGateways_ResponseSyntax) **
Un elenco di gateway.
Tipo: matrice di oggetti [Gateway](API_BGW_Gateway.md)
** [NextToken](#API_BGW_ListGateways_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `maxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.
Modello: `.+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListGateways)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListGateways)
# ListHypervisors
Elenca gli hypervisor.
## Sintassi della richiesta
```
{
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [MaxResults](#API_BGW_ListHypervisors_RequestSyntax) **
Il numero massimo di hypervisor da elencare.
Tipo: numero intero
Intervallo valido: valore minimo di 1.
Obbligatorio: no
** [NextToken](#API_BGW_ListHypervisors_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `maxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.
Modello: `.+`
Obbligatorio: no
## Sintassi della risposta
```
{
"Hypervisors": [
{
"Host": "string",
"HypervisorArn": "string",
"KmsKeyArn": "string",
"Name": "string",
"State": "string"
}
],
"NextToken": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Hypervisors](#API_BGW_ListHypervisors_ResponseSyntax) **
Un elenco dei tuoi `Hypervisor` oggetti, ordinati in base ai loro Amazon Resource Names (ARNs).
Tipo: matrice di oggetti [Hypervisor](API_BGW_Hypervisor.md)
** [NextToken](#API_BGW_ListHypervisors_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `maxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.
Modello: `.+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListHypervisors)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListHypervisors)
# ListTagsForResource
Elenca i tag applicati alla risorsa identificata dal relativo nome della risorsa Amazon (ARN).
## Sintassi della richiesta
```
{
"ResourceArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [ResourceArn](#API_BGW_ListTagsForResource_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dei tag della risorsa da elencare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"ResourceArn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ResourceArn](#API_BGW_ListTagsForResource_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dei tag della risorsa elencati.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `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) **
Un elenco dei tag della risorsa.
Tipo: matrice di oggetti [Tag](API_BGW_Tag.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListTagsForResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListTagsForResource)
# ListVirtualMachines
Elenca le macchine virtuali.
## Sintassi della richiesta
```
{
"HypervisorArn": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [HypervisorArn](#API_BGW_ListVirtualMachines_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor connesso alla macchina virtuale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: no
** [MaxResults](#API_BGW_ListVirtualMachines_RequestSyntax) **
Il numero massimo di macchine virtuali da elencare.
Tipo: numero intero
Intervallo valido: valore minimo di 1.
Obbligatorio: no
** [NextToken](#API_BGW_ListVirtualMachines_RequestSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `maxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.
Modello: `.+`
Obbligatorio: no
## Sintassi della risposta
```
{
"NextToken": "string",
"VirtualMachines": [
{
"HostName": "string",
"HypervisorId": "string",
"LastBackupDate": number,
"Name": "string",
"Path": "string",
"ResourceArn": "string"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_BGW_ListVirtualMachines_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale di risorse restituite. Ad esempio, se viene effettuata una richiesta per restituire il numero `maxResults` di risorse, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1000.
Modello: `.+`
** [VirtualMachines](#API_BGW_ListVirtualMachines_ResponseSyntax) **
Un elenco dei tuoi `VirtualMachine` oggetti, ordinati in base ai loro Amazon Resource Names (ARNs).
Tipo: matrice di oggetti [VirtualMachine](API_BGW_VirtualMachine.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListVirtualMachines)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListVirtualMachines)
# PutBandwidthRateLimitSchedule
Questa operazione imposta la pianificazione del limite di velocità della larghezza di banda per un gateway specificato. Per impostazione predefinita, i gateway non dispongono di una pianificazione del limite di velocità della larghezza di banda, il che significa che non è in vigore alcuna limitazione della velocità della larghezza di banda. Utilizzarlo per avviare una pianificazione del limite di velocità della larghezza di banda di un gateway.
## Sintassi della richiesta
```
{
"BandwidthRateLimitIntervals": [
{
"AverageUploadRateLimitInBitsPerSec": number,
"DaysOfWeek": [ number ],
"EndHourOfDay": number,
"EndMinuteOfHour": number,
"StartHourOfDay": number,
"StartMinuteOfHour": number
}
],
"GatewayArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [BandwidthRateLimitIntervals](#API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax) **
Un array contenente gli intervalli di pianificazione del limite di velocità della larghezza di banda per un gateway. Quando nessun intervallo del limite di velocità della larghezza di banda è stato pianificato, l'array è vuoto.
Tipo: matrice di oggetti [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md)
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.
Obbligatorio: sì
** [GatewayArn](#API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway. Usa l'[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)operazione per restituire un elenco di gateway per il tuo account e Regione AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_PutBandwidthRateLimitSchedule_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway. Usa l'[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)operazione per restituire un elenco di gateway per il tuo account e Regione AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule)
# PutHypervisorPropertyMappings
Questa operazione imposta le mappature delle proprietà per l'hypervisor specificato. Una mappatura delle proprietà dell'hypervisor mostra la relazione tra le proprietà dell'entità disponibili dall'hypervisor e le proprietà disponibili in. AWS
## Sintassi della richiesta
```
{
"HypervisorArn": "string",
"IamRoleArn": "string",
"VmwareToAwsTagMappings": [
{
"AwsTagKey": "string",
"AwsTagValue": "string",
"VmwareCategory": "string",
"VmwareTagName": "string"
}
]
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [HypervisorArn](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [IamRoleArn](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **
L'Amazon Resource Name (ARN) del ruolo IAM.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):iam::([0-9]+):role/(\S+)`
Obbligatorio: sì
** [VmwareToAwsTagMappings](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **
Questa azione richiede la mappatura dei tag ai tag. VMware AWS
Tipo: matrice di oggetti [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md)
Obbligatorio: sì
## Sintassi della risposta
```
{
"HypervisorArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [HypervisorArn](#API_BGW_PutHypervisorPropertyMappings_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non può continuare perché le autorizzazioni non sono sufficienti.
** ErrorCode **
Una descrizione del motivo per cui le autorizzazioni sono insufficienti.
Codice di stato HTTP: 400
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings)
# PutMaintenanceStartTime
Imposta l'ora di inizio della manutenzione per un gateway.
## Sintassi della richiesta
```
{
"DayOfMonth": number,
"DayOfWeek": number,
"GatewayArn": "string",
"HourOfDay": number,
"MinuteOfHour": number
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [DayOfMonth](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **
Il giorno del mese di inizio della manutenzione su un gateway.
I valori validi sono compresi tra `Sunday` e `Saturday`.
Tipo: numero intero
Intervallo valido: valore minimo di 1. Valore massimo di 31.
Obbligatorio: no
** [DayOfWeek](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **
Il giorno della settimana di inizio della manutenzione su un gateway.
Tipo: numero intero
Intervallo valido: valore minimo di 0. Valore massimo di 6.
Obbligatorio: no
** [GatewayArn](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway, utilizzato per specificare l'ora di inizio della manutenzione.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [HourOfDay](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **
L'ora del giorno di inizio della manutenzione su un gateway.
Tipo: numero intero
Intervallo valido: valore minimo di 0. valore massimo pari a 23.
Obbligatorio: sì
** [MinuteOfHour](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **
Il minuto dell'ora di inizio della manutenzione su un gateway.
Tipo: numero intero
Intervallo valido: valore minimo di 0. Valore massimo di 59.
Obbligatorio: sì
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_PutMaintenanceStartTime_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) di un gateway per il quale si imposta l'ora di inizio della manutenzione.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutMaintenanceStartTime)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutMaintenanceStartTime)
# StartVirtualMachinesMetadataSync
Questa azione invia una richiesta per sincronizzare i metadati tra le macchine virtuali specificate.
## Sintassi della richiesta
```
{
"HypervisorArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [HypervisorArn](#API_BGW_StartVirtualMachinesMetadataSync_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"HypervisorArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [HypervisorArn](#API_BGW_StartVirtualMachinesMetadataSync_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non può continuare perché le autorizzazioni non sono sufficienti.
** ErrorCode **
Una descrizione del motivo per cui le autorizzazioni sono insufficienti.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa non trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync)
# TagResource
Il tag della risorsa.
## Sintassi della richiesta
```
{
"ResourceARN": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [ResourceARN](#API_BGW_TagResource_RequestSyntax) **
Il nome della risorsa Amazon (ARN) della risorsa a cui assegnare tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [Tags](#API_BGW_TagResource_RequestSyntax) **
Un elenco di tag da assegnare alla risorsa.
Tipo: matrice di oggetti [Tag](API_BGW_Tag.md)
Obbligatorio: sì
## Sintassi della risposta
```
{
"ResourceARN": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ResourceARN](#API_BGW_TagResource_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) della risorsa a cui sono stati assegnati tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/TagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/TagResource)
# TestHypervisorConfiguration
Esegue il test della configurazione dell'hypervisor per verificare che il gateway di backup sia in grado di connettersi all'hypervisor e alle relative risorse.
## Sintassi della richiesta
```
{
"GatewayArn": "string",
"Host": "string",
"Password": "string",
"Username": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway all'hypervisor da testare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [Host](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **
L'host del server dell'hypervisor. Può essere un indirizzo IP o un nome dominio completo (FQDN).
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 128 caratteri.
Modello: `.+`
Obbligatorio: sì
** [Password](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **
La password dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[ -~]+`
Obbligatorio: no
** [Username](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **
Il nome utente dell'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`
Obbligatorio: no
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/TestHypervisorConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/TestHypervisorConfiguration)
# UntagResource
Rimuovi i tag dalla risorsa.
## Sintassi della richiesta
```
{
"ResourceARN": "string",
"TagKeys": [ "string" ]
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [ResourceARN](#API_BGW_UntagResource_RequestSyntax) **
Il nome della risorsa Amazon (ARN) della risorsa da cui rimuovere i tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [TagKeys](#API_BGW_UntagResource_RequestSyntax) **
L'elenco delle chiavi tag che specificano quali tag rimuovere.
Tipo: array di stringhe
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`
Obbligatorio: sì
## Sintassi della risposta
```
{
"ResourceARN": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ResourceARN](#API_BGW_UntagResource_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) della risorsa da cui sono stati rimossi i tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UntagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UntagResource)
# UpdateGatewayInformation
Aggiorna il nome di un gateway. Specifica il gateway da aggiornare utilizzando il nome della risorsa Amazon (ARN) del gateway nella richiesta.
## Sintassi della richiesta
```
{
"GatewayArn": "string",
"GatewayDisplayName": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_UpdateGatewayInformation_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway da aggiornare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [GatewayDisplayName](#API_BGW_UpdateGatewayInformation_RequestSyntax) **
Il nome visualizzato aggiornato del gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Obbligatorio: no
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_UpdateGatewayInformation_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway aggiornato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateGatewayInformation)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateGatewayInformation)
# UpdateGatewaySoftwareNow
Aggiorna il software macchina virtuale (VM) del gateway. La richiesta attiva immediatamente l'aggiornamento software.
**Nota**
Quando si effettua questa richiesta, viene immediatamente ricevuta una risposta `200 OK`. Tuttavia, il completamento dell'aggiornamento potrebbe richiedere tempo.
## Sintassi della richiesta
```
{
"GatewayArn": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [GatewayArn](#API_BGW_UpdateGatewaySoftwareNow_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gateway da aggiornare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
## Sintassi della risposta
```
{
"GatewayArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [GatewayArn](#API_BGW_UpdateGatewaySoftwareNow_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) del gateway aggiornato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow)
# UpdateHypervisor
Aggiorna i metadati di un hypervisor, inclusi host, nome utente e password. Specifica quale hypervisor aggiornare utilizzando il nome della risorsa Amazon (ARN) del gateway nella richiesta.
## Sintassi della richiesta
```
{
"Host": "string",
"HypervisorArn": "string",
"LogGroupArn": "string",
"Name": "string",
"Password": "string",
"Username": "string"
}
```
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
La richiesta accetta i seguenti dati in formato JSON.
** [Host](#API_BGW_UpdateHypervisor_RequestSyntax) **
L'host aggiornato dell'hypervisor. Può essere un indirizzo IP o un nome dominio completo (FQDN).
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 128 caratteri.
Modello: `.+`
Obbligatorio: no
** [HypervisorArn](#API_BGW_UpdateHypervisor_RequestSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor da aggiornare.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: sì
** [LogGroupArn](#API_BGW_UpdateHypervisor_RequestSyntax) **
Il nome della risorsa Amazon (ARN) del gruppo di gateway all'interno del log richiesto.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 2048 caratteri.
Modello: `$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*`
Obbligatorio: no
** [Name](#API_BGW_UpdateHypervisor_RequestSyntax) **
Il nome aggiornato per l'hypervisor
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Obbligatorio: no
** [Password](#API_BGW_UpdateHypervisor_RequestSyntax) **
La password aggiornata per l'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[ -~]+`
Obbligatorio: no
** [Username](#API_BGW_UpdateHypervisor_RequestSyntax) **
Il nome utente aggiornato per l'hypervisor.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`
Obbligatorio: no
## Sintassi della risposta
```
{
"HypervisorArn": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [HypervisorArn](#API_BGW_UpdateHypervisor_ResponseSyntax) **
Il nome della risorsa Amazon (ARN) dell'hypervisor aggiornato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non può continuare perché le autorizzazioni non sono sufficienti.
** ErrorCode **
Una descrizione del motivo per cui le autorizzazioni sono insufficienti.
Codice di stato HTTP: 400
** ConflictException **
L'operazione non può continuare perché non è supportata.
** ErrorCode **
Una descrizione del motivo per cui l'operazione non è supportata.
Codice di stato HTTP: 400
** InternalServerException **
L'azione non è riuscita perché si è verificato un errore interno. Riprova più tardi.
** ErrorCode **
Una descrizione dell'errore interno che si è verificato.
Codice di stato HTTP: 500
** ResourceNotFoundException **
Non è stata trovata una risorsa necessaria per l'azione.
** ErrorCode **
Una descrizione della risorsa che non è stata trovata.
Codice di stato HTTP: 400
** ThrottlingException **
Il TPS è stato limitato per proteggere da volumi di richieste elevate, voluti o non voluti.
** ErrorCode **
Errore: il TPS è stato limitato per proteggere da elevati volumi di richieste intenzionali o non intenzionali.
Codice di stato HTTP: 400
** ValidationException **
L'operazione non è riuscita perché si è verificato un errore di convalida.
** ErrorCode **
Una descrizione della causa dell'errore di convalida.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateHypervisor)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateHypervisor)
# Ricerca AWS Backup
Le seguenti azioni sono supportate da Ricerca 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
Questa operazione recupera i metadati di un processo di ricerca, incluso lo stato di avanzamento.
## Sintassi della richiesta
```
GET /search-jobs/SearchJobIdentifier HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [SearchJobIdentifier](#API_BKS_GetSearchJob_RequestSyntax) **
Stringa univoca obbligatoria che specifica il processo di ricerca.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CompletionTime](#API_BKS_GetSearchJob_ResponseSyntax) **
Data e ora di completamento di un processo di ricerca, in formato Unix e UTC (Coordinated Universal Time). Il valore di `CompletionTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreationTime](#API_BKS_GetSearchJob_ResponseSyntax) **
Data e ora di creazione di un processo di ricerca, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CompletionTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CurrentSearchProgress](#API_BKS_GetSearchJob_ResponseSyntax) **
Restituisce numeri che rappresentano BackupsScannedCount ItemsScanned, e. ItemsMatched
Tipo: oggetto [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md)
** [EncryptionKeyArn](#API_BKS_GetSearchJob_ResponseSyntax) **
La chiave di crittografia per il processo di ricerca specificato.
Esempio: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
Tipo: String
** [ItemFilters](#API_BKS_GetSearchJob_ResponseSyntax) **
I filtri degli elementi rappresentano tutte le proprietà degli elementi di input specificate al momento della creazione della ricerca.
Tipo: oggetto [ItemFilters](API_BKS_ItemFilters.md)
** [Name](#API_BKS_GetSearchJob_ResponseSyntax) **
Nome restituito del processo di ricerca specificato.
Tipo: String
** [SearchJobArn](#API_BKS_GetSearchJob_ResponseSyntax) **
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
Tipo: String
** [SearchJobIdentifier](#API_BKS_GetSearchJob_ResponseSyntax) **
La stringa univoca che identifica il lavoro di ricerca specificato.
Tipo: String
** [SearchScope](#API_BKS_GetSearchJob_ResponseSyntax) **
L'ambito di ricerca è costituito da tutte le proprietà di backup inserite in una ricerca.
Tipo: oggetto [SearchScope](API_BKS_SearchScope.md)
** [SearchScopeSummary](#API_BKS_GetSearchJob_ResponseSyntax) **
Viene restituito un riepilogo dell'ambito del lavoro di ricerca specificato, tra cui:
+ TotalBackupsToScanCount, il numero di punti di ripristino restituiti dalla ricerca.
+ TotalItemsToScanCount, il numero di elementi restituiti dalla ricerca.
Tipo: oggetto [SearchScopeSummary](API_BKS_SearchScopeSummary.md)
** [Status](#API_BKS_GetSearchJob_ResponseSyntax) **
Lo stato corrente del processo di ricerca specificato.
Un lavoro di ricerca può avere uno dei seguenti stati:`RUNNING`;;`COMPLETED`;`STOPPED`; `FAILED``TIMED_OUT`; o`EXPIRED`.
Tipo: String
Valori validi: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`
** [StatusMessage](#API_BKS_GetSearchJob_ResponseSyntax) **
Verrà restituito un messaggio di stato per un lavoro di ricerca con stato di `ERRORED` o per uno stato di `COMPLETED` lavori con problemi.
Ad esempio, un messaggio può indicare che una ricerca conteneva punti di ripristino che non possono essere analizzati a causa di un problema di autorizzazioni.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo un certo numero di secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è andata a buon fine a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchJob)
# GetSearchResultExportJob
Questa operazione recupera i metadati di un processo di esportazione.
Un processo di esportazione è un'operazione che trasmette i risultati di un processo di ricerca a un bucket S3 specificato in un file.csv.
Un processo di esportazione consente di conservare i risultati di una ricerca oltre i 7 giorni di conservazione programmati del lavoro di ricerca.
## Sintassi della richiesta
```
GET /export-search-jobs/ExportJobIdentifier HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ExportJobIdentifier](#API_BKS_GetSearchResultExportJob_RequestSyntax) **
Questa è la stringa univoca che identifica uno specifico processo di esportazione.
Necessario per questa operazione.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CompletionTime": number,
"CreationTime": number,
"ExportJobArn": "string",
"ExportJobIdentifier": "string",
"ExportSpecification": { ... },
"SearchJobArn": "string",
"Status": "string",
"StatusMessage": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CompletionTime](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
Data e ora di completamento di un processo di esportazione, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [CreationTime](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
Data e ora di creazione di un processo di esportazione, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [ExportJobArn](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
L'unico Amazon Resource Name (ARN) che identifica in modo univoco il processo di esportazione.
Tipo: String
** [ExportJobIdentifier](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
Questa è la stringa univoca che identifica il processo di esportazione specificato.
Tipo: String
** [ExportSpecification](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
La specifica di esportazione è costituita dal bucket S3 di destinazione in cui sono stati esportati i risultati della ricerca, insieme al prefisso di destinazione.
Tipo: oggetto [ExportSpecification](API_BKS_ExportSpecification.md)
**Nota:** questo oggetto è un'Unione. È possibile specificare o restituire un solo membro di questo oggetto.
** [SearchJobArn](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
Tipo: String
** [Status](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
Questo è lo stato attuale del processo di esportazione.
Tipo: String
Valori validi: `RUNNING | FAILED | COMPLETED`
** [StatusMessage](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **
Un messaggio di stato è una stringa che viene restituita per il processo di ricerca con lo stato di`FAILED`, insieme alla procedura per correggere e riprovare l'operazione.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è riuscita a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchResultExportJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchResultExportJob)
# ListSearchJobBackups
Questa operazione restituisce un elenco di tutti i backup (punti di ripristino) in un formato impaginato che sono stati inclusi nel processo di ricerca.
Se una ricerca non mostra un backup previsto nei risultati, è possibile richiamare questa operazione per visualizzare ogni backup incluso nella ricerca. Verranno visualizzati tutti i backup che non sono stati inclusi perché `FAILED` lo stato è dovuto a un problema di autorizzazioni, insieme a un messaggio di stato.
Nei risultati di ricerca `ACTIVE` verranno inclusi solo i punti di ripristino con un indice di backup con uno stato di. Se l'indice ha un altro stato, il relativo stato verrà visualizzato insieme a un messaggio di stato.
## Sintassi della richiesta
```
GET /search-jobs/SearchJobIdentifier/backups?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_BKS_ListSearchJobBackups_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_BKS_ListSearchJobBackups_RequestSyntax) **
L'elemento successivo che segue un elenco parziale dei backup restituiti inclusi in un processo di ricerca.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
** [SearchJobIdentifier](#API_BKS_ListSearchJobBackups_RequestSyntax) **
La stringa univoca che specifica il processo di ricerca.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_BKS_ListSearchJobBackups_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale dei backup restituiti inclusi in un processo di ricerca.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [Results](#API_BKS_ListSearchJobBackups_ResponseSyntax) **
I punti di ripristino hanno restituito i risultati di un lavoro di ricerca
Tipo: matrice di oggetti [SearchJobBackupsResult](API_BKS_SearchJobBackupsResult.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è andata a buon fine a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobBackups)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobBackups)
# ListSearchJobResults
Questa operazione restituisce un elenco di un lavoro di ricerca specificato.
## Sintassi della richiesta
```
GET /search-jobs/SearchJobIdentifier/search-results?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_BKS_ListSearchJobResults_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_BKS_ListSearchJobResults_RequestSyntax) **
L'elemento successivo dopo un elenco parziale dei risultati di ricerca restituiti.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di risultati di ricerca dei lavori, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
** [SearchJobIdentifier](#API_BKS_ListSearchJobResults_RequestSyntax) **
La stringa univoca che specifica il processo di ricerca.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Results": [
{ ... }
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_BKS_ListSearchJobResults_ResponseSyntax) **
L'elemento successivo dopo un elenco parziale dei risultati di ricerca delle offerte di lavoro.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [Results](#API_BKS_ListSearchJobResults_ResponseSyntax) **
I risultati sono costituiti da EBSResult Item o ResultItem S3.
Tipo: matrice di oggetti [ResultItem](API_BKS_ResultItem.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è riuscita a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobResults)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobResults)
# ListSearchJobs
Questa operazione restituisce un elenco di lavori di ricerca appartenenti a un account.
## Sintassi della richiesta
```
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **
Includi questo parametro per filtrare l'elenco in base allo stato del lavoro di ricerca.
Valori validi: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`
** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **
L'elemento successivo che segue un elenco parziale dei lavori di ricerca restituiti.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [NextToken](#API_BKS_ListSearchJobs_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale dei backup restituiti inclusi in un processo di ricerca.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **
I lavori di ricerca presenti nell'elenco, con i dettagli dei lavori di ricerca restituiti.
Tipo: matrice di oggetti [SearchJobSummary](API_BKS_SearchJobSummary.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo un certo numero di secondi.
Codice di stato HTTP: 500
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è andata a buon fine a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs)
# ListSearchResultExportJobs
Questa operazione esporta i risultati di ricerca di un job di ricerca in un bucket S3 di destinazione specificato.
## Sintassi della richiesta
```
GET /export-search-jobs?MaxResults=MaxResults&NextToken=NextToken&SearchJobIdentifier=SearchJobIdentifier&Status=Status HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [MaxResults](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **
Il numero massimo di elementi dell'elenco di risorse da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
** [NextToken](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **
L'elemento successivo che segue un elenco parziale dei backup restituiti inclusi in un processo di ricerca.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
** [SearchJobIdentifier](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **
La stringa univoca che specifica il processo di ricerca.
** [Status](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **
I lavori di ricerca da includere nel processo di esportazione possono essere filtrati includendo questo parametro.
Valori validi: `RUNNING | FAILED | COMPLETED`
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
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"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ExportJobs](#API_BKS_ListSearchResultExportJobs_ResponseSyntax) **
L'operazione restituisce i lavori di esportazione inclusi.
Tipo: matrice di oggetti [ExportJobSummary](API_BKS_ExportJobSummary.md)
** [NextToken](#API_BKS_ListSearchResultExportJobs_ResponseSyntax) **
L'elemento successivo che segue un elenco parziale dei backup restituiti inclusi in un processo di ricerca.
Ad esempio, se viene effettuata una richiesta per restituire il `MaxResults` numero di backup, `NextToken` consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ServiceQuotaExceededException **
La richiesta è stata respinta a causa del superamento dei limiti di quota consentiti.
** message **
Questa richiesta non ha avuto successo a causa del superamento dei limiti della quota di servizio.
** quotaCode **
Questo è il codice specifico del tipo di quota.
** resourceId **
Identificatore della risorsa.
** resourceType **
Tipo di risorsa.
** serviceCode **
Questo è il codice univoco del servizio di origine con la quota.
Codice di stato HTTP: 402
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è riuscita a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchResultExportJobs)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchResultExportJobs)
# ListTagsForResource
Questa operazione restituisce i tag per un tipo di risorsa.
## Sintassi della richiesta
```
GET /tags/ResourceArn HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ResourceArn](#API_BKS_ListTagsForResource_RequestSyntax) **
L'Amazon Resource Name (ARN) che identifica in modo univoco la risorsa. >
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Tags": {
"string" : "string"
}
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Tags](#API_BKS_ListTagsForResource_ResponseSyntax) **
Elenco dei tag restituiti dall'operazione.
Tipo: mappatura stringa a stringa
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo un certo numero di secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è andata a buon fine a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListTagsForResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListTagsForResource)
# StartSearchJob
Questa operazione crea un processo di ricerca che restituisce punti di ripristino filtrati per SearchScope e elementi filtrati per. ItemFilters
Puoi facoltativamente includere ClientToken,, Name EncryptionKeyArn, Tags. and/or
## Sintassi della richiesta
```
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"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ClientToken](#API_BKS_StartSearchJob_RequestSyntax) **
Includi questo parametro per consentire più chiamate identiche per l'idempotenza.
Un token client è valido per 8 ore dopo il completamento della prima richiesta che lo utilizza. Trascorso questo periodo, qualsiasi richiesta con lo stesso token viene trattata come una nuova richiesta.
▬Tipo: stringa
Obbligatorio: no
** [EncryptionKeyArn](#API_BKS_StartSearchJob_RequestSyntax) **
La chiave di crittografia per il processo di ricerca specificato.
▬Tipo: stringa
Obbligatorio: no
** [ItemFilters](#API_BKS_StartSearchJob_RequestSyntax) **
I filtri degli elementi rappresentano tutte le proprietà degli elementi di input specificate al momento della creazione della ricerca.
Contiene EBSItem filtri o S3 ItemFilters
Tipo: oggetto [ItemFilters](API_BKS_ItemFilters.md)
Obbligatorio: no
** [Name](#API_BKS_StartSearchJob_RequestSyntax) **
Includi caratteri alfanumerici per creare un nome per questo lavoro di ricerca.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 500 caratteri.
Obbligatorio: no
** [SearchScope](#API_BKS_StartSearchJob_RequestSyntax) **
Questo oggetto può contenere BackupResourceTypes,, BackupResourceArns BackupResourceCreationTime BackupResourceTags, e SourceResourceArns filtrare i punti di ripristino restituiti dal processo di ricerca.
Tipo: oggetto [SearchScope](API_BKS_SearchScope.md)
Obbligatorio: sì
** [Tags](#API_BKS_StartSearchJob_RequestSyntax) **
Elenco dei tag restituiti dall'operazione.
Tipo: mappatura stringa a stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"SearchJobArn": "string",
"SearchJobIdentifier": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [CreationTime](#API_BKS_StartSearchJob_ResponseSyntax) **
Data e ora di creazione di un lavoro, in formato Unix e UTC (Coordinated Universal Time). Il valore di `CompletionTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
** [SearchJobArn](#API_BKS_StartSearchJob_ResponseSyntax) **
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
Tipo: String
** [SearchJobIdentifier](#API_BKS_StartSearchJob_ResponseSyntax) **
La stringa univoca che specifica il lavoro di ricerca.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** ConflictException **
Questa eccezione si verifica quando viene rilevato un conflitto con una precedente operazione riuscita. Ciò si verifica in genere quando l'operazione precedente non ha avuto il tempo di propagarsi all'host che serve la richiesta corrente.
La risposta consigliata a questa eccezione è un nuovo tentativo (con una logica di backoff appropriata).
** message **
L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.
** resourceId **
Identificatore della risorsa interessata.
** resourceType **
Tipo di risorsa interessata.
Codice di stato HTTP: 409
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo un certo numero di secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ServiceQuotaExceededException **
La richiesta è stata respinta a causa del superamento dei limiti di quota consentiti.
** message **
Questa richiesta non ha avuto successo a causa del superamento dei limiti della quota di servizio.
** quotaCode **
Questo è il codice specifico del tipo di quota.
** resourceId **
Identificatore della risorsa.
** resourceType **
Tipo di risorsa.
** serviceCode **
Questo è il codice univoco del servizio di origine con la quota.
Codice di stato HTTP: 402
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è andata a buon fine a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchJob)
# StartSearchResultExportJob
Questa operazione avvia un processo per esportare i risultati del processo di ricerca in un bucket S3 designato.
## Sintassi della richiesta
```
PUT /export-search-jobs HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"ExportSpecification": { ... },
"RoleArn": "string",
"SearchJobIdentifier": "string",
"Tags": {
"string" : "string"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [ClientToken](#API_BKS_StartSearchResultExportJob_RequestSyntax) **
Includi questo parametro per consentire più chiamate identiche per l'idempotenza.
Un token client è valido per 8 ore dopo il completamento della prima richiesta che lo utilizza. Trascorso questo periodo, qualsiasi richiesta con lo stesso token viene trattata come una nuova richiesta.
▬Tipo: stringa
Obbligatorio: no
** [ExportSpecification](#API_BKS_StartSearchResultExportJob_RequestSyntax) **
Questa specifica contiene una stringa obbligatoria del bucket di destinazione; facoltativamente, puoi includere il prefisso di destinazione.
Tipo: oggetto [ExportSpecification](API_BKS_ExportSpecification.md)
**Nota:** questo oggetto è un'Unione. È possibile specificare o restituire un solo membro di questo oggetto.
Obbligatorio: sì
** [RoleArn](#API_BKS_StartSearchResultExportJob_RequestSyntax) **
Questo parametro specifica il ruolo ARN utilizzato per avviare i lavori di esportazione dei risultati della ricerca.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.
Modello: `arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)`
Obbligatorio: no
** [SearchJobIdentifier](#API_BKS_StartSearchResultExportJob_RequestSyntax) **
La stringa univoca che specifica il lavoro di ricerca.
Tipo: stringa
Obbligatorio: sì
** [Tags](#API_BKS_StartSearchResultExportJob_RequestSyntax) **
Tag opzionali da includere. Un tag è una coppia chiave-valore che puoi utilizzare per gestire, filtrare e cercare le risorse. I caratteri consentiti includono lettere UTF-8, numeri, spazi e i caratteri seguenti: \$1 - = . \$1 : /.
Tipo: mappatura stringa a stringa
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ExportJobArn": "string",
"ExportJobIdentifier": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [ExportJobArn](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **
Si tratta dell'ARN (Amazon Resource Name) univoco che appartiene al nuovo processo di esportazione.
Tipo: String
** [ExportJobIdentifier](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **
Questo è l'identificatore univoco che specifica il nuovo processo di esportazione.
Tipo: String
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** ConflictException **
Questa eccezione si verifica quando viene rilevato un conflitto con una precedente operazione riuscita. Ciò si verifica in genere quando l'operazione precedente non ha avuto il tempo di propagarsi all'host che serve la richiesta corrente.
La risposta consigliata a questa eccezione è un nuovo tentativo (con una logica di backoff appropriata).
** message **
L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.
** resourceId **
Identificatore della risorsa interessata.
** resourceType **
Tipo di risorsa interessata.
Codice di stato HTTP: 409
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ServiceQuotaExceededException **
La richiesta è stata respinta a causa del superamento dei limiti di quota consentiti.
** message **
Questa richiesta non ha avuto successo a causa del superamento dei limiti della quota di servizio.
** quotaCode **
Questo è il codice specifico del tipo di quota.
** resourceId **
Identificatore della risorsa.
** resourceType **
Tipo di risorsa.
** serviceCode **
Questo è il codice univoco del servizio di origine con la quota.
Codice di stato HTTP: 402
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è riuscita a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchResultExportJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchResultExportJob)
# StopSearchJob
Questa operazione termina un lavoro di ricerca.
È `RUNNING` possibile interrompere solo un processo di ricerca con uno stato di.
## Sintassi della richiesta
```
PUT /search-jobs/SearchJobIdentifier/actions/cancel HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [SearchJobIdentifier](#API_BKS_StopSearchJob_RequestSyntax) **
La stringa univoca che specifica il processo di ricerca.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** ConflictException **
Questa eccezione si verifica quando viene rilevato un conflitto con una precedente operazione riuscita. Ciò si verifica in genere quando l'operazione precedente non ha avuto il tempo di propagarsi all'host che serve la richiesta corrente.
La risposta consigliata a questa eccezione è un nuovo tentativo (con una logica di backoff appropriata).
** message **
L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.
** resourceId **
Identificatore della risorsa interessata.
** resourceType **
Tipo di risorsa interessata.
Codice di stato HTTP: 409
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è riuscita a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StopSearchJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StopSearchJob)
# TagResource
Questa operazione inserisce dei tag sulla risorsa che indichi.
## Sintassi della richiesta
```
POST /tags/ResourceArn HTTP/1.1
Content-type: application/json
{
"Tags": {
"string" : "string"
}
}
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ResourceArn](#API_BKS_TagResource_RequestSyntax) **
L'Amazon Resource Name (ARN) che identifica in modo univoco la risorsa.
Questa è la risorsa che avrà i tag indicati.
Obbligatorio: sì
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Tags](#API_BKS_TagResource_RequestSyntax) **
Tag obbligatori da includere. Un tag è una coppia chiave-valore che puoi utilizzare per gestire, filtrare e cercare le risorse. I caratteri consentiti includono lettere UTF-8, numeri, spazi e i caratteri seguenti: \$1 - = . \$1 : /.
Tipo: mappatura stringa a stringa
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo un certo numero di secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è andata a buon fine a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/TagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/TagResource)
# UntagResource
Questa operazione rimuove i tag dalla risorsa specificata.
## Sintassi della richiesta
```
DELETE /tags/ResourceArn?tagKeys=TagKeys HTTP/1.1
```
## Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
** [ResourceArn](#API_BKS_UntagResource_RequestSyntax) **
L'Amazon Resource Name (ARN) che identifica in modo univoco la risorsa da cui desideri rimuovere i tag.
Obbligatorio: sì
** [TagKeys](#API_BKS_UntagResource_RequestSyntax) **
Questo parametro obbligatorio contiene le chiavi dei tag che desideri rimuovere dall'origine.
Obbligatorio: sì
## Corpo della richiesta
La richiesta non ha un corpo della richiesta.
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.
** message **
L'utente non dispone di accesso sufficiente per eseguire questa azione.
Codice di stato HTTP: 403
** InternalServerException **
Si è verificato un errore interno del server. Invia di nuovo la richiesta.
** message **
Errore imprevisto durante l'elaborazione della richiesta.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
Codice di stato HTTP: 500
** ResourceNotFoundException **
La risorsa non è stata trovata per questa richiesta.
Verifica che le informazioni sulla risorsa, ad esempio l'ARN o il tipo, siano corrette ed esistenti, quindi riprova la richiesta.
** message **
La richiesta fa riferimento a una risorsa che non esiste.
** resourceId **
Identificatore ipotetico della risorsa interessata.
** resourceType **
Tipo ipotetico della risorsa interessata.
Codice di stato HTTP: 404
** ThrottlingException **
La richiesta è stata negata a causa del throttling della richiesta.
** message **
La richiesta non è riuscita a causa della limitazione della richiesta.
** quotaCode **
Questo è il codice univoco del servizio di origine con la quota.
** retryAfterSeconds **
Riprova la chiamata dopo alcuni secondi.
** serviceCode **
Questo è il codice univoco del servizio di origine.
Codice di stato HTTP: 429
** ValidationException **
L'input non soddisfa i vincoli specificati da un servizio.
** message **
L'input non soddisfa i vincoli specificati da un servizio Amazon.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/UntagResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/UntagResource)
# Tipi di dati
I seguenti tipi di dati sono supportati da 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)
I seguenti tipi di dati sono supportati da 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)
I seguenti tipi di dati sono supportati da Ricerca 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
I seguenti tipi di dati sono supportati da 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
Le opzioni di backup per ogni tipo di risorsa.
## Indice
** BackupOptions **
Specifica l'opzione di backup per una risorsa selezionata. Questa opzione è disponibile per i processi di backup Windows VSS e i backup S3.
Valori validi:
Imposta su `"WindowsVSS":"enabled"` per abilitare l'opzione di backup `WindowsVSS` e creare un backup di Windows VSS.
Imposta su `"WindowsVSS":"disabled"` per creare un backup regolare. Per impostazione predefinita, l'opzione `WindowsVSS` non è abilitata.
Per i backup S3, imposta per `"BackupACLs":"disabled"` escludere ACLs dal backup o `"BackupObjectTags":"disabled"` per escludere i tag degli oggetti dal backup. Per impostazione predefinita, entrambi i tag ACLs e gli object sono inclusi nei backup di S3.
Se si specifica un'opzione non valida, si ottiene un'eccezione `InvalidParameterValueException`.
Per ulteriori informazioni sui backup di Windows VSS, consulta [Creazione di backup di Windows VSS](https://docs.aws.amazon.com/aws-backup/latest/devguide/windows-backups.html).
Tipo: mappatura stringa a stringa
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
Modello di valore: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** ResourceType **
Specifica un oggetto contenente il tipo di risorsa e le opzioni di backup. L'unico tipo di risorsa supportato sono le istanze Amazon EC2 con Windows Volume Shadow Copy Service (VSS). *Per un CloudFormation esempio, consulta il [ CloudFormation modello di esempio per abilitare Windows VSS](https://docs.aws.amazon.com/aws-backup/latest/devguide/integrate-cloudformation-with-aws-backup.html) nella Guida per l' AWS Backup utente.*
Valori validi: `EC2`.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/AdvancedBackupSetting)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/AdvancedBackupSetting)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/AdvancedBackupSetting)
# AggregatedScanResult
Contiene risultati di scansione aggregati su più operazioni di scansione, fornendo un riepilogo dello stato e dei risultati della scansione.
## Indice
** FailedScan **
Un valore booleano che indica se una delle scansioni aggregate non è riuscita.
Tipo: Booleano
Obbligatorio: no
** Findings **
Una serie di risultati rilevati in tutte le scansioni aggregate.
Tipo: array di stringhe
Valori validi: `MALWARE`
Campo obbligatorio: no
** LastComputed **
Il timestamp in cui è stato calcolato l'ultima volta il risultato della scansione aggregata, in formato Unix e Coordinated Universal Time (UTC).
Tipo: Timestamp
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue: AWS SDKs
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/AggregatedScanResult)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/AggregatedScanResult)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/AggregatedScanResult)
# BackupJob
Contiene informazioni dettagliate su un processo di backup.
## Indice
** AccountId **
L'ID account proprietario del processo di backup.
Tipo: stringa
Modello: `^[0-9]{12}$`
Obbligatorio: no
** BackupJobId **
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.
▬Tipo: stringa
Obbligatorio: no
** BackupOptions **
Specifica l'opzione di backup per una risorsa selezionata. Questa opzione è disponibile solo per i processi di backup di Windows Volume Shadow Copy Service (VSS).
Valori validi: imposta su `"WindowsVSS":"enabled"` per abilitare l'opzione di backup `WindowsVSS` e creare un backup di Windows VSS. Imposta su `"WindowsVSS":"disabled"` per creare un backup regolare. Se si specifica un'opzione non valida, si ottiene un'eccezione `InvalidParameterValueException`.
Tipo: mappatura stringa a stringa
Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$`
Modello di valore: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** BackupSizeInBytes **
La dimensione, in byte, di un backup (punto di ripristino).
Questo valore può essere riprodotto in modo diverso a seconda del tipo di risorsa, poiché AWS Backup estrae informazioni sui dati da altri AWS servizi. Ad esempio, il valore restituito può mostrare un valore di`0`, che può differire dal valore previsto.
Il comportamento previsto per i valori per tipo di risorsa è descritto come segue:
+ Amazon Aurora, Amazon DocumentDB e Amazon Neptune non hanno questo valore compilato dall'operazione. `GetBackupJobStatus`
+ Per Amazon DynamoDB con funzionalità avanzate, questo valore si riferisce alla dimensione del punto di ripristino (backup).
+ Amazon EC2 e Amazon EBS mostrano la dimensione del volume (storage fornito) restituita come parte di questo valore. Amazon EBS non restituisce informazioni sulle dimensioni del backup; la dimensione dello snapshot avrà lo stesso valore della risorsa originale di cui è stato eseguito il backup.
+ Per Amazon EFS, questo valore si riferisce ai delta byte trasferiti durante un backup.
+ Per Amazon EKS, questo valore si riferisce alla dimensione del punto di ripristino EKS annidato.
+ Amazon FSx non inserisce questo valore nell'operazione `GetBackupJobStatus` per i FSx file system.
+ Un'istanza Amazon RDS verrà visualizzata come`0`.
+ Per le macchine virtuali in esecuzione VMware, questo valore viene passato AWS Backup attraverso un flusso di lavoro asincrono, il che può significare che questo valore visualizzato può sottorappresentare la dimensione effettiva del backup.
Tipo: long
Obbligatorio: no
** BackupType **
Rappresenta il tipo di backup per un processo di backup.
▬Tipo: stringa
Obbligatorio: no
** BackupVaultArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
▬Tipo: stringa
Obbligatorio: no
** BackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: no
** BytesTransferred **
La dimensione in byte trasferiti in un vault di backup nel momento in cui è stata richiesta la verifica dello stato del processo.
Tipo: long
Obbligatorio: no
** CompletionDate **
La data e l'ora di complemento di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** CreatedBy **
Contiene informazioni di identificazione sulla creazione di un processo di backup, tra cui `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` e `BackupRuleId` del piano backup utilizzato per crearlo.
Tipo: oggetto [RecoveryPointCreator](API_RecoveryPointCreator.md)
Obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** EncryptionKeyArn **
L'Amazon Resource Name (ARN) della chiave KMS utilizzata per crittografare il backup. Può essere una chiave gestita dal cliente o una chiave gestita, AWS a seconda della configurazione del vault.
▬Tipo: stringa
Obbligatorio: no
** ExpectedCompletionDate **
La data e l'ora prevista di complemento di un processo di backup delle risorse, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `ExpectedCompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** IamRoleArn **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione. I ruoli IAM diversi dal ruolo predefinito devono includere `AWSBackup` o `AwsBackup` nel nome del ruolo. Ad esempio, `arn:aws:iam::123456789012:role/AWSBackupRDSAccess`. I nomi ruolo senza queste stringhe non dispongono delle autorizzazioni per eseguire processi di backup.
▬Tipo: stringa
Obbligatorio: no
** InitiationDate **
La data in cui è stato avviato il processo di backup.
Tipo: Timestamp
Obbligatorio: no
** IsEncrypted **
Un valore booleano che indica se il backup è crittografato. Tutti i backup in entrata AWS Backup sono crittografati, ma questo campo indica lo stato della crittografia per motivi di trasparenza.
Tipo: Booleano
Obbligatorio: no
** IsParent **
Questo è un valore booleano che indica che si tratta di un processo di backup (composito) padre.
Tipo: Booleano
Obbligatorio: no
** MessageCategory **
Questo parametro è il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio possono essere `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` e `INVALIDPARAMETERS`. Vedi [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco di MessageCategory stringhe.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
▬Tipo: stringa
Obbligatorio: no
** ParentJobId **
Questo identifica in modo univoco una richiesta ad AWS Backup di eseguire il backup di una risorsa. Il risultato sarà l'ID processo (composito) padre.
▬Tipo: stringa
Obbligatorio: no
** PercentDone **
Contiene una percentuale stimata di completamento di un processo nel momento in cui è stato richiesto lo stato del processo.
▬Tipo: stringa
Obbligatorio: no
** RecoveryPointArn **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
▬Tipo: stringa
Obbligatorio: no
** RecoveryPointLifecycle **
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** ResourceArn **
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
▬Tipo: stringa
Obbligatorio: no
** ResourceName **
Il nome non univoco della risorsa che appartiene al backup specificato.
▬Tipo: stringa
Obbligatorio: no
** ResourceType **
Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS). Per i backup di Windows Volume Shadow Copy Service (VSS), l'unico tipo di risorsa supportato è Amazon. EC2
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** StartBy **
Specifica l'ora in formato Unix e UTC (Coordinated Universal Time) in cui è necessario avviare un processo di backup prima che venga annullato. Il valore viene calcolato aggiungendo la finestra di avvio all'ora pianificata. Pertanto, se l'ora pianificata era le 18:00 e la finestra di avvia è di 2 ore, l'ora `StartBy` sarebbe le 20:00 della data specificata. Il valore di `StartBy` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** State **
Lo stato corrente di un processo di backup.
Tipo: String
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL`
Campo obbligatorio: no
** StatusMessage **
Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.
▬Tipo: stringa
Obbligatorio: no
** VaultLockState **
Lo stato di blocco dell'archivio di backup. Per i vault con intercapedine logiche, indica se il deposito è bloccato in modalità di conformità. I valori validi includono `LOCKED` e `UNLOCKED`.
▬Tipo: stringa
Obbligatorio: no
** VaultType **
Il tipo di archivio di backup in cui è archiviato il punto di ripristino. I valori validi sono `BACKUP_VAULT` per gli archivi di backup standard e `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` per gli archivi con intercapedine logiche.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupJob)
# BackupJobSummary
È un riepilogo dei processi creati o eseguiti negli ultimi 30 giorni.
Il riepilogo restituito può contenere quanto segue: Regione, Account RestourceType, Stato MessageCategory StartTime, EndTime,, e Numero di lavori inclusi.
## Indice
** AccountId **
L'ID dell'account proprietario dei processi del riepilogo.
Tipo: stringa
Modello: `^[0-9]{12}$`
Campo obbligatorio: no
** Count **
Il valore espresso come numero di processi in un riepilogo dei processi.
Tipo: integer
Campo obbligatorio: no
** EndTime **
Il valore in formato numerico dell'ora di fine di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** MessageCategory **
Questo parametro è il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio sono `AccessDenied`, `Success` e `InvalidParameters`. Vedi [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco di MessageCategory stringhe.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
Tipo: string
Campo obbligatorio: no
** Region **
Le AWS regioni all'interno del riepilogo delle offerte di lavoro.
Tipo: string
Campo obbligatorio: no
** ResourceType **
Il valore del numero di processi per il tipo di risorsa specificato. La richiesta `GetSupportedResourceTypes` restituisce le stringhe per i tipi di risorsa supportati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
** StartTime **
Il valore in formato numerico dell'ora di inizio di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** State **
Questo valore indica il numero di processi con lo stato specificato.
Tipo: stringa
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupJobSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupJobSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupJobSummary)
# BackupPlan
Contiene un nome di visualizzazione del piano di backup e una gamma di oggetti `BackupRule`, ciascuno dei quali specifica una regola di backup. Ogni regola in un piano di backup è un'attività pianificata separata e può eseguire il backup di un'altra gamma di risorse AWS .
## Indice
** BackupPlanName **
Il nome visualizzato di un piano di backup. Deve contenere solo caratteri alfanumerici o «-\$1». caratteri speciali.
Se è impostato nella console, può contenere da 1 a 50 caratteri; se è impostato tramite CLI o API, può contenere da 1 a 200 caratteri.
Tipo: stringa
Obbligatorio: sì
** Rules **
Un array di oggetti `BackupRule`, ciascuno dei quali specifica un'operazione pianificata che viene utilizzato per eseguire il backup di una gamma di risorse.
Tipo: matrice di oggetti [BackupRule](API_BackupRule.md)
Obbligatorio: sì
** AdvancedBackupSettings **
Contiene un elenco di `BackupOptions` per ogni tipo di risorsa.
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)
Obbligatorio: no
** ScanSettings **
Contiene la configurazione di scansione per il piano di backup e include lo scanner Malware, le risorse selezionate e il ruolo dello scanner.
Tipo: matrice di oggetti [ScanSetting](API_ScanSetting.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlan)
# BackupPlanInput
Contiene un nome di visualizzazione del piano di backup e una gamma di oggetti `BackupRule`, ciascuno dei quali specifica una regola di backup. Ogni regola in un piano di backup è un'attività pianificata separata.
## Indice
** BackupPlanName **
Il nome visualizzato di un piano di backup. Deve contenere da 1 a 50 caratteri alfanumerici o i caratteri '-\$1.' punti (.).
Tipo: stringa
Obbligatorio: sì
** Rules **
Un array di oggetti `BackupRule`, ciascuno dei quali specifica un'operazione pianificata che viene utilizzato per eseguire il backup di una gamma di risorse.
Tipo: matrice di oggetti [BackupRuleInput](API_BackupRuleInput.md)
Obbligatorio: sì
** AdvancedBackupSettings **
Specifica un elenco di `BackupOptions` per ogni tipo di risorsa. Queste impostazioni sono disponibili solo per i processi di backup di Windows Volume Shadow Copy Service (VSS).
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)
Obbligatorio: no
** ScanSettings **
Contiene la configurazione di scansione per la regola di backup e include lo scanner antimalware e la modalità di scansione completa o incrementale.
Tipo: matrice di oggetti [ScanSetting](API_ScanSetting.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlanInput)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlanInput)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlanInput)
# BackupPlansListMember
Contiene metadati relativi a un piano di backup.
## Indice
** AdvancedBackupSettings **
Contiene un elenco di `BackupOptions` per un tipo di risorsa.
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)
Campo obbligatorio: no
** BackupPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
Tipo: string
Campo obbligatorio: no
** BackupPlanId **
Identifica in modo univoco un piano di backup.
Tipo: string
Campo obbligatorio: no
** BackupPlanName **
Il nome visualizzato di un piano di backup salvato.
Tipo: string
Campo obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un piano di backup delle risorse, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** CreatorRequestId **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
Tipo: string
Campo obbligatorio: no
** DeletionDate **
La data e l'ora di eliminazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `DeletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** LastExecutionDate **
L'ultima volta che è stato eseguito questo piano di backup. Una data e ora, in formato UNIX e nell'ora Universal Coordinated Time (UTC). Il valore di `LastExecutionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** VersionId **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. La versione IDs non può essere modificata.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlansListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlansListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlansListMember)
# BackupPlanTemplatesListMember
Un oggetto che specifica i metadati associati a un modello di piano di backup.
## Indice
** BackupPlanTemplateId **
Identifica in modo univoco un modello di piano di backup archiviato.
Tipo: string
Campo obbligatorio: no
** BackupPlanTemplateName **
Il nome visualizzato opzionale di un modello di piano di backup.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupPlanTemplatesListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupPlanTemplatesListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupPlanTemplatesListMember)
# BackupRule
Specifica un'attività pianificata utilizzata per eseguire il backup di una selezione di risorse.
## Indice
** RuleName **
Un nome visualizzato per una regola di backup. Deve contenere da 1 a 50 caratteri alfanumerici o i caratteri '-\$1.' punti (.).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: sì
** TargetBackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** CompletionWindowMinutes **
Un valore in minuti dopo che un processo di backup viene avviato correttamente prima che sia completato o annullato da AWS Backup. Questo valore è facoltativo.
Tipo: long
Obbligatorio: no
** CopyActions **
Una matrice di oggetti `CopyAction`, che contiene i dettagli dell'operazione di copia.
Tipo: matrice di oggetti [CopyAction](API_CopyAction.md)
Obbligatorio: no
** EnableContinuousBackup **
Specifica se AWS Backup crea backup continui. Le vere cause della creazione AWS Backup di backup continui in grado di point-in-time ripristinare (PITR). False (o non specificata) causa la creazione AWS Backup di backup di istantanee.
Tipo: Booleano
Obbligatorio: no
** IndexActions **
IndexActions è un array che viene utilizzato per specificare come devono essere indicizzati i dati di backup.
Ciascuno BackupRule può avere 0 o 1 IndexAction, poiché a ogni backup può essere associato fino a un indice.
All'interno dell'array c'è ResourceType. Ne verrà accettato uno solo per ciascuno BackupRule.
Tipo: matrice di oggetti [IndexAction](API_IndexAction.md)
Obbligatorio: no
** Lifecycle **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** RecoveryPointTags **
I tag assegnati alle risorse associate a questa regola quando vengono ripristinate dal backup.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** RuleId **
Identifica in modo univoco una regola utilizzata per pianificare il backup di una selezione di risorse.
▬Tipo: stringa
Obbligatorio: no
** ScanActions **
Contiene la configurazione di scansione per la regola di backup e include lo scanner antimalware e la modalità di scansione completa o incrementale.
Tipo: matrice di oggetti [ScanAction](API_ScanAction.md)
Obbligatorio: no
** ScheduleExpression **
Un'espressione cron in UTC che specifica quando AWS Backup avvia un processo di backup. Quando non viene fornita alcuna espressione CRON, AWS Backup utilizzerà l'espressione predefinita. `cron(0 5 ? * * *)`
Per ulteriori informazioni sulle espressioni AWS cron, consulta [Schedule Expressions for Rules](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html) nella *Amazon CloudWatch Events User Guide*.
Due esempi di espressioni AWS cron sono ` 15 * ? * * *` (eseguire un backup ogni ora a 15 minuti dopo l'ora) e `0 12 * * ? *` (eseguire un backup ogni giorno alle 12:00 UTC).
Per una tabella di esempi, fai clic sul collegamento precedente e scorri la pagina verso il basso.
▬Tipo: stringa
Obbligatorio: no
** ScheduleExpressionTimezone **
Il fuso orario in cui è impostata l'espressione di pianificazione. Per impostazione predefinita, ScheduleExpressions sono in formato UTC. Puoi modificarlo impostando un fuso orario specifico.
▬Tipo: stringa
Obbligatorio: no
** StartWindowMinutes **
Un valore in minuti dopo la pianificazione di un backup prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo. Se questo valore è incluso, devono essere necessari almeno 60 minuti per evitare errori.
Durante la finestra di avvio, il processo di backup rimane in stato `CREATED` finché non viene avviato correttamente o fino alla scadenza della finestra di avvio. Se all'interno della finestra di avvio AWS Backup viene visualizzato un errore che consente di riprovare il processo, AWS Backup riproverà automaticamente a iniziare il processo almeno ogni 10 minuti fino all'avvio corretto del backup (lo stato del lavoro cambia in`RUNNING`) o fino a quando lo stato del lavoro non cambia a `EXPIRED` (cosa che dovrebbe verificarsi allo scadere della finestra di avvio).
Tipo: long
Obbligatorio: no
** TargetLogicallyAirGappedBackupVaultArn **
L'ARN di un caveau con intercapedine logiche. L'ARN deve trovarsi nello stesso account e nella stessa regione. Se fornite, le risorse completamente gestite supportate eseguono il backup direttamente nel vault logicamente separato, mentre altre risorse supportate creano un'istantanea temporanea (fatturabile) nel vault di backup, quindi la copiano in un archivio con sistema logico. Le risorse non supportate eseguono il backup solo nell'archivio di backup specificato.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupRule)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupRule)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupRule)
# BackupRuleInput
Specifica un'attività pianificata utilizzata per eseguire il backup di una selezione di risorse.
## Indice
** RuleName **
Un nome visualizzato per una regola di backup. Deve contenere da 1 a 50 caratteri alfanumerici o i caratteri '-\$1.' punti (.).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: sì
** TargetBackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: sì
** CompletionWindowMinutes **
Un valore in minuti dopo che un processo di backup viene avviato correttamente prima che sia completato o annullato da AWS Backup. Questo valore è facoltativo.
Tipo: long
Obbligatorio: no
** CopyActions **
Una matrice di oggetti `CopyAction`, che contiene i dettagli dell'operazione di copia.
Tipo: matrice di oggetti [CopyAction](API_CopyAction.md)
Obbligatorio: no
** EnableContinuousBackup **
Specifica se AWS Backup crea backup continui. Le vere cause della creazione AWS Backup di backup continui in grado di point-in-time ripristinare (PITR). False (o non specificata) causa la creazione di copie AWS Backup di backup istantanee.
Tipo: Booleano
Obbligatorio: no
** IndexActions **
Può esserne presente fino IndexAction a uno per ogni backup BackupRule, poiché a ogni backup può essere associato 0 o 1 indice di backup.
All'interno dell'array c'è ResourceTypes. Verrà accettato un solo tipo di risorsa per ogni tipo BackupRule. Valori validi:
+ `EBS` per Amazon Elastic Block Store
+ `S3`per Amazon Simple Storage Service (Amazon S3)
Tipo: matrice di oggetti [IndexAction](API_IndexAction.md)
Obbligatorio: no
** Lifecycle **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup eseguirà automaticamente la transizione e la scadenza dei backup in base al ciclo di vita definito.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L'impostazione «transizione al freddo dopo giorni» non può essere modificata dopo il passaggio di un backup alla conservazione a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Questo parametro ha un valore massimo di 100 anni (36.5000 giorni).
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** RecoveryPointTags **
I tag da assegnare alle risorse.
Tipo: mappatura stringa a stringa
Obbligatorio: no
** ScanActions **
Contiene la configurazione di scansione per la regola di backup e include lo scanner antimalware e la modalità di scansione completa o incrementale.
Tipo: matrice di oggetti [ScanAction](API_ScanAction.md)
Obbligatorio: no
** ScheduleExpression **
Un'espressione CRON in UTC che specifica quando AWS Backup avvia un processo di backup. Quando non viene fornita alcuna espressione CRON, AWS Backup utilizzerà l'espressione predefinita. `cron(0 5 ? * * *)`
▬Tipo: stringa
Obbligatorio: no
** ScheduleExpressionTimezone **
Il fuso orario in cui è impostata l'espressione di pianificazione. Per impostazione predefinita, ScheduleExpressions sono in formato UTC. Puoi modificarlo impostando un fuso orario specifico.
▬Tipo: stringa
Obbligatorio: no
** StartWindowMinutes **
Un valore in minuti dopo la pianificazione di un backup prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo. Se questo valore è incluso, devono essere necessari almeno 60 minuti per evitare errori.
Il valore massimo di questo parametro è 100 anni (52.560.000 minuti).
Durante la finestra di avvio, il processo di backup rimane in stato `CREATED` finché non viene avviato correttamente o fino alla scadenza della finestra di avvio. Se all'interno della finestra di avvio AWS Backup viene visualizzato un errore che consente di riprovare il processo, AWS Backup riproverà automaticamente a iniziare il processo almeno ogni 10 minuti fino all'avvio corretto del backup (lo stato del lavoro cambia in`RUNNING`) o fino a quando lo stato del lavoro non cambia a `EXPIRED` (cosa che dovrebbe verificarsi allo scadere della finestra di avvio).
Tipo: long
Obbligatorio: no
** TargetLogicallyAirGappedBackupVaultArn **
L'ARN di un caveau con intercapedine logiche. L'ARN deve trovarsi nello stesso account e nella stessa regione. Se fornite, le risorse completamente gestite supportate eseguono il backup direttamente nel vault logicamente separato, mentre altre risorse supportate creano un'istantanea temporanea (fatturabile) nel vault di backup, quindi la copiano in un archivio con sistema logico. Le risorse non supportate eseguono il backup solo nell'archivio di backup specificato.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupRuleInput)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupRuleInput)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupRuleInput)
# BackupSelection
Utilizzato per specificare un set di risorse per un piano di backup.
Ti consigliamo di specificare condizioni, tag o risorse da includere o escludere. In caso contrario, Backup tenta di selezionare tutte le risorse di storage supportate e attivate, il che potrebbe avere implicazioni indesiderate sui costi.
Per ulteriori informazioni, vedere [Assegnazione](https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json) di risorse a livello di codice.
## Indice
** IamRoleArn **
L'ARN del ruolo IAM AWS Backup utilizzato per l'autenticazione durante il backup della risorsa di destinazione; ad esempio,. `arn:aws:iam::123456789012:role/S3Access`
Tipo: stringa
Obbligatorio: sì
** SelectionName **
Il nome di visualizzazione di un documento di selezione delle risorse. Deve contenere da 1 a 50 caratteri alfanumerici o i caratteri '-\$1.' punti (.).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: sì
** Conditions **
Le condizioni che definisci per assegnare risorse ai tuoi piani di backup utilizzando i tag. Ad esempio, `"StringEquals": { "ConditionKey": "aws:ResourceTag/backup", "ConditionValue": "daily" }`.
`Conditions`supporta`StringEquals`, `StringLike``StringNotEquals`, e`StringNotLike`. Gli operatori di condizione fanno distinzione tra maiuscole e minuscole.
Se si specificano più condizioni, le risorse corrispondono in gran parte a tutte le condizioni (logica AND).
Tipo: oggetto [Conditions](API_Conditions.md)
Obbligatorio: no
** ListOfTags **
Si consiglia di utilizzare il `Conditions` parametro anziché questo parametro.
Le condizioni che definisci per assegnare risorse ai tuoi piani di backup utilizzando i tag. Ad esempio, `"StringEquals": { "ConditionKey": "backup", "ConditionValue": "daily"}`.
`ListOfTags`supporta solo`StringEquals`. Gli operatori di condizione fanno distinzione tra maiuscole e minuscole.
Se si specificano più condizioni, le risorse corrispondono in gran parte a qualsiasi condizione (logica OR).
Tipo: matrice di oggetti [Condition](API_Condition.md)
Obbligatorio: no
** NotResources **
I nomi delle risorse Amazon (ARNs) da escludere da un piano di backup. Il numero massimo di ARNs è 500 senza caratteri jolly o 30 ARNs con caratteri jolly.
Se devi escludere molte risorse da un piano di backup, prendi in considerazione una strategia di selezione delle risorse diversa, ad esempio assegnare solo uno o alcuni tipi di risorse o perfezionare la selezione delle risorse utilizzando i tag.
Tipo: array di stringhe
Obbligatorio: no
** Resources **
I nomi delle risorse Amazon (ARNs) da assegnare a un piano di backup. Il numero massimo di caratteri jolly ARNs è 500 senza caratteri jolly o 30 ARNs con caratteri jolly.
Se occorre assegnare molte risorse a un piano di backup, prendere in considerazione una strategia di selezione delle risorse diversa, come assegnare tutte le risorse di un tipo di risorsa o perfezionare la selezione delle risorse utilizzando i tag.
Se ne specificate più di uno ARNs, le risorse corrispondono di gran lunga a una qualsiasi delle ARNs (logiche OR).
Quando si utilizzano caratteri jolly nei modelli ARN per le selezioni di backup, l'asterisco (\$1) deve apparire alla fine della stringa ARN (modello di prefisso). Ad esempio, `arn:aws:s3:::my-bucket-*` è valido, ma non è supportato. `arn:aws:s3:::*-logs`
Tipo: array di stringhe
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupSelection)
# BackupSelectionsListMember
Contiene metadati relativi a un oggetto `BackupSelection`.
## Indice
** BackupPlanId **
Identifica in modo univoco un piano di backup.
Tipo: string
Campo obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** CreatorRequestId **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
Tipo: string
Campo obbligatorio: no
** IamRoleArn **
Specifica il nome della risorsa Amazon (ARN) del ruolo IAM per creare il punto di ripristino di destinazione; ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: string
Campo obbligatorio: no
** SelectionId **
Identifica in modo univoco una richiesta per assegnare un set di risorse a un piano di backup.
Tipo: string
Campo obbligatorio: no
** SelectionName **
Il nome di visualizzazione di un documento di selezione delle risorse.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupSelectionsListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupSelectionsListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupSelectionsListMember)
# BackupVaultListMember
Contiene metadati relativi a un vault di backup.
## Indice
** BackupVaultArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
▬Tipo: stringa
Obbligatorio: no
** BackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un backup delle risorse, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** CreatorRequestId **
Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** EncryptionKeyArn **
Una chiave di crittografia lato server che è possibile specificare per crittografare i backup da servizi che supportano la AWS Backup gestione completa, ad esempio. `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` Se specifichi una chiave, è necessario specificare il relativo ARN, non il relativo alias. Se non specifichi una chiave, AWS Backup crea una chiave KMS per impostazione predefinita.
[Per sapere quali AWS Backup servizi supportano la AWS Backup gestione completa e come AWS Backup gestisce la crittografia per i backup dei servizi che non supportano ancora la gestione completa AWS Backup, vedi Encryption for backup in AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/encryption.html)
▬Tipo: stringa
Obbligatorio: no
** EncryptionKeyType **
Il tipo di chiave di crittografia utilizzata per l'archivio di backup. I valori validi sono CUSTOMER\$1MANAGED\$1KMS\$1KEY per le chiavi gestite dal cliente o \$1OWNED\$1KMS\$1KEY per le chiavi di proprietà. AWS AWS
Tipo: String
Valori validi: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`
Campo obbligatorio: no
** LockDate **
La data e l'ora in cui la configurazione di Vault AWS Backup Lock diventa immutabile, il che significa che non può essere modificata o eliminata.
Se hai applicato Vault Lock al vault senza specificare una data di blocco, puoi modificare le impostazioni di Vault Lock o eliminare completamente Vault Lock dal vault, in qualsiasi momento.
Questo valore è in formato Unix, ora Coordinated Universal Time (UTC) ed è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** Locked **
Un valore booleano che indica se AWS Backup Vault Lock si applica al vault di backup selezionato. Se `true`, Vault Lock impedisce le operazioni di eliminazione e aggiornamento sui punti di ripristino nel vault selezionato.
Tipo: Booleano
Obbligatorio: no
** MaxRetentionDays **
L'impostazione AWS Backup Vault Lock che specifica il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione massimo sui punti di ripristino nel vault (consentendo lo storage a tempo indeterminato).
Se specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o inferiore al periodo di conservazione massimo. Se il periodo di conservazione del processo è più lungo del periodo di conservazione massimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. I punti di ripristino già archiviati nel vault prima di Vault Lock non sono interessati.
Tipo: long
Obbligatorio: no
** MinRetentionDays **
L'impostazione AWS Backup Vault Lock che specifica il periodo di conservazione minimo durante il quale il vault conserva i propri punti di ripristino. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione minimo.
Se specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o superiore al periodo di conservazione minimo. Se il periodo di conservazione del processo è più breve del periodo di conservazione minimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. I punti di ripristino già archiviati nel vault prima di Vault Lock non sono interessati.
Tipo: long
Obbligatorio: no
** NumberOfRecoveryPoints **
Il numero di punti di ripristino archiviati in un vault di backup. Il valore del conteggio dei punti di ripristino visualizzato nella console può essere un’approssimazione.
Tipo: long
Obbligatorio: no
** VaultState **
Lo stato attuale del vault.
Tipo: String
Valori validi: `CREATING | AVAILABLE | FAILED`
Campo obbligatorio: no
** VaultType **
Il tipo di archivio in cui è archiviato il punto di ripristino descritto.
Tipo: String
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupVaultListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupVaultListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupVaultListMember)
# CalculatedLifecycle
Contiene i timestamp `DeleteAt` e `MoveToColdStorageAt`, utilizzati per specificare un ciclo di vita per un punto di ripristino.
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup trasferiti allo storage dei dati inattivi devono essere archiviati nello storage dei dati inattivi per un minimo di 90 giorni. Pertanto, l'impostazione "conservazione" deve essere 90 giorni maggiore dell'impostazione "transizione a inattivo dopo". L'impostazione "transizione a inattivo dopo" non può essere modificata dopo che è stata eseguita la transizione di un backup a inattivo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle [funzionalità](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.
## Indice
** DeleteAt **
Un timestamp che specifica quando eliminare un punto di ripristino.
Tipo: Timestamp
Campo obbligatorio: no
** MoveToColdStorageAt **
Un timestamp che specifica quando eseguire la transizione di un punto di ripristino allo storage a freddo.
Tipo: Timestamp
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CalculatedLifecycle)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CalculatedLifecycle)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CalculatedLifecycle)
# Condition
Contiene una matrice di triplette costituite da un tipo di condizione (ad esempio `StringEquals`), una chiave e un valore. Utilizzato per filtrare le risorse utilizzando i relativi tag e assegnarle a un piano di backup. Distinzione tra lettere maiuscole e minuscole.
## Indice
** ConditionKey **
La chiave in una coppia chiave-valore. Ad esempio, nel `Department: Accounting`, `Department` è la chiave.
Tipo: stringa
Campo obbligatorio: sì
** ConditionType **
Un'operazione applicata a una coppia chiave-valore utilizzata per assegnare risorse al piano di backup. La condizione supporta solo `StringEquals`. Per opzioni di assegnazione più flessibili, tra cui `StringLike` e la possibilità di escludere risorse dal piano di backup, utilizza `Conditions` (con una "s" alla fine) per [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: stringa
Valori validi: `STRINGEQUALS`
Campo obbligatorio: sì
** ConditionValue **
Il valore in una coppia chiave-valore. Ad esempio, nel `Department: Accounting`, `Accounting` è il valore.
Tipo: stringa
Campo obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Condition)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Condition)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Condition)
# ConditionParameter
Include informazioni sui tag che definisci per assegnare risorse con tag per un piano di backup.
Includi il prefisso `aws:ResourceTag` nei tag. Ad esempio `"aws:ResourceTag/TagKey1": "Value1"`.
## Indice
** ConditionKey **
La chiave in una coppia chiave-valore. Ad esempio, nel `Department: Accounting`, `Department` è la chiave.
Tipo: string
Campo obbligatorio: no
** ConditionValue **
Il valore in una coppia chiave-valore. Ad esempio, nel `Department: Accounting`, `Accounting` è il valore.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ConditionParameter)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ConditionParameter)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ConditionParameter)
# Conditions
Contiene informazioni sulle risorse da includere o escludere da un piano di backup utilizzando i relativi tag. Le condizioni distinguono maiuscole e minuscole.
## Indice
** StringEquals **
Filtra i valori delle risorse con tag solo per le risorse a cui hai aggiunto tag con lo stesso valore. Detta anche “corrispondenza esatta”.
Tipo: matrice di oggetti [ConditionParameter](API_ConditionParameter.md)
Campo obbligatorio: no
** StringLike **
Filtra i valori delle risorse con tag per i valori dei tag corrispondenti con l'uso di un carattere jolly (\$1) in qualunque punto della stringa. Ad esempio, “prod\$1” o “\$1rod\$1” corrispondono al valore del tag “production”.
Tipo: matrice di oggetti [ConditionParameter](API_ConditionParameter.md)
Campo obbligatorio: no
** StringNotEquals **
Filtra i valori delle risorse con tag solo per le risorse a cui hai aggiunto tag che non hanno lo stesso valore. Detta anche “corrispondenza negata”.
Tipo: matrice di oggetti [ConditionParameter](API_ConditionParameter.md)
Campo obbligatorio: no
** StringNotLike **
Filtra i valori delle risorse con tag per i valori dei tag non corrispondenti con l'uso di un carattere jolly (\$1) in qualunque punto della stringa.
Tipo: matrice di oggetti [ConditionParameter](API_ConditionParameter.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Conditions)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Conditions)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Conditions)
# ControlInputParameter
I parametri per un controllo. Un controllo può avere zero, uno o più parametri. Un esempio di controllo con due parametri è il seguente: "la frequenza del piano di backup è almeno `daily` e il periodo di conservazione è almeno `1 year`". Il primo parametro è `daily`, mentre il secondo parametro è `1 year`.
## Indice
** ParameterName **
Il nome di un parametro, ad esempio `BackupPlanFrequency`.
Tipo: string
Campo obbligatorio: no
** ParameterValue **
Il valore del parametro, ad esempio `hourly`.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ControlInputParameter)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ControlInputParameter)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ControlInputParameter)
# ControlScope
Un framework consiste in uno o più controlli. Ogni controllo ha il proprio ambito di controllo. L'ambito di controllo può includere uno o più tipi di risorse, una combinazione di chiavi e valori di un tag oppure una combinazione di un singolo tipo di risorsa e un singolo ID risorsa. Se non è specificato alcun ambito, le valutazioni per la regola vengono attivate quando la configurazione di una qualunque risorsa nel gruppo di registrazione cambia.
**Nota**
Per impostare un ambito di controllo che includa tutta una risorsa particolare, lascia vuoto il campo `ControlScope` o non passarlo quando richiami `CreateFramework`.
## Indice
** ComplianceResourceIds **
L'ID dell'unica AWS risorsa che vuoi che l'ambito di controllo contenga.
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 100 elementi.
Campo obbligatorio: no
** ComplianceResourceTypes **
Descrive se l'ambito di controllo include uno o più tipi di risorsa, ad esempio `EFS` o `RDS`.
Tipo: matrice di stringhe
Campo obbligatorio: no
** Tags **
La coppia chiave-valore del tag applicata alle AWS risorse che desideri attivare una valutazione per una regola. È possibile fornire fino a una sola coppia chiave-valore. Il valore del tag è facoltativo, ma non può essere una stringa vuota se si crea o si modifica un framework dalla console (sebbene il valore possa essere una stringa vuota se inclusa in un CloudFormation modello).
La struttura a cui assegnare un tag è: `[{"Key":"string","Value":"string"}]`.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ControlScope)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ControlScope)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ControlScope)
# CopyAction
I dettagli dell'operazione di copia.
## Indice
** DestinationBackupVaultArn **
Un Amazon Resource Name (ARN) che identifica in modo univoco l'insieme di credenziali di backup di destinazione per il backup copiato. Ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: stringa
Campo obbligatorio: sì
** Lifecycle **
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup trasferiti allo storage dei dati inattivi devono essere archiviati nello storage dei dati inattivi per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CopyAction)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CopyAction)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CopyAction)
# CopyJob
Contiene informazioni dettagliate su un processo di copia.
## Indice
** AccountId **
L'ID account proprietario del processo di copia.
Tipo: stringa
Modello: `^[0-9]{12}$`
Obbligatorio: no
** BackupSizeInBytes **
La dimensione, in byte, di un processo di copia.
Tipo: long
Obbligatorio: no
** ChildJobsInState **
Ciò restituisce le statistiche dei processi di copia figlio (nidificati) inclusi.
Tipo: mappatura stringa a intero lungo
Chiavi valide: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL`
Obbligatorio: no
** CompletionDate **
La data e l'ora di completamento di un processo di copia, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** CompositeMemberIdentifier **
L'identificatore di una risorsa all'interno di un gruppo composito, ad esempio un punto di ripristino annidato (figlio) appartenente a uno stack composito (principale). L'ID viene trasferito dall'[ID logico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) all'interno di uno stack.
▬Tipo: stringa
Obbligatorio: no
** CopyJobId **
Identifica in modo univoco un processo di copia.
▬Tipo: stringa
Obbligatorio: no
** CreatedBy **
Contiene informazioni sul piano e sulla regola di backup AWS Backup utilizzati per avviare il backup del punto di ripristino.
Tipo: oggetto [RecoveryPointCreator](API_RecoveryPointCreator.md)
Obbligatorio: no
** CreatedByBackupJobId **
L'ID del processo di backup che ha avviato questo processo di copia. Applicabile solo ai lavori di copia pianificati e ai lavori di copia automatici su vault logicamente airgapped.
▬Tipo: stringa
Obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un processo di copia, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** DestinationBackupVaultArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di copia di destinazione, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
▬Tipo: stringa
Obbligatorio: no
** DestinationEncryptionKeyArn **
L'Amazon Resource Name (ARN) della chiave KMS utilizzata per crittografare il backup copiato nel vault di destinazione. Può essere una chiave gestita dal cliente o una chiave gestita. AWS
▬Tipo: stringa
Obbligatorio: no
** DestinationRecoveryPointArn **
Un ARN che identifica in modo univoco un punto di ripristino di destinazione; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
▬Tipo: stringa
Obbligatorio: no
** DestinationRecoveryPointLifecycle **
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** DestinationVaultLockState **
Lo stato di blocco del vault di backup di destinazione. Per i vault con intercapedine logiche, indica se il deposito è bloccato in modalità di conformità. I valori validi includono `LOCKED` e `UNLOCKED`.
▬Tipo: stringa
Obbligatorio: no
** DestinationVaultType **
Il tipo di archivio di backup di destinazione in cui è archiviato il punto di ripristino copiato. I valori validi sono `BACKUP_VAULT` per gli archivi di backup standard e `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` per gli archivi con intercapedine logiche.
▬Tipo: stringa
Obbligatorio: no
** IamRoleArn **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio `arn:aws:iam::123456789012:role/S3Access`.
▬Tipo: stringa
Obbligatorio: no
** IsParent **
Questo è un valore booleano che indica che si tratta di un processo di copia (composito) padre.
Tipo: Booleano
Obbligatorio: no
** MessageCategory **
Questo parametro è il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio possono essere `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` e `InvalidParameters`. Vedi [Monitoraggio per un elenco di stringhe](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html). MessageCategory
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma
▬Tipo: stringa
Obbligatorio: no
** NumberOfChildJobs **
Il numero di lavori di copia secondari (annidati).
Tipo: long
Obbligatorio: no
** ParentJobId **
Questo identifica in modo univoco una richiesta ad AWS Backup per copiare una risorsa. Il risultato sarà l'ID processo (composito) padre.
▬Tipo: stringa
Obbligatorio: no
** ResourceArn **
La AWS risorsa da copiare, ad esempio un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
▬Tipo: stringa
Obbligatorio: no
** ResourceName **
Il nome non univoco della risorsa che appartiene al backup specificato.
▬Tipo: stringa
Obbligatorio: no
** ResourceType **
Il tipo di AWS risorsa da copiare; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** SourceBackupVaultArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup di origine, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
▬Tipo: stringa
Obbligatorio: no
** SourceRecoveryPointArn **
Un ARN che identifica in modo univoco un punto di ripristino di origine; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
▬Tipo: stringa
Obbligatorio: no
** State **
Lo stato corrente di un processo di copia.
Tipo: String
Valori validi: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL`
Campo obbligatorio: no
** StatusMessage **
Un messaggio dettagliato che spiega lo stato del processo di copia di una risorsa.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CopyJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CopyJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CopyJob)
# CopyJobSummary
È un riepilogo dei processi di copia creati o eseguiti negli ultimi 30 giorni.
Il riepilogo restituito può contenere quanto segue: Regione, Account RestourceType, Stato MessageCategory StartTime, EndTime,, e Numero di lavori inclusi.
## Indice
** AccountId **
L'ID dell'account proprietario dei processi del riepilogo.
Tipo: stringa
Modello: `^[0-9]{12}$`
Campo obbligatorio: no
** Count **
Il valore espresso come numero di processi in un riepilogo dei processi.
Tipo: integer
Campo obbligatorio: no
** EndTime **
Il valore in formato numerico dell'ora di fine di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** MessageCategory **
Questo parametro è il numero di processi per la categoria di messaggi specificata.
Stringhe di esempio sono `AccessDenied`, `Success` e `InvalidParameters`. Vedi [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco di MessageCategory stringhe.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
`AGGREGATE_ALL` aggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma.
▬Tipo: stringa
Campo obbligatorio: no
** Region **
Le AWS regioni all'interno del riepilogo del lavoro.
▬Tipo: stringa
Campo obbligatorio: no
** ResourceType **
Il valore del numero di processi per il tipo di risorsa specificato. La richiesta `GetSupportedResourceTypes` restituisce le stringhe per i tipi di risorsa supportati
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
** StartTime **
Il valore in formato numerico dell'ora di inizio di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** State **
Questo valore indica il numero di processi con lo stato specificato.
▬Tipo: stringa
Valori validi: `CREATED | RUNNING | ABORTING | ABORTED | COMPLETING | COMPLETED | FAILING | FAILED | PARTIAL | AGGREGATE_ALL | ANY`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CopyJobSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CopyJobSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CopyJobSummary)
# DateRange
Questo è un filtro di risorse che contiene FromDate: DateTime e ToDate: DateTime. Entrambi i valori sono obbligatori. DateTime I valori futuri non sono consentiti.
La data e l'ora sono in formato Unix e ora UTC (Coordinated Universal Time) e hanno una precisione al millisecondo (i millisecondi sono opzionali). Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
## Indice
** FromDate **
Questo valore è la data di inizio, inclusiva.
La data e l'ora sono in formato Unix e ora UTC (Coordinated Universal Time) e hanno una precisione al millisecondo (i millisecondi sono opzionali).
Tipo: Timestamp
Campo obbligatorio: sì
** ToDate **
Questo valore è la data di fine, inclusiva.
La data e l'ora sono in formato Unix e ora UTC (Coordinated Universal Time) e hanno una precisione al millisecondo (i millisecondi sono opzionali).
Tipo: Timestamp
Campo obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DateRange)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DateRange)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DateRange)
# Framework
Contiene informazioni dettagliate su un framework. I framework contengono controlli che valutano e generano report sugli eventi e sulle risorse di backup. I framework generano risultati di conformità giornalieri.
## Indice
** CreationTime **
La data e l'ora di creazione del framework, nella rappresentazione ISO 8601. Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, 2020-07-10T15:00:00.000-08:00 rappresenta il 10 luglio 2020 alle 15:00 8 ore indietro rispetto all'UTC.
Tipo: Timestamp
Campo obbligatorio: no
** DeploymentStatus **
Lo stato di implementazione di un framework. Gli stati sono:
`CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED`
Tipo: string
Campo obbligatorio: no
** FrameworkArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: string
Campo obbligatorio: no
** FrameworkDescription **
Descrizione facoltativa del framework, per un massimo di 1.024 caratteri.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
Campo obbligatorio: no
** FrameworkName **
Il nome univoco di un framework. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Campo obbligatorio: no
** NumberOfControls **
Il numero di controlli contenuti dal framework.
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Framework)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Framework)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Framework)
# FrameworkControl
Contiene informazioni dettagliate su tutti i controlli di un framework. Ogni framework deve contenere almeno un controllo.
## Indice
** ControlName **
Il nome di un controllo. Il nome deve contenere da 1 a 256 caratteri.
Tipo: stringa
Campo obbligatorio: sì
** ControlInputParameters **
Le coppie nome/valore.
Tipo: matrice di oggetti [ControlInputParameter](API_ControlInputParameter.md)
Campo obbligatorio: no
** ControlScope **
L'ambito di un controllo. L'ambito del controllo stabilisce gli elementi da valutare. I tre ambiti di controllo esemplificativi sono: un piano di backup specifico, tutti i piani di backup con un tag specifico o tutti i piani di backup.
Per ulteriori informazioni, consulta [`ControlScope`.](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ControlScope.html)
Tipo: oggetto [ControlScope](API_ControlScope.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/FrameworkControl)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/FrameworkControl)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/FrameworkControl)
# IndexAction
Questo è un array opzionale all'interno di un BackupRule.
IndexAction è composto da uno ResourceTypes.
## Indice
** ResourceTypes **
Verranno accettate 0 o 1 azione indicizzata per ciascuna BackupRule.
Valori validi:
+ `EBS` per Amazon Elastic Block Store
+ `S3`per Amazon Simple Storage Service (Amazon S3)
Tipo: matrice di stringhe
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/IndexAction)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/IndexAction)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/IndexAction)
# IndexedRecoveryPoint
Si tratta di un punto di ripristino a cui è associato un indice di backup.
Solo i punti di ripristino con un indice di backup possono essere inclusi in una ricerca.
## Indice
** BackupCreationDate **
Data e ora di creazione di un backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** BackupVaultArn **
Un ARN che identifica in modo univoco l'archivio di backup in cui è archiviato l'indice del punto di ripristino.
Ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: string
Campo obbligatorio: no
** IamRoleArn **
Questo specifica l'ARN del ruolo IAM utilizzato per questa operazione.
Ad esempio, arn:aws:iam: :123456789012:role/s3access
Tipo: string
Campo obbligatorio: no
** IndexCreationDate **
Data e ora di creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** IndexStatus **
Questo è lo stato corrente dell'indice di backup associato al punto di ripristino specificato.
Gli stati sono: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Tipo: stringa
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
Campo obbligatorio: no
** IndexStatusMessage **
Una stringa sotto forma di messaggio dettagliato che spiega lo stato di un indice di backup associato al punto di ripristino.
Tipo: string
Campo obbligatorio: no
** RecoveryPointArn **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`
Tipo: string
Campo obbligatorio: no
** ResourceType **
Il tipo di risorsa del punto di ripristino indicizzato.
+ `EBS` per Amazon Elastic Block Store
+ `S3`per Amazon Simple Storage Service (Amazon S3)
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
** SourceResourceArn **
Una stringa di Amazon Resource Name (ARN) che identifica in modo univoco la risorsa di origine.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/IndexedRecoveryPoint)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/IndexedRecoveryPoint)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/IndexedRecoveryPoint)
# KeyValue
Coppia di due stringhe correlate. I caratteri consentiti sono lettere, spazi e numeri che possono essere rappresentati nel formato UTF-8 e i caratteri seguenti: ` + - = . _ : /`.
## Indice
** Key **
La chiave tag (String). La chiave non può iniziare con `aws:`.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
Tipo: stringa
Campo obbligatorio: sì
** Value **
Il valore della chiave.
Limitazioni di lunghezza: lunghezza massima di 256.
Modello: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
Tipo: stringa
Campo obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/KeyValue)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/KeyValue)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/KeyValue)
# LatestMpaApprovalTeamUpdate
Contiene informazioni sull'ultimo aggiornamento di un'associazione di team di approvazione MPA.
## Indice
** ExpiryDate **
La data e l'ora in cui scadrà l'aggiornamento del team di approvazione MPA.
Tipo: Timestamp
Campo obbligatorio: no
** InitiationDate **
La data e l'ora in cui è stato avviato l'aggiornamento del team di approvazione MPA.
Tipo: Timestamp
Campo obbligatorio: no
** MpaSessionArn **
L'ARN della sessione MPA associata a questo aggiornamento.
Tipo: string
Campo obbligatorio: no
** Status **
Lo stato attuale dell'aggiornamento del team di approvazione MPA.
Tipo: stringa
Valori validi: `PENDING | APPROVED | FAILED`
Campo obbligatorio: no
** StatusMessage **
Un messaggio che descrive lo stato attuale dell'aggiornamento del team di approvazione MPA.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/LatestMpaApprovalTeamUpdate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/LatestMpaApprovalTeamUpdate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/LatestMpaApprovalTeamUpdate)
# LatestRevokeRequest
Contiene informazioni sull'ultima richiesta di revoca dell'accesso a un archivio di backup.
## Indice
** ExpiryDate **
La data e l'ora in cui scadrà la richiesta di revoca.
Tipo: Timestamp
Campo obbligatorio: no
** InitiationDate **
La data e l'ora in cui è stata avviata la richiesta di revoca.
Tipo: Timestamp
Campo obbligatorio: no
** MpaSessionArn **
L'ARN della sessione MPA associata a questa richiesta di revoca.
Tipo: string
Campo obbligatorio: no
** Status **
Lo stato attuale della richiesta di revoca.
Tipo: stringa
Valori validi: `PENDING | FAILED`
Campo obbligatorio: no
** StatusMessage **
Un messaggio che descrive lo stato attuale della richiesta di revoca.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/LatestRevokeRequest)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/LatestRevokeRequest)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/LatestRevokeRequest)
# LegalHold
Un blocco a fini legali è uno strumento amministrativo che impedisce l'eliminazione dei backup mentre sono bloccati. Finché il blocco è in vigore, i backup bloccati non possono essere eliminati e le policy del ciclo di vita che potrebbero alterare lo stato del backup (ad esempio la transizione allo storage a freddo) vengono rimandate finché il blocco a fini legali non viene rimosso. Un backup può essere oggetto di molteplici blocchi a fini legali. I blocchi a fini legali vengono applicati a uno o più backup (noti anche come punti di ripristino). Questi backup possono essere filtrati per tipo di risorsa e per risorsa. IDs
## Indice
** CancellationDate **
L'ora in cui il blocco legale è stato annullato.
Tipo: Timestamp
Campo obbligatorio: no
** CreationDate **
L'ora in cui è stata creata la conservazione legale.
Tipo: Timestamp
Campo obbligatorio: no
** Description **
La descrizione di una custodia legale.
Tipo: string
Campo obbligatorio: no
** LegalHoldArn **
L'Amazon Resource Name (ARN) del deposito legale; ad esempio,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`
Tipo: string
Campo obbligatorio: no
** LegalHoldId **
L'ID del deposito legale.
Tipo: string
Campo obbligatorio: no
** Status **
Lo stato del deposito legale.
Tipo: stringa
Valori validi: `CREATING | ACTIVE | CANCELING | CANCELED`
Campo obbligatorio: no
** Title **
Il titolo del deposito legale.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/LegalHold)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/LegalHold)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/LegalHold)
# Lifecycle
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`
## Indice
** DeleteAfterDays **
Il numero di giorni dopo la creazione in cui un punto di ripristino viene eliminato. Questo valore deve corrispondere ad almeno 90 giorni dal numero di giorni specificato in`MoveToColdStorageAfterDays`.
Tipo: long
Obbligatorio: no
** DeleteAfterEvent **
L'evento dopo il quale viene eliminato un punto di ripristino. Un punto di ripristino con entrambi `DeleteAfterDays` e `DeleteAfterEvent` verrà eliminato dopo la prima condizione soddisfatta. Non valido come input.
Tipo: String
Valori validi: `DELETE_AFTER_COPY`
Campo obbligatorio: no
** MoveToColdStorageAfterDays **
Il numero di giorni dopo la creazione in cui un punto di ripristino viene spostato nella cella frigorifera.
Tipo: long
Obbligatorio: no
** OptInToArchiveForSupportedResources **
Se il valore è vero, il piano di backup trasferisce le risorse supportate al livello di archiviazione (a freddo) in base alle impostazioni del ciclo di vita.
Tipo: Booleano
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/Lifecycle)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/Lifecycle)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/Lifecycle)
# ProtectedResource
Una struttura contenente informazioni su una risorsa di backup.
## Indice
** LastBackupTime **
La data e l'ora di esecuzione dell'ultimo backup di una risorsa, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `LastBackupTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** LastBackupVaultArn **
L'ARN (Amazon Resource Name) dell'archivio di backup che contiene il punto di ripristino di backup più recente.
Tipo: string
Campo obbligatorio: no
** LastRecoveryPointArn **
L'ARN (Amazon Resource Name) del punto di ripristino più recente.
Tipo: string
Campo obbligatorio: no
** ResourceArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: string
Campo obbligatorio: no
** ResourceName **
Il nome non univoco della risorsa che appartiene al backup specificato.
Tipo: string
Campo obbligatorio: no
** ResourceType **
Il tipo di AWS risorsa, ad esempio un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS). Per i backup di Windows Volume Shadow Copy Service (VSS), l'unico tipo di risorsa supportato è Amazon. EC2
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ProtectedResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ProtectedResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ProtectedResource)
# ProtectedResourceConditions
Le condizioni definite per le risorse nel piano di test di ripristino utilizzando i tag.
## Indice
** StringEquals **
Filtra i valori delle risorse con tag solo per le risorse a cui hai aggiunto tag con lo stesso valore. Detta anche “corrispondenza esatta”.
Tipo: matrice di oggetti [KeyValue](API_KeyValue.md)
Campo obbligatorio: no
** StringNotEquals **
Filtra i valori delle risorse con tag solo per le risorse a cui hai aggiunto tag che non hanno lo stesso valore. Detta anche “corrispondenza negata”.
Tipo: matrice di oggetti [KeyValue](API_KeyValue.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ProtectedResourceConditions)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ProtectedResourceConditions)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ProtectedResourceConditions)
# RecoveryPointByBackupVault
Contiene informazioni dettagliate sui punti di ripristino archiviati in un vault di backup.
## Indice
** AggregatedScanResult **
Contiene i risultati di scansione più recenti rispetto al punto di ripristino e attualmente include `FailedScan``Findings`,`LastComputed`.
Tipo: oggetto [AggregatedScanResult](API_AggregatedScanResult.md)
Obbligatorio: no
** BackupSizeInBytes **
La dimensione, in byte, di un backup.
Tipo: long
Obbligatorio: no
** BackupVaultArn **
Un ARN che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
▬Tipo: stringa
Obbligatorio: no
** BackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: no
** CalculatedLifecycle **
Un oggetto `CalculatedLifecycle` contenente i timestamp `DeleteAt` e `MoveToColdStorageAt`.
Tipo: oggetto [CalculatedLifecycle](API_CalculatedLifecycle.md)
Obbligatorio: no
** CompletionDate **
La data e l'ora di completamento del processo di ripristino di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** CompositeMemberIdentifier **
L'identificatore di una risorsa all'interno di un gruppo composito, ad esempio un punto di ripristino annidato (secondario) appartenente a uno stack composito (principale). L'ID viene trasferito dall'[ID logico](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) all'interno di uno stack.
▬Tipo: stringa
Obbligatorio: no
** CreatedBy **
Contiene informazioni identificative sulla creazione di un punto di ripristino, tra cui `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion` e `BackupRuleId` del piano di backup utilizzato per crearlo.
Tipo: oggetto [RecoveryPointCreator](API_RecoveryPointCreator.md)
Obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** EncryptionKeyArn **
La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
▬Tipo: stringa
Obbligatorio: no
** EncryptionKeyType **
Il tipo di chiave di crittografia utilizzata per il punto di ripristino. I valori validi sono CUSTOMER\$1MANAGED\$1KMS\$1KEY per le chiavi gestite dal cliente o \$1OWNED\$1KMS\$1KEY per le chiavi di proprietà. AWS AWS
Tipo: String
Valori validi: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`
Campo obbligatorio: no
** IamRoleArn **
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.
▬Tipo: stringa
Obbligatorio: no
** IndexStatus **
Questo è lo stato corrente dell'indice di backup associato al punto di ripristino specificato.
Gli stati sono: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Tipo: String
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
Campo obbligatorio: no
** IndexStatusMessage **
Una stringa sotto forma di messaggio dettagliato che spiega lo stato di un indice di backup associato al punto di ripristino.
▬Tipo: stringa
Obbligatorio: no
** InitiationDate **
La data e l'ora in cui è stato avviato il processo di backup che ha creato questo punto di ripristino, in formato Unix e Coordinated Universal Time (UTC).
Tipo: Timestamp
Obbligatorio: no
** IsEncrypted **
Un valore booleano che viene restituito come `TRUE` se il punto di ripristino specificato è crittografato o `FALSE` se il punto di ripristino non è crittografato.
Tipo: Booleano
Obbligatorio: no
** IsParent **
Questo è un valore booleano che indica che si tratta di un punto di ripristino (composito) padre.
Tipo: Booleano
Obbligatorio: no
** LastRestoreTime **
La data e l'ora dell'ultimo ripristino di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `LastRestoreTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** Lifecycle **
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.
Tipo: oggetto [Lifecycle](API_Lifecycle.md)
Obbligatorio: no
** ParentRecoveryPointArn **
L'Amazon Resource Name (ARN) del punto di ripristino principale (composito).
▬Tipo: stringa
Obbligatorio: no
** RecoveryPointArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
▬Tipo: stringa
Obbligatorio: no
** ResourceArn **
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
▬Tipo: stringa
Obbligatorio: no
** ResourceName **
Il nome non univoco della risorsa che appartiene al backup specificato.
▬Tipo: stringa
Obbligatorio: no
** ResourceType **
Il tipo di AWS risorsa salvata come punto di ripristino; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS). Per i backup di Windows Volume Shadow Copy Service (VSS), l'unico tipo di risorsa supportato è Amazon. EC2
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** SourceBackupVaultArn **
Il vault di backup da cui è stato originariamente copiato il punto di ripristino. Se il punto di ripristino viene ripristinato nello stesso account, questo valore sarà `null`.
▬Tipo: stringa
Obbligatorio: no
** Status **
Un codice di stato che specifica lo stato del punto di ripristino.
Tipo: String
Valori validi: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING`
Campo obbligatorio: no
** StatusMessage **
Un messaggio che spiega lo stato attuale del punto di ripristino.
▬Tipo: stringa
Obbligatorio: no
** VaultType **
Il tipo di archivio in cui è archiviato il punto di ripristino descritto.
Tipo: String
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointByBackupVault)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointByBackupVault)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointByBackupVault)
# RecoveryPointByResource
Contiene informazioni dettagliate su un punto di ripristino salvato.
## Indice
** AggregatedScanResult **
Contiene i risultati di scansione più recenti rispetto al punto di ripristino e attualmente include `FailedScan``Findings`,`LastComputed`.
Tipo: oggetto [AggregatedScanResult](API_AggregatedScanResult.md)
Obbligatorio: no
** BackupSizeBytes **
La dimensione, in byte, di un backup.
Tipo: long
Obbligatorio: no
** BackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** EncryptionKeyArn **
La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
▬Tipo: stringa
Obbligatorio: no
** EncryptionKeyType **
Il tipo di chiave di crittografia utilizzata per il punto di ripristino. I valori validi sono CUSTOMER\$1MANAGED\$1KMS\$1KEY per le chiavi gestite dal cliente o \$1OWNED\$1KMS\$1KEY per le chiavi di proprietà. AWS AWS
Tipo: String
Valori validi: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY`
Campo obbligatorio: no
** IndexStatus **
Questo è lo stato corrente dell'indice di backup associato al punto di ripristino specificato.
Gli stati sono: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`
Un punto di ripristino con un indice con lo stato di `ACTIVE` può essere incluso in una ricerca.
Tipo: String
Valori validi: `PENDING | ACTIVE | FAILED | DELETING`
Campo obbligatorio: no
** IndexStatusMessage **
Una stringa sotto forma di messaggio dettagliato che spiega lo stato di un indice di backup associato al punto di ripristino.
▬Tipo: stringa
Obbligatorio: no
** IsParent **
Questo è un valore booleano che indica che si tratta di un punto di ripristino (composito) padre.
Tipo: Booleano
Obbligatorio: no
** ParentRecoveryPointArn **
L'Amazon Resource Name (ARN) del punto di ripristino principale (composito).
▬Tipo: stringa
Obbligatorio: no
** RecoveryPointArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
▬Tipo: stringa
Obbligatorio: no
** ResourceName **
Il nome non univoco della risorsa che appartiene al backup specificato.
▬Tipo: stringa
Obbligatorio: no
** Status **
Un codice di stato che specifica lo stato del punto di ripristino.
Tipo: String
Valori validi: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING`
Campo obbligatorio: no
** StatusMessage **
Un messaggio che spiega lo stato attuale del punto di ripristino.
▬Tipo: stringa
Obbligatorio: no
** VaultType **
Il tipo di archivio in cui è archiviato il punto di ripristino descritto.
Tipo: String
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointByResource)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointByResource)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointByResource)
# RecoveryPointCreator
Contiene informazioni sul piano e sulla regola di backup AWS Backup utilizzati per avviare il backup del punto di ripristino.
## Indice
** BackupPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
▬Tipo: stringa
Campo obbligatorio: no
** BackupPlanId **
Identifica in modo univoco un piano di backup.
▬Tipo: stringa
Campo obbligatorio: no
** BackupPlanName **
Il nome del piano di backup che ha creato questo punto di ripristino. Ciò fornisce un contesto leggibile dall'uomo su quale piano di backup era responsabile del processo di backup.
▬Tipo: stringa
Campo obbligatorio: no
** BackupPlanVersion **
IDs Le versioni sono stringhe univoche, generate casualmente, con codifica Unicode e UTF-8 lunghe al massimo 1.024 byte. e non possono essere modificati.
▬Tipo: stringa
Campo obbligatorio: no
** BackupRuleCron **
L'espressione cron che definisce la pianificazione per la regola di backup. Questo mostra la frequenza e la tempistica in cui i backup vengono attivati automaticamente.
▬Tipo: stringa
Campo obbligatorio: no
** BackupRuleId **
Identifica in modo univoco una regola utilizzata per pianificare il backup di una selezione di risorse.
▬Tipo: stringa
Campo obbligatorio: no
** BackupRuleName **
Il nome della regola di backup all'interno del piano di backup che ha creato questo punto di ripristino. Questo aiuta a identificare quale regola specifica ha attivato il job di backup.
▬Tipo: stringa
Campo obbligatorio: no
** BackupRuleTimezone **
Il fuso orario utilizzato per la pianificazione delle regole di backup. Ciò fornisce il contesto in cui è pianificata l'esecuzione dei backup nel fuso orario specificato.
▬Tipo: stringa
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointCreator)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointCreator)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointCreator)
# RecoveryPointMember
Questo è un punto di ripristino (nidificato) figlio di un punto di ripristino (composito) padre. Questi punti di ripristino possono essere dissociati dal punto di ripristino (composito) padre, nel qual caso non saranno più un membro.
## Indice
** BackupVaultName **
Il nome dell'archivio di backup (il contenitore logico in cui sono archiviati i backup).
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`
Campo obbligatorio: no
** RecoveryPointArn **
L'Amazon Resource Name (ARN) del punto di ripristino principale (composito).
Tipo: string
Campo obbligatorio: no
** ResourceArn **
L'Amazon Resource Name (ARN) che identifica in modo univoco una risorsa salvata.
Tipo: string
Campo obbligatorio: no
** ResourceType **
Il tipo di AWS risorsa che viene salvata come punto di ripristino.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointMember)
# RecoveryPointSelection
Questo specifica i criteri per assegnare un set di risorse, come i tipi di risorse o i vault di backup.
## Indice
** DateRange **
Questo è un filtro di risorse che contiene FromDate: DateTime e ToDate: DateTime. Entrambi i valori sono obbligatori. DateTime I valori futuri non sono consentiti.
La data e l'ora sono in formato Unix e ora UTC (Coordinated Universal Time) e hanno una precisione al millisecondo (i millisecondi sono opzionali). Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: oggetto [DateRange](API_DateRange.md)
Campo obbligatorio: no
** ResourceIdentifiers **
Queste sono le risorse incluse nella selezione delle risorse (tra cui il tipo di risorse e vault).
Tipo: matrice di stringhe
Campo obbligatorio: no
** VaultNames **
Questi sono i nomi dei vault in cui sono contenuti i punti di ripristino selezionati.
Tipo: matrice di stringhe
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RecoveryPointSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RecoveryPointSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RecoveryPointSelection)
# ReportDeliveryChannel
Contiene informazioni del piano di report indicante dove consegnare i report, in particolare il nome del bucket Amazon S3, il prefisso della chiave S3 e i formati dei report.
## Indice
** S3BucketName **
Il nome univoco del bucket S3 che riceve i report.
Tipo: stringa
Campo obbligatorio: sì
** Formats **
Il formato dei report: `CSV``JSON`, o entrambi. Se non è specificato, il formato predefinito è `CSV`.
Tipo: matrice di stringhe
Campo obbligatorio: no
** S3KeyPrefix **
Il prefisso con cui AWS Backup Audit Manager invia i report ad Amazon S3. Il prefisso è questa parte del seguente percorso: s3:///your-bucket-name-name. `prefix` Backup/us-west-2/year/month/day/report Se non è specificato, non esiste alcun prefisso.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportDeliveryChannel)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportDeliveryChannel)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportDeliveryChannel)
# ReportDestination
Contiene informazioni del processo di report relative alla destinazione del report.
## Indice
** S3BucketName **
Il nome univoco del bucket Amazon S3 che riceve i report.
Tipo: string
Campo obbligatorio: no
** S3Keys **
La chiave dell'oggetto che identifica in modo univoco i report nel bucket S3.
Tipo: matrice di stringhe
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportDestination)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportDestination)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportDestination)
# ReportJob
Contiene informazioni dettagliate su un processo di report. Un processo di report compila un report basato su un piano di report e lo pubblica su Amazon S3.
## Indice
** CompletionTime **
La data e l'ora di completamento di un processo di report, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** CreationTime **
La data e l'ora di creazione di un processo di report, nel formato orario Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** ReportDestination **
Il nome del bucket S3 e le chiavi S3 per la destinazione in cui il processo di report pubblica il report.
Tipo: oggetto [ReportDestination](API_ReportDestination.md)
Campo obbligatorio: no
** ReportJobId **
L'identificatore per un processo di report. Stringa con codifica UTF-8 Unicode univoca generata casualmente con lunghezza massima di 1.024 byte. Il processo di segnalazione IDs non può essere modificato.
Tipo: string
Campo obbligatorio: no
** ReportPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: string
Campo obbligatorio: no
** ReportTemplate **
Identifica il modello di report per il report. I report vengono creati utilizzando un modello di report. I modelli di report sono:
`RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`
Tipo: string
Campo obbligatorio: no
** Status **
Lo stato di un processo di report. Gli stati sono:
`CREATED | RUNNING | COMPLETED | FAILED`
`COMPLETED` significa che il report è disponibile per la revisione nella destinazione designata. Se lo stato è `FAILED`, esamina `StatusMessage` per il motivo.
Tipo: string
Campo obbligatorio: no
** StatusMessage **
Un messaggio che spiega lo stato del processo di report.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportJob)
# ReportPlan
Contiene informazioni dettagliate su un piano di report.
## Indice
** CreationTime **
La data e l'ora di creazione di un piano di report, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** DeploymentStatus **
Lo stato di implementazione di un piano di report. Gli stati sono:
`CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED`
Tipo: string
Campo obbligatorio: no
** LastAttemptedExecutionTime **
La data e l'ora dell'ultimo tentativo di esecuzione di un processo di report associato a questo piano di report, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `LastAttemptedExecutionTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** LastSuccessfulExecutionTime **
La data e l'ora dell'ultima esecuzione riuscita di un processo di report associato a questo piano di report, in formato Unix e ora UTC (Coordinated Universal Time). Il valore di `LastSuccessfulExecutionTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** ReportDeliveryChannel **
Contiene informazioni su dove e come consegnare i report, in particolare il nome del bucket Amazon S3, il prefisso della chiave S3 e i formati dei report.
Tipo: oggetto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)
Campo obbligatorio: no
** ReportPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
Tipo: string
Campo obbligatorio: no
** ReportPlanDescription **
Descrizione facoltativa del piano di report, per un massimo di 1.024 caratteri.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello: `.*\S.*`
Campo obbligatorio: no
** ReportPlanName **
Il nome univoco del piano di report. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (\$1).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello: `[a-zA-Z][_a-zA-Z0-9]*`
Campo obbligatorio: no
** ReportSetting **
Identifica il modello di report per il report. I report vengono creati utilizzando un modello di report. I modelli di report sono:
`RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`
Se il modello di report è `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, questa risorsa API descrive anche la copertura del report tramite Regioni AWS e i framework.
Tipo: oggetto [ReportSetting](API_ReportSetting.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportPlan)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportPlan)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportPlan)
# ReportSetting
Contiene informazioni dettagliate sull’impostazione di un report.
## Indice
** ReportTemplate **
Identifica il modello di report per il report. I report vengono creati utilizzando un modello di report. I modelli di report sono:
`RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT`
Tipo: stringa
Obbligatorio: sì
** Accounts **
Questi sono gli account da includere nel report.
Usa il valore stringa di `ROOT` per includere tutte le unità organizzative.
Tipo: array di stringhe
Obbligatorio: no
** FrameworkArns **
Gli Amazon Resource Names (ARNs) dei framework coperti da un rapporto.
Tipo: array di stringhe
Obbligatorio: no
** NumberOfFrameworks **
Il numero di framework coperti da un report.
Tipo: Integer
Obbligatorio: no
** OrganizationUnits **
Sono le unità organizzative da includere nel report.
Tipo: array di stringhe
Obbligatorio: no
** Regions **
Sono le regioni da includere nel report.
Usa il carattere jolly come valore di stringa per includere tutte le regioni.
Tipo: array di stringhe
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ReportSetting)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ReportSetting)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ReportSetting)
# ResourceSelection
Contiene metadati sulla selezione delle risorse per le configurazioni di tiering.
È possibile specificare fino a 5 diverse selezioni di risorse per configurazione di tiering. I dati trasferiti al livello più economico rimangono lì fino all'eliminazione (transizione unidirezionale).
## Indice
** Resources **
Un array di stringhe che contiene le risorse associate o contiene ARNs un carattere jolly `*` per specificare tutte le risorse. È possibile specificare fino a 100 risorse specifiche per configurazione a più livelli.
Tipo: array di stringhe
Obbligatorio: sì
** ResourceType **
Il tipo di AWS risorsa, ad esempio `S3` per Amazon S3. Per le configurazioni a più livelli, questo è attualmente limitato a. `S3`
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: sì
** TieringDownSettingsInDays **
Il numero di giorni dopo la creazione all'interno di un archivio di backup in cui un oggetto può passare al livello di storage caldo a basso costo. Deve essere un numero intero positivo compreso tra 60 e 36500 giorni.
Tipo: numero intero
Intervallo valido: valore minimo pari a 60. Valore massimo di 36500.
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ResourceSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ResourceSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ResourceSelection)
# RestoreAccessBackupVaultListMember
Contiene informazioni su un archivio di backup per l'accesso al ripristino.
## Indice
** ApprovalDate **
La data e l'ora in cui è stato approvato il Restore Access Backup Vault.
Tipo: Timestamp
Campo obbligatorio: no
** CreationDate **
La data e l'ora in cui è stato creato il Restore Access Backup Vault.
Tipo: Timestamp
Campo obbligatorio: no
** LatestRevokeRequest **
Informazioni sull'ultima richiesta di revoca dell'accesso a questo archivio di backup.
Tipo: oggetto [LatestRevokeRequest](API_LatestRevokeRequest.md)
Campo obbligatorio: no
** RestoreAccessBackupVaultArn **
L'ARN del deposito di backup per l'accesso al ripristino.
Tipo: string
Campo obbligatorio: no
** VaultState **
Lo stato attuale del Restore Access Backup Vault.
Tipo: stringa
Valori validi: `CREATING | AVAILABLE | FAILED`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreAccessBackupVaultListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreAccessBackupVaultListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreAccessBackupVaultListMember)
# RestoreJobCreator
Contiene informazioni sul piano di test di ripristino utilizzato da AWS Backup per avviare il processo di ripristino.
## Indice
** RestoreTestingPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di test di ripristino.
Tipo: string
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreJobCreator)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreJobCreator)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreJobCreator)
# RestoreJobsListMember
Contiene metadati relativi a un processo di ripristino.
## Indice
** AccountId **
L'ID account proprietario del processo di ripristino.
Tipo: stringa
Modello: `^[0-9]{12}$`
Obbligatorio: no
** BackupSizeInBytes **
La dimensione, in byte, della risorsa ripristinata.
Tipo: long
Obbligatorio: no
** BackupVaultArn **
L'Amazon Resource Name (ARN) del vault di backup contenente il punto di ripristino da ripristinare. Questo aiuta a identificare le politiche e le autorizzazioni di accesso al vault.
▬Tipo: stringa
Obbligatorio: no
** CompletionDate **
La data e l'ora di completamento del processo di ripristino di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** CreatedBy **
Contiene informazioni di identificazione sulla creazione di un processo di ripristino.
Tipo: oggetto [RestoreJobCreator](API_RestoreJobCreator.md)
Obbligatorio: no
** CreatedResourceArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.
▬Tipo: stringa
Obbligatorio: no
** CreationDate **
La data e l'ora di creazione di un processo di ripristino, nel formato orario Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** DeletionStatus **
Registra lo stato dei dati generati dal test di ripristino. Lo stato può essere `Deleting`, `Failed` o `Successful`.
Tipo: String
Valori validi: `DELETING | FAILED | SUCCESSFUL`
Campo obbligatorio: no
** DeletionStatusMessage **
Descrive lo stato di eliminazione del processo di ripristino.
▬Tipo: stringa
Obbligatorio: no
** ExpectedCompletionTimeMinutes **
La quantità di tempo in minuti prevista per l’esecuzione del processo di ripristino di un punto di ripristino.
Tipo: long
Obbligatorio: no
** IamRoleArn **
Il ruolo IAM utilizzato dall'ARN per creare il punto di ripristino di destinazione; ad esempio,. `arn:aws:iam::123456789012:role/S3Access`
▬Tipo: stringa
Obbligatorio: no
** IsParent **
Si tratta di un valore booleano che indica se il processo di ripristino è un processo di ripristino principale (composito).
Tipo: Booleano
Obbligatorio: no
** ParentJobId **
Questo è l'identificatore univoco del processo di ripristino principale per il processo di ripristino selezionato.
▬Tipo: stringa
Obbligatorio: no
** PercentDone **
Contiene una percentuale stimata di completamento di un processo nel momento in cui è stato richiesto lo stato del processo.
▬Tipo: stringa
Obbligatorio: no
** RecoveryPointArn **
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
▬Tipo: stringa
Obbligatorio: no
** RecoveryPointCreationDate **
La data di creazione di un punto di ripristino.
Tipo: Timestamp
Obbligatorio: no
** ResourceType **
Il tipo di risorsa dei processi di ripristino elencati, ad esempio un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS). Per i backup di Windows Volume Shadow Copy Service (VSS), l'unico tipo di risorsa supportato è Amazon. EC2
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** RestoreJobId **
Identifica in modo univoco il processo che ripristina un punto di ripristino.
▬Tipo: stringa
Obbligatorio: no
** SourceResourceArn **
L'Amazon Resource Name (ARN) della risorsa originale di cui è stato eseguito il backup. Ciò fornisce un contesto su quale risorsa viene ripristinata.
▬Tipo: stringa
Obbligatorio: no
** Status **
Un codice di stato che specifica lo stato del processo avviato da AWS Backup per ripristinare un punto di ripristino.
Tipo: String
Valori validi: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED`
Campo obbligatorio: no
** StatusMessage **
Un messaggio dettagliato che spiega lo stato del processo di ripristino di un punto di ripristino.
▬Tipo: stringa
Obbligatorio: no
** ValidationStatus **
Lo stato della convalida viene eseguito sul processo di ripristino indicato.
Tipo: String
Valori validi: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`
Campo obbligatorio: no
** ValidationStatusMessage **
Descrive lo stato della convalida eseguita sul processo di ripristino indicato.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreJobsListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreJobsListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreJobsListMember)
# RestoreJobSummary
È il riepilogo dei processi di ripristino creati o eseguiti negli ultimi 30 giorni.
Il riepilogo restituito può contenere quanto segue: Regione, Account ResourceType, Stato MessageCategory StartTime, EndTime,, e Numero di lavori inclusi.
## Indice
** AccountId **
L'ID dell'account proprietario dei processi del riepilogo.
Tipo: stringa
Modello: `^[0-9]{12}$`
Campo obbligatorio: no
** Count **
Il valore espresso come numero di processi in un riepilogo dei processi.
Tipo: integer
Campo obbligatorio: no
** EndTime **
Il valore in formato numerico dell'ora di fine di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** Region **
Le AWS regioni all'interno del riepilogo delle offerte di lavoro.
▬Tipo: stringa
Campo obbligatorio: no
** ResourceType **
Il valore del numero di processi per il tipo di risorsa specificato. La richiesta `GetSupportedResourceTypes` restituisce le stringhe per i tipi di risorsa supportati.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Campo obbligatorio: no
** StartTime **
Il valore in formato numerico dell'ora di inizio di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** State **
Questo valore indica il numero di processi con lo stato specificato.
▬Tipo: stringa
Valori validi: `CREATED | PENDING | RUNNING | ABORTED | COMPLETED | FAILED | AGGREGATE_ALL | ANY`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreJobSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreJobSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreJobSummary)
# RestoreTestingPlanForCreate
Contiene i metadati su un piano di test di ripristino.
## Indice
** RecoveryPointSelection **
`RecoveryPointSelection`ha cinque parametri (tre obbligatori e due opzionali). I valori specificati determinano quale punto di ripristino è incluso nel test di ripristino. È necessario indicare con `Algorithm` se si desidera utilizzare il punto di ripristino più recente `SelectionWindowDays` o se si desidera un punto di ripristino casuale e indicare attraverso `IncludeVaults` quali archivi è possibile scegliere i punti di ripristino.
`Algorithm`(*obbligatorio*) Valori validi: "`LATEST_WITHIN_WINDOW`" o "`RANDOM_WITHIN_WINDOW`».
`Recovery point types`(*obbligatorio*) Valori validi: "`SNAPSHOT`" e/o "`CONTINUOUS`». Include `SNAPSHOT` per ripristinare solo i punti di ripristino delle istantanee; include `CONTINUOUS` per ripristinare i punti di ripristino continui (point in time restore/PITR); utilizza entrambi per ripristinare un'istantanea o un punto di ripristino continuo. Il punto di ripristino sarà determinato dal valore di. `Algorithm`
`IncludeVaults`(*richiesto*). È necessario includere uno o più archivi di backup. Usa il carattere jolly ["\$1"] o specifico. ARNs
`SelectionWindowDays`(*opzionale*) Il valore deve essere un numero intero (in giorni) compreso tra 1 e 365. Se non è incluso, il valore predefinito è. `30`
`ExcludeVaults`(*opzionale*). È possibile scegliere di inserire uno o più archivi di backup specifici ARNs per escludere i contenuti di tali archivi dall'idoneità al ripristino. In alternativa, è possibile includere un elenco di selettori. Se questo parametro e il relativo valore non sono inclusi, il valore predefinito è un elenco vuoto.
Tipo: oggetto [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md)
Campo obbligatorio: sì
** RestoreTestingPlanName **
RestoreTestingPlanName è una stringa univoca che è il nome del piano di test di ripristino. Non può essere modificato dopo la creazione e deve essere composto solo da caratteri alfanumerici e caratteri di sottolineatura.
Tipo: stringa
Campo obbligatorio: sì
** ScheduleExpression **
Un'espressione CRON nel fuso orario specificato quando viene eseguito un piano di test di ripristino. Quando non viene fornita alcuna espressione CRON, AWS Backup utilizzerà l'espressione `cron(0 5 ? * * *)` predefinita.
Tipo: stringa
Campo obbligatorio: sì
** ScheduleExpressionTimezone **
Facoltativo. Questo è il fuso orario in cui viene impostata l'espressione di pianificazione. Per impostazione predefinita, ScheduleExpressions sono in UTC. Puoi modificarlo impostando un fuso orario specifico.
Tipo: string
Campo obbligatorio: no
** StartWindowHours **
L'impostazione predefinita è 24 ore.
Un valore in ore dopo la pianificazione di un test di ripristino prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo. Se incluso, il parametro ha un valore massimo di 168 ore (una settimana).
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForCreate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForCreate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForCreate)
# RestoreTestingPlanForGet
Contiene i metadati su un piano di test di ripristino.
## Indice
** CreationTime **
La data e l'ora di creazione di un piano di test di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: sì
** RecoveryPointSelection **
I criteri specificati per assegnare un set di risorse, come i tipi di punto di ripristino o i vault di backup.
Tipo: oggetto [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md)
Campo obbligatorio: sì
** RestoreTestingPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di test di ripristino.
Tipo: stringa
Campo obbligatorio: sì
** RestoreTestingPlanName **
Il nome del piano di test di ripristino.
Tipo: stringa
Campo obbligatorio: sì
** ScheduleExpression **
Un'espressione CRON nel fuso orario specificato quando viene eseguito un piano di test di ripristino. Quando non viene fornita alcuna espressione CRON, AWS Backup utilizzerà l'espressione `cron(0 5 ? * * *)` predefinita.
Tipo: stringa
Campo obbligatorio: sì
** CreatorRequestId **
Identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Se la richiesta include un `CreatorRequestId` che corrisponde a un piano di backup esistente, tale piano viene restituito. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
Tipo: string
Campo obbligatorio: no
** LastExecutionTime **
L'ultima volta che è stato eseguito un test di ripristino con il piano di test di ripristino specificato. Una data e ora, in formato UNIX e nell'ora Universal Coordinated Time (UTC). Il valore di `LastExecutionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** LastUpdateTime **
La data e l'ora di aggiornamento del piano di test di ripristino. Questo aggiornamento è in formato Unix e nell'ora Coordinated Universal Time (UTC). Il valore di `LastUpdateTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** ScheduleExpressionTimezone **
Facoltativo. Questo è il fuso orario in cui viene impostata l'espressione di pianificazione. Per impostazione predefinita, ScheduleExpressions sono in UTC. Puoi modificarlo impostando un fuso orario specifico.
Tipo: string
Campo obbligatorio: no
** StartWindowHours **
L'impostazione predefinita è 24 ore.
Un valore in ore dopo la pianificazione di un test di ripristino prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo. Se incluso, il parametro ha un valore massimo di 168 ore (una settimana).
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForGet)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForGet)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForGet)
# RestoreTestingPlanForList
Contiene i metadati su un piano di test di ripristino.
## Indice
** CreationTime **
La data e l'ora di creazione di un piano di test di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: sì
** RestoreTestingPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di test di ripristino.
Tipo: stringa
Campo obbligatorio: sì
** RestoreTestingPlanName **
Il nome del piano di test di ripristino.
Tipo: stringa
Campo obbligatorio: sì
** ScheduleExpression **
Un'espressione CRON nel fuso orario specificato quando viene eseguito un piano di test di ripristino. Quando non viene fornita alcuna espressione CRON, AWS Backup utilizzerà l'espressione `cron(0 5 ? * * *)` predefinita.
Tipo: stringa
Campo obbligatorio: sì
** LastExecutionTime **
L'ultima volta che è stato eseguito un test di ripristino con il piano di test di ripristino specificato. Una data e ora, in formato UNIX e nell'ora Universal Coordinated Time (UTC). Il valore di `LastExecutionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** LastUpdateTime **
La data e l'ora di aggiornamento del piano di test di ripristino. Questo aggiornamento è in formato Unix e nell'ora Coordinated Universal Time (UTC). Il valore di `LastUpdateTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Campo obbligatorio: no
** ScheduleExpressionTimezone **
Facoltativo. Questo è il fuso orario in cui viene impostata l'espressione di pianificazione. Per impostazione predefinita, ScheduleExpressions sono in UTC. Puoi modificarlo impostando un fuso orario specifico.
Tipo: string
Campo obbligatorio: no
** StartWindowHours **
L'impostazione predefinita è 24 ore.
Un valore in ore dopo la pianificazione di un test di ripristino prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo. Se incluso, il parametro ha un valore massimo di 168 ore (una settimana).
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForList)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForList)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForList)
# RestoreTestingPlanForUpdate
Contiene i metadati su un piano di test di ripristino.
## Indice
** RecoveryPointSelection **
Obbligatorio: `Algorithm`; `RecoveryPointTypes`; `IncludeVaults` (*almeno uno*).
Facoltativo: *SelectionWindowDays*(*'30' se non specificato*); `ExcludeVaults` (il valore predefinito è un elenco vuoto se non è elencato).
Tipo: oggetto [RestoreTestingRecoveryPointSelection](API_RestoreTestingRecoveryPointSelection.md)
Campo obbligatorio: no
** ScheduleExpression **
Un'espressione CRON nel fuso orario specificato quando viene eseguito un piano di test di ripristino. Quando non viene fornita alcuna espressione CRON, AWS Backup utilizzerà l'espressione predefinita. `cron(0 5 ? * * *)`
Tipo: string
Campo obbligatorio: no
** ScheduleExpressionTimezone **
Facoltativo. Questo è il fuso orario in cui viene impostata l'espressione di pianificazione. Per impostazione predefinita, ScheduleExpressions sono in UTC. Puoi modificarlo impostando un fuso orario specifico.
Tipo: string
Campo obbligatorio: no
** StartWindowHours **
L'impostazione predefinita è 24 ore.
Un valore in ore dopo la pianificazione di un test di ripristino prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo. Se incluso, il parametro ha un valore massimo di 168 ore (una settimana).
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingPlanForUpdate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingPlanForUpdate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingPlanForUpdate)
# RestoreTestingRecoveryPointSelection
`RecoveryPointSelection`ha cinque parametri (tre obbligatori e due opzionali). I valori specificati determinano quale punto di ripristino è incluso nel test di ripristino. È necessario indicare con `Algorithm` se si desidera utilizzare il punto di ripristino più recente `SelectionWindowDays` o se si desidera un punto di ripristino casuale e indicare attraverso `IncludeVaults` quali archivi è possibile scegliere i punti di ripristino.
`Algorithm`(*obbligatorio*) Valori validi: "`LATEST_WITHIN_WINDOW`" o "`RANDOM_WITHIN_WINDOW`».
`Recovery point types`(*obbligatorio*) Valori validi: "`SNAPSHOT`" e/o "`CONTINUOUS`». Include `SNAPSHOT` per ripristinare solo i punti di ripristino delle istantanee; include `CONTINUOUS` per ripristinare i punti di ripristino continui (point in time restore/PITR); utilizza entrambi per ripristinare un'istantanea o un punto di ripristino continuo. Il punto di ripristino sarà determinato dal valore di. `Algorithm`
`IncludeVaults`(*richiesto*). È necessario includere uno o più archivi di backup. Usa il carattere jolly ["\$1"] o specifico. ARNs
`SelectionWindowDays`(*opzionale*) Il valore deve essere un numero intero (in giorni) compreso tra 1 e 365. Se non è incluso, il valore predefinito è. `30`
`ExcludeVaults`(*opzionale*). È possibile scegliere di inserire uno o più archivi di backup specifici ARNs per escludere i contenuti di tali archivi dall'idoneità al ripristino. In alternativa, è possibile includere un elenco di selettori. Se questo parametro e il relativo valore non sono inclusi, il valore predefinito è un elenco vuoto.
## Indice
** Algorithm **
I valori accettabili sono "LATEST\$1WITHIN\$1WINDOW" o "RANDOM\$1WITHIN\$1WINDOW"
Tipo: stringa
Valori validi: `LATEST_WITHIN_WINDOW | RANDOM_WITHIN_WINDOW`
Campo obbligatorio: no
** ExcludeVaults **
I valori accettati includono selettori specifici ARNs o un elenco di selettori. L'impostazione predefinita è un elenco vuoto se non specificato.
Tipo: matrice di stringhe
Campo obbligatorio: no
** IncludeVaults **
I valori accettati includono wildcard ["\$1"] o by specific ARNs o ARN wilcard replacement ["arn:aws:backup:us-west- 2:123456789012:backup-vault:asdf»,...] ["arn:aws:backup: \$1:\$1:backup-vault:asdf-\$1»,...]
Tipo: matrice di stringhe
Campo obbligatorio: no
** RecoveryPointTypes **
Questi sono i tipi di punto di ripristino.
`SNAPSHOT`Includi per ripristinare solo i punti di ripristino delle istantanee; includi per ripristinare i punti di ripristino continui (point in time restore`CONTINUOUS`/PITR); usa entrambi per ripristinare un'istantanea o un punto di ripristino continuo. Il punto di ripristino sarà determinato dal valore di. `Algorithm`
Tipo: matrice di stringhe
Valori validi: `CONTINUOUS | SNAPSHOT`
Campo obbligatorio: no
** SelectionWindowDays **
I valori accettati sono numeri interi compresi tra 1 e 365.
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingRecoveryPointSelection)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingRecoveryPointSelection)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingRecoveryPointSelection)
# RestoreTestingSelectionForCreate
Contiene metadati relativi a una selezione specifica del test di ripristino.
ProtectedResourceType è obbligatorio, ad esempio Amazon EBS o Amazon EC2.
Consiste in `RestoreTestingSelectionName`, `ProtectedResourceType` e uno dei seguenti parametri:
+ `ProtectedResourceArns`
+ `ProtectedResourceConditions`
Ogni tipo di risorsa protetta può avere un solo valore.
Una selezione di test di ripristino può includere un valore jolly ("\$1") per `ProtectedResourceArns` insieme a `ProtectedResourceConditions`. In alternativa, puoi includere fino a 30 risorse protette specifiche ARNs in`ProtectedResourceArns`.
Esempi di `ProtectedResourceConditions` sono `StringEquals` e `StringNotEquals`.
## Indice
** IamRoleArn **
Il nome della risorsa Amazon (ARN) del ruolo IAM utilizzato da AWS Backup per creare la risorsa di destinazione, ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: stringa
Obbligatorio: sì
** ProtectedResourceType **
Il tipo di AWS risorsa inclusa in una selezione di test di ripristino, ad esempio un volume Amazon EBS o un database Amazon RDS.
I tipi di risorsa supportati e accettati sono:
+ `Aurora` per Amazon Aurora
+ `DocumentDB` per Amazon DocumentDB (compatibile con MongoDB)
+ `DynamoDB` per Amazon DynamoDB
+ `EBS` per Amazon Elastic Block Store
+ `EC2` per Amazon Elastic Compute Cloud
+ `EFS` per Amazon Elastic File System
+ `FSx`per Amazon FSx
+ `Neptune` per Amazon Neptune
+ `RDS` per Amazon Relational Database Service
+ `S3` per Amazon S3
Tipo: stringa
Obbligatorio: sì
** RestoreTestingSelectionName **
Il nome univoco della selezione dei test di ripristino che appartiene al relativo piano di test di ripristino.
Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: stringa
Obbligatorio: sì
** ProtectedResourceArns **
Ogni risorsa protetta può essere filtrata in base alle sue caratteristiche specifiche ARNs, ad esempio `ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]` o con un carattere jolly:`ProtectedResourceArns: ["*"]`, ma non entrambi.
Tipo: array di stringhe
Obbligatorio: no
** ProtectedResourceConditions **
Se hai incluso il carattere jolly in ProtectedResourceArns, puoi includere condizioni relative alla risorsa, ad esempio. `ProtectedResourceConditions: { StringEquals: [{ key: "XXXX", value: "YYYY" }]`
Tipo: oggetto [ProtectedResourceConditions](API_ProtectedResourceConditions.md)
Obbligatorio: no
** RestoreMetadataOverrides **
È possibile sovrascrivere determinate chiavi di ripristino dei metadati includendo il parametro `RestoreMetadataOverrides` nel corpo di `RestoreTestingSelection`. I valori della chiave non fanno distinzione tra maiuscole e minuscole.
Consulta l'elenco completo dei [metadati dedotti del test di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html).
Tipo: mappatura stringa a stringa
Obbligatorio: no
** ValidationWindowHours **
Si tratta del numero di ore (da 0 a 168) disponibili per eseguire uno script di convalida sui dati. I dati vengono eliminati al completamento dello script di convalida o alla fine del periodo di conservazione specificato, a seconda dell'evento che si verifica prima.
Tipo: Integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForCreate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForCreate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForCreate)
# RestoreTestingSelectionForGet
Contiene metadati relativi a una selezione per il test di ripristino.
## Indice
** CreationTime **
La data e l'ora in cui è stata creata la selezione per il test di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 201812:11:30.087.
Tipo: Timestamp
Obbligatorio: sì
** IamRoleArn **
Il nome della risorsa Amazon (ARN) del ruolo IAM utilizzato da AWS Backup per creare la risorsa di destinazione, ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: stringa
Obbligatorio: sì
** ProtectedResourceType **
Il tipo di AWS risorsa inclusa in una selezione di test delle risorse, ad esempio un volume Amazon EBS o un database Amazon RDS.
Tipo: stringa
Obbligatorio: sì
** RestoreTestingPlanName **
RestoreTestingPlanName è una stringa univoca che è il nome del piano di test di ripristino.
Tipo: stringa
Obbligatorio: sì
** RestoreTestingSelectionName **
Il nome univoco della selezione del test di ripristino che appartiene al relativo piano di test di ripristino.
Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: stringa
Obbligatorio: sì
** CreatorRequestId **
Identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Se la richiesta include un `CreatorRequestId` che corrisponde a un piano di backup esistente, tale piano viene restituito. Questo parametro è facoltativo.
Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).
▬Tipo: stringa
Obbligatorio: no
** ProtectedResourceArns **
Puoi includere caratteri specifici ARNs, ad esempio `ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]` oppure puoi includere un carattere jolly:`ProtectedResourceArns: ["*"]`, ma non entrambi.
Tipo: array di stringhe
Obbligatorio: no
** ProtectedResourceConditions **
In una selezione per il test delle risorse, questo parametro filtra in base a condizioni specifiche come `StringEquals` o `StringNotEquals`.
Tipo: oggetto [ProtectedResourceConditions](API_ProtectedResourceConditions.md)
Obbligatorio: no
** RestoreMetadataOverrides **
È possibile sovrascrivere determinate chiavi di ripristino dei metadati includendo il parametro `RestoreMetadataOverrides` nel corpo di `RestoreTestingSelection`. I valori della chiave non fanno distinzione tra maiuscole e minuscole.
Consulta l'elenco completo dei [metadati dedotti del test di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html).
Tipo: mappatura stringa a stringa
Obbligatorio: no
** ValidationWindowHours **
Il numero di ore (da 1 a 168) disponibili per eseguire uno script di convalida sui dati. I dati vengono eliminati al completamento dello script di convalida o alla fine del periodo di conservazione specificato, a seconda dell'evento che si verifica prima.
Tipo: Integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForGet)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForGet)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForGet)
# RestoreTestingSelectionForList
Contiene metadati relativi a una selezione per il test di ripristino.
## Indice
** CreationTime **
La data e l'ora in cui è stata creata la selezione per il test di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
Obbligatorio: sì
** IamRoleArn **
Il nome della risorsa Amazon (ARN) del ruolo IAM utilizzato da AWS Backup per creare la risorsa di destinazione, ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: stringa
Obbligatorio: sì
** ProtectedResourceType **
Il tipo di AWS risorsa inclusa in una selezione di test di ripristino, ad esempio un volume Amazon EBS o un database Amazon RDS.
Tipo: stringa
Obbligatorio: sì
** RestoreTestingPlanName **
Stringa univoca che costituisce il nome del piano di test di ripristino.
Il nome non può essere modificato dopo la creazione. Il nome deve contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: stringa
Obbligatorio: sì
** RestoreTestingSelectionName **
Nome univoco di una selezione per il test di ripristino.
Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 50 caratteri.
Tipo: stringa
Obbligatorio: sì
** ValidationWindowHours **
Questo valore rappresenta il periodo di tempo, in ore, di conservazione dei dati dopo un test di ripristino, in modo da poter completare la convalida facoltativa.
Il valore accettato è un numero intero compreso tra 0 e 168 (l'equivalente in ore di sette giorni).
Tipo: Integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForList)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForList)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForList)
# RestoreTestingSelectionForUpdate
Contiene metadati relativi a una selezione per il test di ripristino.
## Indice
** IamRoleArn **
Il nome della risorsa Amazon (ARN) del ruolo IAM utilizzato da AWS Backup per creare la risorsa di destinazione, ad esempio `arn:aws:iam::123456789012:role/S3Access`.
Tipo: string
Campo obbligatorio: no
** ProtectedResourceArns **
Puoi includere un elenco di caratteri specifici ARNs, ad esempio `ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]` oppure puoi includere un carattere jolly:`ProtectedResourceArns: ["*"]`, ma non entrambi.
Tipo: matrice di stringhe
Campo obbligatorio: no
** ProtectedResourceConditions **
Le condizioni definite per le risorse nel piano di test di ripristino utilizzando i tag.
Tipo: oggetto [ProtectedResourceConditions](API_ProtectedResourceConditions.md)
Campo obbligatorio: no
** RestoreMetadataOverrides **
È possibile sovrascrivere determinate chiavi di ripristino dei metadati includendo il parametro `RestoreMetadataOverrides` nel corpo di `RestoreTestingSelection`. I valori della chiave non fanno distinzione tra maiuscole e minuscole.
Consulta l'elenco completo dei [metadati dedotti del test di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html).
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
** ValidationWindowHours **
Questo valore rappresenta il periodo di tempo, in ore, di conservazione dei dati dopo un test di ripristino, in modo da poter completare la convalida facoltativa.
Il valore accettato è un numero intero compreso tra 0 e 168 (l'equivalente in ore di sette giorni).
Tipo: integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RestoreTestingSelectionForUpdate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RestoreTestingSelectionForUpdate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RestoreTestingSelectionForUpdate)
# ScanAction
Definisce un'azione di scansione che specifica lo scanner antimalware e la modalità di scansione da utilizzare.
## Indice
** MalwareScanner **
Lo scanner antimalware da utilizzare per l'azione di scansione. Attualmento solo `GUARDDUTY` è supportato.
Tipo: String
Valori validi: `GUARDDUTY`
Campo obbligatorio: no
** ScanMode **
La modalità di scansione da utilizzare per l'azione di scansione.
Valori validi: `FULL_SCAN` \$1 `INCREMENTAL_SCAN`.
Tipo: String
Valori validi: `FULL_SCAN | INCREMENTAL_SCAN`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanAction)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanAction)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanAction)
# ScanJob
Contiene metadati su un processo di scansione, incluse informazioni sul processo di scansione, sui risultati e sulle risorse associate.
## Indice
** AccountId **
L'ID dell'account proprietario del processo di scansione.
Tipo: stringa
Obbligatorio: sì
** BackupVaultArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.
Tipo: stringa
Obbligatorio: sì
** BackupVaultName **
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Tipo: stringa
Obbligatorio: sì
** CreatedBy **
Contiene informazioni identificative sulla creazione di un processo di scansione.
Tipo: oggetto [ScanJobCreator](API_ScanJobCreator.md)
Obbligatorio: sì
** CreationDate **
La data e l'ora di creazione di un processo di scansione, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: sì
** IamRoleArn **
Speciifica l'ARN del ruolo IAM utilizzato per creare il processo di scansione; ad esempio,. `arn:aws:iam::123456789012:role/S3Access`
Tipo: stringa
Obbligatorio: sì
** MalwareScanner **
Il motore di scansione utilizzato per il processo di scansione. Attualmento solo `GUARDDUTY` è supportato.
Tipo: String
Valori validi: `GUARDDUTY`
Obbligatorio: sì
** RecoveryPointArn **
Un ARN che identifica in modo univoco il punto di ripristino oggetto della scansione; ad esempio,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`
Tipo: stringa
Obbligatorio: sì
** ResourceArn **
Un ARN che identifica in modo univoco la risorsa di origine del punto di ripristino oggetto della scansione.
Tipo: stringa
Obbligatorio: sì
** ResourceName **
Il nome non univoco della risorsa che appartiene al backup specificato.
Tipo: stringa
Obbligatorio: sì
** ResourceType **
Il tipo di AWS risorsa da scansionare; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).
Tipo: String
Valori validi: `EBS | EC2 | S3`
Obbligatorio: sì
** ScanJobId **
L'identificatore univoco che identifica la richiesta del processo di scansione. AWS Backup
Tipo: stringa
Obbligatorio: sì
** ScanMode **
Speciifica il tipo di scansione utilizzato per il processo di scansione.
Include:
`FULL_SCAN`eseguirà la scansione dell'intera sequenza di dati all'interno del backup.
`INCREMENTAL_SCAN`eseguirà la scansione della differenza di dati tra il punto di ripristino di destinazione e l'ARN del punto di ripristino di base.
Tipo: String
Valori validi: `FULL_SCAN | INCREMENTAL_SCAN`
Obbligatorio: sì
** ScannerRoleArn **
Specifica l'ARN del ruolo IAM dello scanner utilizzato per il processo di scansione.
Tipo: stringa
Obbligatorio: sì
** CompletionDate **
La data e l'ora di completamento di un processo di scansione, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CompletionDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** ScanBaseRecoveryPointArn **
Un ARN che identifica in modo univoco il punto di ripristino di base per la scansione. Questo campo viene compilato quando viene eseguito un processo di scansione incrementale.
▬Tipo: stringa
Obbligatorio: no
** ScanId **
L'ID di scansione generato dallo scanner antimalware per il processo di scansione corrispondente.
▬Tipo: stringa
Obbligatorio: no
** ScanResult **
Contiene le informazioni sui risultati della scansione, incluso lo stato delle minacce rilevate durante la scansione.
Tipo: oggetto [ScanResultInfo](API_ScanResultInfo.md)
Obbligatorio: no
** State **
Lo stato attuale del processo di scansione.
Valori validi: `CREATED` \$1 `RUNNING` \$1 `COMPLETED` \$1 `COMPLETED_WITH_ISSUES` \$1 `FAILED` \$1`CANCELED`.
Tipo: String
Valori validi: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING`
Campo obbligatorio: no
** StatusMessage **
Un messaggio dettagliato che spiega lo stato del processo di scansione.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanJob)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanJob)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanJob)
# ScanJobCreator
Contiene informazioni identificative sulla creazione di un processo di scansione, incluso il piano di backup e la regola che ha avviato la scansione.
## Indice
** BackupPlanArn **
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`.
Tipo: stringa
Obbligatorio: sì
** BackupPlanId **
L'ID del piano di backup.
Tipo: stringa
Obbligatorio: sì
** BackupPlanVersion **
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. La versione IDs non può essere modificata.
Tipo: stringa
Obbligatorio: sì
** BackupRuleId **
Identifica in modo univoco la regola di backup che ha avviato il processo di scansione.
Tipo: stringa
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanJobCreator)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanJobCreator)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanJobCreator)
# ScanJobSummary
Contiene informazioni di riepilogo sui lavori di scansione, inclusi conteggi e metadati per un periodo di tempo e criteri specifici.
## Indice
** AccountId **
L'ID dell'account proprietario dei lavori di scansione inclusi in questo riepilogo.
Tipo: stringa
Modello: `^[0-9]{12}$`
Obbligatorio: no
** Count **
Il numero di lavori di scansione che corrispondono ai criteri specificati.
Tipo: Integer
Obbligatorio: no
** EndTime **
Il valore in formato numerico dell'ora di fine di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** MalwareScanner **
Speciifica lo scanner antimalware utilizzato durante il processo di scansione. Attualmente supporta `GUARDDUTY` solo.
Tipo: String
Valori validi: `GUARDDUTY`
Campo obbligatorio: no
** Region **
La AWS regione in cui sono stati eseguiti i processi di scansione.
▬Tipo: stringa
Obbligatorio: no
** ResourceType **
Il tipo di AWS risorsa per i lavori di scansione inclusi in questo riepilogo.
Tipo: stringa
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** ScanResultStatus **
Lo stato dei risultati della scansione per i lavori di scansione inclusi in questo riepilogo.
Valori validi: `THREATS_FOUND` \$1 `NO_THREATS_FOUND`.
Tipo: String
Valori validi: `NO_THREATS_FOUND | THREATS_FOUND`
Campo obbligatorio: no
** StartTime **
Il valore in formato numerico dell'ora di inizio di un processo.
Questo valore indica l'ora in formato Unix, Coordinated Universal Time (UTC) con precisione al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** State **
Lo stato dei lavori di scansione inclusi in questo riepilogo.
Valori validi: `CREATED` \$1 `RUNNING` \$1 `COMPLETED` \$1 `COMPLETED_WITH_ISSUES` \$1 `FAILED` \$1`CANCELED`.
Tipo: String
Valori validi: `CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanJobSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanJobSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanJobSummary)
# ScanResult
Contiene i risultati di una scansione di sicurezza, incluse le informazioni sullo scanner, lo stato della scansione e tutti i risultati rilevati.
## Indice
** Findings **
Una serie di risultati scoperti durante la scansione.
Tipo: array di stringhe
Valori validi: `MALWARE`
Campo obbligatorio: no
** LastScanTimestamp **
Il timestamp di quando è stata eseguita l'ultima scansione, in formato Unix e Coordinated Universal Time (UTC).
Tipo: Timestamp
Obbligatorio: no
** MalwareScanner **
Lo scanner di malware utilizzato per eseguire la scansione. Attualmento solo `GUARDDUTY` è supportato.
Tipo: String
Valori validi: `GUARDDUTY`
Campo obbligatorio: no
** ScanJobState **
Lo stato finale del processo di scansione.
Valori validi: `COMPLETED` \$1 `FAILED` \$1 `CANCELED`.
Tipo: String
Valori validi: `COMPLETED | COMPLETED_WITH_ISSUES | FAILED | CANCELED`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanResult)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanResult)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanResult)
# ScanResultInfo
Contiene informazioni sui risultati di un processo di scansione.
## Indice
** ScanResultStatus **
Lo stato dei risultati della scansione.
Valori validi: `THREATS_FOUND` \$1 `NO_THREATS_FOUND`.
Tipo: String
Valori validi: `NO_THREATS_FOUND | THREATS_FOUND`
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanResultInfo)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanResultInfo)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanResultInfo)
# ScanSetting
Contiene le impostazioni di configurazione per la scansione antimalware, tra cui il tipo di scanner, i tipi di risorse di destinazione e il ruolo dello scanner.
## Indice
** MalwareScanner **
Lo scanner antimalware da utilizzare per la scansione. Attualmento solo `GUARDDUTY` è supportato.
Tipo: String
Valori validi: `GUARDDUTY`
Campo obbligatorio: no
** ResourceTypes **
Una serie di tipi di risorse da scansionare alla ricerca di malware.
Tipo: array di stringhe
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`
Obbligatorio: no
** ScannerRoleArn **
L'Amazon Resource Name (ARN) del ruolo IAM utilizzato dallo scanner per accedere alle risorse, ad esempio. `arn:aws:iam::123456789012:role/ScannerRole`
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScanSetting)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScanSetting)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScanSetting)
# ScheduledPlanExecutionMember
Contiene informazioni sull'esecuzione di un piano di backup pianificato, inclusi il tempo di esecuzione, il tipo di regola e l'identificatore della regola associato.
## Indice
** ExecutionTime **
Il timestamp di pianificazione dell'esecuzione del backup, in formato Unix e Coordinated Universal Time (UTC). Il valore è preciso in millisecondi.
Tipo: Timestamp
Campo obbligatorio: no
** RuleExecutionType **
Il tipo di esecuzione delle regole di backup. I valori validi sono `CONTINUOUS` (point-in-time ripristino), `SNAPSHOTS` (backup istantanei) o `CONTINUOUS_AND_SNAPSHOTS` (entrambi i tipi combinati).
▬Tipo: stringa
Valori validi: `CONTINUOUS | SNAPSHOTS | CONTINUOUS_AND_SNAPSHOTS`
Campo obbligatorio: no
** RuleId **
L'identificatore univoco della regola di backup che verrà eseguita all'ora pianificata.
▬Tipo: stringa
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ScheduledPlanExecutionMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ScheduledPlanExecutionMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ScheduledPlanExecutionMember)
# TieringConfiguration
Contiene metadati relativi a una configurazione a più livelli.
## Indice
** BackupVaultName **
Il nome dell'archivio di backup a cui si applica la configurazione a più livelli. `*`Da utilizzare per applicare a tutti gli archivi di backup.
Tipo: stringa
Modello: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`
Obbligatorio: sì
** ResourceSelection **
Una serie di oggetti di selezione delle risorse che specificano quali risorse sono incluse nella configurazione di livelli e le relative impostazioni.
Tipo: matrice di oggetti [ResourceSelection](API_ResourceSelection.md)
Obbligatorio: sì
** TieringConfigurationName **
Il nome univoco della configurazione a più livelli. Non può essere modificato dopo la creazione e deve essere composto solo da caratteri alfanumerici e caratteri di sottolineatura.
Tipo: stringa
Modello: `^[a-zA-Z0-9_]{1,200}$`
Obbligatorio: sì
** CreationTime **
Data e ora di creazione di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** CreatorRequestId **
Si tratta di una stringa univoca che identifica la richiesta e consente di ritentare le richieste non riuscite senza il rischio di eseguire l'operazione due volte.
▬Tipo: stringa
Obbligatorio: no
** LastUpdatedTime **
Data e ora di aggiornamento di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `LastUpdatedTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** TieringConfigurationArn **
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfiguration)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfiguration)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfiguration)
# TieringConfigurationInputForCreate
Contiene metadati su una configurazione a più livelli per le operazioni di creazione.
## Indice
** BackupVaultName **
Il nome dell'archivio di backup a cui si applica la configurazione a più livelli. `*`Da utilizzare per applicare a tutti gli archivi di backup.
Tipo: stringa
Modello: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`
Obbligatorio: sì
** ResourceSelection **
Una serie di oggetti di selezione delle risorse che specificano quali risorse sono incluse nella configurazione di livelli e le relative impostazioni.
Tipo: matrice di oggetti [ResourceSelection](API_ResourceSelection.md)
Obbligatorio: sì
** TieringConfigurationName **
Il nome univoco della configurazione a più livelli. Non può essere modificato dopo la creazione e deve essere composto solo da caratteri alfanumerici e caratteri di sottolineatura.
Tipo: stringa
Modello: `^[a-zA-Z0-9_]{1,200}$`
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfigurationInputForCreate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfigurationInputForCreate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfigurationInputForCreate)
# TieringConfigurationInputForUpdate
Contiene metadati su una configurazione a più livelli per le operazioni di aggiornamento.
## Indice
** BackupVaultName **
Il nome dell'archivio di backup a cui si applica la configurazione a più livelli. `*`Da utilizzare per applicare a tutti gli archivi di backup.
Tipo: stringa
Modello: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`
Obbligatorio: sì
** ResourceSelection **
Una serie di oggetti di selezione delle risorse che specificano quali risorse sono incluse nella configurazione di livelli e le relative impostazioni.
Tipo: matrice di oggetti [ResourceSelection](API_ResourceSelection.md)
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfigurationInputForUpdate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfigurationInputForUpdate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfigurationInputForUpdate)
# TieringConfigurationsListMember
Contiene i metadati relativi a una configurazione a più livelli restituita in un elenco.
## Indice
** BackupVaultName **
Il nome dell'archivio di backup a cui si applica la configurazione a più livelli. `*`Da utilizzare per applicare a tutti gli archivi di backup.
Tipo: stringa
Modello: `^(\*|[a-zA-Z0-9\-\_]{2,50})$`
Obbligatorio: no
** CreationTime **
Data e ora di creazione di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** LastUpdatedTime **
Data e ora di aggiornamento di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `LastUpdatedTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.
Tipo: Timestamp
Obbligatorio: no
** TieringConfigurationArn **
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering.
▬Tipo: stringa
Obbligatorio: no
** TieringConfigurationName **
Il nome univoco della configurazione di tiering.
Tipo: stringa
Modello: `^[a-zA-Z0-9_]{1,200}$`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TieringConfigurationsListMember)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TieringConfigurationsListMember)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TieringConfigurationsListMember)
# AWS Backup gateway
I seguenti tipi di dati sono supportati da 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)
# BandwidthRateLimitInterval
Descrive un intervallo del limite di velocità della larghezza di banda per un gateway. Una pianificazione del limite di velocità della larghezza di banda è costituita da uno o più intervalli del limite di velocità della larghezza di banda. Un intervallo limite di velocità di larghezza di banda definisce un periodo di tempo in uno o più giorni della settimana, durante il quale vengono specificati limiti di velocità di larghezza di banda per il caricamento.
## Indice
** DaysOfWeek **
Il componente giorni della settimana dell'intervallo del limite di velocità della larghezza di banda, rappresentato da numeri ordinali da 0 a 6, dove 0 rappresenta la domenica e 6 il sabato.
Tipo: matrice di numeri interi
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 7 elementi.
Intervallo valido: valore minimo di 0. Valore massimo di 6.
Obbligatorio: sì
** EndHourOfDay **
L'ora del giorno in cui termina l'intervallo del limite di velocità della larghezza di banda.
Tipo: numero intero
Intervallo valido: valore minimo di 0. valore massimo pari a 23.
Obbligatorio: sì
** EndMinuteOfHour **
Il minuto dell'ora in cui termina l'intervallo del limite di velocità della larghezza di banda.
L'intervallo del limite di velocità della larghezza di banda termina alla fine del minuto. Per terminare un intervallo alla fine di un'ora, utilizza il valore `59`.
Tipo: numero intero
Intervallo valido: valore minimo di 0. Valore massimo di 59.
Obbligatorio: sì
** StartHourOfDay **
L'ora del giorno in cui inizia l'intervallo del limite di velocità della larghezza di banda.
Tipo: numero intero
Intervallo valido: valore minimo di 0. valore massimo pari a 23.
Obbligatorio: sì
** StartMinuteOfHour **
Il minuto dell'ora in cui inizia l'intervallo del limite di velocità della larghezza di banda. L'intervallo inizia all'inizio di tale minuto. Per iniziare un intervallo esattamente all'inizio dell'ora, utilizza il valore `0`.
Tipo: numero intero
Intervallo valido: valore minimo di 0. Valore massimo di 59.
Obbligatorio: sì
** AverageUploadRateLimitInBitsPerSec **
Il componente limite di velocità di caricamento media dell'intervallo del limite di velocità della larghezza di banda, in bit al secondo. Questo campo non viene visualizzato nella risposta se il limite di velocità di caricamento non è impostato.
Tipo: long
Intervallo valido: valore minimo di 51200. Valore massimo di 8000000000000.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/BandwidthRateLimitInterval)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/BandwidthRateLimitInterval)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/BandwidthRateLimitInterval)
# Gateway
Un gateway è un'appliance AWS Backup Gateway che funziona sulla rete del cliente per fornire una connettività perfetta allo storage di backup nel AWS cloud.
## Indice
** GatewayArn **
Il nome della risorsa Amazon (ARN) del gateway. Utilizza l'`ListGateways`operazione per restituire un elenco di gateway per il tuo account e. Regione AWS
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Campo obbligatorio: no
** GatewayDisplayName **
Il nome visualizzato del gateway.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** GatewayType **
Il tipo del gateway.
Tipo: stringa
Valori validi: `BACKUP_VM`
Campo obbligatorio: no
** HypervisorId **
L'ID hypervisor del gateway.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Campo obbligatorio: no
** LastSeenTime **
L'ultima volta che il AWS Backup gateway ha comunicato con il gateway, in formato Unix e ora UTC.
Tipo: Timestamp
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/Gateway)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/Gateway)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/Gateway)
# GatewayDetails
I dettagli del gateway.
## Indice
** DeprecationDate **
Data dopo la quale questo gateway non riceverà gli aggiornamenti software per nuove funzionalità e correzioni di bug.
Tipo: Timestamp
Obbligatorio: no
** GatewayArn **
Il nome della risorsa Amazon (ARN) del gateway. Utilizza l'operazione `ListGateways` per restituire un elenco di gateway per l'account e la Regione AWS.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 50. Lunghezza massima di 180.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Obbligatorio: no
** GatewayDisplayName **
Il nome visualizzato del gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Obbligatorio: no
** GatewayType **
Il tipo del tipo di gateway.
Tipo: String
Valori validi: `BACKUP_VM`
Campo obbligatorio: no
** HypervisorId **
L'ID hypervisor del gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Obbligatorio: no
** LastSeenTime **
Dettagli che mostrano l'ultima volta che il AWS Backup gateway ha comunicato con il cloud, in formato Unix e ora UTC.
Tipo: Timestamp
Obbligatorio: no
** MaintenanceStartTime **
Restituisce l'ora di inizio della manutenzione settimanale del gateway, incluso il giorno della settimana. Nota che i valori sono espressi in termini del fuso orario del gateway. Può essere settimanale o mensile.
Tipo: oggetto [MaintenanceStartTime](API_BGW_MaintenanceStartTime.md)
Obbligatorio: no
** NextUpdateAvailabilityTime **
Dettagli che mostrano l'ora di disponibilità del gateway per il prossimo aggiornamento.
Tipo: Timestamp
Obbligatorio: no
** SoftwareVersion **
Il numero di versione del software in esecuzione sull'appliance gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Obbligatorio: no
** VpcEndpoint **
Il nome DNS dell'endpoint del cloud privato virtuale (VPC) utilizzato dal gateway per connettersi al cloud per il backup gateway.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GatewayDetails)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GatewayDetails)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GatewayDetails)
# Hypervisor
Rappresenta le autorizzazioni dell'hypervisor a cui si connetterà il gateway.
Un hypervisor è un hardware, software o firmware che crea e gestisce macchine virtuali e alloca risorse alle stesse.
## Indice
** Host **
L'host del server dell'hypervisor. Può essere un indirizzo IP o un nome dominio completo (FQDN).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 128 caratteri.
Modello: `.+`
Campo obbligatorio: no
** HypervisorArn **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Campo obbligatorio: no
** KmsKeyArn **
L'Amazon Resource Name (ARN) AWS Key Management Service utilizzato per crittografare l'hypervisor.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`
Campo obbligatorio: no
** Name **
Il nome dell'hypervisor.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** State **
Lo stato dell'hypervisor.
Tipo: stringa
Valori validi: `PENDING | ONLINE | OFFLINE | ERROR`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/Hypervisor)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/Hypervisor)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/Hypervisor)
# HypervisorDetails
Questi sono i dettagli dell'hypervisor specificato. Un hypervisor è un hardware, software o firmware che crea e gestisce macchine virtuali e alloca risorse alle stesse.
## Indice
** Host **
L'host del server dell'hypervisor. Può essere un indirizzo IP o un nome dominio completo (FQDN).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 128 caratteri.
Modello: `.+`
Campo obbligatorio: no
** HypervisorArn **
Il nome della risorsa Amazon (ARN) dell'hypervisor.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Campo obbligatorio: no
** KmsKeyArn **
Il nome della risorsa Amazon (ARN) della AWS KMS utilizzata per crittografare l'hypervisor.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`
Campo obbligatorio: no
** LastSuccessfulMetadataSyncTime **
Questa è l'ora dell'ultima sincronizzazione riuscita dei metadati.
Tipo: Timestamp
Campo obbligatorio: no
** LatestMetadataSyncStatus **
Questo è lo stato più recente per la sincronizzazione dei metadati indicata.
Tipo: stringa
Valori validi: `CREATED | RUNNING | FAILED | PARTIALLY_FAILED | SUCCEEDED`
Campo obbligatorio: no
** LatestMetadataSyncStatusMessage **
Questo è lo stato più recente per la sincronizzazione dei metadati indicata.
Tipo: string
Campo obbligatorio: no
** LogGroupArn **
Il nome della risorsa Amazon (ARN) del gruppo di gateway all'interno del log richiesto.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 2048 caratteri.
Modello: `$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*`
Campo obbligatorio: no
** Name **
Questo è il nome dell'hypervisor specificato.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** State **
Questo è lo stato corrente dell'hypervisor specificato.
Gli stati possibili sono `PENDING`, `ONLINE`, `OFFLINE` o `ERROR`.
Tipo: stringa
Valori validi: `PENDING | ONLINE | OFFLINE | ERROR`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/HypervisorDetails)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/HypervisorDetails)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/HypervisorDetails)
# MaintenanceStartTime
Questa è l'ora di inizio della manutenzione settimanale del gateway, incluso il giorno e l'ora della settimana. Nota che i valori sono espressi in termini del fuso orario del gateway. Può essere settimanale o mensile.
## Indice
** HourOfDay **
La componente oraria dell'ora di inizio della manutenzione è rappresentata come *hh*, in cui *hh* è l'ora (da 0 a 23). L'ora del giorno è espressa nel fuso orario del gateway.
Tipo: integer
Intervallo valido: valore minimo di 0. valore massimo pari a 23.
Campo obbligatorio: sì
** MinuteOfHour **
La componente in minuti dell'ora di inizio della manutenzione è rappresentata come *mm*, in cui *mm* è il minuto (da 0 a 59). Il minuto dell'ora è espresso nel fuso orario del gateway.
Tipo: integer
Intervallo valido: valore minimo di 0. Valore massimo di 59.
Campo obbligatorio: sì
** DayOfMonth **
Il componente giorno del mese dell'ora di inizio della manutenzione rappresentato come un numero ordinale compreso tra 1 e 28, dove 1 rappresenta il primo giorno del mese e 28 rappresenta l'ultimo giorno del mese.
Tipo: integer
Intervallo valido: valore minimo di 1. Valore massimo di 31.
Campo obbligatorio: no
** DayOfWeek **
Un numero ordinale compreso tra 0 e 6 che rappresenta il giorno della settimana, dove 0 rappresenta la domenica e 6 rappresenta il sabato. Il giorno della settimana è espresso nel fuso orario del gateway.
Tipo: integer
Intervallo valido: valore minimo di 0. Valore massimo di 6.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/MaintenanceStartTime)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/MaintenanceStartTime)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/MaintenanceStartTime)
# Tag
Una coppia chiave-valore che puoi utilizzare per gestire, filtrare e cercare le risorse. I caratteri consentiti includono lettere UTF-8, numeri e i seguenti caratteri: \$1 - =. \$1: /. Gli spazi non sono consentiti nei valori dei tag.
## Indice
** Key **
La parte chiave della coppia chiave-valore di un tag. La chiave non può iniziare con `aws:`.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`
Campo obbligatorio: sì
** Value **
La parte valore della coppia chiave-valore di un tag.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello: `[^\x00]*`
Campo obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/Tag)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/Tag)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/Tag)
# VirtualMachine
Una macchina virtuale che si trova su un hypervisor.
## Indice
** HostName **
Il nome host della macchina virtuale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** HypervisorId **
L'ID dell'hypervisor della macchina virtuale.
Tipo: string
Campo obbligatorio: no
** LastBackupDate **
La data più recente in cui è stato eseguito il backup di una macchina virtuale, in formato Unix e nell'ora UTC.
Tipo: Timestamp
Campo obbligatorio: no
** Name **
Il nome della macchina virtuale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** Path **
Il percorso della macchina virtuale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 4096.
Modello: `[^\x00]+`
Campo obbligatorio: no
** ResourceArn **
Il nome della risorsa Amazon (ARN) della macchina virtuale. Ad esempio, `arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL`.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VirtualMachine)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VirtualMachine)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VirtualMachine)
# VirtualMachineDetails
I tuoi `VirtualMachine` oggetti, ordinati in base ai loro Amazon Resource Names (ARNs).
## Indice
** HostName **
Il nome host della macchina virtuale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** HypervisorId **
L'ID dell'hypervisor della macchina virtuale.
Tipo: string
Campo obbligatorio: no
** LastBackupDate **
La data più recente in cui è stato eseguito il backup di una macchina virtuale, in formato Unix e nell'ora UTC.
Tipo: Timestamp
Campo obbligatorio: no
** Name **
Il nome della macchina virtuale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.
Modello: `[a-zA-Z0-9-]*`
Campo obbligatorio: no
** Path **
Il percorso della macchina virtuale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 4096.
Modello: `[^\x00]+`
Campo obbligatorio: no
** ResourceArn **
Il nome della risorsa Amazon (ARN) della macchina virtuale. Ad esempio, `arn:aws:backup-gateway:us-west-1:0000000000000:vm/vm-0000ABCDEFGIJKL`.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 50. La lunghezza massima è 500 caratteri.
Modello: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`
Campo obbligatorio: no
** VmwareTags **
Questi sono i dettagli dei VMware tag associati alla macchina virtuale specificata.
Tipo: matrice di oggetti [VmwareTag](API_BGW_VmwareTag.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VirtualMachineDetails)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VirtualMachineDetails)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VirtualMachineDetails)
# VmwareTag
Un VMware tag è un tag associato a una macchina virtuale specifica. Un [tag](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_Tag.html) è una coppia chiave-valore che puoi utilizzare per gestire, filtrare e cercare le risorse.
Il contenuto dei VMware tag può essere abbinato ai AWS tag.
## Indice
** VmwareCategory **
Questa è la categoria di. VMware
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 80.
Campo obbligatorio: no
** VmwareTagDescription **
Questa è una descrizione di un VMware tag definita dall'utente.
Tipo: string
Campo obbligatorio: no
** VmwareTagName **
Questo è il nome di un VMware tag definito dall'utente.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 80.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VmwareTag)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VmwareTag)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VmwareTag)
# VmwareToAwsTagMapping
Questo mostra la mappatura dei VMware tag ai AWS tag corrispondenti.
## Indice
** AwsTagKey **
La parte fondamentale della coppia chiave-valore del AWS tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`
Obbligatorio: sì
** AwsTagValue **
La parte relativa al valore della coppia chiave-valore del AWS tag.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello: `[^\x00]*`
Obbligatorio: sì
** VmwareCategory **
È la categoria di. VMware
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 80.
Obbligatorio: sì
** VmwareTagName **
Questo è il nome di un VMware tag definito dall'utente.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 80.
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/VmwareToAwsTagMapping)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/VmwareToAwsTagMapping)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/VmwareToAwsTagMapping)
# Ricerca AWS Backup
I seguenti tipi di dati sono supportati da Ricerca 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
Questo filtra in base ai punti di ripristino all'interno dei CreatedBefore timestamp CreatedAfter e.
## Indice
** CreatedAfter **
Questo timestamp include i punti di ripristino creati solo dopo il tempo specificato.
Tipo: Timestamp
Obbligatorio: no
** CreatedBefore **
Questo timestamp include i punti di ripristino creati solo prima dell'ora specificata.
Tipo: Timestamp
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/BackupCreationTimeFilter)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/BackupCreationTimeFilter)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/BackupCreationTimeFilter)
# CurrentSearchProgress
Contiene informazioni sui risultati recuperati da un lavoro di ricerca che potrebbe non essere stato completato.
## Indice
** ItemsMatchedCount **
Questo numero è la somma di tutti gli elementi che corrispondono ai filtri degli elementi in un processo di ricerca in corso.
Tipo: long
Obbligatorio: no
** ItemsScannedCount **
Questo numero è la somma di tutti gli articoli che sono stati scansionati finora durante un processo di ricerca.
Tipo: long
Obbligatorio: no
** RecoveryPointsScannedCount **
Questo numero è la somma di tutti i backup che sono stati scansionati finora durante un processo di ricerca.
Tipo: Integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/CurrentSearchProgress)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/CurrentSearchProgress)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/CurrentSearchProgress)
# EBSItemFilter
Contiene matrici di oggetti, che possono includere oggetti con condizioni CreationTimes temporali, oggetti FilePaths stringhe, oggetti con condizioni LastModificationTimes temporali,
## Indice
** CreationTimes **
È possibile includere da 1 a 10 valori.
Se ne viene incluso uno, i risultati restituiranno solo gli elementi corrispondenti.
Se ne sono inclusi più di uno, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori inclusi.
Tipo: matrice di oggetti [TimeCondition](API_BKS_TimeCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** FilePaths **
È possibile includere da 1 a 10 valori.
Se è incluso un percorso di file, i risultati restituiranno solo gli elementi che corrispondono al percorso del file.
Se è incluso più di un percorso di file, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei percorsi di file.
Tipo: matrice di oggetti [StringCondition](API_BKS_StringCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** LastModificationTimes **
È possibile includere da 1 a 10 valori.
Se ne viene incluso uno, i risultati restituiranno solo gli elementi corrispondenti.
Se ne sono inclusi più di uno, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori inclusi.
Tipo: matrice di oggetti [TimeCondition](API_BKS_TimeCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** Sizes **
È possibile includere da 1 a 10 valori.
Se ne viene incluso uno, i risultati restituiranno solo gli elementi corrispondenti.
Se ne sono inclusi più di uno, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori inclusi.
Tipo: matrice di oggetti [LongCondition](API_BKS_LongCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/EBSItemFilter)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/EBSItemFilter)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/EBSItemFilter)
# EBSResultItem
Questi sono gli articoli restituiti nei risultati di una ricerca nei metadati di backup di Amazon EBS.
## Indice
** BackupResourceArn **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori dell'Amazon Resource Name (ARN) dei punti di ripristino restituiti in una ricerca nei metadati di backup di Amazon EBS.
▬Tipo: stringa
Obbligatorio: no
** BackupVaultName **
Il nome del vault di backup.
▬Tipo: stringa
Obbligatorio: no
** CreationTime **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori per i tempi di creazione restituiti in una ricerca nei metadati di backup di Amazon EBS.
Tipo: Timestamp
Obbligatorio: no
** FilePath **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori dei percorsi di file restituiti in una ricerca nei metadati di backup di Amazon EBS.
▬Tipo: stringa
Obbligatorio: no
** FileSize **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori delle dimensioni dei file restituiti in una ricerca nei metadati di backup di Amazon EBS.
Tipo: long
Obbligatorio: no
** FileSystemIdentifier **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori dei file system restituiti in una ricerca nei metadati di backup di Amazon EBS.
▬Tipo: stringa
Obbligatorio: no
** LastModifiedTime **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori di Last Modified Time restituiti in una ricerca nei metadati di backup di Amazon EBS.
Tipo: Timestamp
Obbligatorio: no
** SourceResourceArn **
Si tratta di uno o più elementi nei risultati che corrispondono ai valori per l'Amazon Resource Name (ARN) delle risorse di origine restituite in una ricerca nei metadati di backup di Amazon EBS.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/EBSResultItem)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/EBSResultItem)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/EBSResultItem)
# ExportJobSummary
Questo è il riepilogo di un processo di esportazione.
## Indice
** ExportJobIdentifier **
Questa è la stringa univoca che identifica un processo di esportazione specifico.
Tipo: stringa
Obbligatorio: sì
** CompletionTime **
Questo è un timestamp dell'ora in cui il processo di esportazione è stato completato.
Tipo: Timestamp
Obbligatorio: no
** CreationTime **
Questo è un timestamp dell'ora in cui è stato creato il processo di esportazione.
Tipo: Timestamp
Obbligatorio: no
** ExportJobArn **
Si tratta dell'ARN (Amazon Resource Name) univoco che appartiene al nuovo processo di esportazione.
▬Tipo: stringa
Obbligatorio: no
** SearchJobArn **
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
▬Tipo: stringa
Obbligatorio: no
** Status **
Lo stato del processo di esportazione è uno dei seguenti:
`CREATED`; `RUNNING``FAILED`; oppure`COMPLETED`.
Tipo: String
Valori validi: `RUNNING | FAILED | COMPLETED`
Campo obbligatorio: no
** StatusMessage **
Un messaggio di stato è una stringa restituita per un processo di esportazione.
È incluso un messaggio di stato per qualsiasi stato diverso da quello `COMPLETED` senza problemi.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ExportJobSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ExportJobSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ExportJobSummary)
# ExportSpecification
Contiene l'oggetto della specifica di esportazione.
## Indice
**Importante**
Questo tipo di dati è UNION, quindi è possibile specificare solo uno dei seguenti membri quando viene utilizzato o restituito.
** s3ExportSpecification **
Questo specifica il bucket Amazon S3 di destinazione per il processo di esportazione. Inoltre, se incluso, specifica anche il prefisso di destinazione.
Tipo: oggetto [S3ExportSpecification](API_BKS_S3ExportSpecification.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ExportSpecification)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ExportSpecification)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ExportSpecification)
# ItemFilters
I filtri degli elementi rappresentano tutte le proprietà degli elementi di input specificate al momento della creazione della ricerca.
Contiene EBSItem filtri o S3 ItemFilters
## Indice
** EBSItemFilters **
Questo array può contenere oggetti CreationTimes, FilePaths LastModificationTimes, o Sizes.
Tipo: matrice di oggetti [EBSItemFilter](API_BKS_EBSItemFilter.md)
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.
Obbligatorio: no
** S3ItemFilters **
Questo array può contenere CreationTimes, ETags, ObjectKeys, Sizes o VersionIds oggetti.
Tipo: matrice di oggetti [S3ItemFilter](API_BKS_S3ItemFilter.md)
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ItemFilters)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ItemFilters)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ItemFilters)
# LongCondition
La condizione long contiene un `Value` e può facoltativamente contenere un`Operator`.
## Indice
** Value **
Il valore di un elemento incluso in uno dei filtri degli elementi di ricerca.
Tipo: long
Obbligatorio: sì
** Operator **
Una stringa che definisce i valori che verranno restituiti.
Se è inclusa, evita le combinazioni di operatori che restituiranno tutti i valori possibili. Ad esempio, includendo entrambi `EQUALS_TO` e `NOT_EQUALS_TO` con un valore di `4` verranno restituiti tutti i valori.
Tipo: String
Valori validi: `EQUALS_TO | NOT_EQUALS_TO | LESS_THAN_EQUAL_TO | GREATER_THAN_EQUAL_TO`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/LongCondition)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/LongCondition)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/LongCondition)
# ResultItem
Si tratta di un oggetto che rappresenta l'elemento restituito nei risultati di una ricerca per un tipo di risorsa specifico.
## Indice
**Importante**
Questo tipo di dati è UNION, quindi è possibile specificare solo uno dei seguenti membri quando viene utilizzato o restituito.
** EBSResultItem **
Si tratta di articoli restituiti nei risultati di una ricerca su Amazon EBS.
Tipo: oggetto [EBSResultItem](API_BKS_EBSResultItem.md)
Obbligatorio: no
** S3ResultItem **
Si tratta di articoli restituiti nei risultati di una ricerca su Amazon S3.
Tipo: oggetto [S3ResultItem](API_BKS_S3ResultItem.md)
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ResultItem)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ResultItem)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ResultItem)
# S3ExportSpecification
Questa specifica contiene una stringa obbligatoria del bucket di destinazione; facoltativamente, puoi includere il prefisso di destinazione.
## Indice
** DestinationBucket **
Questo specifica il bucket Amazon S3 di destinazione per il processo di esportazione.
Tipo: stringa
Obbligatorio: sì
** DestinationPrefix **
Questo specifica il prefisso per il bucket Amazon S3 di destinazione per il processo di esportazione.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/S3ExportSpecification)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/S3ExportSpecification)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/S3ExportSpecification)
# S3ItemFilter
Questo contiene matrici di oggetti, che possono includere ObjectKeys, Sizes, CreationTimes VersionIds, and/or Etag.
## Indice
** CreationTimes **
È possibile includere da 1 a 10 valori.
Se viene incluso un valore, i risultati restituiranno solo gli elementi che corrispondono al valore.
Se viene incluso più di un valore, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori.
Tipo: matrice di oggetti [TimeCondition](API_BKS_TimeCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** ETags **
È possibile includere da 1 a 10 valori.
Se viene incluso un valore, i risultati restituiranno solo gli elementi che corrispondono al valore.
Se viene incluso più di un valore, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori.
Tipo: matrice di oggetti [StringCondition](API_BKS_StringCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** ObjectKeys **
È possibile includere da 1 a 10 valori.
Se viene incluso un valore, i risultati restituiranno solo gli elementi che corrispondono al valore.
Se viene incluso più di un valore, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori.
Tipo: matrice di oggetti [StringCondition](API_BKS_StringCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** Sizes **
È possibile includere da 1 a 10 valori.
Se viene incluso un valore, i risultati restituiranno solo gli elementi che corrispondono al valore.
Se viene incluso più di un valore, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori.
Tipo: matrice di oggetti [LongCondition](API_BKS_LongCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Obbligatorio: no
** VersionIds **
È possibile includere da 1 a 10 valori.
Se viene incluso un valore, i risultati restituiranno solo gli elementi che corrispondono al valore.
Se viene incluso più di un valore, i risultati restituiranno tutti gli elementi che corrispondono a uno qualsiasi dei valori.
Tipo: matrice di oggetti [StringCondition](API_BKS_StringCondition.md)
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/S3ItemFilter)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/S3ItemFilter)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/S3ItemFilter)
# S3ResultItem
Questi sono gli articoli restituiti nei risultati di una ricerca nei metadati di backup di Amazon S3.
## Indice
** BackupResourceArn **
Si tratta di elementi nei risultati restituiti che corrispondono all'input del punto di ripristino Amazon Resource Names (ARN) durante una ricerca nei metadati di backup di Amazon S3.
▬Tipo: stringa
Obbligatorio: no
** BackupVaultName **
Il nome del vault di backup.
▬Tipo: stringa
Obbligatorio: no
** CreationTime **
Si tratta di uno o più articoli nei risultati restituiti che corrispondono ai valori immessi durante la creazione dell'articolo durante una ricerca nei metadati di backup di Amazon S3.
Tipo: Timestamp
Obbligatorio: no
** ETag **
Si tratta di uno o più elementi nei risultati restituiti che corrispondono ai valori ETags immessi durante una ricerca nei metadati di backup di Amazon S3.
▬Tipo: stringa
Obbligatorio: no
** ObjectKey **
Si tratta di uno o più elementi restituiti nei risultati di una ricerca nei metadati di backup di Amazon S3 che corrispondono ai valori immessi per la chiave dell'oggetto.
▬Tipo: stringa
Obbligatorio: no
** ObjectSize **
Si tratta di elementi nei risultati restituiti che corrispondono ai valori delle dimensioni degli oggetti immessi durante una ricerca nei metadati di backup di Amazon S3.
Tipo: long
Obbligatorio: no
** SourceResourceArn **
Si tratta di elementi nei risultati restituiti che corrispondono all'input di origine di Amazon Resource Names (ARN) durante una ricerca nei metadati di backup di Amazon S3.
▬Tipo: stringa
Obbligatorio: no
** VersionId **
Si tratta di uno o più elementi nei risultati restituiti che corrispondono ai valori per l' IDs immissione della versione durante una ricerca nei metadati di backup di Amazon S3.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/S3ResultItem)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/S3ResultItem)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/S3ResultItem)
# SearchJobBackupsResult
Contiene le informazioni sui punti di ripristino restituiti nei risultati di un processo di ricerca.
## Indice
** BackupCreationTime **
Questa è l'ora di creazione del backup (punto di ripristino).
Tipo: Timestamp
Obbligatorio: no
** BackupResourceArn **
L'Amazon Resource Name (ARN) che identifica in modo univoco le risorse di backup.
▬Tipo: stringa
Obbligatorio: no
** IndexCreationTime **
Questa è l'ora di creazione dell'indice di backup.
Tipo: Timestamp
Obbligatorio: no
** ResourceType **
Questo è il tipo di risorsa della ricerca.
Tipo: String
Valori validi: `S3 | EBS`
Campo obbligatorio: no
** SourceResourceArn **
L'Amazon Resource Name (ARN) che identifica in modo univoco le risorse di origine.
▬Tipo: stringa
Obbligatorio: no
** Status **
Questo è lo stato del risultato del backup del processo di ricerca.
Tipo: String
Valori validi: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`
Campo obbligatorio: no
** StatusMessage **
Questo è il messaggio di stato incluso nei risultati.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchJobBackupsResult)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchJobBackupsResult)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchJobBackupsResult)
# SearchJobSummary
Si tratta di informazioni relative a un lavoro di ricerca.
## Indice
** CompletionTime **
Questa è l'ora di completamento del lavoro di ricerca.
Tipo: Timestamp
Obbligatorio: no
** CreationTime **
Questa è l'ora di creazione del lavoro di ricerca.
Tipo: Timestamp
Obbligatorio: no
** Name **
Questo è il nome del lavoro di ricerca.
▬Tipo: stringa
Obbligatorio: no
** SearchJobArn **
La stringa univoca che identifica l'Amazon Resource Name (ARN) del processo di ricerca specificato.
▬Tipo: stringa
Obbligatorio: no
** SearchJobIdentifier **
La stringa univoca che specifica il lavoro di ricerca.
▬Tipo: stringa
Obbligatorio: no
** SearchScopeSummary **
Riepilogo restituito dell'ambito del lavoro di ricerca specificato, tra cui:
+ TotalBackupsToScanCount, il numero di punti di ripristino restituiti dalla ricerca.
+ TotalItemsToScanCount, il numero di elementi restituiti dalla ricerca.
Tipo: oggetto [SearchScopeSummary](API_BKS_SearchScopeSummary.md)
Obbligatorio: no
** Status **
Questo è lo stato del processo di ricerca.
Tipo: String
Valori validi: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`
Campo obbligatorio: no
** StatusMessage **
Verrà restituito un messaggio di stato per un lavoro di ricerca con stato di `ERRORED` o per uno stato di `COMPLETED` lavori con problemi.
Ad esempio, un messaggio può indicare che una ricerca conteneva punti di ripristino che non possono essere analizzati a causa di un problema di autorizzazioni.
▬Tipo: stringa
Obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchJobSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchJobSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchJobSummary)
# SearchScope
L'ambito di ricerca è costituito da tutte le proprietà di backup immesse in una ricerca.
## Indice
** BackupResourceTypes **
I tipi di risorse inclusi in una ricerca.
I tipi di risorse idonei includono S3 ed EBS.
Tipo: array di stringhe
Membri dell'array: numero minimo di 1 elemento.
Valori validi: `S3 | EBS`
Obbligatorio: sì
** BackupResourceArns **
L'Amazon Resource Name (ARN) che identifica in modo univoco le risorse di backup.
Tipo: array di stringhe
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Obbligatorio: no
** BackupResourceCreationTime **
Questa è l'ora in cui è stata creata una risorsa di backup.
Tipo: oggetto [BackupCreationTimeFilter](API_BKS_BackupCreationTimeFilter.md)
Obbligatorio: no
** BackupResourceTags **
Si tratta di uno o più tag sul backup (punto di ripristino).
Tipo: mappatura stringa a stringa
Obbligatorio: no
** SourceResourceArns **
L'Amazon Resource Name (ARN) che identifica in modo univoco le risorse di origine.
Tipo: array di stringhe
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchScope)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchScope)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchScope)
# SearchScopeSummary
Il riepilogo dell'ambito del lavoro di ricerca specificato, tra cui:
+ TotalBackupsToScanCount, il numero di punti di ripristino restituiti dalla ricerca.
+ TotalItemsToScanCount, il numero di elementi restituiti dalla ricerca.
## Indice
** TotalItemsToScanCount **
Questo è il conteggio del numero totale di elementi che verranno scansionati in una ricerca.
Tipo: long
Obbligatorio: no
** TotalRecoveryPointsToScanCount **
Questo è il numero totale di backup che verranno scansionati in una ricerca.
Tipo: Integer
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/SearchScopeSummary)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/SearchScopeSummary)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/SearchScopeSummary)
# StringCondition
Contiene il valore della stringa e può contenere uno o più operatori.
## Indice
** Value **
Il valore della stringa.
Tipo: stringa
Obbligatorio: sì
** Operator **
Una stringa che definisce quali valori verranno restituiti.
Se è inclusa, evita le combinazioni di operatori che restituiranno tutti i valori possibili. Ad esempio, includendo entrambi `EQUALS_TO` e `NOT_EQUALS_TO` con un valore di `4` verranno restituiti tutti i valori.
Tipo: String
Valori validi: `EQUALS_TO | NOT_EQUALS_TO | CONTAINS | DOES_NOT_CONTAIN | BEGINS_WITH | ENDS_WITH | DOES_NOT_BEGIN_WITH | DOES_NOT_END_WITH`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StringCondition)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StringCondition)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StringCondition)
# TimeCondition
Una condizione temporale indica l'ora di creazione, l'ora dell'ultima modifica o un'altra ora.
## Indice
** Value **
Questo è il valore del timestamp della condizione temporale.
Tipo: Timestamp
Obbligatorio: sì
** Operator **
Una stringa che definisce quali valori verranno restituiti.
Se è inclusa, evita le combinazioni di operatori che restituiranno tutti i valori possibili. Ad esempio, includendo entrambi `EQUALS_TO` e `NOT_EQUALS_TO` con un valore di `4` verranno restituiti tutti i valori.
Tipo: String
Valori validi: `EQUALS_TO | NOT_EQUALS_TO | LESS_THAN_EQUAL_TO | GREATER_THAN_EQUAL_TO`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/TimeCondition)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/TimeCondition)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/TimeCondition)
# Parametri comuni
L'elenco seguente contiene i parametri utilizzati da tutte le azioni per firmare le richieste di Signature Version 4 con una stringa di query. Qualsiasi parametro specifico di un'operazione è riportato nell'argomento relativo all'operazione. Per ulteriori informazioni sulla versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.
**X-Amz-Algorithm**
Algoritmo hash utilizzato per creare la firma della richiesta.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Valori validi: `AWS4-HMAC-SHA256`
Obbligatorio: condizionale
**X-Amz-Credential**
Il valore dell'ambito delle credenziali, che è una stringa che include la chiave di accesso, la data, la regione di destinazione, il servizio richiesto e una stringa di terminazione ("aws4\$1request"). Il valore viene espresso nel seguente formato: *chiave\$1accesso*/*AAAAMMGG*/*regione*/*servizio*/aws4\$1request.
Per ulteriori informazioni, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella *Guida per l'utente IAM*.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-Date**
La data utilizzata per creare la firma. Il formato deve essere il formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Per esempio, la data e l'ora seguenti è un X-Amz-Date valore valido:`20120325T120000Z`.
Condizione: X-Amz-Date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato base ISO 8601, non X-Amz-Date è obbligatoria. Quando X-Amz-Date viene utilizzata, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta [Elementi di una firma di richiesta AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) nella Guida per l'utente *IAM*.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-Security-Token**
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service (AWS STS). Per un elenco di servizi che supportano le credenziali di sicurezza temporanee da AWS STS, consulta la pagina [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) nella *Guida per l'utente di IAM*.
Condizione: se utilizzi credenziali di sicurezza temporanee di AWS STS, devi includere il token di sicurezza.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-Signature**
Specifica la firma con codifica esadecimale calcolata dalla stringa da firmare e dalla chiave di firma derivata.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-SignedHeaders**
Specifica tutte le intestazioni HTTP incluse come parte della richiesta canonica. Per ulteriori informazioni sulla specificazione delle intestazioni firmate, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella Guida per l'utente *IAM*.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Obbligatorio: condizionale
# Tipi di errore comuni
Questa sezione elenca i tipi di errore più comuni che questo AWS servizio può restituire. Non tutti i servizi restituiscono tutti i tipi di errore elencati qui. Per gli errori specifici di un'azione API per questo servizio, consulta l'argomento per quell'azione API.
**AccessDeniedException**
Non sei autorizzato a eseguire questa azione. Verifica che la tua policy IAM includa le autorizzazioni richieste.
Codice di stato HTTP: 403
**ExpiredTokenException**
Il token di sicurezza incluso nella richiesta è scaduto. Richiedi un nuovo token di sicurezza e riprova.
Codice di stato HTTP: 403
**IncompleteSignature**
La firma della richiesta non è conforme agli AWS standard. Verifica di utilizzare AWS credenziali valide e che la richiesta sia formattata correttamente. Se utilizzi un SDK, assicurati che sia aggiornato.
Codice di stato HTTP: 403
**InternalFailure**
La richiesta non può essere elaborata in questo momento a causa di un problema interno del server. Riprova più tardi. Se il problema persiste, contatta l' AWS assistenza.
Codice di stato HTTP: 500
**MalformedHttpRequestException**
Il corpo della richiesta non può essere elaborato. Ciò accade in genere quando il corpo della richiesta non può essere decompresso utilizzando l'algoritmo di codifica del contenuto specificato. Verifica che l'intestazione di codifica del contenuto corrisponda al formato di compressione utilizzato.
Codice di stato HTTP: 400
**NotAuthorized**
Non disponi delle autorizzazioni necessarie per eseguire questa azione. Verifica che la tua policy IAM includa le autorizzazioni richieste.
Codice di stato HTTP: 401
**OptInRequired**
Il tuo AWS account richiede un abbonamento per questo servizio. Verifica di aver abilitato il servizio nel tuo account.
Codice di stato HTTP: 403
**RequestAbortedException**
La richiesta è stata interrotta prima che potesse essere restituita una risposta. Ciò accade in genere quando il client chiude la connessione.
Codice di stato HTTP: 400
**RequestEntityTooLargeException**
L'entità della richiesta è troppo grande. Riduci le dimensioni del corpo della richiesta e riprova.
Codice di stato HTTP: 413
**RequestTimeoutException**
La richiesta è scaduta. Il server non ha ricevuto la richiesta completa entro il periodo di tempo previsto. Riprovare.
Codice di stato HTTP: 408
**ServiceUnavailable**
Il servizio è temporaneamente non disponibile. Riprova più tardi.
Codice di stato HTTP: 503
**ThrottlingException**
La frequenza delle richieste è troppo alta. Riprovano AWS SDKs automaticamente le richieste che ricevono questa eccezione. Riduci la frequenza delle richieste.
Codice di stato HTTP: 400
**UnknownOperationException**
L'azione o l'operazione non viene riconosciuta. Verifica che il nome dell'azione sia digitato correttamente e che sia supportato dalla versione dell'API che stai utilizzando.
Codice di stato HTTP: 404
**UnrecognizedClientException**
Il certificato X.509 o AWS l'ID della chiave di accesso che hai fornito non esiste nei nostri archivi. Verifica di utilizzare credenziali valide e che non siano scadute.
Codice di stato HTTP: 403
**ValidationError**
L'input non soddisfa il formato o i vincoli richiesti. Verifica che tutti i parametri obbligatori siano inclusi e che i valori siano validi.
Codice di stato HTTP: 400