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
<a name="API_Operations_AWS_Backup"></a>

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
<a name="API_AssociateBackupVaultMpaApprovalTeam"></a>

Associa un team di approvazione MPA a un archivio di backup.

## Sintassi della richiesta
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-uri-BackupVaultName"></a>
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
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [MpaApprovalTeamArn](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-MpaApprovalTeamArn"></a>
L'Amazon Resource Name (ARN) del team di approvazione MPA da associare al backup vault.  
Tipo: stringa  
Obbligatorio: sì

 ** [RequesterComment](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-RequesterComment"></a>
Un commento fornito dal richiedente che spiega la richiesta di associazione.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_AssociateBackupVaultMpaApprovalTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_AssociateBackupVaultMpaApprovalTeam_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

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
<a name="API_AssociateBackupVaultMpaApprovalTeam_SeeAlso"></a>

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
<a name="API_CancelLegalHold"></a>

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
<a name="API_CancelLegalHold_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_CancelLegalHold_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [CancelDescription](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-CancelDescription"></a>
Una stringa che descrive il motivo della rimozione del blocco a fini legali.  
Obbligatorio: sì

 ** [legalHoldId](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-LegalHoldId"></a>
L'ID del blocco a fini legali.  
Obbligatorio: sì

 ** [RetainRecordInDays](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-RetainRecordInDays"></a>
L'importo intero, in giorni, dopo il quale rimuovere la conservazione legale.

## Corpo della richiesta
<a name="API_CancelLegalHold_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_CancelLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 201
```

## Elementi di risposta
<a name="API_CancelLegalHold_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 201 con un corpo HTTP vuoto.

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

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
<a name="API_CancelLegalHold_SeeAlso"></a>

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
<a name="API_CreateBackupPlan"></a>

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
<a name="API_CreateBackupPlan_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateBackupPlan_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateBackupPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-BackupPlan"></a>
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) **   <a name="Backup-CreateBackupPlan-request-BackupPlanTags"></a>
I tag da assegnare al piano di backup.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-CreatorRequestId"></a>
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
<a name="API_CreateBackupPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateBackupPlan_ResponseElements"></a>

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) **   <a name="Backup-CreateBackupPlan-response-AdvancedBackupSettings"></a>
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) **   <a name="Backup-CreateBackupPlan-response-BackupPlanArn"></a>
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) **   <a name="Backup-CreateBackupPlan-response-BackupPlanId"></a>
L'ID del piano di backup.  
Tipo: String

 ** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-CreationDate"></a>
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) **   <a name="Backup-CreateBackupPlan-response-VersionId"></a>
Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. e non possono essere modificati.  
Tipo: String

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

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
<a name="API_CreateBackupPlan_SeeAlso"></a>

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
<a name="API_CreateBackupSelection"></a>

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
<a name="API_CreateBackupSelection_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateBackupSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-uri-BackupPlanId"></a>
L'ID del piano di backup.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateBackupSelection_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupSelection](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-BackupSelection"></a>
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) **   <a name="Backup-CreateBackupSelection-request-CreatorRequestId"></a>
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
<a name="API_CreateBackupSelection_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateBackupSelection_ResponseElements"></a>

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) **   <a name="Backup-CreateBackupSelection-response-BackupPlanId"></a>
L'ID del piano di backup.  
Tipo: String

 ** [CreationDate](#API_CreateBackupSelection_ResponseSyntax) **   <a name="Backup-CreateBackupSelection-response-CreationDate"></a>
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) **   <a name="Backup-CreateBackupSelection-response-SelectionId"></a>
Identifica in modo univoco il corpo di una richiesta per assegnare un set di risorse a un piano di backup.  
Tipo: String

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

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
<a name="API_CreateBackupSelection_SeeAlso"></a>

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
<a name="API_CreateBackupVault"></a>

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
<a name="API_CreateBackupVault_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-uri-BackupVaultName"></a>
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
<a name="API_CreateBackupVault_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupVaultTags](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-BackupVaultTags"></a>
I tag da assegnare al vault di backup.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [CreatorRequestId](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-CreatorRequestId"></a>
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) **   <a name="Backup-CreateBackupVault-request-EncryptionKeyArn"></a>
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
<a name="API_CreateBackupVault_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateBackupVault_ResponseElements"></a>

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) **   <a name="Backup-CreateBackupVault-response-BackupVaultArn"></a>
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) **   <a name="Backup-CreateBackupVault-response-BackupVaultName"></a>
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) **   <a name="Backup-CreateBackupVault-response-CreationDate"></a>
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
<a name="API_CreateBackupVault_Errors"></a>

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
<a name="API_CreateBackupVault_SeeAlso"></a>

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
<a name="API_CreateFramework"></a>

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
<a name="API_CreateFramework_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateFramework_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateFramework_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [FrameworkControls](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkControls"></a>
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) **   <a name="Backup-CreateFramework-request-FrameworkDescription"></a>
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) **   <a name="Backup-CreateFramework-request-FrameworkName"></a>
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) **   <a name="Backup-CreateFramework-request-FrameworkTags"></a>
I tag da assegnare al framework.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [IdempotencyToken](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-IdempotencyToken"></a>
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
<a name="API_CreateFramework_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateFramework_ResponseElements"></a>

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) **   <a name="Backup-CreateFramework-response-FrameworkArn"></a>
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) **   <a name="Backup-CreateFramework-response-FrameworkName"></a>
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
<a name="API_CreateFramework_Errors"></a>

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
<a name="API_CreateFramework_SeeAlso"></a>

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
<a name="API_CreateLegalHold"></a>

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
<a name="API_CreateLegalHold_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateLegalHold_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateLegalHold_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Description](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Description"></a>
La descrizione della conservazione legale.  
Tipo: stringa  
Obbligatorio: sì

 ** [IdempotencyToken](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-IdempotencyToken"></a>
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) **   <a name="Backup-CreateLegalHold-request-RecoveryPointSelection"></a>
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) **   <a name="Backup-CreateLegalHold-request-Tags"></a>
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) **   <a name="Backup-CreateLegalHold-request-Title"></a>
Il titolo della custodia legale.  
Tipo: stringa  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_CreateLegalHold_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateLegalHold_ResponseElements"></a>

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) **   <a name="Backup-CreateLegalHold-response-CreationDate"></a>
L'ora in cui è stata creata la custodia legale.  
Tipo: Timestamp

 ** [Description](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Description"></a>
La descrizione del blocco legale.  
Tipo: String

 ** [LegalHoldArn](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-LegalHoldArn"></a>
L'Amazon Resource Name (ARN) della custodia legale.  
Tipo: String

 ** [LegalHoldId](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-LegalHoldId"></a>
L'ID del blocco a fini legali.  
Tipo: String

 ** [RecoveryPointSelection](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-RecoveryPointSelection"></a>
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) **   <a name="Backup-CreateLegalHold-response-Status"></a>
Lo stato della custodia legale.  
Tipo: String  
Valori validi: `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Title"></a>
Il titolo della custodia legale.  
Tipo: String

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

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
<a name="API_CreateLegalHold_SeeAlso"></a>

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
<a name="API_CreateLogicallyAirGappedBackupVault"></a>

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
<a name="API_CreateLogicallyAirGappedBackupVault_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateLogicallyAirGappedBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-uri-BackupVaultName"></a>
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
<a name="API_CreateLogicallyAirGappedBackupVault_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupVaultTags](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-BackupVaultTags"></a>
I tag da assegnare al vault.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [CreatorRequestId](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-CreatorRequestId"></a>
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) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-EncryptionKeyArn"></a>
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) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-MaxRetentionDays"></a>
Il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino.  
Tipo: long  
Obbligatorio: sì

 ** [MinRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-MinRetentionDays"></a>
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
<a name="API_CreateLogicallyAirGappedBackupVault_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateLogicallyAirGappedBackupVault_ResponseElements"></a>

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) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-BackupVaultArn"></a>
L'ARN (Amazon Resource Name) del vault.  
Tipo: String

 ** [BackupVaultName](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-BackupVaultName"></a>
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) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-CreationDate"></a>
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) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-VaultState"></a>
Lo stato attuale del vault.  
Tipo: String  
Valori validi: `CREATING | AVAILABLE | FAILED` 

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

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
<a name="API_CreateLogicallyAirGappedBackupVault_SeeAlso"></a>

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
<a name="API_CreateReportPlan"></a>

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
<a name="API_CreateReportPlan_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateReportPlan_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateReportPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-IdempotencyToken"></a>
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) **   <a name="Backup-CreateReportPlan-request-ReportDeliveryChannel"></a>
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) **   <a name="Backup-CreateReportPlan-request-ReportPlanDescription"></a>
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) **   <a name="Backup-CreateReportPlan-request-ReportPlanName"></a>
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) **   <a name="Backup-CreateReportPlan-request-ReportPlanTags"></a>
I tag da assegnare al piano di report.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportSetting"></a>
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
<a name="API_CreateReportPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateReportPlan_ResponseElements"></a>

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) **   <a name="Backup-CreateReportPlan-response-CreationTime"></a>
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) **   <a name="Backup-CreateReportPlan-response-ReportPlanArn"></a>
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) **   <a name="Backup-CreateReportPlan-response-ReportPlanName"></a>
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
<a name="API_CreateReportPlan_Errors"></a>

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
<a name="API_CreateReportPlan_SeeAlso"></a>

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
<a name="API_CreateRestoreAccessBackupVault"></a>

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
<a name="API_CreateRestoreAccessBackupVault_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateRestoreAccessBackupVault_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateRestoreAccessBackupVault_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupVaultName](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-BackupVaultName"></a>
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) **   <a name="Backup-CreateRestoreAccessBackupVault-request-BackupVaultTags"></a>
Tag opzionali da assegnare al repository di backup per l'accesso al ripristino.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [CreatorRequestId](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-CreatorRequestId"></a>
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) **   <a name="Backup-CreateRestoreAccessBackupVault-request-RequesterComment"></a>
Un commento che spiega il motivo della richiesta di ripristino dell'accesso al backup vault.  
▬Tipo: stringa  
Obbligatorio: no

 ** [SourceBackupVaultArn](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-SourceBackupVaultArn"></a>
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
<a name="API_CreateRestoreAccessBackupVault_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateRestoreAccessBackupVault_ResponseElements"></a>

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) **   <a name="Backup-CreateRestoreAccessBackupVault-response-CreationDate"></a>
>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) **   <a name="Backup-CreateRestoreAccessBackupVault-response-RestoreAccessBackupVaultArn"></a>
L'ARN che identifica in modo univoco l'archivio di backup di accesso al ripristino creato.  
Tipo: String

 ** [RestoreAccessBackupVaultName](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-RestoreAccessBackupVaultName"></a>
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) **   <a name="Backup-CreateRestoreAccessBackupVault-response-VaultState"></a>
Lo stato attuale del repository di backup per l'accesso al ripristino.  
Tipo: String  
Valori validi: `CREATING | AVAILABLE | FAILED` 

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

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
<a name="API_CreateRestoreAccessBackupVault_SeeAlso"></a>

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
<a name="API_CreateRestoreTestingPlan"></a>

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
<a name="API_CreateRestoreTestingPlan_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateRestoreTestingPlan_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateRestoreTestingPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CreatorRequestId](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-CreatorRequestId"></a>
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) **   <a name="Backup-CreateRestoreTestingPlan-request-RestoreTestingPlan"></a>
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) **   <a name="Backup-CreateRestoreTestingPlan-request-Tags"></a>
I tag da assegnare al piano di test di ripristino.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateRestoreTestingPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateRestoreTestingPlan_ResponseElements"></a>

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) **   <a name="Backup-CreateRestoreTestingPlan-response-CreationTime"></a>
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) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
Un nome della risorsa Amazon (ARN) che identifica in modo univoco il piano di test di ripristino creato.  
Tipo: String

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
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
<a name="API_CreateRestoreTestingPlan_Errors"></a>

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
<a name="API_CreateRestoreTestingPlan_SeeAlso"></a>

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
<a name="API_CreateRestoreTestingSelection"></a>

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
<a name="API_CreateRestoreTestingSelection_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_CreateRestoreTestingSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
Immettere il nome del piano di test di ripristino restituito dalla CreateRestoreTestingPlan richiesta correlata.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_CreateRestoreTestingSelection_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CreatorRequestId](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-CreatorRequestId"></a>
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) **   <a name="Backup-CreateRestoreTestingSelection-request-RestoreTestingSelection"></a>
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
<a name="API_CreateRestoreTestingSelection_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateRestoreTestingSelection_ResponseElements"></a>

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) **   <a name="Backup-CreateRestoreTestingSelection-response-CreationTime"></a>
L'ora in cui è stata creata la selezione per il test delle risorse.  
Tipo: Timestamp

 ** [RestoreTestingPlanArn](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingPlanArn"></a>
L'ARN del piano di test di ripristino a cui è associata la selezione del test di ripristino.  
Tipo: String

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingPlanName"></a>
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) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingSelectionName"></a>
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
<a name="API_CreateRestoreTestingSelection_Errors"></a>

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
<a name="API_CreateRestoreTestingSelection_SeeAlso"></a>

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
<a name="API_CreateTieringConfiguration"></a>

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
<a name="API_CreateTieringConfiguration_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateTieringConfiguration_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateTieringConfiguration_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-CreatorRequestId"></a>
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) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
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) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
I tag da assegnare alla configurazione a più livelli.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateTieringConfiguration_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateTieringConfiguration_ResponseElements"></a>

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) **   <a name="Backup-CreateTieringConfiguration-response-CreationTime"></a>
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) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering creata.  
Tipo: String

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
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
<a name="API_CreateTieringConfiguration_Errors"></a>

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
<a name="API_CreateTieringConfiguration_SeeAlso"></a>

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
<a name="API_DeleteBackupPlan"></a>

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
<a name="API_DeleteBackupPlan_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBackupPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_DeleteBackupPlan_RequestSyntax) **   <a name="Backup-DeleteBackupPlan-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteBackupPlan_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBackupPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DeleteBackupPlan_ResponseElements"></a>

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) **   <a name="Backup-DeleteBackupPlan-response-BackupPlanArn"></a>
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) **   <a name="Backup-DeleteBackupPlan-response-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Tipo: String

 ** [DeletionDate](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-DeletionDate"></a>
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) **   <a name="Backup-DeleteBackupPlan-response-VersionId"></a>
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
<a name="API_DeleteBackupPlan_Errors"></a>

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
<a name="API_DeleteBackupPlan_SeeAlso"></a>

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
<a name="API_DeleteBackupSelection"></a>

Elimina la selezione delle risorse associate a un piano di backup specificato da `SelectionId`.

## Sintassi della richiesta
<a name="API_DeleteBackupSelection_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBackupSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_DeleteBackupSelection_RequestSyntax) **   <a name="Backup-DeleteBackupSelection-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

 ** [selectionId](#API_DeleteBackupSelection_RequestSyntax) **   <a name="Backup-DeleteBackupSelection-request-uri-SelectionId"></a>
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
<a name="API_DeleteBackupSelection_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBackupSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteBackupSelection_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteBackupSelection_SeeAlso"></a>

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
<a name="API_DeleteBackupVault"></a>

Elimina il vault di backup identificato dal relativo nome. Un vault può essere eliminato solo se è vuoto.

## Sintassi della richiesta
<a name="API_DeleteBackupVault_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DeleteBackupVault_RequestSyntax) **   <a name="Backup-DeleteBackupVault-request-uri-BackupVaultName"></a>
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
<a name="API_DeleteBackupVault_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteBackupVault_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteBackupVault_SeeAlso"></a>

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
<a name="API_DeleteBackupVaultAccessPolicy"></a>

Elimina il documento di policy che gestisce le autorizzazioni su un vault di backup.

## Sintassi della richiesta
<a name="API_DeleteBackupVaultAccessPolicy_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBackupVaultAccessPolicy_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DeleteBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-DeleteBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
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
<a name="API_DeleteBackupVaultAccessPolicy_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBackupVaultAccessPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteBackupVaultAccessPolicy_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteBackupVaultAccessPolicy_SeeAlso"></a>

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
<a name="API_DeleteBackupVaultLockConfiguration"></a>

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
<a name="API_DeleteBackupVaultLockConfiguration_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBackupVaultLockConfiguration_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DeleteBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-DeleteBackupVaultLockConfiguration-request-uri-BackupVaultName"></a>
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
<a name="API_DeleteBackupVaultLockConfiguration_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBackupVaultLockConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteBackupVaultLockConfiguration_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteBackupVaultLockConfiguration_SeeAlso"></a>

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
<a name="API_DeleteBackupVaultNotifications"></a>

Elimina le notifiche degli eventi per il vault di backup specificato.

## Sintassi della richiesta
<a name="API_DeleteBackupVaultNotifications_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteBackupVaultNotifications_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DeleteBackupVaultNotifications_RequestSyntax) **   <a name="Backup-DeleteBackupVaultNotifications-request-uri-BackupVaultName"></a>
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
<a name="API_DeleteBackupVaultNotifications_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteBackupVaultNotifications_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteBackupVaultNotifications_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteBackupVaultNotifications_SeeAlso"></a>

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
<a name="API_DeleteFramework"></a>

Elimina il framework specificato da un nome framework.

## Sintassi della richiesta
<a name="API_DeleteFramework_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteFramework_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [frameworkName](#API_DeleteFramework_RequestSyntax) **   <a name="Backup-DeleteFramework-request-uri-FrameworkName"></a>
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
<a name="API_DeleteFramework_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteFramework_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteFramework_SeeAlso"></a>

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
<a name="API_DeleteRecoveryPoint"></a>

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
<a name="API_DeleteRecoveryPoint_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteRecoveryPoint_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DeleteRecoveryPoint_RequestSyntax) **   <a name="Backup-DeleteRecoveryPoint-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-DeleteRecoveryPoint-request-uri-RecoveryPointArn"></a>
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
<a name="API_DeleteRecoveryPoint_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteRecoveryPoint_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteRecoveryPoint_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteRecoveryPoint_SeeAlso"></a>

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
<a name="API_DeleteReportPlan"></a>

Elimina il piano di report specificato dal nome di un piano di report.

## Sintassi della richiesta
<a name="API_DeleteReportPlan_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteReportPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [reportPlanName](#API_DeleteReportPlan_RequestSyntax) **   <a name="Backup-DeleteReportPlan-request-uri-ReportPlanName"></a>
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
<a name="API_DeleteReportPlan_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteReportPlan_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteReportPlan_SeeAlso"></a>

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
<a name="API_DeleteRestoreTestingPlan"></a>

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
<a name="API_DeleteRestoreTestingPlan_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteRestoreTestingPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_DeleteRestoreTestingPlan_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
Nome univoco richiesto del piano di test di ripristino che si desidera eliminare.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteRestoreTestingPlan_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteRestoreTestingPlan_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteRestoreTestingPlan_SeeAlso"></a>

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
<a name="API_DeleteRestoreTestingSelection"></a>

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
<a name="API_DeleteRestoreTestingSelection_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteRestoreTestingSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_DeleteRestoreTestingSelection_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
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) **   <a name="Backup-DeleteRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
Nome univoco obbligatorio della selezione per il test di ripristino che si desidera eliminare.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteRestoreTestingSelection_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DeleteRestoreTestingSelection_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteRestoreTestingSelection_SeeAlso"></a>

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
<a name="API_DeleteTieringConfiguration"></a>

Elimina la configurazione di livelli specificata da un nome di configurazione di livelli.

## Sintassi della richiesta
<a name="API_DeleteTieringConfiguration_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DeleteTieringConfiguration_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [tieringConfigurationName](#API_DeleteTieringConfiguration_RequestSyntax) **   <a name="Backup-DeleteTieringConfiguration-request-uri-TieringConfigurationName"></a>
Il nome univoco di una configurazione a più livelli.  
Modello: `^[a-zA-Z0-9_]{1,200}$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DeleteTieringConfiguration_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DeleteTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteTieringConfiguration_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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
<a name="API_DeleteTieringConfiguration_SeeAlso"></a>

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
<a name="API_DescribeBackupJob"></a>

Restituisce i dettagli del processo di backup per il `BackupJobId` specificato.

## Sintassi della richiesta
<a name="API_DescribeBackupJob_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeBackupJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupJobId](#API_DescribeBackupJob_RequestSyntax) **   <a name="Backup-DescribeBackupJob-request-uri-BackupJobId"></a>
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeBackupJob_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeBackupJob_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DescribeBackupJob_ResponseElements"></a>

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) **   <a name="Backup-DescribeBackupJob-response-AccountId"></a>
Restituisce l'ID account proprietario del processo di backup.  
Tipo: stringa  
Modello: `^[0-9]{12}$` 

 ** [BackupJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupJobId"></a>
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.  
Tipo: String

 ** [BackupOptions](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupOptions"></a>
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) **   <a name="Backup-DescribeBackupJob-response-BackupSizeInBytes"></a>
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) **   <a name="Backup-DescribeBackupJob-response-BackupType"></a>
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) **   <a name="Backup-DescribeBackupJob-response-BackupVaultArn"></a>
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) **   <a name="Backup-DescribeBackupJob-response-BackupVaultName"></a>
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) **   <a name="Backup-DescribeBackupJob-response-BytesTransferred"></a>
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) **   <a name="Backup-DescribeBackupJob-response-ChildJobsInState"></a>
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) **   <a name="Backup-DescribeBackupJob-response-CompletionDate"></a>
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) **   <a name="Backup-DescribeBackupJob-response-CreatedBy"></a>
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) **   <a name="Backup-DescribeBackupJob-response-CreationDate"></a>
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) **   <a name="Backup-DescribeBackupJob-response-EncryptionKeyArn"></a>
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) **   <a name="Backup-DescribeBackupJob-response-ExpectedCompletionDate"></a>
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) **   <a name="Backup-DescribeBackupJob-response-IamRoleArn"></a>
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) **   <a name="Backup-DescribeBackupJob-response-InitiationDate"></a>
La data di avvio di un processo di backup.  
Tipo: Timestamp

 ** [IsEncrypted](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IsEncrypted"></a>
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) **   <a name="Backup-DescribeBackupJob-response-IsParent"></a>
Ciò restituisce il valore booleano di cui un processo di backup è un processo principale (composito).  
Tipo: Booleano

 ** [MessageCategory](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-MessageCategory"></a>
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) **   <a name="Backup-DescribeBackupJob-response-NumberOfChildJobs"></a>
Ciò restituisce il numero di processi di backup figlio (nidificati).  
Tipo: long

 ** [ParentJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ParentJobId"></a>
Ciò restituisce l'ID del processo di backup della risorsa principale (composito).  
Tipo: String

 ** [PercentDone](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-PercentDone"></a>
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) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointArn"></a>
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) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointLifecycle"></a>
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) **   <a name="Backup-DescribeBackupJob-response-ResourceArn"></a>
Un ARN identifica in modo univoco una risorsa salvata. Il formato dell'ARN dipende dal tipo di risorsa.  
Tipo: String

 ** [ResourceName](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceName"></a>
Il nome non univoco della risorsa che appartiene al backup specificato.  
Tipo: String

 ** [ResourceType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceType"></a>
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) **   <a name="Backup-DescribeBackupJob-response-StartBy"></a>
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) **   <a name="Backup-DescribeBackupJob-response-State"></a>
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) **   <a name="Backup-DescribeBackupJob-response-StatusMessage"></a>
Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.  
Tipo: String

 ** [VaultLockState](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultLockState"></a>
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) **   <a name="Backup-DescribeBackupJob-response-VaultType"></a>
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
<a name="API_DescribeBackupJob_Errors"></a>

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
<a name="API_DescribeBackupJob_SeeAlso"></a>

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
<a name="API_DescribeBackupVault"></a>

Restituisce i metadati relativi a un vault di backup specificato in base al nome.

## Sintassi della richiesta
<a name="API_DescribeBackupVault_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) **   <a name="Backup-DescribeBackupVault-request-uri-BackupVaultAccountId"></a>
L'ID dell'account del vault di backup specificato.

 ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) **   <a name="Backup-DescribeBackupVault-request-uri-BackupVaultName"></a>
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
<a name="API_DescribeBackupVault_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeBackupVault_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DescribeBackupVault_ResponseElements"></a>

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) **   <a name="Backup-DescribeBackupVault-response-BackupVaultArn"></a>
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) **   <a name="Backup-DescribeBackupVault-response-BackupVaultName"></a>
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) **   <a name="Backup-DescribeBackupVault-response-CreationDate"></a>
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) **   <a name="Backup-DescribeBackupVault-response-CreatorRequestId"></a>
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) **   <a name="Backup-DescribeBackupVault-response-EncryptionKeyArn"></a>
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) **   <a name="Backup-DescribeBackupVault-response-EncryptionKeyType"></a>
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) **   <a name="Backup-DescribeBackupVault-response-LatestMpaApprovalTeamUpdate"></a>
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) **   <a name="Backup-DescribeBackupVault-response-LockDate"></a>
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) **   <a name="Backup-DescribeBackupVault-response-Locked"></a>
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) **   <a name="Backup-DescribeBackupVault-response-MaxRetentionDays"></a>
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) **   <a name="Backup-DescribeBackupVault-response-MinRetentionDays"></a>
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) **   <a name="Backup-DescribeBackupVault-response-MpaApprovalTeamArn"></a>
L'ARN del team di approvazione MPA associato a questo archivio di backup.  
Tipo: String

 ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MpaSessionArn"></a>
L'ARN della sessione MPA associata a questo archivio di backup.  
Tipo: String

 ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-NumberOfRecoveryPoints"></a>
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) **   <a name="Backup-DescribeBackupVault-response-SourceBackupVaultArn"></a>
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) **   <a name="Backup-DescribeBackupVault-response-VaultState"></a>
Lo stato attuale del vault. ->  
Tipo: String  
Valori validi: `CREATING | AVAILABLE | FAILED` 

 ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-VaultType"></a>
Il tipo di deposito descritto.  
Tipo: String  
Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

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

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
<a name="API_DescribeBackupVault_SeeAlso"></a>

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
<a name="API_DescribeCopyJob"></a>

Restituisce i metadati associati alla creazione di una copia di una risorsa.

## Sintassi della richiesta
<a name="API_DescribeCopyJob_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeCopyJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [copyJobId](#API_DescribeCopyJob_RequestSyntax) **   <a name="Backup-DescribeCopyJob-request-uri-CopyJobId"></a>
Identifica in modo univoco un processo di copia.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeCopyJob_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeCopyJob_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DescribeCopyJob_ResponseElements"></a>

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) **   <a name="Backup-DescribeCopyJob-response-CopyJob"></a>
Contiene informazioni dettagliate su un processo di copia.  
Tipo: oggetto [CopyJob](API_CopyJob.md)

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

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
<a name="API_DescribeCopyJob_SeeAlso"></a>

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
<a name="API_DescribeFramework"></a>

Restituisce i dettagli del framework per il `FrameworkName` specificato.

## Sintassi della richiesta
<a name="API_DescribeFramework_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeFramework_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [frameworkName](#API_DescribeFramework_RequestSyntax) **   <a name="Backup-DescribeFramework-request-uri-FrameworkName"></a>
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
<a name="API_DescribeFramework_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeFramework_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DescribeFramework_ResponseElements"></a>

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) **   <a name="Backup-DescribeFramework-response-CreationTime"></a>
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) **   <a name="Backup-DescribeFramework-response-DeploymentStatus"></a>
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) **   <a name="Backup-DescribeFramework-response-FrameworkArn"></a>
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) **   <a name="Backup-DescribeFramework-response-FrameworkControls"></a>
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) **   <a name="Backup-DescribeFramework-response-FrameworkDescription"></a>
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) **   <a name="Backup-DescribeFramework-response-FrameworkName"></a>
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) **   <a name="Backup-DescribeFramework-response-FrameworkStatus"></a>
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) **   <a name="Backup-DescribeFramework-response-IdempotencyToken"></a>
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
<a name="API_DescribeFramework_Errors"></a>

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
<a name="API_DescribeFramework_SeeAlso"></a>

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
<a name="API_DescribeGlobalSettings"></a>

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
<a name="API_DescribeGlobalSettings_RequestSyntax"></a>

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

## Parametri della richiesta URI:
<a name="API_DescribeGlobalSettings_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_DescribeGlobalSettings_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeGlobalSettings_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DescribeGlobalSettings_ResponseElements"></a>

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) **   <a name="Backup-DescribeGlobalSettings-response-GlobalSettings"></a>
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) **   <a name="Backup-DescribeGlobalSettings-response-LastUpdateTime"></a>
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
<a name="API_DescribeGlobalSettings_Errors"></a>

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
<a name="API_DescribeGlobalSettings_SeeAlso"></a>

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
<a name="API_DescribeProtectedResource"></a>

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
<a name="API_DescribeProtectedResource_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeProtectedResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_DescribeProtectedResource_RequestSyntax) **   <a name="Backup-DescribeProtectedResource-request-uri-ResourceArn"></a>
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
<a name="API_DescribeProtectedResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeProtectedResource_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_DescribeProtectedResource_ResponseElements"></a>

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) **   <a name="Backup-DescribeProtectedResource-response-LastBackupTime"></a>
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) **   <a name="Backup-DescribeProtectedResource-response-LastBackupVaultArn"></a>
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) **   <a name="Backup-DescribeProtectedResource-response-LastRecoveryPointArn"></a>
L'ARN (Amazon Resource Name) del punto di ripristino più recente.  
Tipo: String

 ** [LatestRestoreExecutionTimeMinutes](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreExecutionTimeMinutes"></a>
Il tempo, in minuti, impiegato per il completamento del processo di ripristino più recente.  
Tipo: long

 ** [LatestRestoreJobCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreJobCreationDate"></a>
La data di creazione del processo di ripristino più recente.  
Tipo: Timestamp

 ** [LatestRestoreRecoveryPointCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreRecoveryPointCreationDate"></a>
La data di creazione del punto di ripristino più recente.  
Tipo: Timestamp

 ** [ResourceArn](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-ResourceArn"></a>
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.  
Tipo: String

 ** [ResourceName](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-ResourceName"></a>
Il nome della risorsa che appartiene al backup specificato.  
Tipo: String

 ** [ResourceType](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-ResourceType"></a>
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
<a name="API_DescribeProtectedResource_Errors"></a>

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
<a name="API_DescribeProtectedResource_SeeAlso"></a>

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
<a name="API_DescribeRecoveryPoint"></a>

Restituisce i metadati associati a un punto di ripristino, inclusi ID, stato, crittografia e ciclo di vita.

## Sintassi della richiesta
<a name="API_DescribeRecoveryPoint_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeRecoveryPoint_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultAccountId"></a>
L'ID dell'account del vault di backup specificato.  
Modello: `^[0-9]{12}$` 

 ** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-request-uri-RecoveryPointArn"></a>
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
<a name="API_DescribeRecoveryPoint_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeRecoveryPoint_ResponseSyntax"></a>

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

{
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "CompletionDate": number,
   "CompositeMemberIdentifier": "string",
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "EncryptionKeyType": "string",
   "IamRoleArn": "string",
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "LastRestoreTime": number,
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ParentRecoveryPointArn": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanResults": [ 
      { 
         "Findings": [ "string" ],
         "LastScanTimestamp": number,
         "MalwareScanner": "string",
         "ScanJobState": "string"
      }
   ],
   "SourceBackupVaultArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "StorageClass": "string",
   "VaultType": "string"
}
```

## Elementi di risposta
<a name="API_DescribeRecoveryPoint_ResponseElements"></a>

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) **   <a name="Backup-DescribeRecoveryPoint-response-BackupSizeInBytes"></a>
La dimensione, in byte, di un backup.  
Tipo: long

 ** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultArn"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultName"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-CalculatedLifecycle"></a>
Un oggetto `CalculatedLifecycle` contenente i timestamp `DeleteAt` e `MoveToColdStorageAt`.  
Tipo: oggetto [CalculatedLifecycle](API_CalculatedLifecycle.md)

 ** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompletionDate"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-CompositeMemberIdentifier"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-CreatedBy"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-CreationDate"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyArn"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyType"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-IamRoleArn"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatus"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatusMessage"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-InitiationDate"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-IsEncrypted"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-IsParent"></a>
Ciò restituisce il valore booleano di cui un punto di ripristino è un processo padre (composito).  
Tipo: Booleano

 ** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-LastRestoreTime"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-Lifecycle"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-ParentRecoveryPointArn"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-RecoveryPointArn"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceArn"></a>
Un ARN identifica in modo univoco una risorsa salvata. Il formato dell'ARN dipende dal tipo di risorsa.  
Tipo: String

 ** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceName"></a>
Il nome della risorsa che appartiene al backup specificato.  
Tipo: String

 ** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceType"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-ScanResults"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-SourceBackupVaultArn"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-Status"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-StatusMessage"></a>
Un messaggio di stato che spiega lo stato del punto di ripristino.  
Tipo: String

 ** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StorageClass"></a>
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) **   <a name="Backup-DescribeRecoveryPoint-response-VaultType"></a>
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
<a name="API_DescribeRecoveryPoint_Errors"></a>

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
<a name="API_DescribeRecoveryPoint_SeeAlso"></a>

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
<a name="API_DescribeRegionSettings"></a>

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
<a name="API_DescribeRegionSettings_RequestSyntax"></a>

```
GET /account-settings HTTP/1.1
```

## Parametri della richiesta URI:
<a name="API_DescribeRegionSettings_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_DescribeRegionSettings_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeRegionSettings_ResponseSyntax"></a>

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

{
   "ResourceTypeManagementPreference": { 
      "string" : boolean 
   },
   "ResourceTypeOptInPreference": { 
      "string" : boolean 
   }
}
```

## Elementi di risposta
<a name="API_DescribeRegionSettings_ResponseElements"></a>

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) **   <a name="Backup-DescribeRegionSettings-response-ResourceTypeManagementPreference"></a>
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) **   <a name="Backup-DescribeRegionSettings-response-ResourceTypeOptInPreference"></a>
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
<a name="API_DescribeRegionSettings_Errors"></a>

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
<a name="API_DescribeRegionSettings_SeeAlso"></a>

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
<a name="API_DescribeReportJob"></a>

Restituisce i dettagli associati alla creazione di un report come specificato da `ReportJobId`.

## Sintassi della richiesta
<a name="API_DescribeReportJob_RequestSyntax"></a>

```
GET /audit/report-jobs/reportJobId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeReportJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [reportJobId](#API_DescribeReportJob_RequestSyntax) **   <a name="Backup-DescribeReportJob-request-uri-ReportJobId"></a>
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
<a name="API_DescribeReportJob_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeReportJob_ResponseSyntax"></a>

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

{
   "ReportJob": { 
      "CompletionTime": number,
      "CreationTime": number,
      "ReportDestination": { 
         "S3BucketName": "string",
         "S3Keys": [ "string" ]
      },
      "ReportJobId": "string",
      "ReportPlanArn": "string",
      "ReportTemplate": "string",
      "Status": "string",
      "StatusMessage": "string"
   }
}
```

## Elementi di risposta
<a name="API_DescribeReportJob_ResponseElements"></a>

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) **   <a name="Backup-DescribeReportJob-response-ReportJob"></a>
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
<a name="API_DescribeReportJob_Errors"></a>

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
<a name="API_DescribeReportJob_SeeAlso"></a>

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
<a name="API_DescribeReportPlan"></a>

Restituisce un elenco di tutti i piani di report per un Account AWS and Regione AWS.

## Sintassi della richiesta
<a name="API_DescribeReportPlan_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DescribeReportPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [reportPlanName](#API_DescribeReportPlan_RequestSyntax) **   <a name="Backup-DescribeReportPlan-request-uri-ReportPlanName"></a>
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
<a name="API_DescribeReportPlan_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeReportPlan_ResponseSyntax"></a>

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

{
   "ReportPlan": { 
      "CreationTime": number,
      "DeploymentStatus": "string",
      "LastAttemptedExecutionTime": number,
      "LastSuccessfulExecutionTime": number,
      "ReportDeliveryChannel": { 
         "Formats": [ "string" ],
         "S3BucketName": "string",
         "S3KeyPrefix": "string"
      },
      "ReportPlanArn": "string",
      "ReportPlanDescription": "string",
      "ReportPlanName": "string",
      "ReportSetting": { 
         "Accounts": [ "string" ],
         "FrameworkArns": [ "string" ],
         "NumberOfFrameworks": number,
         "OrganizationUnits": [ "string" ],
         "Regions": [ "string" ],
         "ReportTemplate": "string"
      }
   }
}
```

## Elementi di risposta
<a name="API_DescribeReportPlan_ResponseElements"></a>

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) **   <a name="Backup-DescribeReportPlan-response-ReportPlan"></a>
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
<a name="API_DescribeReportPlan_Errors"></a>

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
<a name="API_DescribeReportPlan_SeeAlso"></a>

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
<a name="API_DescribeRestoreJob"></a>

Restituisce i metadati associati a un processo di ripristino specificato da un ID processo.

## Sintassi della richiesta
<a name="API_DescribeRestoreJob_RequestSyntax"></a>

```
GET /restore-jobs/restoreJobId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeRestoreJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [restoreJobId](#API_DescribeRestoreJob_RequestSyntax) **   <a name="Backup-DescribeRestoreJob-request-uri-RestoreJobId"></a>
Identifica in modo univoco il processo che ripristina un punto di ripristino.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeRestoreJob_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeRestoreJob_ResponseSyntax"></a>

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

{
   "AccountId": "string",
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "RestoreTestingPlanArn": "string"
   },
   "CreatedResourceArn": "string",
   "CreationDate": number,
   "DeletionStatus": "string",
   "DeletionStatusMessage": "string",
   "ExpectedCompletionTimeMinutes": number,
   "IamRoleArn": "string",
   "IsParent": boolean,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointCreationDate": number,
   "ResourceType": "string",
   "RestoreJobId": "string",
   "SourceResourceArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## Elementi di risposta
<a name="API_DescribeRestoreJob_ResponseElements"></a>

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) **   <a name="Backup-DescribeRestoreJob-response-AccountId"></a>
Restituisce l'ID account proprietario del processo di ripristino.  
Tipo: stringa  
Modello: `^[0-9]{12}$` 

 ** [BackupSizeInBytes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupSizeInBytes"></a>
La dimensione, in byte, della risorsa ripristinata.  
Tipo: long

 ** [BackupVaultArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupVaultArn"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-CompletionDate"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-CreatedBy"></a>
Contiene informazioni di identificazione sulla creazione di un processo di ripristino.  
Tipo: oggetto [RestoreJobCreator](API_RestoreJobCreator.md)

 ** [CreatedResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedResourceArn"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-CreationDate"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatus"></a>
Lo stato dei dati generati dal test di ripristino.  
Tipo: String  
Valori validi: `DELETING | FAILED | SUCCESSFUL` 

 ** [DeletionStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatusMessage"></a>
Descrive lo stato di eliminazione del processo di ripristino.  
Tipo: String

 ** [ExpectedCompletionTimeMinutes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ExpectedCompletionTimeMinutes"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-IamRoleArn"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-IsParent"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-ParentJobId"></a>
Questo è l'identificatore univoco del processo di ripristino principale per il processo di ripristino selezionato.  
Tipo: String

 ** [PercentDone](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-PercentDone"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointArn"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointCreationDate"></a>
La data di creazione del punto di ripristino creato dal processo di ripristino specificato.  
Tipo: Timestamp

 ** [ResourceType](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ResourceType"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-RestoreJobId"></a>
Identifica in modo univoco il processo che ripristina un punto di ripristino.  
Tipo: String

 ** [SourceResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-SourceResourceArn"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-Status"></a>
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) **   <a name="Backup-DescribeRestoreJob-response-StatusMessage"></a>
Un messaggio che mostra lo stato di un processo per ripristinare un punto di ripristino.  
Tipo: String

 ** [ValidationStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatus"></a>
Lo stato di convalida eseguito sul processo di ripristino indicato.  
Tipo: String  
Valori validi: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING` 

 ** [ValidationStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatusMessage"></a>
Il messaggio sullo stato.  
Tipo: String

## Errori
<a name="API_DescribeRestoreJob_Errors"></a>

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
<a name="API_DescribeRestoreJob_SeeAlso"></a>

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
<a name="API_DescribeScanJob"></a>

Restituisce i dettagli del processo di scansione per l' ScanJobID specificato.

## Sintassi della richiesta
<a name="API_DescribeScanJob_RequestSyntax"></a>

```
GET /scan/jobs/ScanJobId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeScanJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ScanJobId](#API_DescribeScanJob_RequestSyntax) **   <a name="Backup-DescribeScanJob-request-uri-ScanJobId"></a>
Identifica in modo univoco una richiesta di scansione AWS Backup di una risorsa.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DescribeScanJob_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeScanJob_ResponseSyntax"></a>

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

{
   "AccountId": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanVersion": "string",
      "BackupRuleId": "string"
   },
   "CreationDate": number,
   "IamRoleArn": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanId": "string",
   "ScanJobId": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string",
   "ScanResult": { 
      "ScanResultStatus": "string"
   },
   "State": "string",
   "StatusMessage": "string"
}
```

## Elementi di risposta
<a name="API_DescribeScanJob_ResponseElements"></a>

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) **   <a name="Backup-DescribeScanJob-response-AccountId"></a>
Restituisce l'ID dell'account proprietario del processo di scansione.  
Modello: `^[0-9]{12}$`   
Tipo: String

 ** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultArn"></a>
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) **   <a name="Backup-DescribeScanJob-response-BackupVaultName"></a>
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) **   <a name="Backup-DescribeScanJob-response-CompletionDate"></a>
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) **   <a name="Backup-DescribeScanJob-response-CreatedBy"></a>
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) **   <a name="Backup-DescribeScanJob-response-CreationDate"></a>
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) **   <a name="Backup-DescribeScanJob-response-IamRoleArn"></a>
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) **   <a name="Backup-DescribeScanJob-response-MalwareScanner"></a>
Il motore di scansione utilizzato per il processo di scansione corrispondente. Attualmento solo `GUARDUTY` è supportato.  
Tipo: String  
Valori validi: `GUARDDUTY` 

 ** [RecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-RecoveryPointArn"></a>
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) **   <a name="Backup-DescribeScanJob-response-ResourceArn"></a>
Un ARN che identifica in modo univoco la risorsa di origine dell'ARN del punto di ripristino corrispondente.  
Tipo: String

 ** [ResourceName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceName"></a>
Il nome non univoco della risorsa che appartiene al backup specificato.  
Tipo: String

 ** [ResourceType](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceType"></a>
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) **   <a name="Backup-DescribeScanJob-response-ScanBaseRecoveryPointArn"></a>
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) **   <a name="Backup-DescribeScanJob-response-ScanId"></a>
L'ID di scansione generato da Amazon GuardDuty per la richiesta Scan Job ID corrispondente da AWS Backup.  
Tipo: String

 ** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanJobId"></a>
L'ID del processo di scansione a cui è stata identificata in modo univoco la AWS Backup richiesta.  
Tipo: String

 ** [ScanMode](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanMode"></a>
Speciifica il tipo di scansione utilizzato per il processo di scansione.  
Tipo: String  
Valori validi: `FULL_SCAN | INCREMENTAL_SCAN` 

 ** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScannerRoleArn"></a>
Specifica il ruolo IAM dello scanner utilizzato dall'ARN per il processo di scansione.  
Tipo: String

 ** [ScanResult](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanResult"></a>
 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) **   <a name="Backup-DescribeScanJob-response-State"></a>
Lo stato corrente di un processo di scansione.  
Tipo: String  
Valori validi: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-StatusMessage"></a>
Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.  
Tipo: String

## Errori
<a name="API_DescribeScanJob_Errors"></a>

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
<a name="API_DescribeScanJob_SeeAlso"></a>

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
<a name="API_DisassociateBackupVaultMpaApprovalTeam"></a>

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
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/mpaApprovalTeam?delete HTTP/1.1
Content-type: application/json

{
   "RequesterComment": "string"
}
```

## Parametri della richiesta URI
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-DisassociateBackupVaultMpaApprovalTeam-request-uri-BackupVaultName"></a>
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
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [RequesterComment](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-DisassociateBackupVaultMpaApprovalTeam-request-RequesterComment"></a>
Un commento facoltativo che spiega il motivo della dissociazione del team di approvazione MPA dal backup vault.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_DisassociateBackupVaultMpaApprovalTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DisassociateBackupVaultMpaApprovalTeam_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

## Errori
<a name="API_DisassociateBackupVaultMpaApprovalTeam_Errors"></a>

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
<a name="API_DisassociateBackupVaultMpaApprovalTeam_SeeAlso"></a>

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
<a name="API_DisassociateRecoveryPoint"></a>

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
<a name="API_DisassociateRecoveryPoint_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/disassociate HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DisassociateRecoveryPoint_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DisassociateRecoveryPoint_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPoint-request-uri-BackupVaultName"></a>
Il nome univoco di un AWS Backup vault.  
Modello: `^[a-zA-Z0-9\-\_]{2,50}$`   
Obbligatorio: sì

 ** [recoveryPointArn](#API_DisassociateRecoveryPoint_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPoint-request-uri-RecoveryPointArn"></a>
Un Amazon Resource Name (ARN) che identifica in modo univoco un punto di ripristino. AWS Backup   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_DisassociateRecoveryPoint_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DisassociateRecoveryPoint_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DisassociateRecoveryPoint_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_DisassociateRecoveryPoint_Errors"></a>

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
<a name="API_DisassociateRecoveryPoint_SeeAlso"></a>

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
<a name="API_DisassociateRecoveryPointFromParent"></a>

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
<a name="API_DisassociateRecoveryPointFromParent_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_DisassociateRecoveryPointFromParent_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_DisassociateRecoveryPointFromParent_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPointFromParent-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-DisassociateRecoveryPointFromParent-request-uri-RecoveryPointArn"></a>
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
<a name="API_DisassociateRecoveryPointFromParent_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DisassociateRecoveryPointFromParent_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_DisassociateRecoveryPointFromParent_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

## Errori
<a name="API_DisassociateRecoveryPointFromParent_Errors"></a>

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
<a name="API_DisassociateRecoveryPointFromParent_SeeAlso"></a>

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
<a name="API_ExportBackupPlanTemplate"></a>

Restituisce il piano di backup specificato dall'ID del piano come un modello di backup.

## Sintassi della richiesta
<a name="API_ExportBackupPlanTemplate_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/toTemplate/ HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ExportBackupPlanTemplate_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_ExportBackupPlanTemplate_RequestSyntax) **   <a name="Backup-ExportBackupPlanTemplate-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_ExportBackupPlanTemplate_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ExportBackupPlanTemplate_ResponseSyntax"></a>

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

{
   "BackupPlanTemplateJson": "string"
}
```

## Elementi di risposta
<a name="API_ExportBackupPlanTemplate_ResponseElements"></a>

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) **   <a name="Backup-ExportBackupPlanTemplate-response-BackupPlanTemplateJson"></a>
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
<a name="API_ExportBackupPlanTemplate_Errors"></a>

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
<a name="API_ExportBackupPlanTemplate_SeeAlso"></a>

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
<a name="API_GetBackupPlan"></a>

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
<a name="API_GetBackupPlan_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/?MaxScheduledRunsPreview=MaxScheduledRunsPreview&versionId=VersionId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetBackupPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

 ** [MaxScheduledRunsPreview](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-MaxScheduledRunsPreview"></a>
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) **   <a name="Backup-GetBackupPlan-request-uri-VersionId"></a>
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
<a name="API_GetBackupPlan_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBackupPlan_ResponseSyntax"></a>

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

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   },
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "DeletionDate": number,
   "LastExecutionDate": number,
   "ScheduledRunsPreview": [ 
      { 
         "ExecutionTime": number,
         "RuleExecutionType": "string",
         "RuleId": "string"
      }
   ],
   "VersionId": "string"
}
```

## Elementi di risposta
<a name="API_GetBackupPlan_ResponseElements"></a>

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) **   <a name="Backup-GetBackupPlan-response-AdvancedBackupSettings"></a>
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) **   <a name="Backup-GetBackupPlan-response-BackupPlan"></a>
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) **   <a name="Backup-GetBackupPlan-response-BackupPlanArn"></a>
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) **   <a name="Backup-GetBackupPlan-response-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Tipo: String

 ** [CreationDate](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-CreationDate"></a>
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) **   <a name="Backup-GetBackupPlan-response-CreatorRequestId"></a>
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) **   <a name="Backup-GetBackupPlan-response-DeletionDate"></a>
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) **   <a name="Backup-GetBackupPlan-response-LastExecutionDate"></a>
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) **   <a name="Backup-GetBackupPlan-response-ScheduledRunsPreview"></a>
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) **   <a name="Backup-GetBackupPlan-response-VersionId"></a>
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
<a name="API_GetBackupPlan_Errors"></a>

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
<a name="API_GetBackupPlan_SeeAlso"></a>

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
<a name="API_GetBackupPlanFromJSON"></a>

Restituisce un documento JSON valido che specifica un piano di backup o un errore.

## Sintassi della richiesta
<a name="API_GetBackupPlanFromJSON_RequestSyntax"></a>

```
POST /backup/template/json/toPlan HTTP/1.1
Content-type: application/json

{
   "BackupPlanTemplateJson": "string"
}
```

## Parametri della richiesta URI:
<a name="API_GetBackupPlanFromJSON_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_GetBackupPlanFromJSON_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupPlanTemplateJson](#API_GetBackupPlanFromJSON_RequestSyntax) **   <a name="Backup-GetBackupPlanFromJSON-request-BackupPlanTemplateJson"></a>
Un documento del piano di backup fornito dal cliente in formato JSON.  
Tipo: stringa  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_GetBackupPlanFromJSON_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBackupPlanFromJSON_ResponseElements"></a>

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) **   <a name="Backup-GetBackupPlanFromJSON-response-BackupPlan"></a>
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
<a name="API_GetBackupPlanFromJSON_Errors"></a>

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
<a name="API_GetBackupPlanFromJSON_SeeAlso"></a>

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
<a name="API_GetBackupPlanFromTemplate"></a>

Restituisce il modello specificato dal relativo `templateId` come un piano di backup.

## Sintassi della richiesta
<a name="API_GetBackupPlanFromTemplate_RequestSyntax"></a>

```
GET /backup/template/plans/templateId/toPlan HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetBackupPlanFromTemplate_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [templateId](#API_GetBackupPlanFromTemplate_RequestSyntax) **   <a name="Backup-GetBackupPlanFromTemplate-request-uri-BackupPlanTemplateId"></a>
Identifica in modo univoco un modello di piano di backup archiviato.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetBackupPlanFromTemplate_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBackupPlanFromTemplate_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBackupPlanFromTemplate_ResponseElements"></a>

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) **   <a name="Backup-GetBackupPlanFromTemplate-response-BackupPlanDocument"></a>
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
<a name="API_GetBackupPlanFromTemplate_Errors"></a>

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
<a name="API_GetBackupPlanFromTemplate_SeeAlso"></a>

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
<a name="API_GetBackupSelection"></a>

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
<a name="API_GetBackupSelection_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBackupSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_GetBackupSelection_RequestSyntax) **   <a name="Backup-GetBackupSelection-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

 ** [selectionId](#API_GetBackupSelection_RequestSyntax) **   <a name="Backup-GetBackupSelection-request-uri-SelectionId"></a>
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
<a name="API_GetBackupSelection_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBackupSelection_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetBackupSelection_ResponseElements"></a>

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) **   <a name="Backup-GetBackupSelection-response-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Tipo: String

 ** [BackupSelection](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-BackupSelection"></a>
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) **   <a name="Backup-GetBackupSelection-response-CreationDate"></a>
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) **   <a name="Backup-GetBackupSelection-response-CreatorRequestId"></a>
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) **   <a name="Backup-GetBackupSelection-response-SelectionId"></a>
Identifica in modo univoco il corpo di una richiesta per assegnare un set di risorse a un piano di backup.  
Tipo: String

## Errori
<a name="API_GetBackupSelection_Errors"></a>

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
<a name="API_GetBackupSelection_SeeAlso"></a>

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
<a name="API_GetBackupVaultAccessPolicy"></a>

Restituisce il documento relativo alla policy di accesso associato al vault di backup denominato.

## Sintassi della richiesta
<a name="API_GetBackupVaultAccessPolicy_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBackupVaultAccessPolicy_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_GetBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-GetBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
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
<a name="API_GetBackupVaultAccessPolicy_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBackupVaultAccessPolicy_ResponseSyntax"></a>

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

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "Policy": "string"
}
```

## Elementi di risposta
<a name="API_GetBackupVaultAccessPolicy_ResponseElements"></a>

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) **   <a name="Backup-GetBackupVaultAccessPolicy-response-BackupVaultArn"></a>
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) **   <a name="Backup-GetBackupVaultAccessPolicy-response-BackupVaultName"></a>
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) **   <a name="Backup-GetBackupVaultAccessPolicy-response-Policy"></a>
Il documento relativo alla policy di accesso del vault di backup in formato JSON.  
Tipo: String

## Errori
<a name="API_GetBackupVaultAccessPolicy_Errors"></a>

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
<a name="API_GetBackupVaultAccessPolicy_SeeAlso"></a>

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
<a name="API_GetBackupVaultNotifications"></a>

Restituisce le notifiche degli eventi per il vault di backup specificato.

## Sintassi della richiesta
<a name="API_GetBackupVaultNotifications_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetBackupVaultNotifications_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_GetBackupVaultNotifications_RequestSyntax) **   <a name="Backup-GetBackupVaultNotifications-request-uri-BackupVaultName"></a>
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
<a name="API_GetBackupVaultNotifications_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetBackupVaultNotifications_ResponseSyntax"></a>

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

{
   "BackupVaultArn": "string",
   "BackupVaultEvents": [ "string" ],
   "BackupVaultName": "string",
   "SNSTopicArn": "string"
}
```

## Elementi di risposta
<a name="API_GetBackupVaultNotifications_ResponseElements"></a>

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) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultArn"></a>
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) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultEvents"></a>
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) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultName"></a>
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) **   <a name="Backup-GetBackupVaultNotifications-response-SNSTopicArn"></a>
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
<a name="API_GetBackupVaultNotifications_Errors"></a>

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
<a name="API_GetBackupVaultNotifications_SeeAlso"></a>

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
<a name="API_GetLegalHold"></a>

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
<a name="API_GetLegalHold_RequestSyntax"></a>

```
GET /legal-holds/legalHoldId/ HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetLegalHold_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [legalHoldId](#API_GetLegalHold_RequestSyntax) **   <a name="Backup-GetLegalHold-request-uri-LegalHoldId"></a>
L'ID del deposito legale.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetLegalHold_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetLegalHold_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetLegalHold_ResponseElements"></a>

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) **   <a name="Backup-GetLegalHold-response-CancelDescription"></a>
Il motivo per cui è stata rimossa la sospensione legale.  
Tipo: String

 ** [CancellationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancellationDate"></a>
L'ora in cui il blocco legale è stato annullato.  
Tipo: Timestamp

 ** [CreationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CreationDate"></a>
L'ora in cui è stata creata la conservazione legale.  
Tipo: Timestamp

 ** [Description](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Description"></a>
La descrizione della custodia legale.  
Tipo: String

 ** [LegalHoldArn](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldArn"></a>
L'ARN del framework per la conservazione legale specificata. Il formato dell'ARN dipende dal tipo di risorsa.  
Tipo: String

 ** [LegalHoldId](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldId"></a>
L'ID del deposito legale.  
Tipo: String

 ** [RecoveryPointSelection](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RecoveryPointSelection"></a>
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) **   <a name="Backup-GetLegalHold-response-RetainRecordUntil"></a>
La data e l'ora fino alle quali viene conservato il record di conservazione legale.  
Tipo: Timestamp

 ** [Status](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Status"></a>
Lo stato della custodia legale.  
Tipo: String  
Valori validi: `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Title"></a>
Il titolo del deposito legale.  
Tipo: String

## Errori
<a name="API_GetLegalHold_Errors"></a>

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
<a name="API_GetLegalHold_SeeAlso"></a>

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
<a name="API_GetRecoveryPointIndexDetails"></a>

Questa operazione restituisce i metadati e i dettagli specifici dell'indice di backup associato al punto di ripristino specificato.

## Sintassi della richiesta
<a name="API_GetRecoveryPointIndexDetails_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetRecoveryPointIndexDetails_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_GetRecoveryPointIndexDetails_RequestSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-request-uri-RecoveryPointArn"></a>
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
<a name="API_GetRecoveryPointIndexDetails_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetRecoveryPointIndexDetails_ResponseSyntax"></a>

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

{
   "BackupVaultArn": "string",
   "IndexCompletionDate": number,
   "IndexCreationDate": number,
   "IndexDeletionDate": number,
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "RecoveryPointArn": "string",
   "SourceResourceArn": "string",
   "TotalItemsIndexed": number
}
```

## Elementi di risposta
<a name="API_GetRecoveryPointIndexDetails_ResponseElements"></a>

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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-BackupVaultArn"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexCompletionDate"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexCreationDate"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexDeletionDate"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexStatus"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-IndexStatusMessage"></a>
Un messaggio dettagliato che spiega lo stato di un indice di backup associato al punto di ripristino.  
Tipo: String

 ** [RecoveryPointArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-RecoveryPointArn"></a>
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) **   <a name="Backup-GetRecoveryPointIndexDetails-response-SourceResourceArn"></a>
Una stringa di Amazon Resource Name (ARN) che identifica in modo univoco la risorsa di origine.  
Tipo: String

 ** [TotalItemsIndexed](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-TotalItemsIndexed"></a>
Numero di elementi all'interno dell'indice di backup associato al punto di ripristino.  
Tipo: long

## Errori
<a name="API_GetRecoveryPointIndexDetails_Errors"></a>

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
<a name="API_GetRecoveryPointIndexDetails_SeeAlso"></a>

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
<a name="API_GetRecoveryPointRestoreMetadata"></a>

Restituisce un set di coppie chiave-valore che sono state utilizzate per creare il backup.

## Sintassi della richiesta
<a name="API_GetRecoveryPointRestoreMetadata_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/restore-metadata?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetRecoveryPointRestoreMetadata_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [BackupVaultAccountId](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-request-uri-BackupVaultAccountId"></a>
L'ID dell'account del vault di backup specificato.  
Modello: `^[0-9]{12}$` 

 ** [backupVaultName](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-GetRecoveryPointRestoreMetadata-request-uri-RecoveryPointArn"></a>
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
<a name="API_GetRecoveryPointRestoreMetadata_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetRecoveryPointRestoreMetadata_ResponseSyntax"></a>

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

{
   "BackupVaultArn": "string",
   "RecoveryPointArn": "string",
   "ResourceType": "string",
   "RestoreMetadata": { 
      "string" : "string" 
   }
}
```

## Elementi di risposta
<a name="API_GetRecoveryPointRestoreMetadata_ResponseElements"></a>

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) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-BackupVaultArn"></a>
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) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-RecoveryPointArn"></a>
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) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-ResourceType"></a>
Il tipo di risorsa del punto di ripristino.  
Tipo: stringa  
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreMetadata](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-RestoreMetadata"></a>
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
<a name="API_GetRecoveryPointRestoreMetadata_Errors"></a>

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
<a name="API_GetRecoveryPointRestoreMetadata_SeeAlso"></a>

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
<a name="API_GetRestoreJobMetadata"></a>

Questa richiesta restituisce i metadati per il processo di ripristino specificato.

## Sintassi della richiesta
<a name="API_GetRestoreJobMetadata_RequestSyntax"></a>

```
GET /restore-jobs/restoreJobId/metadata HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetRestoreJobMetadata_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [restoreJobId](#API_GetRestoreJobMetadata_RequestSyntax) **   <a name="Backup-GetRestoreJobMetadata-request-uri-RestoreJobId"></a>
Si tratta di un identificatore univoco di un processo di ripristino all'interno AWS Backup.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetRestoreJobMetadata_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetRestoreJobMetadata_ResponseSyntax"></a>

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

{
   "Metadata": { 
      "string" : "string" 
   },
   "RestoreJobId": "string"
}
```

## Elementi di risposta
<a name="API_GetRestoreJobMetadata_ResponseElements"></a>

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) **   <a name="Backup-GetRestoreJobMetadata-response-Metadata"></a>
Contiene i metadati del processo di backup specificato.  
Tipo: mappatura stringa a stringa

 ** [RestoreJobId](#API_GetRestoreJobMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreJobMetadata-response-RestoreJobId"></a>
Si tratta di un identificatore univoco di un processo di ripristino all'interno di. AWS Backup  
Tipo: String

## Errori
<a name="API_GetRestoreJobMetadata_Errors"></a>

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
<a name="API_GetRestoreJobMetadata_SeeAlso"></a>

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
<a name="API_GetRestoreTestingInferredMetadata"></a>

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
<a name="API_GetRestoreTestingInferredMetadata_RequestSyntax"></a>

```
GET /restore-testing/inferred-metadata?BackupVaultAccountId=BackupVaultAccountId&BackupVaultName=BackupVaultName&RecoveryPointArn=RecoveryPointArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_GetRestoreTestingInferredMetadata_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [BackupVaultAccountId](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-BackupVaultAccountId"></a>
L'ID dell'account del vault di backup specificato.

 ** [BackupVaultName](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-RecoveryPointArn"></a>
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
<a name="API_GetRestoreTestingInferredMetadata_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetRestoreTestingInferredMetadata_ResponseSyntax"></a>

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

{
   "InferredMetadata": { 
      "string" : "string" 
   }
}
```

## Elementi di risposta
<a name="API_GetRestoreTestingInferredMetadata_ResponseElements"></a>

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) **   <a name="Backup-GetRestoreTestingInferredMetadata-response-InferredMetadata"></a>
Questa è una mappa di stringhe dei metadati dedotti dalla richiesta.  
Tipo: mappatura stringa a stringa

## Errori
<a name="API_GetRestoreTestingInferredMetadata_Errors"></a>

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
<a name="API_GetRestoreTestingInferredMetadata_SeeAlso"></a>

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
<a name="API_GetRestoreTestingPlan"></a>

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
<a name="API_GetRestoreTestingPlan_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetRestoreTestingPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_GetRestoreTestingPlan_RequestSyntax) **   <a name="Backup-GetRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
Il nome univoco richiesto del piano di test di ripristino.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetRestoreTestingPlan_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetRestoreTestingPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetRestoreTestingPlan_ResponseElements"></a>

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) **   <a name="Backup-GetRestoreTestingPlan-response-RestoreTestingPlan"></a>
Specifica il corpo di un piano di test di ripristino. Include `RestoreTestingPlanName`.  
Tipo: oggetto [RestoreTestingPlanForGet](API_RestoreTestingPlanForGet.md)

## Errori
<a name="API_GetRestoreTestingPlan_Errors"></a>

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
<a name="API_GetRestoreTestingPlan_SeeAlso"></a>

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
<a name="API_GetRestoreTestingSelection"></a>

Restituisce RestoreTestingSelection, che mostra le risorse e gli elementi del piano di test di ripristino.

## Sintassi della richiesta
<a name="API_GetRestoreTestingSelection_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetRestoreTestingSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_GetRestoreTestingSelection_RequestSyntax) **   <a name="Backup-GetRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
Il nome univoco richiesto del piano di test di ripristino.  
Obbligatorio: sì

 ** [RestoreTestingSelectionName](#API_GetRestoreTestingSelection_RequestSyntax) **   <a name="Backup-GetRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
Il nome univoco richiesto della selezione del test di ripristino.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetRestoreTestingSelection_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetRestoreTestingSelection_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetRestoreTestingSelection_ResponseElements"></a>

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) **   <a name="Backup-GetRestoreTestingSelection-response-RestoreTestingSelection"></a>
Nome univoco della selezione del test di ripristino.  
Tipo: oggetto [RestoreTestingSelectionForGet](API_RestoreTestingSelectionForGet.md)

## Errori
<a name="API_GetRestoreTestingSelection_Errors"></a>

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
<a name="API_GetRestoreTestingSelection_SeeAlso"></a>

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
<a name="API_GetSupportedResourceTypes"></a>

Restituisce i tipi di AWS risorse supportati da AWS Backup.

## Sintassi della richiesta
<a name="API_GetSupportedResourceTypes_RequestSyntax"></a>

```
GET /supported-resource-types HTTP/1.1
```

## Parametri della richiesta URI:
<a name="API_GetSupportedResourceTypes_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_GetSupportedResourceTypes_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetSupportedResourceTypes_ResponseSyntax"></a>

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

{
   "ResourceTypes": [ "string" ]
}
```

## Elementi di risposta
<a name="API_GetSupportedResourceTypes_ResponseElements"></a>

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) **   <a name="Backup-GetSupportedResourceTypes-response-ResourceTypes"></a>
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
<a name="API_GetSupportedResourceTypes_Errors"></a>

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
<a name="API_GetSupportedResourceTypes_SeeAlso"></a>

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
<a name="API_GetTieringConfiguration"></a>

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
<a name="API_GetTieringConfiguration_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_GetTieringConfiguration_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [tieringConfigurationName](#API_GetTieringConfiguration_RequestSyntax) **   <a name="Backup-GetTieringConfiguration-request-uri-TieringConfigurationName"></a>
Il nome univoco di una configurazione a più livelli.  
Modello: `^[a-zA-Z0-9_]{1,200}$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_GetTieringConfiguration_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_GetTieringConfiguration_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_GetTieringConfiguration_ResponseElements"></a>

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) **   <a name="Backup-GetTieringConfiguration-response-TieringConfiguration"></a>
Speciifica il corpo di una configurazione a più livelli. Include `TieringConfigurationName`.  
Tipo: oggetto [TieringConfiguration](API_TieringConfiguration.md)

## Errori
<a name="API_GetTieringConfiguration_Errors"></a>

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
<a name="API_GetTieringConfiguration_SeeAlso"></a>

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
<a name="API_ListBackupJobs"></a>

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
<a name="API_ListBackupJobs_RequestSyntax"></a>

```
GET /backup-jobs/?accountId=ByAccountId&backupVaultName=ByBackupVaultName&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByAccountId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByAccountId"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-ByBackupVaultName"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteAfter"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteBefore"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedAfter"></a>
Restituisce solo i processi di backup creati dopo la data specificata.

 ** [ByCreatedBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedBefore"></a>
Restituisce solo i processi di backup creati prima della data specificata.

 ** [ByMessageCategory](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByMessageCategory"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-ByParentJobId"></a>
Si tratta di un filtro per elencare i processi (nidificati) figlio in base all'ID del processo padre.

 ** [ByResourceArn](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceArn"></a>
Restituisce solo i processi di backup che corrispondono alla al nome della risorsa Amazon (ARN) specificata.

 ** [ByResourceType](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceType"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-ByState"></a>
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) **   <a name="Backup-ListBackupJobs-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-NextToken"></a>
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
<a name="API_ListBackupJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupJobs_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_ListBackupJobs_ResponseElements"></a>

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) **   <a name="Backup-ListBackupJobs-response-BackupJobs"></a>
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) **   <a name="Backup-ListBackupJobs-response-NextToken"></a>
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
<a name="API_ListBackupJobs_Errors"></a>

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
<a name="API_ListBackupJobs_SeeAlso"></a>

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
<a name="API_ListBackupJobSummaries"></a>

È 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
<a name="API_ListBackupJobSummaries_RequestSyntax"></a>

```
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupJobSummaries_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AccountId](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AccountId"></a>
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) **   <a name="Backup-ListBackupJobSummaries-request-uri-AggregationPeriod"></a>
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) **   <a name="Backup-ListBackupJobSummaries-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListBackupJobSummaries-request-uri-MessageCategory"></a>
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) **   <a name="Backup-ListBackupJobSummaries-request-uri-NextToken"></a>
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) **   <a name="Backup-ListBackupJobSummaries-request-uri-ResourceType"></a>
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) **   <a name="Backup-ListBackupJobSummaries-request-uri-State"></a>
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
<a name="API_ListBackupJobSummaries_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupJobSummaries_ResponseSyntax"></a>

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

