Obsoleto: richiesta di conformità del bucket PUT
La richiesta di conformità del bucket PUT è obsoleta. Tuttavia, puoi continuare a utilizzare questa richiesta per modificare le impostazioni di conformità per un bucket Conforme legacy esistente. Ad esempio, è possibile mettere in attesa per motivi legali un bucket esistente o aumentarne il periodo di conservazione.
|
La funzionalità StorageGRID Compliance disponibile nelle precedenti versioni StorageGRID è obsoleta ed è stata sostituita da S3 Object Lock. Per maggiori dettagli vedere quanto segue: |
Per completare questa operazione è necessario disporre dell'autorizzazione s3:PutBucketCompliance oppure essere l'account root.
Quando si invia una richiesta di conformità del bucket PUT, è necessario specificare un valore per ogni campo delle impostazioni di conformità.
Richiedi esempio
Questa richiesta di esempio modifica le impostazioni di conformità per il bucket denominato mybucket
. In questo esempio, gli oggetti in mybucket
verranno ora conservati per due anni (1.051.200 minuti) anziché uno, a partire dal momento in cui l'oggetto viene inserito nella griglia. Non esiste alcun vincolo legale su questo secchio. Ogni oggetto verrà automaticamente eliminato dopo due anni.
PUT /mybucket/?x-ntap-sg-compliance HTTP/1.1 Date: date Authorization: authorization name Host: host Content-Length: 152 <SGCompliance> <RetentionPeriodMinutes>1051200</RetentionPeriodMinutes> <LegalHold>false</LegalHold> <AutoDelete>true</AutoDelete> </SGCompliance>
Nome | Descrizione |
---|---|
Periodo di conservazioneMinuti |
Durata del periodo di conservazione degli oggetti aggiunti a questo bucket, in minuti. Il periodo di conservazione inizia quando l'oggetto viene inserito nella griglia. Importante Quando si specifica un nuovo valore per RetentionPeriodMinutes, è necessario specificare un valore uguale o maggiore del periodo di conservazione corrente del bucket. Dopo aver impostato il periodo di conservazione del bucket, non è possibile diminuire tale valore; è possibile solo aumentarlo. |
LegalHold |
|
Eliminazione automatica |
|
Coerenza per le impostazioni di conformità
Quando si aggiornano le impostazioni di conformità per un bucket S3 con una richiesta di conformità del bucket PUT, StorageGRID tenta di aggiornare i metadati del bucket in tutta la griglia. Per impostazione predefinita, StorageGRID utilizza la coerenza Strong-global per garantire che tutti i siti dei data center e tutti i nodi di archiviazione che contengono metadati dei bucket abbiano coerenza di lettura dopo scrittura per le impostazioni di conformità modificate.
Se StorageGRID non riesce a raggiungere la coerenza Strong-global perché un sito del data center o più nodi di archiviazione in un sito non sono disponibili, il codice di stato HTTP per la risposta è 503 Service Unavailable.
Se si riceve questa risposta, è necessario contattare l'amministratore della rete per assicurarsi che i servizi di archiviazione richiesti siano resi disponibili il prima possibile. Se l'amministratore della rete non è in grado di rendere disponibili sufficienti nodi di archiviazione in ciascun sito, il supporto tecnico potrebbe consigliarti di riprovare la richiesta non riuscita forzando la coerenza Strong-site.
|
Non forzare mai la coerenza Strong-site per la conformità del bucket PUT, a meno che non ti sia stato chiesto di farlo dal supporto tecnico e a meno che tu non comprenda le potenziali conseguenze dell'utilizzo di questo livello. |
Quando la coerenza viene ridotta a Strong-site, StorageGRID garantisce che le impostazioni di conformità aggiornate avranno coerenza di lettura dopo scrittura solo per le richieste client all'interno di un sito. Ciò significa che il sistema StorageGRID potrebbe avere temporaneamente più impostazioni incoerenti per questo bucket finché tutti i siti e i nodi di archiviazione non saranno disponibili. Impostazioni incoerenti possono dare luogo a comportamenti inaspettati e indesiderati. Ad esempio, se si sottopone un bucket a un blocco legale e si impone una minore coerenza, le precedenti impostazioni di conformità del bucket (ovvero il blocco legale) potrebbero continuare a essere valide in alcuni siti di data center. Di conseguenza, gli oggetti che ritieni siano in sospeso a fini legali potrebbero essere eliminati alla scadenza del periodo di conservazione, dall'utente o tramite l'eliminazione automatica, se abilitata.
Per forzare l'uso della coerenza Strong-site, riemettere la richiesta di conformità del bucket PUT e includere Consistency-Control
Intestazione della richiesta HTTP, come segue:
PUT /mybucket/?x-ntap-sg-compliance HTTP/1.1 Consistency-Control: strong-site
Risposte di errore
-
Se il bucket non è stato creato per essere conforme, il codice di stato HTTP per la risposta è
404 Not Found
. -
Se
RetentionPeriodMinutes
nella richiesta è inferiore al periodo di conservazione corrente del bucket, il codice di stato HTTP è400 Bad Request
.
"Obsoleto: modifiche alla richiesta PUT Bucket per conformità"