已棄用：PUT Bucket 合規性請求
建議變更
PDF
PUT Bucket 合規性請求已被棄用。但是，您可以繼續使用此請求來修改現有舊版合規儲存桶的合規性設定。例如，您可以將現有儲存桶置於合法保留狀態或延長其保留期。
|
先前版本的StorageGRID中提供的StorageGRID合規功能已被棄用，並已被 S3 物件鎖定取代。請參閱以下內容以了解更多詳細資訊： |
您必須擁有 s3:PutBucketCompliance 權限，或成為帳戶根，才能完成此操作。
發出 PUT Bucket 合規性請求時，必須為合規性設定的每個欄位指定一個值。
請求範例
此範例請求修改名為 mybucket。在這個例子中，對象 `mybucket`從對象納入電網時起，將保留兩年（1,051,200 分鐘），而不是一年。此儲存桶不存在合法保留。每個物件將在兩年後自動刪除。
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>
| Name | 描述 |
|---|---|
保留期分鐘 |
新增至此儲存桶的物件的保留期限長度（以分鐘為單位）。保留期從物件納入電網時開始。 重要 為 RetentionPeriodMinutes 指定新值時，必須指定等於或大於儲存桶目前保留期的值。設定儲存桶的保留期後，您無法減少該值；您只能增加它。 |
法律保留 |
|
自動刪除 |
|
合規性設定的一致性
當您使用 PUT Bucket 合規性要求更新 S3 儲存桶的合規性設定時， StorageGRID會嘗試在整個網格中更新儲存體桶的元資料。預設情況下， StorageGRID使用 強全域 一致性來確保所有資料中心站點和所有包含儲存桶元資料的儲存節點對於變更的合規性設定具有讀寫一致性。
如果StorageGRID因資料中心網站或網站上的多個儲存節點不可用而無法實現 強全域 一致性，則回應的 HTTP 狀態碼為 503 Service Unavailable.
如果收到此回复，則必須聯絡網格管理員，以確保盡快提供所需的儲存服務。如果網格管理員無法在每個站點提供足夠的儲存節點，技術支援可能會指導您透過強制*強站點*一致性來重試失敗的請求。
|
切勿強制使用 Strong-site 一致性來遵守 PUT bucket 規定，除非技術支援指示您這樣做，並且您了解使用此級別的潛在後果。 |
當一致性降低到*強站點*時， StorageGRID保證更新後的合規性設定僅對站點內的用戶端請求具有讀寫一致性。這意味著StorageGRID系統可能會暫時對該儲存桶具有多個不一致的設置，直到所有站點和儲存節點都可用。不一致的設定可能會導致意外和不良的行為。例如，如果您將儲存桶置於合法保留之下並強制降低一致性，則儲存桶先前的合規性設定（即合法保留）可能會在某些資料中心網站繼續有效。因此，您認為處於合法保留狀態的物件可能會在保留期到期時被使用者或自動刪除功能（如果已啟用）刪除。
若要強制使用 Strong-site 一致性，請重新發出 PUT Bucket 合規性要求，並包含 `Consistency-Control`HTTP請求頭，如下：
PUT /mybucket/?x-ntap-sg-compliance HTTP/1.1 Consistency-Control: strong-site
錯誤回應
-
如果儲存桶的建立不符合要求，則回應的 HTTP 狀態代碼為
404 Not Found。 -
如果
RetentionPeriodMinutes`如果請求小於儲存桶的目前保留期，則 HTTP 狀態碼為 `400 Bad Request。