{
   "AggregationPeriod": "string",
   "BackupJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MessageCategory": "string",
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListBackupJobSummaries_ResponseElements"></a>

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) **   <a name="Backup-ListBackupJobSummaries-response-AggregationPeriod"></a>
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) **   <a name="Backup-ListBackupJobSummaries-response-BackupJobSummaries"></a>
Le informazioni di riepilogo.  
Tipo: matrice di oggetti [BackupJobSummary](API_BackupJobSummary.md)

 ** [NextToken](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-NextToken"></a>
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
<a name="API_ListBackupJobSummaries_Errors"></a>

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
<a name="API_ListBackupJobSummaries_SeeAlso"></a>

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
<a name="API_ListBackupPlans"></a>

Elenca i piani di backup attivi per l'account.

## Sintassi della richiesta
<a name="API_ListBackupPlans_RequestSyntax"></a>

```
GET /backup/plans/?includeDeleted=IncludeDeleted&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupPlans_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [IncludeDeleted](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-IncludeDeleted"></a>
Un valore booleano con un valore predefinito di `FALSE` che restituisce i piani di backup eliminati se impostato su `TRUE`.

 ** [MaxResults](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-NextToken"></a>
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
<a name="API_ListBackupPlans_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupPlans_ResponseSyntax"></a>

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

{
   "BackupPlansList": [ 
      { 
         "AdvancedBackupSettings": [ 
            { 
               "BackupOptions": { 
                  "string" : "string" 
               },
               "ResourceType": "string"
            }
         ],
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "DeletionDate": number,
         "LastExecutionDate": number,
         "VersionId": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListBackupPlans_ResponseElements"></a>

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) **   <a name="Backup-ListBackupPlans-response-BackupPlansList"></a>
Informazioni sui piani di backup.  
Tipo: matrice di oggetti [BackupPlansListMember](API_BackupPlansListMember.md)

 ** [NextToken](#API_ListBackupPlans_ResponseSyntax) **   <a name="Backup-ListBackupPlans-response-NextToken"></a>
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
<a name="API_ListBackupPlans_Errors"></a>

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
<a name="API_ListBackupPlans_SeeAlso"></a>

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
<a name="API_ListBackupPlanTemplates"></a>

Elenca i modelli del piano di backup.

## Sintassi della richiesta
<a name="API_ListBackupPlanTemplates_RequestSyntax"></a>

```
GET /backup/template/plans?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupPlanTemplates_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListBackupPlanTemplates_RequestSyntax) **   <a name="Backup-ListBackupPlanTemplates-request-uri-MaxResults"></a>
Il numero massimo di articoli da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListBackupPlanTemplates_RequestSyntax) **   <a name="Backup-ListBackupPlanTemplates-request-uri-NextToken"></a>
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
<a name="API_ListBackupPlanTemplates_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupPlanTemplates_ResponseSyntax"></a>

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

{
   "BackupPlanTemplatesList": [ 
      { 
         "BackupPlanTemplateId": "string",
         "BackupPlanTemplateName": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListBackupPlanTemplates_ResponseElements"></a>

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) **   <a name="Backup-ListBackupPlanTemplates-response-BackupPlanTemplatesList"></a>
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) **   <a name="Backup-ListBackupPlanTemplates-response-NextToken"></a>
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
<a name="API_ListBackupPlanTemplates_Errors"></a>

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
<a name="API_ListBackupPlanTemplates_SeeAlso"></a>

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
<a name="API_ListBackupPlanVersions"></a>

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
<a name="API_ListBackupPlanVersions_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/versions/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupPlanVersions_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

 ** [MaxResults](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-NextToken"></a>
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
<a name="API_ListBackupPlanVersions_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupPlanVersions_ResponseSyntax"></a>

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

{
   "BackupPlanVersionsList": [ 
      { 
         "AdvancedBackupSettings": [ 
            { 
               "BackupOptions": { 
                  "string" : "string" 
               },
               "ResourceType": "string"
            }
         ],
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "DeletionDate": number,
         "LastExecutionDate": number,
         "VersionId": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListBackupPlanVersions_ResponseElements"></a>

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) **   <a name="Backup-ListBackupPlanVersions-response-BackupPlanVersionsList"></a>
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) **   <a name="Backup-ListBackupPlanVersions-response-NextToken"></a>
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
<a name="API_ListBackupPlanVersions_Errors"></a>

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
<a name="API_ListBackupPlanVersions_SeeAlso"></a>

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
<a name="API_ListBackupSelections"></a>

Restituisce un array contenente i metadati delle risorse associate al piano di backup di destinazione.

## Sintassi della richiesta
<a name="API_ListBackupSelections_RequestSyntax"></a>

```
GET /backup/plans/backupPlanId/selections/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupSelections_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Obbligatorio: sì

 ** [MaxResults](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-NextToken"></a>
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
<a name="API_ListBackupSelections_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupSelections_ResponseSyntax"></a>

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

{
   "BackupSelectionsList": [ 
      { 
         "BackupPlanId": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "IamRoleArn": "string",
         "SelectionId": "string",
         "SelectionName": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListBackupSelections_ResponseElements"></a>

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) **   <a name="Backup-ListBackupSelections-response-BackupSelectionsList"></a>
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) **   <a name="Backup-ListBackupSelections-response-NextToken"></a>
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
<a name="API_ListBackupSelections_Errors"></a>

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
<a name="API_ListBackupSelections_SeeAlso"></a>

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
<a name="API_ListBackupVaults"></a>

Restituisce un elenco di container di storage dei punti di ripristino insieme alle informazioni su di essi.

## Sintassi della richiesta
<a name="API_ListBackupVaults_RequestSyntax"></a>

```
GET /backup-vaults/?maxResults=MaxResults&nextToken=NextToken&shared=ByShared&vaultType=ByVaultType HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListBackupVaults_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByShared](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-ByShared"></a>
Questo parametro ordinerà l'elenco di vault in base ai vault condivisi.

 ** [ByVaultType](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-ByVaultType"></a>
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) **   <a name="Backup-ListBackupVaults-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-NextToken"></a>
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
<a name="API_ListBackupVaults_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListBackupVaults_ResponseSyntax"></a>

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

{
   "BackupVaultList": [ 
      { 
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "LockDate": number,
         "Locked": boolean,
         "MaxRetentionDays": number,
         "MinRetentionDays": number,
         "NumberOfRecoveryPoints": number,
         "VaultState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListBackupVaults_ResponseElements"></a>

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) **   <a name="Backup-ListBackupVaults-response-BackupVaultList"></a>
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) **   <a name="Backup-ListBackupVaults-response-NextToken"></a>
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
<a name="API_ListBackupVaults_Errors"></a>

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
<a name="API_ListBackupVaults_SeeAlso"></a>

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
<a name="API_ListCopyJobs"></a>

Restituisce i metadati relativi ai processi di copia.

## Sintassi della richiesta
<a name="API_ListCopyJobs_RequestSyntax"></a>

```
GET /copy-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&destinationVaultArn=ByDestinationVaultArn&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&sourceRecoveryPointArn=BySourceRecoveryPointArn&state=ByState HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListCopyJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByAccountId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByAccountId"></a>
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) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteAfter"></a>
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) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteBefore"></a>
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) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedAfter"></a>
Restituisce solo i processi di copia creati dopo la data specificata.

 ** [ByCreatedBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedBefore"></a>
Restituisce solo i processi di copia creati prima della data specificata.

 ** [ByDestinationVaultArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByDestinationVaultArn"></a>
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) **   <a name="Backup-ListCopyJobs-request-uri-ByMessageCategory"></a>
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) **   <a name="Backup-ListCopyJobs-request-uri-ByParentJobId"></a>
Si tratta di un filtro per elencare i processi (nidificati) figlio in base all'ID del processo padre.

 ** [ByResourceArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceArn"></a>
Restituisce solo i processi di copia che corrispondono al nome della risorsa Amazon (ARN) specificata. 

 ** [ByResourceType](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceType"></a>
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) **   <a name="Backup-ListCopyJobs-request-uri-BySourceRecoveryPointArn"></a>
Filtra i lavori di copia in base al punto di ripristino di origine specificato ARN.

 ** [ByState](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByState"></a>
Restituisce solo i processi di copia che si trovano nello stato specificato.  
Valori validi: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL` 

 ** [MaxResults](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-NextToken"></a>
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
<a name="API_ListCopyJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListCopyJobs_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_ListCopyJobs_ResponseElements"></a>

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) **   <a name="Backup-ListCopyJobs-response-CopyJobs"></a>
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) **   <a name="Backup-ListCopyJobs-response-NextToken"></a>
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
<a name="API_ListCopyJobs_Errors"></a>

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
<a name="API_ListCopyJobs_SeeAlso"></a>

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
<a name="API_ListCopyJobSummaries"></a>

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
<a name="API_ListCopyJobSummaries_RequestSyntax"></a>

```
GET /audit/copy-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListCopyJobSummaries_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AccountId](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-AccountId"></a>
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) **   <a name="Backup-ListCopyJobSummaries-request-uri-AggregationPeriod"></a>
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) **   <a name="Backup-ListCopyJobSummaries-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListCopyJobSummaries-request-uri-MessageCategory"></a>
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) **   <a name="Backup-ListCopyJobSummaries-request-uri-NextToken"></a>
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) **   <a name="Backup-ListCopyJobSummaries-request-uri-ResourceType"></a>
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) **   <a name="Backup-ListCopyJobSummaries-request-uri-State"></a>
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
<a name="API_ListCopyJobSummaries_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListCopyJobSummaries_ResponseSyntax"></a>

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

{
   "AggregationPeriod": "string",
   "CopyJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MessageCategory": "string",
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListCopyJobSummaries_ResponseElements"></a>

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) **   <a name="Backup-ListCopyJobSummaries-response-AggregationPeriod"></a>
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) **   <a name="Backup-ListCopyJobSummaries-response-CopyJobSummaries"></a>
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) **   <a name="Backup-ListCopyJobSummaries-response-NextToken"></a>
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
<a name="API_ListCopyJobSummaries_Errors"></a>

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
<a name="API_ListCopyJobSummaries_SeeAlso"></a>

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
<a name="API_ListFrameworks"></a>

Restituisce un elenco di tutti i framework per un Account AWS and. Regione AWS

## Sintassi della richiesta
<a name="API_ListFrameworks_RequestSyntax"></a>

```
GET /audit/frameworks?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListFrameworks_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListFrameworks_RequestSyntax) **   <a name="Backup-ListFrameworks-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListFrameworks-request-uri-NextToken"></a>
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
<a name="API_ListFrameworks_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListFrameworks_ResponseSyntax"></a>

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

{
   "Frameworks": [ 
      { 
         "CreationTime": number,
         "DeploymentStatus": "string",
         "FrameworkArn": "string",
         "FrameworkDescription": "string",
         "FrameworkName": "string",
         "NumberOfControls": number
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListFrameworks_ResponseElements"></a>

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) **   <a name="Backup-ListFrameworks-response-Frameworks"></a>
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) **   <a name="Backup-ListFrameworks-response-NextToken"></a>
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
<a name="API_ListFrameworks_Errors"></a>

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
<a name="API_ListFrameworks_SeeAlso"></a>

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
<a name="API_ListIndexedRecoveryPoints"></a>

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
<a name="API_ListIndexedRecoveryPoints_RequestSyntax"></a>

```
GET /indexes/recovery-point/?createdAfter=CreatedAfter&createdBefore=CreatedBefore&indexStatus=IndexStatus&maxResults=MaxResults&nextToken=NextToken&resourceType=ResourceType&sourceResourceArn=SourceResourceArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListIndexedRecoveryPoints_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [CreatedAfter](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-CreatedAfter"></a>
Restituisce solo i punti di ripristino indicizzati che sono stati creati dopo la data specificata.

 ** [CreatedBefore](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-CreatedBefore"></a>
Restituisce solo punti di ripristino indicizzati creati prima della data specificata.

 ** [IndexStatus](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-IndexStatus"></a>
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) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-NextToken"></a>
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) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-ResourceType"></a>
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) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-SourceResourceArn"></a>
Una stringa di Amazon Resource Name (ARN) che identifica in modo univoco la risorsa di origine.

## Corpo della richiesta
<a name="API_ListIndexedRecoveryPoints_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListIndexedRecoveryPoints_ResponseSyntax"></a>

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

{
   "IndexedRecoveryPoints": [ 
      { 
         "BackupCreationDate": number,
         "BackupVaultArn": "string",
         "IamRoleArn": "string",
         "IndexCreationDate": number,
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "RecoveryPointArn": "string",
         "ResourceType": "string",
         "SourceResourceArn": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListIndexedRecoveryPoints_ResponseElements"></a>

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) **   <a name="Backup-ListIndexedRecoveryPoints-response-IndexedRecoveryPoints"></a>
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) **   <a name="Backup-ListIndexedRecoveryPoints-response-NextToken"></a>
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
<a name="API_ListIndexedRecoveryPoints_Errors"></a>

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
<a name="API_ListIndexedRecoveryPoints_SeeAlso"></a>

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
<a name="API_ListLegalHolds"></a>

Questa azione restituisce i metadati relativi ai blocchi a fini legali attivi e precedenti.

## Sintassi della richiesta
<a name="API_ListLegalHolds_RequestSyntax"></a>

```
GET /legal-holds/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListLegalHolds_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListLegalHolds_RequestSyntax) **   <a name="Backup-ListLegalHolds-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListLegalHolds-request-uri-NextToken"></a>
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
<a name="API_ListLegalHolds_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListLegalHolds_ResponseSyntax"></a>

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

{
   "LegalHolds": [ 
      { 
         "CancellationDate": number,
         "CreationDate": number,
         "Description": "string",
         "LegalHoldArn": "string",
         "LegalHoldId": "string",
         "Status": "string",
         "Title": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementi di risposta
<a name="API_ListLegalHolds_ResponseElements"></a>

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) **   <a name="Backup-ListLegalHolds-response-LegalHolds"></a>
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) **   <a name="Backup-ListLegalHolds-response-NextToken"></a>
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
<a name="API_ListLegalHolds_Errors"></a>

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
<a name="API_ListLegalHolds_SeeAlso"></a>

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
<a name="API_ListProtectedResources"></a>

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
<a name="API_ListProtectedResources_RequestSyntax"></a>

```
GET /resources/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListProtectedResources_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListProtectedResources_RequestSyntax) **   <a name="Backup-ListProtectedResources-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListProtectedResources_RequestSyntax) **   <a name="Backup-ListProtectedResources-request-uri-NextToken"></a>
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
<a name="API_ListProtectedResources_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListProtectedResources_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "Results": [ 
      { 
         "LastBackupTime": number,
         "LastBackupVaultArn": "string",
         "LastRecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListProtectedResources_ResponseElements"></a>

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) **   <a name="Backup-ListProtectedResources-response-NextToken"></a>
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) **   <a name="Backup-ListProtectedResources-response-Results"></a>
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
<a name="API_ListProtectedResources_Errors"></a>

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
<a name="API_ListProtectedResources_SeeAlso"></a>

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
<a name="API_ListProtectedResourcesByBackupVault"></a>

Questa richiesta elenca le risorse protette corrispondenti a ciascun vault di backup.

## Sintassi della richiesta
<a name="API_ListProtectedResourcesByBackupVault_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/resources/?backupVaultAccountId=BackupVaultAccountId&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListProtectedResourcesByBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [BackupVaultAccountId](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-BackupVaultAccountId"></a>
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) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-NextToken"></a>
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
<a name="API_ListProtectedResourcesByBackupVault_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListProtectedResourcesByBackupVault_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "Results": [ 
      { 
         "LastBackupTime": number,
         "LastBackupVaultArn": "string",
         "LastRecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListProtectedResourcesByBackupVault_ResponseElements"></a>

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) **   <a name="Backup-ListProtectedResourcesByBackupVault-response-NextToken"></a>
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) **   <a name="Backup-ListProtectedResourcesByBackupVault-response-Results"></a>
Questi sono i risultati restituiti per la richiesta. ListProtectedResourcesByBackupVault  
Tipo: matrice di oggetti [ProtectedResource](API_ProtectedResource.md)

## Errori
<a name="API_ListProtectedResourcesByBackupVault_Errors"></a>

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
<a name="API_ListProtectedResourcesByBackupVault_SeeAlso"></a>

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
<a name="API_ListRecoveryPointsByBackupVault"></a>

Restituisce informazioni dettagliate sui punti di ripristino archiviati in un vault di backup.

## Sintassi della richiesta
<a name="API_ListRecoveryPointsByBackupVault_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_ListRecoveryPointsByBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [BackupVaultAccountId](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-BackupVaultAccountId"></a>
Questo parametro ordina l'elenco dei punti di ripristino in base all'ID account.  
Modello: `^[0-9]{12}$` 

 ** [backupVaultName](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByBackupPlanId"></a>
Restituisce solo i punti di ripristino che corrispondono all'ID del piano di backup specificato.

 ** [ByCreatedAfter](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByCreatedAfter"></a>
Restituisce solo i punti di ripristino creati dopo il timestamp specificato.

 ** [ByCreatedBefore](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByCreatedBefore"></a>
Restituisce solo i punti di ripristino creati prima del timestamp specificato.

 ** [ByParentRecoveryPointArn](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByParentRecoveryPointArn"></a>
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) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByResourceArn"></a>
Restituisce solo i processi di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.

 ** [ByResourceType](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByResourceType"></a>
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) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-NextToken"></a>
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
<a name="API_ListRecoveryPointsByBackupVault_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRecoveryPointsByBackupVault_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "AggregatedScanResult": { 
            "FailedScan": boolean,
            "Findings": [ "string" ],
            "LastComputed": number
         },
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CalculatedLifecycle": { 
            "DeleteAt": number,
            "MoveToColdStorageAt": number
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "IamRoleArn": "string",
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "LastRestoreTime": number,
         "Lifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRecoveryPointsByBackupVault_ResponseElements"></a>

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) **   <a name="Backup-ListRecoveryPointsByBackupVault-response-NextToken"></a>
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) **   <a name="Backup-ListRecoveryPointsByBackupVault-response-RecoveryPoints"></a>
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
<a name="API_ListRecoveryPointsByBackupVault_Errors"></a>

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
<a name="API_ListRecoveryPointsByBackupVault_SeeAlso"></a>

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
<a name="API_ListRecoveryPointsByLegalHold"></a>

Questa azione restituisce il punto di ripristino ARNs (Amazon Resource Names) della conservazione legale specificata.

## Sintassi della richiesta
<a name="API_ListRecoveryPointsByLegalHold_RequestSyntax"></a>

```
GET /legal-holds/legalHoldId/recovery-points?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRecoveryPointsByLegalHold_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [legalHoldId](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-LegalHoldId"></a>
L'ID del blocco a fini legali.  
Obbligatorio: sì

 ** [MaxResults](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-NextToken"></a>
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
<a name="API_ListRecoveryPointsByLegalHold_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRecoveryPointsByLegalHold_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupVaultName": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceType": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRecoveryPointsByLegalHold_ResponseElements"></a>

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) **   <a name="Backup-ListRecoveryPointsByLegalHold-response-NextToken"></a>
L'elemento successivo che segue un elenco parziale di risorse restituite.  
Tipo: String

 ** [RecoveryPoints](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-response-RecoveryPoints"></a>
I punti di ripristino.  
Tipo: matrice di oggetti [RecoveryPointMember](API_RecoveryPointMember.md)

## Errori
<a name="API_ListRecoveryPointsByLegalHold_Errors"></a>

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
<a name="API_ListRecoveryPointsByLegalHold_SeeAlso"></a>

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
<a name="API_ListRecoveryPointsByResource"></a>

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
<a name="API_ListRecoveryPointsByResource_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_ListRecoveryPointsByResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ManagedByAWSBackupOnly](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-ManagedByAWSBackupOnly"></a>
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) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-NextToken"></a>
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) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-ResourceArn"></a>
Un ARN che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_ListRecoveryPointsByResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRecoveryPointsByResource_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "AggregatedScanResult": { 
            "FailedScan": boolean,
            "Findings": [ "string" ],
            "LastComputed": number
         },
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRecoveryPointsByResource_ResponseElements"></a>

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) **   <a name="Backup-ListRecoveryPointsByResource-response-NextToken"></a>
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) **   <a name="Backup-ListRecoveryPointsByResource-response-RecoveryPoints"></a>
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
<a name="API_ListRecoveryPointsByResource_Errors"></a>

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
<a name="API_ListRecoveryPointsByResource_SeeAlso"></a>

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
<a name="API_ListReportJobs"></a>

Restituisce i dettagli relativi ai processi di report.

## Sintassi della richiesta
<a name="API_ListReportJobs_RequestSyntax"></a>

```
GET /audit/report-jobs?CreationAfter=ByCreationAfter&CreationBefore=ByCreationBefore&MaxResults=MaxResults&NextToken=NextToken&ReportPlanName=ByReportPlanName&Status=ByStatus HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListReportJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByCreationAfter](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationAfter"></a>
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) **   <a name="Backup-ListReportJobs-request-uri-ByCreationBefore"></a>
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) **   <a name="Backup-ListReportJobs-request-uri-ByReportPlanName"></a>
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) **   <a name="Backup-ListReportJobs-request-uri-ByStatus"></a>
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) **   <a name="Backup-ListReportJobs-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListReportJobs-request-uri-NextToken"></a>
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
<a name="API_ListReportJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListReportJobs_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "ReportJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "ReportDestination": { 
            "S3BucketName": "string",
            "S3Keys": [ "string" ]
         },
         "ReportJobId": "string",
         "ReportPlanArn": "string",
         "ReportTemplate": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListReportJobs_ResponseElements"></a>

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) **   <a name="Backup-ListReportJobs-response-NextToken"></a>
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) **   <a name="Backup-ListReportJobs-response-ReportJobs"></a>
I dettagli relativi ai processi di report in formato JSON.  
Tipo: matrice di oggetti [ReportJob](API_ReportJob.md)

## Errori
<a name="API_ListReportJobs_Errors"></a>

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
<a name="API_ListReportJobs_SeeAlso"></a>

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
<a name="API_ListReportPlans"></a>

Restituisce un elenco dei piani di report. Per informazioni dettagliate su un singolo piano di report, utilizzare `DescribeReportPlan`.

## Sintassi della richiesta
<a name="API_ListReportPlans_RequestSyntax"></a>

```
GET /audit/report-plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListReportPlans_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListReportPlans_RequestSyntax) **   <a name="Backup-ListReportPlans-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListReportPlans-request-uri-NextToken"></a>
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
<a name="API_ListReportPlans_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListReportPlans_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "ReportPlans": [ 
      { 
         "CreationTime": number,
         "DeploymentStatus": "string",
         "LastAttemptedExecutionTime": number,
         "LastSuccessfulExecutionTime": number,
         "ReportDeliveryChannel": { 
            "Formats": [ "string" ],
            "S3BucketName": "string",
            "S3KeyPrefix": "string"
         },
         "ReportPlanArn": "string",
         "ReportPlanDescription": "string",
         "ReportPlanName": "string",
         "ReportSetting": { 
            "Accounts": [ "string" ],
            "FrameworkArns": [ "string" ],
            "NumberOfFrameworks": number,
            "OrganizationUnits": [ "string" ],
            "Regions": [ "string" ],
            "ReportTemplate": "string"
         }
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListReportPlans_ResponseElements"></a>

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) **   <a name="Backup-ListReportPlans-response-NextToken"></a>
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) **   <a name="Backup-ListReportPlans-response-ReportPlans"></a>
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
<a name="API_ListReportPlans_Errors"></a>

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
<a name="API_ListReportPlans_SeeAlso"></a>

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
<a name="API_ListRestoreAccessBackupVaults"></a>

Restituisce un elenco di archivi di backup per l'accesso al ripristino associati a un archivio di backup specificato.

## Sintassi della richiesta
<a name="API_ListRestoreAccessBackupVaults_RequestSyntax"></a>

```
GET /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRestoreAccessBackupVaults_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire nella risposta.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-NextToken"></a>
Il token di impaginazione di una richiesta precedente per recuperare il set successivo di risultati.

## Corpo della richiesta
<a name="API_ListRestoreAccessBackupVaults_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRestoreAccessBackupVaults_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RestoreAccessBackupVaults": [ 
      { 
         "ApprovalDate": number,
         "CreationDate": number,
         "LatestRevokeRequest": { 
            "ExpiryDate": number,
            "InitiationDate": number,
            "MpaSessionArn": "string",
            "Status": "string",
            "StatusMessage": "string"
         },
         "RestoreAccessBackupVaultArn": "string",
         "VaultState": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRestoreAccessBackupVaults_ResponseElements"></a>

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) **   <a name="Backup-ListRestoreAccessBackupVaults-response-NextToken"></a>
Il token di impaginazione da utilizzare in una richiesta successiva per recuperare il successivo set di risultati.  
Tipo: String

 ** [RestoreAccessBackupVaults](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-response-RestoreAccessBackupVaults"></a>
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
<a name="API_ListRestoreAccessBackupVaults_Errors"></a>

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
<a name="API_ListRestoreAccessBackupVaults_SeeAlso"></a>

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
<a name="API_ListRestoreJobs"></a>

Restituisce un elenco di processi AWS Backup avviati per ripristinare una risorsa salvata, inclusi i dettagli sul processo di ripristino.

## Sintassi della richiesta
<a name="API_ListRestoreJobs_RequestSyntax"></a>

```
GET /restore-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentJobId=ByParentJobId&resourceType=ByResourceType&restoreTestingPlanArn=ByRestoreTestingPlanArn&status=ByStatus HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRestoreJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByAccountId](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByAccountId"></a>
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) **   <a name="Backup-ListRestoreJobs-request-uri-ByCompleteAfter"></a>
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) **   <a name="Backup-ListRestoreJobs-request-uri-ByCompleteBefore"></a>
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) **   <a name="Backup-ListRestoreJobs-request-uri-ByCreatedAfter"></a>
Restituisce solo i processi di ripristino creati dopo la data specificata.

 ** [ByCreatedBefore](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCreatedBefore"></a>
Restituisce solo i processi di ripristino creati prima della data specificata.

 ** [ByParentJobId](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByParentJobId"></a>
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) **   <a name="Backup-ListRestoreJobs-request-uri-ByResourceType"></a>
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) **   <a name="Backup-ListRestoreJobs-request-uri-ByRestoreTestingPlanArn"></a>
Restituisce solo i processi di test di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.

 ** [ByStatus](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByStatus"></a>
Restituisce solo i processi di ripristino associati allo stato processo specificato.  
Valori validi: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [MaxResults](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-NextToken"></a>
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
<a name="API_ListRestoreJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRestoreJobs_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "IsParent": boolean,
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRestoreJobs_ResponseElements"></a>

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) **   <a name="Backup-ListRestoreJobs-response-NextToken"></a>
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) **   <a name="Backup-ListRestoreJobs-response-RestoreJobs"></a>
Un array di oggetti contenenti informazioni dettagliate sui processi per ripristinare le risorse salvate.  
Tipo: matrice di oggetti [RestoreJobsListMember](API_RestoreJobsListMember.md)

## Errori
<a name="API_ListRestoreJobs_Errors"></a>

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
<a name="API_ListRestoreJobs_SeeAlso"></a>

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
<a name="API_ListRestoreJobsByProtectedResource"></a>

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
<a name="API_ListRestoreJobsByProtectedResource_RequestSyntax"></a>

```
GET /resources/resourceArn/restore-jobs/?maxResults=MaxResults&nextToken=NextToken&recoveryPointCreationDateAfter=ByRecoveryPointCreationDateAfter&recoveryPointCreationDateBefore=ByRecoveryPointCreationDateBefore&status=ByStatus HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRestoreJobsByProtectedResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByRecoveryPointCreationDateAfter](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByRecoveryPointCreationDateAfter"></a>
Restituisce solo i processi di ripristino dei punti di ripristino creati dopo la data specificata.

 ** [ByRecoveryPointCreationDateBefore](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByRecoveryPointCreationDateBefore"></a>
Restituisce solo i processi di ripristino dei punti di ripristino creati prima della data specificata.

 ** [ByStatus](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByStatus"></a>
Restituisce solo i processi di ripristino associati allo stato processo specificato.  
Valori validi: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [MaxResults](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-NextToken"></a>
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) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ResourceArn"></a>
Restituisce solo i processi di ripristino che corrispondono al nome della risorsa Amazon (ARN) specificata.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_ListRestoreJobsByProtectedResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRestoreJobsByProtectedResource_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "IsParent": boolean,
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRestoreJobsByProtectedResource_ResponseElements"></a>

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) **   <a name="Backup-ListRestoreJobsByProtectedResource-response-NextToken"></a>
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) **   <a name="Backup-ListRestoreJobsByProtectedResource-response-RestoreJobs"></a>
Un array di oggetti contenenti informazioni dettagliate sui processi per ripristinare le risorse salvate.  
Tipo: matrice di oggetti [RestoreJobsListMember](API_RestoreJobsListMember.md)

## Errori
<a name="API_ListRestoreJobsByProtectedResource_Errors"></a>

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
<a name="API_ListRestoreJobsByProtectedResource_SeeAlso"></a>

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
<a name="API_ListRestoreJobSummaries"></a>

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
<a name="API_ListRestoreJobSummaries_RequestSyntax"></a>

```
GET /audit/restore-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRestoreJobSummaries_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AccountId](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-AccountId"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-request-uri-AggregationPeriod"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-request-uri-NextToken"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-request-uri-ResourceType"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-request-uri-State"></a>
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
<a name="API_ListRestoreJobSummaries_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRestoreJobSummaries_ResponseSyntax"></a>

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

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "RestoreJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRestoreJobSummaries_ResponseElements"></a>

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) **   <a name="Backup-ListRestoreJobSummaries-response-AggregationPeriod"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-response-NextToken"></a>
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) **   <a name="Backup-ListRestoreJobSummaries-response-RestoreJobSummaries"></a>
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
<a name="API_ListRestoreJobSummaries_Errors"></a>

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
<a name="API_ListRestoreJobSummaries_SeeAlso"></a>

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
<a name="API_ListRestoreTestingPlans"></a>

Restituisce un elenco di piani di test di ripristino.

## Sintassi della richiesta
<a name="API_ListRestoreTestingPlans_RequestSyntax"></a>

```
GET /restore-testing/plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRestoreTestingPlans_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListRestoreTestingPlans_RequestSyntax) **   <a name="Backup-ListRestoreTestingPlans-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListRestoreTestingPlans_RequestSyntax) **   <a name="Backup-ListRestoreTestingPlans-request-uri-NextToken"></a>
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
<a name="API_ListRestoreTestingPlans_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRestoreTestingPlans_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RestoreTestingPlans": [ 
      { 
         "CreationTime": number,
         "LastExecutionTime": number,
         "LastUpdateTime": number,
         "RestoreTestingPlanArn": "string",
         "RestoreTestingPlanName": "string",
         "ScheduleExpression": "string",
         "ScheduleExpressionTimezone": "string",
         "StartWindowHours": number
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRestoreTestingPlans_ResponseElements"></a>

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) **   <a name="Backup-ListRestoreTestingPlans-response-NextToken"></a>
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) **   <a name="Backup-ListRestoreTestingPlans-response-RestoreTestingPlans"></a>
È l'elenco dei piani di test di ripristino restituito.  
Tipo: matrice di oggetti [RestoreTestingPlanForList](API_RestoreTestingPlanForList.md)

## Errori
<a name="API_ListRestoreTestingPlans_Errors"></a>

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
<a name="API_ListRestoreTestingPlans_SeeAlso"></a>

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
<a name="API_ListRestoreTestingSelections"></a>

Restituisce un elenco di selezioni del test di ripristino. Può essere filtrato per `MaxResults` e `RestoreTestingPlanName`.

## Sintassi della richiesta
<a name="API_ListRestoreTestingSelections_RequestSyntax"></a>

```
GET /restore-testing/plans/RestoreTestingPlanName/selections?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListRestoreTestingSelections_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-NextToken"></a>
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) **   <a name="Backup-ListRestoreTestingSelections-request-uri-RestoreTestingPlanName"></a>
Restituisce le selezioni del test di ripristino in base al nome del piano di test di ripristino specificato.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_ListRestoreTestingSelections_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListRestoreTestingSelections_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "RestoreTestingSelections": [ 
      { 
         "CreationTime": number,
         "IamRoleArn": "string",
         "ProtectedResourceType": "string",
         "RestoreTestingPlanName": "string",
         "RestoreTestingSelectionName": "string",
         "ValidationWindowHours": number
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListRestoreTestingSelections_ResponseElements"></a>

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) **   <a name="Backup-ListRestoreTestingSelections-response-NextToken"></a>
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) **   <a name="Backup-ListRestoreTestingSelections-response-RestoreTestingSelections"></a>
Le selezioni del test di ripristino restituite associate al piano di test di ripristino.  
Tipo: matrice di oggetti [RestoreTestingSelectionForList](API_RestoreTestingSelectionForList.md)

## Errori
<a name="API_ListRestoreTestingSelections_Errors"></a>

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
<a name="API_ListRestoreTestingSelections_SeeAlso"></a>

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
<a name="API_ListScanJobs"></a>

Restituisce un elenco di processi di scansione esistenti per un account autenticato negli ultimi 30 giorni.

## Sintassi della richiesta
<a name="API_ListScanJobs_RequestSyntax"></a>

```
GET /scan/jobs?ByAccountId=ByAccountId&ByBackupVaultName=ByBackupVaultName&ByCompleteAfter=ByCompleteAfter&ByCompleteBefore=ByCompleteBefore&ByMalwareScanner=ByMalwareScanner&ByRecoveryPointArn=ByRecoveryPointArn&ByResourceArn=ByResourceArn&ByResourceType=ByResourceType&ByScanResultStatus=ByScanResultStatus&ByState=ByState&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListScanJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByAccountId](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByAccountId"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-ByBackupVaultName"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteAfter"></a>
Restituisce solo i lavori di scansione completati dopo una data espressa in formato Unix e Coordinated Universal Time (UTC).

 ** [ByCompleteBefore](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteBefore"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-ByMalwareScanner"></a>
Restituisce solo i processi di scansione per lo scanner antimalware specificato. Attualmente supporta solo`GUARDDUTY`.  
Valori validi: `GUARDDUTY` 

 ** [ByRecoveryPointArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByRecoveryPointArn"></a>
Restituisce solo i processi di scansione eseguiti sul punto di ripristino specificato.

 ** [ByResourceArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceArn"></a>
Restituisce solo i processi di scansione che corrispondono alla risorsa Amazon Resource Name (ARN) specificata.

 ** [ByResourceType](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceType"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-ByScanResultStatus"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-ByState"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListScanJobs-request-uri-NextToken"></a>
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
<a name="API_ListScanJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListScanJobs_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "ScanJobs": [ 
      { 
         "AccountId": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "IamRoleArn": "string",
         "MalwareScanner": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "ScanBaseRecoveryPointArn": "string",
         "ScanId": "string",
         "ScanJobId": "string",
         "ScanMode": "string",
         "ScannerRoleArn": "string",
         "ScanResult": { 
            "ScanResultStatus": "string"
         },
         "State": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListScanJobs_ResponseElements"></a>

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) **   <a name="Backup-ListScanJobs-response-NextToken"></a>
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) **   <a name="Backup-ListScanJobs-response-ScanJobs"></a>
Una serie di strutture contenenti metadati sui lavori di scansione restituiti in formato JSON.  
Tipo: matrice di oggetti [ScanJob](API_ScanJob.md)

## Errori
<a name="API_ListScanJobs_Errors"></a>

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
<a name="API_ListScanJobs_SeeAlso"></a>

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
<a name="API_ListScanJobSummaries"></a>

Si tratta di una richiesta di riepilogo dei processi di scansione creati o in esecuzione negli ultimi 30 giorni.

## Sintassi della richiesta
<a name="API_ListScanJobSummaries_RequestSyntax"></a>

```
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListScanJobSummaries_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AccountId](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AccountId"></a>
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) **   <a name="Backup-ListScanJobSummaries-request-uri-AggregationPeriod"></a>
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) **   <a name="Backup-ListScanJobSummaries-request-uri-MalwareScanner"></a>
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) **   <a name="Backup-ListScanJobSummaries-request-uri-MaxResults"></a>
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) **   <a name="Backup-ListScanJobSummaries-request-uri-NextToken"></a>
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) **   <a name="Backup-ListScanJobSummaries-request-uri-ResourceType"></a>
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) **   <a name="Backup-ListScanJobSummaries-request-uri-ScanResultStatus"></a>
Restituisce solo i lavori di scansione per i risultati di scansione specificati.  
Valori validi: `NO_THREATS_FOUND | THREATS_FOUND` 

 ** [State](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-State"></a>
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
<a name="API_ListScanJobSummaries_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListScanJobSummaries_ResponseSyntax"></a>

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

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "ScanJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MalwareScanner": "string",
         "Region": "string",
         "ResourceType": "string",
         "ScanResultStatus": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListScanJobSummaries_ResponseElements"></a>

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) **   <a name="Backup-ListScanJobSummaries-response-AggregationPeriod"></a>
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) **   <a name="Backup-ListScanJobSummaries-response-NextToken"></a>
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) **   <a name="Backup-ListScanJobSummaries-response-ScanJobSummaries"></a>
Le informazioni di riepilogo.  
Tipo: matrice di oggetti [ScanJobSummary](API_ScanJobSummary.md)

## Errori
<a name="API_ListScanJobSummaries_Errors"></a>

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
<a name="API_ListScanJobSummaries_SeeAlso"></a>

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
<a name="API_ListTags"></a>

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
<a name="API_ListTags_RequestSyntax"></a>

```
GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListTags_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-NextToken"></a>
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) **   <a name="Backup-ListTags-request-uri-ResourceArn"></a>
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
<a name="API_ListTags_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListTags_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Elementi di risposta
<a name="API_ListTags_ResponseElements"></a>

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) **   <a name="Backup-ListTags-response-NextToken"></a>
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) **   <a name="Backup-ListTags-response-Tags"></a>
Informazioni sui tag.  
Tipo: mappatura stringa a stringa

## Errori
<a name="API_ListTags_Errors"></a>

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
<a name="API_ListTags_SeeAlso"></a>

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
<a name="API_ListTieringConfigurations"></a>

Restituisce un elenco di configurazioni di tiering.

## Sintassi della richiesta
<a name="API_ListTieringConfigurations_RequestSyntax"></a>

```
GET /tiering-configurations/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_ListTieringConfigurations_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [MaxResults](#API_ListTieringConfigurations_RequestSyntax) **   <a name="Backup-ListTieringConfigurations-request-uri-MaxResults"></a>
Il numero massimo di elementi da restituire.  
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

 ** [NextToken](#API_ListTieringConfigurations_RequestSyntax) **   <a name="Backup-ListTieringConfigurations-request-uri-NextToken"></a>
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
<a name="API_ListTieringConfigurations_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListTieringConfigurations_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "TieringConfigurations": [ 
      { 
         "BackupVaultName": "string",
         "CreationTime": number,
         "LastUpdatedTime": number,
         "TieringConfigurationArn": "string",
         "TieringConfigurationName": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListTieringConfigurations_ResponseElements"></a>

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) **   <a name="Backup-ListTieringConfigurations-response-NextToken"></a>
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) **   <a name="Backup-ListTieringConfigurations-response-TieringConfigurations"></a>
Una serie di configurazioni di tiering restituite dalla chiamata. `ListTieringConfigurations`  
Tipo: matrice di oggetti [TieringConfigurationsListMember](API_TieringConfigurationsListMember.md)

## Errori
<a name="API_ListTieringConfigurations_Errors"></a>

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
<a name="API_ListTieringConfigurations_SeeAlso"></a>

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
<a name="API_PutBackupVaultAccessPolicy"></a>

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
<a name="API_PutBackupVaultAccessPolicy_RequestSyntax"></a>

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

{
   "Policy": "string"
}
```

## Parametri della richiesta URI
<a name="API_PutBackupVaultAccessPolicy_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_PutBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-PutBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
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
<a name="API_PutBackupVaultAccessPolicy_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Policy](#API_PutBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-PutBackupVaultAccessPolicy-request-Policy"></a>
Il documento relativo alla policy di accesso del vault di backup in formato JSON.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_PutBackupVaultAccessPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_PutBackupVaultAccessPolicy_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_PutBackupVaultAccessPolicy_Errors"></a>

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
<a name="API_PutBackupVaultAccessPolicy_SeeAlso"></a>

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
<a name="API_PutBackupVaultLockConfiguration"></a>

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
<a name="API_PutBackupVaultLockConfiguration_RequestSyntax"></a>

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

{
   "ChangeableForDays": number,
   "MaxRetentionDays": number,
   "MinRetentionDays": number
}
```

## Parametri della richiesta URI
<a name="API_PutBackupVaultLockConfiguration_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-uri-BackupVaultName"></a>
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
<a name="API_PutBackupVaultLockConfiguration_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ChangeableForDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-ChangeableForDays"></a>
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) **   <a name="Backup-PutBackupVaultLockConfiguration-request-MaxRetentionDays"></a>
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) **   <a name="Backup-PutBackupVaultLockConfiguration-request-MinRetentionDays"></a>
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
<a name="API_PutBackupVaultLockConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_PutBackupVaultLockConfiguration_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_PutBackupVaultLockConfiguration_Errors"></a>

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
<a name="API_PutBackupVaultLockConfiguration_SeeAlso"></a>

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
<a name="API_PutBackupVaultNotifications"></a>

Attiva le notifiche su un vault di backup per l'argomento e gli eventi specificati.

## Sintassi della richiesta
<a name="API_PutBackupVaultNotifications_RequestSyntax"></a>

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

{
   "BackupVaultEvents": [ "string" ],
   "SNSTopicArn": "string"
}
```

## Parametri della richiesta URI
<a name="API_PutBackupVaultNotifications_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-uri-BackupVaultName"></a>
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
<a name="API_PutBackupVaultNotifications_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupVaultEvents](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-BackupVaultEvents"></a>
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) **   <a name="Backup-PutBackupVaultNotifications-request-SNSTopicArn"></a>
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
<a name="API_PutBackupVaultNotifications_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_PutBackupVaultNotifications_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_PutBackupVaultNotifications_Errors"></a>

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
<a name="API_PutBackupVaultNotifications_SeeAlso"></a>

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
<a name="API_PutRestoreValidationResult"></a>

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
<a name="API_PutRestoreValidationResult_RequestSyntax"></a>

```
PUT /restore-jobs/restoreJobId/validations HTTP/1.1
Content-type: application/json

{
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## Parametri della richiesta URI
<a name="API_PutRestoreValidationResult_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [restoreJobId](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-uri-RestoreJobId"></a>
Si tratta di un identificatore univoco di un processo di ripristino all'interno AWS Backup.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_PutRestoreValidationResult_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ValidationStatus](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-ValidationStatus"></a>
Lo stato della convalida del ripristino.  
Tipo: String  
Valori validi: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`   
Obbligatorio: sì

 ** [ValidationStatusMessage](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-ValidationStatusMessage"></a>
È 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
<a name="API_PutRestoreValidationResult_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementi di risposta
<a name="API_PutRestoreValidationResult_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 204 con un corpo HTTP vuoto.

## Errori
<a name="API_PutRestoreValidationResult_Errors"></a>

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
<a name="API_PutRestoreValidationResult_SeeAlso"></a>

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
<a name="API_RevokeRestoreAccessBackupVault"></a>

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
<a name="API_RevokeRestoreAccessBackupVault_RequestSyntax"></a>

```
DELETE /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/restoreAccessBackupVaultArn?requesterComment=RequesterComment HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_RevokeRestoreAccessBackupVault_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-RequesterComment"></a>
Un commento che spiega il motivo della revoca dell'accesso al repository di backup per l'accesso di ripristino.

 ** [restoreAccessBackupVaultArn](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-RestoreAccessBackupVaultArn"></a>
L'ARN del repository di backup per l'accesso al ripristino da revocare.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_RevokeRestoreAccessBackupVault_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_RevokeRestoreAccessBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_RevokeRestoreAccessBackupVault_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_RevokeRestoreAccessBackupVault_Errors"></a>

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
<a name="API_RevokeRestoreAccessBackupVault_SeeAlso"></a>

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
<a name="API_StartBackupJob"></a>

Avvia un processo di backup on demand per la risorsa specificata.

## Sintassi della richiesta
<a name="API_StartBackupJob_RequestSyntax"></a>

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

{
   "BackupOptions": { 
      "string" : "string" 
   },
   "BackupVaultName": "string",
   "CompleteWindowMinutes": number,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Index": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "LogicallyAirGappedBackupVaultArn": "string",
   "RecoveryPointTags": { 
      "string" : "string" 
   },
   "ResourceArn": "string",
   "StartWindowMinutes": number
}
```

## Parametri della richiesta URI:
<a name="API_StartBackupJob_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartBackupJob_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupOptions](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupOptions"></a>
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) **   <a name="Backup-StartBackupJob-request-BackupVaultName"></a>
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) **   <a name="Backup-StartBackupJob-request-CompleteWindowMinutes"></a>
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) **   <a name="Backup-StartBackupJob-request-IamRoleArn"></a>
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) **   <a name="Backup-StartBackupJob-request-IdempotencyToken"></a>
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) **   <a name="Backup-StartBackupJob-request-Index"></a>
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) **   <a name="Backup-StartBackupJob-request-Lifecycle"></a>
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) **   <a name="Backup-StartBackupJob-request-LogicallyAirGappedBackupVaultArn"></a>
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) **   <a name="Backup-StartBackupJob-request-RecoveryPointTags"></a>
I tag da assegnare alle risorse.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [ResourceArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-ResourceArn"></a>
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) **   <a name="Backup-StartBackupJob-request-StartWindowMinutes"></a>
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
<a name="API_StartBackupJob_ResponseSyntax"></a>

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

{
   "BackupJobId": "string",
   "CreationDate": number,
   "IsParent": boolean,
   "RecoveryPointArn": "string"
}
```

## Elementi di risposta
<a name="API_StartBackupJob_ResponseElements"></a>

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) **   <a name="Backup-StartBackupJob-response-BackupJobId"></a>
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.  
Tipo: String

 ** [CreationDate](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-CreationDate"></a>
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) **   <a name="Backup-StartBackupJob-response-IsParent"></a>
Questo è un valore booleano restituito che indica che si tratta di un processo di backup (composito) padre.  
Tipo: Booleano

 ** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-RecoveryPointArn"></a>
 *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
<a name="API_StartBackupJob_Errors"></a>

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
<a name="API_StartBackupJob_SeeAlso"></a>

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
<a name="API_StartCopyJob"></a>

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
<a name="API_StartCopyJob_RequestSyntax"></a>

```
PUT /copy-jobs HTTP/1.1
Content-type: application/json

{
   "DestinationBackupVaultArn": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string",
   "SourceBackupVaultName": "string"
}
```

## Parametri della richiesta URI:
<a name="API_StartCopyJob_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartCopyJob_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-DestinationBackupVaultArn"></a>
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) **   <a name="Backup-StartCopyJob-request-IamRoleArn"></a>
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) **   <a name="Backup-StartCopyJob-request-IdempotencyToken"></a>
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) **   <a name="Backup-StartCopyJob-request-Lifecycle"></a>
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) **   <a name="Backup-StartCopyJob-request-RecoveryPointArn"></a>
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) **   <a name="Backup-StartCopyJob-request-SourceBackupVaultName"></a>
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
<a name="API_StartCopyJob_ResponseSyntax"></a>

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

{
   "CopyJobId": "string",
   "CreationDate": number,
   "IsParent": boolean
}
```

## Elementi di risposta
<a name="API_StartCopyJob_ResponseElements"></a>

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) **   <a name="Backup-StartCopyJob-response-CopyJobId"></a>
Identifica in modo univoco un processo di copia.  
Tipo: String

 ** [CreationDate](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-CreationDate"></a>
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) **   <a name="Backup-StartCopyJob-response-IsParent"></a>
Questo è un valore booleano restituito che indica che si tratta di un processo di copia (composito) padre.  
Tipo: Booleano

## Errori
<a name="API_StartCopyJob_Errors"></a>

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
<a name="API_StartCopyJob_SeeAlso"></a>

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
<a name="API_StartReportJob"></a>

Avvia un processo di report on demand per il piano di report specificato.

## Sintassi della richiesta
<a name="API_StartReportJob_RequestSyntax"></a>

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

{
   "IdempotencyToken": "string"
}
```

## Parametri della richiesta URI
<a name="API_StartReportJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [reportPlanName](#API_StartReportJob_RequestSyntax) **   <a name="Backup-StartReportJob-request-uri-ReportPlanName"></a>
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
<a name="API_StartReportJob_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [IdempotencyToken](#API_StartReportJob_RequestSyntax) **   <a name="Backup-StartReportJob-request-IdempotencyToken"></a>
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
<a name="API_StartReportJob_ResponseSyntax"></a>

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

{
   "ReportJobId": "string"
}
```

## Elementi di risposta
<a name="API_StartReportJob_ResponseElements"></a>

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) **   <a name="Backup-StartReportJob-response-ReportJobId"></a>
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
<a name="API_StartReportJob_Errors"></a>

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
<a name="API_StartReportJob_SeeAlso"></a>

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
<a name="API_StartRestoreJob"></a>

Recupera la risorsa salvata identificata da un nome della risorsa Amazon (ARN).

## Sintassi della richiesta
<a name="API_StartRestoreJob_RequestSyntax"></a>

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

{
   "CopySourceTagsToRestoredResource": boolean,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Metadata": { 
      "string" : "string" 
   },
   "RecoveryPointArn": "string",
   "ResourceType": "string"
}
```

## Parametri della richiesta URI:
<a name="API_StartRestoreJob_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartRestoreJob_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-CopySourceTagsToRestoredResource"></a>
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) **   <a name="Backup-StartRestoreJob-request-IamRoleArn"></a>
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) **   <a name="Backup-StartRestoreJob-request-IdempotencyToken"></a>
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) **   <a name="Backup-StartRestoreJob-request-Metadata"></a>
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) **   <a name="Backup-StartRestoreJob-request-RecoveryPointArn"></a>
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) **   <a name="Backup-StartRestoreJob-request-ResourceType"></a>
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
<a name="API_StartRestoreJob_ResponseSyntax"></a>

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

{
   "RestoreJobId": "string"
}
```

## Elementi di risposta
<a name="API_StartRestoreJob_ResponseElements"></a>

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) **   <a name="Backup-StartRestoreJob-response-RestoreJobId"></a>
Identifica in modo univoco il processo che ripristina un punto di ripristino.  
Tipo: String

## Errori
<a name="API_StartRestoreJob_Errors"></a>

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
<a name="API_StartRestoreJob_SeeAlso"></a>

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
<a name="API_StartScanJob"></a>

Avvia la scansione dei lavori per risorse specifiche.

## Sintassi della richiesta
<a name="API_StartScanJob_RequestSyntax"></a>

```
PUT /scan/job HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string"
}
```

## Parametri della richiesta URI:
<a name="API_StartScanJob_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartScanJob_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupVaultName](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-BackupVaultName"></a>
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) **   <a name="Backup-StartScanJob-request-IamRoleArn"></a>
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) **   <a name="Backup-StartScanJob-request-IdempotencyToken"></a>
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) **   <a name="Backup-StartScanJob-request-MalwareScanner"></a>
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) **   <a name="Backup-StartScanJob-request-RecoveryPointArn"></a>
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) **   <a name="Backup-StartScanJob-request-ScanBaseRecoveryPointArn"></a>
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) **   <a name="Backup-StartScanJob-request-ScanMode"></a>
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) **   <a name="Backup-StartScanJob-request-ScannerRoleArn"></a>
Specificato l'ARN del ruolo dello scanner IAM.  
Tipo: stringa  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_StartScanJob_ResponseSyntax"></a>

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

{
   "CreationDate": number,
   "ScanJobId": "string"
}
```

## Elementi di risposta
<a name="API_StartScanJob_ResponseElements"></a>

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) **   <a name="Backup-StartScanJob-response-CreationDate"></a>
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) **   <a name="Backup-StartScanJob-response-ScanJobId"></a>
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.  
Tipo: String

## Errori
<a name="API_StartScanJob_Errors"></a>

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
<a name="API_StartScanJob_SeeAlso"></a>

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
<a name="API_StopBackupJob"></a>

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
<a name="API_StopBackupJob_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_StopBackupJob_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupJobId](#API_StopBackupJob_RequestSyntax) **   <a name="Backup-StopBackupJob-request-uri-BackupJobId"></a>
Identifica in modo univoco una richiesta di backup di AWS Backup una risorsa.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_StopBackupJob_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_StopBackupJob_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_StopBackupJob_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_StopBackupJob_Errors"></a>

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
<a name="API_StopBackupJob_SeeAlso"></a>

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
<a name="API_TagResource"></a>

Assegna un insieme di coppie chiave-valore a una risorsa.

## Sintassi della richiesta
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI
<a name="API_TagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="Backup-TagResource-request-uri-ResourceArn"></a>
L'ARN che identifica in modo univoco la risorsa.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_TagResource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="Backup-TagResource-request-Tags"></a>
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
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_TagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_TagResource_Errors"></a>

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
<a name="API_TagResource_SeeAlso"></a>

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
<a name="API_UntagResource"></a>

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
<a name="API_UntagResource_RequestSyntax"></a>

```
POST /untag/resourceArn HTTP/1.1
Content-type: application/json

{
   "TagKeyList": [ "string" ]
}
```

## Parametri della richiesta URI
<a name="API_UntagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="Backup-UntagResource-request-uri-ResourceArn"></a>
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
<a name="API_UntagResource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [TagKeyList](#API_UntagResource_RequestSyntax) **   <a name="Backup-UntagResource-request-TagKeyList"></a>
Le chiavi per identificare quali tag chiave-valore rimuovere da una risorsa.  
Tipo: array di stringhe  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_UntagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UntagResource_Errors"></a>

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
<a name="API_UntagResource_SeeAlso"></a>

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
<a name="API_UpdateBackupPlan"></a>

Aggiorna il piano di backup specificato. La nuova versione è identificata in modo univoco dal relativo ID.

## Sintassi della richiesta
<a name="API_UpdateBackupPlan_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_UpdateBackupPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupPlanId](#API_UpdateBackupPlan_RequestSyntax) **   <a name="Backup-UpdateBackupPlan-request-uri-BackupPlanId"></a>
L'ID del piano di backup.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_UpdateBackupPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupPlan](#API_UpdateBackupPlan_RequestSyntax) **   <a name="Backup-UpdateBackupPlan-request-BackupPlan"></a>
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
<a name="API_UpdateBackupPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_UpdateBackupPlan_ResponseElements"></a>

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) **   <a name="Backup-UpdateBackupPlan-response-AdvancedBackupSettings"></a>
Contiene un elenco di `BackupOptions` per ogni tipo di risorsa.  
Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md)

 ** [BackupPlanArn](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-BackupPlanArn"></a>
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) **   <a name="Backup-UpdateBackupPlan-response-BackupPlanId"></a>
Identifica in modo univoco un piano di backup.  
Tipo: String

 ** [CreationDate](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-CreationDate"></a>
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) **   <a name="Backup-UpdateBackupPlan-response-ScanSettings"></a>
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) **   <a name="Backup-UpdateBackupPlan-response-VersionId"></a>
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
<a name="API_UpdateBackupPlan_Errors"></a>

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
<a name="API_UpdateBackupPlan_SeeAlso"></a>

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
<a name="API_UpdateFramework"></a>

Aggiorna il framework specificato.

## Sintassi della richiesta
<a name="API_UpdateFramework_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_UpdateFramework_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [frameworkName](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-uri-FrameworkName"></a>
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
<a name="API_UpdateFramework_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [FrameworkControls](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-FrameworkControls"></a>
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) **   <a name="Backup-UpdateFramework-request-FrameworkDescription"></a>
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) **   <a name="Backup-UpdateFramework-request-IdempotencyToken"></a>
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
<a name="API_UpdateFramework_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_UpdateFramework_ResponseElements"></a>

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) **   <a name="Backup-UpdateFramework-response-CreationTime"></a>
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) **   <a name="Backup-UpdateFramework-response-FrameworkArn"></a>
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) **   <a name="Backup-UpdateFramework-response-FrameworkName"></a>
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
<a name="API_UpdateFramework_Errors"></a>

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
<a name="API_UpdateFramework_SeeAlso"></a>

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
<a name="API_UpdateGlobalSettings"></a>

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
<a name="API_UpdateGlobalSettings_RequestSyntax"></a>

```
PUT /global-settings HTTP/1.1
Content-type: application/json

{
   "GlobalSettings": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI:
<a name="API_UpdateGlobalSettings_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UpdateGlobalSettings_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [GlobalSettings](#API_UpdateGlobalSettings_RequestSyntax) **   <a name="Backup-UpdateGlobalSettings-request-GlobalSettings"></a>
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
<a name="API_UpdateGlobalSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_UpdateGlobalSettings_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateGlobalSettings_Errors"></a>

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
<a name="API_UpdateGlobalSettings_SeeAlso"></a>

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
<a name="API_UpdateRecoveryPointIndexSettings"></a>

Questa operazione aggiorna le impostazioni di un indice dei punti di ripristino.

Obbligatorio: BackupVaultName RecoveryPointArn, e IAMRole Arn

## Sintassi della richiesta
<a name="API_UpdateRecoveryPointIndexSettings_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json

{
   "IamRoleArn": "string",
   "Index": "string"
}
```

## Parametri della richiesta URI
<a name="API_UpdateRecoveryPointIndexSettings_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-RecoveryPointArn"></a>
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
<a name="API_UpdateRecoveryPointIndexSettings_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [IamRoleArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-IamRoleArn"></a>
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) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-Index"></a>
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
<a name="API_UpdateRecoveryPointIndexSettings_ResponseSyntax"></a>

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

{
   "BackupVaultName": "string",
   "Index": "string",
   "IndexStatus": "string",
   "RecoveryPointArn": "string"
}
```

## Elementi di risposta
<a name="API_UpdateRecoveryPointIndexSettings_ResponseElements"></a>

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) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-BackupVaultName"></a>
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) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-Index"></a>
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) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-IndexStatus"></a>
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) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-RecoveryPointArn"></a>
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
<a name="API_UpdateRecoveryPointIndexSettings_Errors"></a>

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
<a name="API_UpdateRecoveryPointIndexSettings_SeeAlso"></a>

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
<a name="API_UpdateRecoveryPointLifecycle"></a>

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
<a name="API_UpdateRecoveryPointLifecycle_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json

{
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   }
}
```

## Parametri della richiesta URI
<a name="API_UpdateRecoveryPointLifecycle_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [backupVaultName](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-uri-BackupVaultName"></a>
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) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-uri-RecoveryPointArn"></a>
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
<a name="API_UpdateRecoveryPointLifecycle_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [Lifecycle](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-Lifecycle"></a>
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
<a name="API_UpdateRecoveryPointLifecycle_ResponseSyntax"></a>

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

{
   "BackupVaultArn": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string"
}
```

## Elementi di risposta
<a name="API_UpdateRecoveryPointLifecycle_ResponseElements"></a>

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) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-BackupVaultArn"></a>
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) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-CalculatedLifecycle"></a>
Un oggetto `CalculatedLifecycle` contenente i timestamp `DeleteAt` e `MoveToColdStorageAt`.  
Tipo: oggetto [CalculatedLifecycle](API_CalculatedLifecycle.md)

 ** [Lifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-Lifecycle"></a>
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) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-RecoveryPointArn"></a>
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
<a name="API_UpdateRecoveryPointLifecycle_Errors"></a>

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
<a name="API_UpdateRecoveryPointLifecycle_SeeAlso"></a>

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
<a name="API_UpdateRegionSettings"></a>

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
<a name="API_UpdateRegionSettings_RequestSyntax"></a>

```
PUT /account-settings HTTP/1.1
Content-type: application/json

{
   "ResourceTypeManagementPreference": { 
      "string" : boolean 
   },
   "ResourceTypeOptInPreference": { 
      "string" : boolean 
   }
}
```

## Parametri della richiesta URI:
<a name="API_UpdateRegionSettings_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UpdateRegionSettings_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ResourceTypeManagementPreference](#API_UpdateRegionSettings_RequestSyntax) **   <a name="Backup-UpdateRegionSettings-request-ResourceTypeManagementPreference"></a>
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) **   <a name="Backup-UpdateRegionSettings-request-ResourceTypeOptInPreference"></a>
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
<a name="API_UpdateRegionSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_UpdateRegionSettings_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_UpdateRegionSettings_Errors"></a>

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
<a name="API_UpdateRegionSettings_SeeAlso"></a>

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
<a name="API_UpdateReportPlan"></a>

Aggiorna il piano di report specificato.

## Sintassi della richiesta
<a name="API_UpdateReportPlan_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_UpdateReportPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [reportPlanName](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-uri-ReportPlanName"></a>
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
<a name="API_UpdateReportPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [IdempotencyToken](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-IdempotencyToken"></a>
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) **   <a name="Backup-UpdateReportPlan-request-ReportDeliveryChannel"></a>
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) **   <a name="Backup-UpdateReportPlan-request-ReportPlanDescription"></a>
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) **   <a name="Backup-UpdateReportPlan-request-ReportSetting"></a>
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
<a name="API_UpdateReportPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_UpdateReportPlan_ResponseElements"></a>

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) **   <a name="Backup-UpdateReportPlan-response-CreationTime"></a>
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) **   <a name="Backup-UpdateReportPlan-response-ReportPlanArn"></a>
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) **   <a name="Backup-UpdateReportPlan-response-ReportPlanName"></a>
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
<a name="API_UpdateReportPlan_Errors"></a>

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
<a name="API_UpdateReportPlan_SeeAlso"></a>

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
<a name="API_UpdateRestoreTestingPlan"></a>

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
<a name="API_UpdateRestoreTestingPlan_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_UpdateRestoreTestingPlan_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
Il nome del piano di test di ripristino.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_UpdateRestoreTestingPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [RestoreTestingPlan](#API_UpdateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-request-RestoreTestingPlan"></a>
Specifica il corpo di un piano di test di ripristino.  
Tipo: oggetto [RestoreTestingPlanForUpdate](API_RestoreTestingPlanForUpdate.md)  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_UpdateRestoreTestingPlan_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_UpdateRestoreTestingPlan_ResponseElements"></a>

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) **   <a name="Backup-UpdateRestoreTestingPlan-response-CreationTime"></a>
L'ora in cui è stato creato il piano di test delle risorse.  
Tipo: Timestamp

 ** [RestoreTestingPlanArn](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
Il nome della risorsa Amazon (ARN) univoco del piano di test di ripristino.  
Tipo: String

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
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) **   <a name="Backup-UpdateRestoreTestingPlan-response-UpdateTime"></a>
L'ora in cui è stato completato l'aggiornamento del piano di test di ripristino.  
Tipo: Timestamp

## Errori
<a name="API_UpdateRestoreTestingPlan_Errors"></a>

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
<a name="API_UpdateRestoreTestingPlan_SeeAlso"></a>

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
<a name="API_UpdateRestoreTestingSelection"></a>

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
<a name="API_UpdateRestoreTestingSelection_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_UpdateRestoreTestingSelection_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
Il nome del piano di test di ripristino è necessario per aggiornare il piano di test indicato.  
Obbligatorio: sì

 ** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
La selezione del test di ripristino richiesta (nome della selezione del test di ripristino che si desidera aggiornare).  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_UpdateRestoreTestingSelection_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [RestoreTestingSelection](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-RestoreTestingSelection"></a>
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
<a name="API_UpdateRestoreTestingSelection_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_UpdateRestoreTestingSelection_ResponseElements"></a>

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) **   <a name="Backup-UpdateRestoreTestingSelection-response-CreationTime"></a>
L'ora in cui la selezione per il test delle risorse è stata aggiornata correttamente.  
Tipo: Timestamp

 ** [RestoreTestingPlanArn](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingPlanArn"></a>
Stringa univoca che costituisce il nome del piano di test di ripristino.  
Tipo: String

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingPlanName"></a>
Il piano di test di ripristino a cui è associata la selezione aggiornata del test di ripristino.  
Tipo: String

 ** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingSelectionName"></a>
Il nome della selezione del test di ripristino restituito.  
Tipo: String

 ** [UpdateTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-UpdateTime"></a>
L'ora in cui è stato completato l'aggiornamento per la selezione del test di ripristino.  
Tipo: Timestamp

## Errori
<a name="API_UpdateRestoreTestingSelection_Errors"></a>

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
<a name="API_UpdateRestoreTestingSelection_SeeAlso"></a>

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
<a name="API_UpdateTieringConfiguration"></a>

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
<a name="API_UpdateTieringConfiguration_RequestSyntax"></a>

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

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

## Parametri della richiesta URI
<a name="API_UpdateTieringConfiguration_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [tieringConfigurationName](#API_UpdateTieringConfiguration_RequestSyntax) **   <a name="Backup-UpdateTieringConfiguration-request-uri-TieringConfigurationName"></a>
Il nome di una configurazione a più livelli da aggiornare.  
Modello: `^[a-zA-Z0-9_]{1,200}$`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_UpdateTieringConfiguration_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [TieringConfiguration](#API_UpdateTieringConfiguration_RequestSyntax) **   <a name="Backup-UpdateTieringConfiguration-request-TieringConfiguration"></a>
Speciifica il corpo di una configurazione a più livelli.  
Tipo: oggetto [TieringConfigurationInputForUpdate](API_TieringConfigurationInputForUpdate.md)  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_UpdateTieringConfiguration_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_UpdateTieringConfiguration_ResponseElements"></a>

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) **   <a name="Backup-UpdateTieringConfiguration-response-CreationTime"></a>
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) **   <a name="Backup-UpdateTieringConfiguration-response-LastUpdatedTime"></a>
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) **   <a name="Backup-UpdateTieringConfiguration-response-TieringConfigurationArn"></a>
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering aggiornata.  
Tipo: String

 ** [TieringConfigurationName](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-TieringConfigurationName"></a>
Questa stringa univoca è il nome della configurazione di tiering.  
Tipo: stringa  
Modello: `^[a-zA-Z0-9_]{1,200}$` 

## Errori
<a name="API_UpdateTieringConfiguration_Errors"></a>

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
<a name="API_UpdateTieringConfiguration_SeeAlso"></a>

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)