Richiesta PUT Bucket compliance obsoleta in StorageGRID
La richiesta di conformità PUT Bucket è obsoleta. Tuttavia, puoi continuare a utilizzarla per modificare le impostazioni di conformità di un bucket Compliant legacy esistente. Ad esempio, puoi mettere un bucket esistente in legal hold o aumentarne il periodo di conservazione.
|
|
La funzionalità di conformità StorageGRID disponibile nelle versioni precedenti di StorageGRID è stata deprecata e sostituita da S3 Object Lock. Per maggiori dettagli, consulta quanto segue: |
Devi avere l'autorizzazione s3:PutBucketCompliance, oppure essere l'account root, per completare questa operazione.
Devi specificare un valore per ogni campo delle impostazioni di conformità quando invii una richiesta di conformità PUT Bucket.
Esempio di richiesta
Questa richiesta di esempio modifica le impostazioni di conformità per il bucket denominato mybucket. In questo esempio, gli oggetti in mybucket ora verranno conservati per due anni (1.051.200 minuti) invece di un anno, a partire dal momento in cui l'oggetto viene inserito nella grid. Non c'è alcun blocco legale su questo bucket. Ogni oggetto verrà eliminato automaticamente 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 |
|---|---|
RetentionPeriodMinutes |
La durata del periodo di conservazione per gli oggetti aggiunti a questo bucket, in minuti. Il periodo di conservazione inizia quando l'oggetto viene inserito nella grid. Importante Quando specifichi un nuovo valore per RetentionPeriodMinutes, devi specificare un valore uguale o superiore all'attuale periodo di conservazione del bucket. Dopo che il periodo di conservazione del bucket è stato impostato, non puoi diminuire quel valore; puoi solo aumentarlo. |
LegalHold |
|
AutoDelete |
|
Coerenza per le impostazioni di conformità
Quando aggiorni le impostazioni di conformità per un bucket S3 con una richiesta PUT Bucket compliance, 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 data center site e tutti i Storage Node che contengono i metadati del bucket abbiano coerenza read-after-write per le impostazioni di conformità modificate.
Se StorageGRID non riesce a raggiungere la coerenza Strong-global perché un sito del data center o più Storage Node in un sito non sono disponibili, il codice di stato HTTP per la risposta è 503 Service Unavailable.
Se ricevi questa risposta, devi contattare l'amministratore della griglia per assicurarti che i servizi di archiviazione richiesti vengano resi disponibili il prima possibile. Se l'amministratore della griglia non è in grado di rendere disponibili un numero sufficiente di Storage Node in ciascun sito, il supporto tecnico potrebbe suggerirti di riprovare la richiesta non riuscita forzando la coerenza Strong-site.
|
|
Non forzare mai la coerenza Strong-site per la conformità PUT del bucket a meno che non ti sia stato indicato 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 read-after-write solo per le richieste dei client all'interno di un sito. Questo significa che il sistema StorageGRID potrebbe temporaneamente avere più impostazioni incoerenti per questo bucket finché tutti i siti e i nodi di Storage non saranno disponibili. Le impostazioni incoerenti possono causare comportamenti imprevisti e indesiderati. Ad esempio, se metti un bucket sotto blocco legale e forzi una coerenza inferiore, le precedenti impostazioni di conformità del bucket (cioè, blocco legale disattivato) potrebbero continuare a essere attive in alcuni siti del data center. Di conseguenza, gli oggetti che pensi siano soggetti a blocco legale potrebbero essere eliminati quando il loro periodo di conservazione scade, sia dall'utente che da AutoDelete, se abilitato.
Per forzare l'utilizzo della coerenza Strong-site, riemettere la richiesta di conformità PUT del bucket e includere l' `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 in modo da essere conforme, il codice di stato HTTP per la risposta è
404 Not Found. -
Se
RetentionPeriodMinutesnella richiesta è inferiore al periodo di conservazione del bucket, il codice di stato HTTP è400 Bad Request.
"Obsoleto: modifiche alla richiesta PUT Bucket per la conformità"