UpdateRecoveryPointLifecycle - AWS Backup
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 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 parametriMoveToColdStorageAfterDays, includi questi parametri DeleteAfterDays e i relativi valori quando richiami questa operazione. La loro mancata inclusione può comportare l'aggiornamento del piano con valori nulli.

Questa operazione non supporta backup continui.

Sintassi della richiesta

POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json

{
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   }
}

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

backupVaultName

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

Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

Lifecycle

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

Obbligatorio: no

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

BackupVaultArn

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

Un oggetto CalculatedLifecycle contenente i timestamp DeleteAt e MoveToColdStorageAt.

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 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. AWS Backup ignora questa espressione per altri tipi di risorse.

Tipo: oggetto Lifecycle

RecoveryPointArn

Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Tipo: String

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.

Context

Type

Codice di stato HTTP: 400

InvalidRequestException

Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.

Context

Type

Codice di stato HTTP: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

Context

Type

Codice di stato HTTP: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

Context

Type

Codice di stato HTTP: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

Context

Type

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: