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

物件上的作業

02/14/2024 貢獻者

PDF

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

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

StorageGRID "一致性值" 受物件上的所有作業支援、但下列項目除外：
- GetObjectAcl
- OPTIONS /
- PutObjectLegalHold
- PutObjectRetention
- 選取物件內容
衝突的用戶端要求（例如兩個寫入同一個金鑰的用戶端）會以「最新致勝」的方式解決。「最新致勝」評估的時間取決於StorageGRID 何時由VMware系統完成指定的要求、而非S3用戶端開始作業的時間。
所有物件均由庫位擁有者擁有、包括匿名使用者或其他帳戶所建立的物件。StorageGRID
透過 Swift 擷取至 StorageGRID 系統的資料物件無法透過 S3 存取。

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

營運實作

營運	實作
刪除物件	多因素驗證（MFA）和回應標頭 `x-amz-mfa` 不受支援。處理 DeleteObject 要求時、 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 物件鎖定" 以瞭解如何在治理模式中刪除物件版本。
刪除ObjectTagging	使用 `tagging` SubResource可移除物件的所有標記。版本管理如果是 `versionId` 查詢參數未在要求中指定、此作業會刪除版本控制儲存區中物件最新版本的所有標記。如果物件的目前版本是刪除標記、則會傳回「 MethodNotAllowed 」狀態 `x-amz-delete-marker` 回應標頭設定為 `true`。
GetObject	"GetObject"
GetObjectAcl	如果提供帳戶所需的存取認證資料、則作業會傳回正面回應、並傳回物件擁有者的ID、顯示名稱和權限、表示擁有者擁有物件的完整存取權。
GetObjectLegalHold	"使用 S3 REST API 來設定 S3 物件鎖定"
GetObjectRetention	"使用 S3 REST API 來設定 S3 物件鎖定"
GetObjectTagging	使用 `tagging` SubResource可傳回物件的所有標記。版本管理如果是 `versionId` 查詢參數未在要求中指定、此作業會傳回版本控制儲存區中物件最新版本的所有標記。如果物件的目前版本是刪除標記、則會傳回「 MethodNotAllowed 」狀態 `x-amz-delete-marker` 回應標頭設定為 `true`。
標題物件	"標題物件"
RestoreObject	"RestoreObject"
PuttObject	"PuttObject"
CopyObject （先前命名的「 Put 物件 - 複本」）	"CopyObject"
PutObjectLegalHold	"使用 S3 REST API 來設定 S3 物件鎖定"
PutObjectRetention	"使用 S3 REST API 來設定 S3 物件鎖定"
PuttObjectTagging	使用 `tagging` SubResource可將一組標記新增至現有物件。物件標籤限制您可以在上傳新物件時新增標記、也可以將標記新增至現有物件。每個物件最多可支援10個標記的支援功能。StorageGRID與物件相關聯的標記必須具有唯一的標記金鑰。標籤金鑰長度最多可達128個UNICODE字元、標籤值長度最多可達256個UNICODE字元。金鑰和值區分大小寫。標記更新和擷取行為當您使用 PuttObjectTagging 更新物件的標記時、 StorageGRID 不會重新擷取物件。這表示不會使用相符ILM規則中指定的擷取行為選項。當ILM由正常背景ILM程序重新評估時、會對更新所觸發的物件放置位置進行任何變更。這表示、如果 ILM 規則使用嚴格選項來擷取行為、則無法在無法進行所需物件放置時（例如、因為新要求的位置無法使用）、就不會採取任何行動。更新後的物件會保留其目前的放置位置、直到能夠放置所需的位置為止。解決衝突衝突的用戶端要求（例如兩個寫入同一個金鑰的用戶端）會以「最新致勝」的方式解決。「最新致勝」評估的時間取決於StorageGRID 何時由VMware系統完成指定的要求、而非S3用戶端開始作業的時間。版本管理如果是 `versionId` 查詢參數未在要求中指定、該作業會將標記新增至版本控制儲存區中物件的最新版本。如果物件的目前版本是刪除標記、則會傳回「 MethodNotAllowed 」狀態 `x-amz-delete-marker` 回應標頭設定為 `true`。
選取物件內容	"選取物件內容"

刪除物件

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

處理 DeleteObject 要求時、 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 物件鎖定" 以瞭解如何在治理模式中刪除物件版本。

刪除ObjectTagging

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

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

GetObject

"GetObject"

GetObjectAcl

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

GetObjectLegalHold

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

GetObjectRetention

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

GetObjectTagging

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

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

標題物件

"標題物件"

RestoreObject

"RestoreObject"

PuttObject

"PuttObject"

CopyObject

（先前命名的「 Put 物件 - 複本」）

"CopyObject"

PutObjectLegalHold

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

PutObjectRetention

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

PuttObjectTagging

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

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

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

選取物件內容

"選取物件內容"

物件上的作業

Creating your file...