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à. # StartBackupJob Avvia un processo di backup on demand per la risorsa specificata. ## Sintassi della richiesta ``` PUT /backup-jobs HTTP/1.1 Content-type: application/json { "BackupOptions": { "string" : "string" }, "BackupVaultName": "string", "CompleteWindowMinutes": number, "IamRoleArn": "string", "IdempotencyToken": "string", "Index": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "LogicallyAirGappedBackupVaultArn": "string", "RecoveryPointTags": { "string" : "string" }, "ResourceArn": "string", "StartWindowMinutes": number } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [BackupOptions](#API_StartBackupJob_RequestSyntax) ** L'opzione di backup per una risorsa selezionata. Questa opzione è disponibile solo per i processi di backup di Windows Volume Shadow Copy Service (VSS). Valori validi: imposta su `"WindowsVSS":"enabled"` per abilitare l'opzione di backup `WindowsVSS` e creare un backup di Windows VSS. Imposta su `"WindowsVSS""disabled"` per creare un backup regolare. Per impostazione predefinita, l'opzione `WindowsVSS` non è abilitata. Tipo: mappatura stringa a stringa Modello di chiave:`^[a-zA-Z0-9\-\_\.]{1,50}$` Modello di valore: `^[a-zA-Z0-9\-\_\.]{1,50}$` Obbligatorio: no ** [BackupVaultName](#API_StartBackupJob_RequestSyntax) ** Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati. Tipo: stringa Modello: `^[a-zA-Z0-9\-\_]{2,50}$` Obbligatorio: sì ** [CompleteWindowMinutes](#API_StartBackupJob_RequestSyntax) ** Un valore in minuti durante il quale un backup avviato correttamente deve essere completato. In caso contrario, il processo verrà annullato da AWS Backup . Questo valore è facoltativo. Questo valore inizia il conto alla rovescia a partire dalla pianificazione del backup. Non aggiunge ulteriore tempo per `StartWindowMinutes` o se il backup è iniziato più tardi del previsto. Analogamente a `StartWindowMinutes`, questo parametro ha un valore massimo di 100 anni (52.560.000 minuti). Tipo: long Obbligatorio: no ** [IamRoleArn](#API_StartBackupJob_RequestSyntax) ** Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`. Tipo: stringa Obbligatorio: sì ** [IdempotencyToken](#API_StartBackupJob_RequestSyntax) ** Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartBackupJob`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita. ▬Tipo: stringa Obbligatorio: no ** [Index](#API_StartBackupJob_RequestSyntax) ** Includi questo parametro per abilitare la creazione dell'indice se il job di backup ha un tipo di risorsa che supporta gli indici di backup. I tipi di risorse che supportano gli indici di backup includono: + `EBS` per Amazon Elastic Block Store + `S3`per Amazon Simple Storage Service (Amazon S3) L'indice può avere 1 dei 2 valori possibili, uno `ENABLED` o `DISABLED` l'altro. Per creare un indice di backup per un punto di `ACTIVE` ripristino idoneo che non dispone ancora di un indice di backup, imposta il valore su`ENABLED`. Per eliminare un indice di backup, imposta il valore su`DISABLED`. Tipo: String Valori validi: `ENABLED | DISABLED` Campo obbligatorio: no ** [Lifecycle](#API_StartBackupJob_RequestSyntax) ** Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup eseguirà automaticamente la transizione e la scadenza dei backup in base al ciclo di vita definito. I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, l’impostazione "conservazione" deve essere 90 giorni maggiore dell’impostazione "transizione a inattivo dopo". L’impostazione “transizione all’archiviazione a freddo dopo giorni” non può essere modificata dopo che è stata eseguita la transizione di un backup all’archiviazione a freddo. I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse. Questo parametro ha un valore massimo di 100 anni (36.5000 giorni). Tipo: oggetto [Lifecycle](API_Lifecycle.md) Obbligatorio: no ** [LogicallyAirGappedBackupVaultArn](#API_StartBackupJob_RequestSyntax) ** L'ARN di un caveau con intercapedine logiche. L'ARN deve trovarsi nello stesso account e nella stessa regione. Se fornite, le risorse completamente gestite supportate eseguono il backup direttamente nel vault logicamente separato, mentre altre risorse supportate creano un'istantanea temporanea (fatturabile) nel vault di backup, quindi la copiano in un archivio con sistema logico. Le risorse non supportate eseguono il backup solo nell'archivio di backup specificato. ▬Tipo: stringa Obbligatorio: no ** [RecoveryPointTags](#API_StartBackupJob_RequestSyntax) ** I tag da assegnare alle risorse. Tipo: mappatura stringa a stringa Obbligatorio: no ** [ResourceArn](#API_StartBackupJob_RequestSyntax) ** Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa. Tipo: stringa Obbligatorio: sì ** [StartWindowMinutes](#API_StartBackupJob_RequestSyntax) ** Un valore in minuti dopo la pianificazione di un backup prima che un processo venga annullato se non viene avviato correttamente. Questo valore è facoltativo e l'impostazione predefinita è 8 ore. Se questo valore è incluso, devono essere necessari almeno 60 minuti per evitare errori. Il valore massimo di questo parametro è 100 anni (52.560.000 minuti). Durante la finestra di avvio, il processo di backup rimane in stato `CREATED` finché non viene avviato correttamente o fino alla scadenza della finestra di avvio. Se all'interno della finestra di avvio AWS Backup viene visualizzato un errore che consente di riprovare il lavoro, AWS Backup riproverà automaticamente a iniziare il processo almeno ogni 10 minuti fino all'avvio corretto del backup (lo stato del lavoro cambia in`RUNNING`) o fino a quando lo stato del lavoro non cambia a `EXPIRED` (cosa che dovrebbe verificarsi al termine della finestra di avvio). Tipo: long Obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "BackupJobId": "string", "CreationDate": number, "IsParent": boolean, "RecoveryPointArn": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [BackupJobId](#API_StartBackupJob_ResponseSyntax) ** Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa. Tipo: String ** [CreationDate](#API_StartBackupJob_ResponseSyntax) ** La data e l'ora di creazione di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087. Tipo: Timestamp ** [IsParent](#API_StartBackupJob_ResponseSyntax) ** Questo è un valore booleano restituito che indica che si tratta di un processo di backup (composito) padre. Tipo: Booleano ** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) ** *Nota: questo campo viene restituito solo per le risorse Amazon EFS e Advanced DynamoDB.* Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`. Tipo: String ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md). ** InvalidParameterValueException ** Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo. ** Context ** ** Type ** Codice di stato HTTP: 400 ** InvalidRequestException ** Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato. ** Context ** ** Type ** Codice di stato HTTP: 400 ** LimitExceededException ** È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta. ** Context ** ** Type ** Codice di stato HTTP: 400 ** MissingParameterValueException ** Indica che manca un parametro obbligatorio. ** Context ** ** Type ** Codice di stato HTTP: 400 ** ResourceNotFoundException ** Una risorsa necessaria per l'azione non esiste. ** Context ** ** Type ** Codice di stato HTTP: 400 ** ServiceUnavailableException ** La richiesta non è riuscita a causa di un errore temporaneo del server. ** Context ** ** Type ** Codice di stato HTTP: 500 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartBackupJob) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartBackupJob) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartBackupJob) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartBackupJob) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartBackupJob) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartBackupJob) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartBackupJob) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartBackupJob) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartBackupJob) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartBackupJob)