本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

物件上的作業

05/18/2023 貢獻者

PDF

本節說明StorageGRID 此「物件」的「物件」功能如何執行S3 REST API作業。

下列條件適用於所有物件作業：

StorageGRID "一致性控管" 受物件上的所有作業支援、但下列項目除外：
- 取得物件ACL
- OPTIONS /
- 將物件保留為合法
- 保留物件
- 選取「物件內容」
衝突的用戶端要求（例如兩個寫入同一個金鑰的用戶端）會以「最新致勝」的方式解決。「最新致勝」評估的時間、是根據StorageGRID 下列條件而定：當系統完成特定要求時、S3用戶端開始作業時、不會開啟。
所有物件均由庫位擁有者擁有、包括匿名使用者或其他帳戶所建立的物件。StorageGRID
透過 Swift 擷取至 StorageGRID 系統的資料物件無法透過 S3 存取。

下表說明StorageGRID 了Ss哪些物件是由S3 REST API物件執行。

營運實作

營運	實作
刪除物件	多因素驗證（MFA）和回應標頭 `x-amz-mfa` 不受支援。處理刪除物件要求時StorageGRID 、功能區會嘗試立即從所有儲存位置移除物件的所有複本。如果成功、StorageGRID 則會立即將回應傳回給用戶端。如果無法在 30 秒內移除所有複本（例如、因為某個位置暫時無法使用）、 StorageGRID 會將複本排入佇列以供移除、然後表示用戶端成功。版本管理若要移除特定版本、申請者必須是貯體擁有者、並使用 `versionId` 子資源：使用此子資源會永久刪除版本。如果是 `versionId` 對應於刪除標記、即回應標頭 `x-amz-delete-marker` 傳回設定為 `true`。如果刪除的物件不含 `versionId` 子資源在啟用版本的儲存區上、會產生刪除標記。。 `versionId` 刪除標記會使用傳回 `x-amz-version-id` 回應標頭和 `x-amz-delete-marker` 回應標頭會傳回設定為 `true`。如果刪除的物件不含 `versionId` 子資源在版本暫停的儲存區上、會永久刪除現有的'null '版本或'null '刪除標記、並產生新的'null '刪除標記。。 `x-amz-delete-marker` 回應標頭會傳回設定為 `true`。附註：在某些情況下、物件可能會有多個刪除標記。請參閱 "使用 S3 REST API 來設定 S3 物件鎖定" 以瞭解如何在治理模式中刪除物件版本。
刪除多個物件（刪除物件）	多因素驗證（MFA）和回應標頭 `x-amz-mfa` 不受支援。您可以在同一個要求訊息中刪除多個物件。請參閱 "使用 S3 REST API 來設定 S3 物件鎖定" 以瞭解如何在治理模式中刪除物件版本。
刪除物件標記	使用 `tagging` SubResource可移除物件的所有標記。版本管理如果是 `versionId` 查詢參數未在要求中指定、此作業會刪除版本控制儲存區中物件最新版本的所有標記。如果物件的目前版本是刪除標記、則會傳回「MethodNotSupported」狀態 `x-amz-delete-marker` 回應標頭設定為 `true`。
取得物件	"取得物件"
取得物件ACL	如果提供帳戶所需的存取認證資料、則作業會傳回正面回應、並傳回物件擁有者的ID、顯示名稱和權限、表示擁有者擁有物件的完整存取權。
取得物件合法持有	"使用 S3 REST API 來設定 S3 物件鎖定"
取得物件保留	"使用 S3 REST API 來設定 S3 物件鎖定"
取得物件標記	使用 `tagging` SubResource可傳回物件的所有標記。版本管理如果是 `versionId` 查詢參數未在要求中指定、此作業會傳回版本控制儲存區中物件最新版本的所有標記。如果物件的目前版本是刪除標記、則會傳回「MethodNotSupported」狀態 `x-amz-delete-marker` 回應標頭設定為 `true`。
標頭物件	"標頭物件"
POST物件還原	"POST物件還原"
放置物件	"放置物件"
放置物件-複製	"放置物件-複製"
將物件保留為合法	"使用 S3 REST API 來設定 S3 物件鎖定"
保留物件	"使用 S3 REST API 來設定 S3 物件鎖定"
放置物件標記	使用 `tagging` SubResource可將一組標記新增至現有物件。物件標籤限制您可以在上傳新物件時新增標記、也可以將標記新增至現有物件。每個物件最多可支援10個標記的支援功能。StorageGRID與物件相關聯的標記必須具有唯一的標記金鑰。標籤金鑰長度最多可達128個UNICODE字元、標籤值長度最多可達256個UNICODE字元。金鑰和值區分大小寫。標記更新和擷取行為當您使用「放置物件」標記來更新物件的標記時、StorageGRID 無法重新擷取物件。這表示不會使用相符ILM規則中指定的擷取行為選項。當ILM由正常背景ILM程序重新評估時、會對更新所觸發的物件放置位置進行任何變更。這表示、如果 ILM 規則使用嚴格選項來擷取行為、則無法在無法進行所需物件放置時（例如、因為新要求的位置無法使用）、就不會採取任何行動。更新後的物件會保留其目前的放置位置、直到能夠放置所需的位置為止。解決衝突相互衝突的用戶端要求（例如兩個寫入同一個金鑰的用戶端）會以「最新致勝」的方式解決。「最新致勝」評估的時間、是根據StorageGRID 下列條件而定：當系統完成特定要求時、S3用戶端開始作業時、不會開啟。版本管理如果是 `versionId` 查詢參數未在要求中指定、該作業會將標記新增至版本控制儲存區中物件的最新版本。如果物件的目前版本是刪除標記、則會傳回「MethodNotSupported」狀態 `x-amz-delete-marker` 回應標頭設定為 `true`。
選取物件內容	"選取物件內容"

刪除物件

多因素驗證（MFA）和回應標頭 x-amz-mfa 不受支援。

處理刪除物件要求時StorageGRID 、功能區會嘗試立即從所有儲存位置移除物件的所有複本。如果成功、StorageGRID 則會立即將回應傳回給用戶端。如果無法在 30 秒內移除所有複本（例如、因為某個位置暫時無法使用）、 StorageGRID 會將複本排入佇列以供移除、然後表示用戶端成功。

版本管理

若要移除特定版本、申請者必須是貯體擁有者、並使用 versionId 子資源：使用此子資源會永久刪除版本。如果是 versionId 對應於刪除標記、即回應標頭 x-amz-delete-marker 傳回設定為 true。

如果刪除的物件不含 versionId 子資源在啟用版本的儲存區上、會產生刪除標記。。 versionId 刪除標記會使用傳回 x-amz-version-id 回應標頭和 x-amz-delete-marker 回應標頭會傳回設定為 true。
如果刪除的物件不含 versionId 子資源在版本暫停的儲存區上、會永久刪除現有的'null '版本或'null '刪除標記、並產生新的'null '刪除標記。。 x-amz-delete-marker 回應標頭會傳回設定為 true。

附註：在某些情況下、物件可能會有多個刪除標記。

請參閱 "使用 S3 REST API 來設定 S3 物件鎖定" 以瞭解如何在治理模式中刪除物件版本。

刪除多個物件

（刪除物件）

多因素驗證（MFA）和回應標頭 x-amz-mfa 不受支援。

您可以在同一個要求訊息中刪除多個物件。

請參閱 "使用 S3 REST API 來設定 S3 物件鎖定" 以瞭解如何在治理模式中刪除物件版本。

刪除物件標記

使用 tagging SubResource可移除物件的所有標記。

版本管理: 如果是 versionId 查詢參數未在要求中指定、此作業會刪除版本控制儲存區中物件最新版本的所有標記。如果物件的目前版本是刪除標記、則會傳回「MethodNotSupported」狀態 x-amz-delete-marker 回應標頭設定為 true。

取得物件

"取得物件"

取得物件ACL

如果提供帳戶所需的存取認證資料、則作業會傳回正面回應、並傳回物件擁有者的ID、顯示名稱和權限、表示擁有者擁有物件的完整存取權。

取得物件合法持有

"使用 S3 REST API 來設定 S3 物件鎖定"

取得物件保留

"使用 S3 REST API 來設定 S3 物件鎖定"

取得物件標記

使用 tagging SubResource可傳回物件的所有標記。

版本管理: 如果是 versionId 查詢參數未在要求中指定、此作業會傳回版本控制儲存區中物件最新版本的所有標記。如果物件的目前版本是刪除標記、則會傳回「MethodNotSupported」狀態 x-amz-delete-marker 回應標頭設定為 true。

標頭物件

POST物件還原

放置物件

放置物件-複製

將物件保留為合法

"使用 S3 REST API 來設定 S3 物件鎖定"

保留物件

"使用 S3 REST API 來設定 S3 物件鎖定"

放置物件標記

使用 tagging SubResource可將一組標記新增至現有物件。

物件標籤限制: 您可以在上傳新物件時新增標記、也可以將標記新增至現有物件。每個物件最多可支援10個標記的支援功能。StorageGRID與物件相關聯的標記必須具有唯一的標記金鑰。標籤金鑰長度最多可達128個UNICODE字元、標籤值長度最多可達256個UNICODE字元。金鑰和值區分大小寫。
標記更新和擷取行為: 當您使用「放置物件」標記來更新物件的標記時、StorageGRID 無法重新擷取物件。這表示不會使用相符ILM規則中指定的擷取行為選項。當ILM由正常背景ILM程序重新評估時、會對更新所觸發的物件放置位置進行任何變更。

這表示、如果 ILM 規則使用嚴格選項來擷取行為、則無法在無法進行所需物件放置時（例如、因為新要求的位置無法使用）、就不會採取任何行動。更新後的物件會保留其目前的放置位置、直到能夠放置所需的位置為止。
解決衝突: 相互衝突的用戶端要求（例如兩個寫入同一個金鑰的用戶端）會以「最新致勝」的方式解決。「最新致勝」評估的時間、是根據StorageGRID 下列條件而定：當系統完成特定要求時、S3用戶端開始作業時、不會開啟。
版本管理: 如果是 versionId 查詢參數未在要求中指定、該作業會將標記新增至版本控制儲存區中物件的最新版本。如果物件的目前版本是刪除標記、則會傳回「MethodNotSupported」狀態 x-amz-delete-marker 回應標頭設定為 true。

選取物件內容

"選取物件內容"

相關資訊

"在稽核記錄中追蹤S3作業"

物件上的作業

Creating your file...