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à.
UpdateRecoveryPointLifecycle
Imposta il ciclo di vita delle transizioni di un punto di ripristino.
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle funzionalità per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.
I backup trasferiti allo storage dei dati inattivi devono essere archiviati nello storage dei dati inattivi per un minimo di 90 giorni. Pertanto, l'impostazione "conservazione" deve essere 90 giorni maggiore dell'impostazione "transizione a inattivo dopo". L'impostazione "transizione a inattivo dopo" non può essere modificata dopo che è stata eseguita la transizione di un backup a inattivo.
Importante
Se il tuo ciclo di vita utilizza attualmente i parametri DeleteAfterDays
eMoveToColdStorageAfterDays
, includi questi parametri e i relativi valori quando chiami questa operazione. La loro mancata inclusione può comportare l'aggiornamento del piano con valori nulli.
Questa operazione non supporta backup continui.
Sintassi della richiesta
POST /backup-vaults/backupVaultName
/recovery-points/recoveryPointArn
HTTP/1.1
Content-type: application/json
{
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
,
"OptInToArchiveForSupportedResources": boolean
}
}
URIParametri della richiesta
La richiesta utilizza i seguenti URI parametri.
- backupVaultName
-
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.
Modello:
^[a-zA-Z0-9\-\_]{2,50}$
Campo obbligatorio: sì
- recoveryPointArn
-
Un Amazon Resource Name (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
Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- Lifecycle
-
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup trasferiti allo storage dei dati inattivi devono essere archiviati nello storage dei dati inattivi per un minimo di 90 giorni. Pertanto, l'impostazione "conservazione" deve essere 90 giorni maggiore dell'impostazione "transizione a inattivo dopo". L'impostazione "transizione a inattivo dopo" non può essere modificata dopo che è stata eseguita la transizione di un backup a inattivo.
Tipo: oggetto Lifecycle
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"CalculatedLifecycle": {
"DeleteAt": number,
"MoveToColdStorageAt": number
},
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointArn": "string"
}
Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di 200. HTTP
I seguenti dati vengono restituiti in JSON formato dal servizio.
- BackupVaultArn
-
Un file ARN che identifica in modo univoco un archivio di backup; ad esempio,.
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
Tipo: stringa
- CalculatedLifecycle
-
Un oggetto
CalculatedLifecycle
contenente i timestampDeleteAt
eMoveToColdStorageAt
.Tipo: oggetto CalculatedLifecycle
- Lifecycle
-
Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.
I backup trasferiti allo storage dei dati inattivi devono essere archiviati nello storage dei dati inattivi per un minimo di 90 giorni. Pertanto, l'impostazione "conservazione" deve essere 90 giorni maggiore dell'impostazione "transizione a inattivo dopo". L'impostazione "transizione a inattivo dopo" non può essere modificata dopo che è stata eseguita la transizione di un backup a inattivo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle funzionalità per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.
Tipo: oggetto Lifecycle
- RecoveryPointArn
-
Un Amazon Resource Name (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
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
HTTPCodice di stato: 400
- InvalidRequestException
-
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
HTTPCodice di stato: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: