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à.
PutBackupVaultLockConfiguration
Applica AWS Backup Vault Lock a un archivio di backup, impedendo i tentativi di eliminare qualsiasi punto di ripristino archiviato o creato in un archivio di backup. Vault Lock impedisce inoltre i tentativi di aggiornare la policy del ciclo di vita che controlla il periodo di conservazione di qualsiasi punto di ripristino attualmente archiviato in un vault di backup. Se specificato, Vault Lock impone un periodo di conservazione minimo e massimo per i processi di backup e copia futuri destinati a un vault di backup.
Nota
AWS Backup Vault Lock è stato valutato da Cohasset Associates per l'utilizzo in ambienti soggetti alle normative SEC 17a-4, CFTC e FINRA. Per ulteriori informazioni su come AWS Backup Vault Lock si rapporta a queste normative, consulta la valutazione della conformità di Cohasset Associates.
Per ulteriori informazioni, consulta Vault Lock di AWS Backup.
Sintassi della richiesta
PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1
Content-type: application/json
{
"ChangeableForDays": number,
"MaxRetentionDays": number,
"MinRetentionDays": number
}Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- backupVaultName
-
La configurazione AWS Backup Vault Lock che specifica il nome dell'archivio di backup che protegge.
Modello:
^[a-zA-Z0-9\-\_]{2,50}$Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ChangeableForDays
-
La configurazione AWS Backup Vault Lock che specifica il numero di giorni prima della data di blocco. Ad esempio, impostare
ChangeableForDayssu 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
ChangeableForDayssu 3 o su un valore maggiore.Prima della data di blocco, puoi eliminare Vault Lock dal vault utilizzando
DeleteBackupVaultLockConfigurationo modificare la configurazione di Vault Lock utilizzandoPutBackupVaultLockConfiguration. 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
DeleteBackupVaultLockConfigurationo modificare la configurazione di Vault Lock utilizzandoPutBackupVaultLockConfigurationin qualsiasi momento.Tipo: long
Campo obbligatorio: no
- MaxRetentionDays
-
La configurazione AWS Backup Vault Lock che specifica il periodo di conservazione massimo durante il quale il vault conserva i suoi 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
Campo obbligatorio: no
- MinRetentionDays
-
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
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
Codice di stato HTTP: 400
- InvalidRequestException
-
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
Codice di stato HTTP: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
