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

Swift REST API作業StorageGRID

貢獻者
PDF

Swift REST API上新增了特定StorageGRID 於該系統的作業。

取得Container一致性要求

"一致性值" 在物件的可用度與這些物件在不同儲存節點和站台之間的一致性之間取得平衡。「取得容器一致性」要求可讓您判斷套用至特定容器的一致性。

申請

要求HTTP標頭 說明

X-AUTH-Token

指定要用於要求的帳戶Swift驗證權杖。

X-ntap-sg- 一致性

指定要求類型、其中 true =取得容器一致性、以及 false =取得容器。

主機

要求導向的主機名稱。

申請範例

GET /v1/28544923908243208806/Swift container
X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29
x-ntap-sg-consistency: true
Host: test.com

回應

回應HTTP標頭 說明

日期

回應的日期和時間。

連線

是否開啟或關閉與伺服器的連線。

X-trans-ID

要求的唯一交易識別碼。

內容長度

回應本文的長度。

X-ntap-sg- 一致性

套用至容器的一致性。支援下列值：

  • 全部 * ：所有節點都會立即接收資料、否則要求將會失敗。

Strong-globall ：保證所有網站上所有用戶端要求的寫入後讀取一致性。

Strong-site ：保證網站內所有用戶端要求的寫入後讀取一致性。

  • 新寫入後讀取 * ：（預設）提供新物件的寫入後讀取一致性、以及物件更新的最終一致性。提供高可用度與資料保護保證。建議大多數情況下使用。

  • 可用 * ：提供新物件和物件更新的最終一致性。對於 S3 貯體、請僅視需要使用（例如、包含很少讀取的記錄值之貯體、或用於對不存在的金鑰執行 head 或 Get 作業）。S3 FabricPool 儲存區不支援。

回應範例

HTTP/1.1 204 No Content
Date: Sat, 29 Nov 2015 01:02:18 GMT
Connection: CLOSE
X-Trans-Id: 1936575373
Content-Length: 0
x-ntap-sg-consistency: strong-site

放置容器一致性要求

「放置容器一致性要求」可讓您指定要套用至容器上執行之作業的一致性。根據預設、會使用「新寫入後讀取」一致性來建立新的容器。

申請

要求HTTP標頭 說明

X-AUTH-Token

用於要求的帳戶Swift驗證權杖。

X-ntap-sg- 一致性

適用於容器上作業的一致性。支援下列值：

  • 全部 * ：所有節點都會立即接收資料、否則要求將會失敗。

Strong-globall ：保證所有網站上所有用戶端要求的寫入後讀取一致性。

Strong-site ：保證網站內所有用戶端要求的寫入後讀取一致性。

  • 新寫入後讀取 * ：（預設）提供新物件的寫入後讀取一致性、以及物件更新的最終一致性。提供高可用度與資料保護保證。建議大多數情況下使用。

  • 可用 * ：提供新物件和物件更新的最終一致性。對於 S3 貯體、請僅視需要使用（例如、包含很少讀取的記錄值之貯體、或用於對不存在的金鑰執行 head 或 Get 作業）。S3 FabricPool 儲存區不支援。

Host

要求導向的主機名稱。

一致性與 ILM 規則如何互動、以影響資料保護

任您選擇 "一致性價值" 而且您的 ILM 規則會影響物件的保護方式。這些設定可以互動。

例如、儲存物件時所使用的一致性會影響物件中繼資料的初始放置、而 "擷取行為" 為 ILM 規則選取會影響物件複本的初始放置位置。由於 StorageGRID 需要同時存取物件的中繼資料及其資料、才能滿足用戶端要求、因此針對一致性和擷取行為選擇符合的保護層級、可以提供更好的初始資料保護、以及更可預測的系統回應。

一致性與 ILM 規則互動方式的範例

假設您有一個雙站台網格、其中包含下列 ILM 規則及下列一致性：

  • * ILM規則*：建立兩個物件複本、一個在本機站台、一個在遠端站台。選取嚴格的擷取行為。

  • ** ：「 Strong-global" （物件中繼資料會立即發佈至所有站台。）

當用戶端將物件儲存到網格時、StorageGRID 在成功傳回用戶端之前、功能區會同時複製物件並將中繼資料散佈到兩個站台。

在擷取最成功的訊息時、物件會受到完整保護、不會遺失。例如、如果在擷取後不久即遺失本機站台、則物件資料和物件中繼資料的複本仍存在於遠端站台。物件可完全擷取。

如果您改用相同的 ILM 規則和「強式站台」一致性、則在物件資料複寫到遠端站台、但在物件中繼資料散佈到遠端站台之前、用戶端可能會收到成功訊息。在此情況下、物件中繼資料的保護層級與物件資料的保護層級不符。如果在擷取後不久本機站台便會遺失、則物件中繼資料將會遺失。無法擷取物件。

一致性與 ILM 規則之間的相互關係可能很複雜。如需協助、請聯絡NetApp。

申請範例

PUT /v1/28544923908243208806/_Swift container_
X-Auth-Token: SGRD_3a877009a2d24cb1801587bfa9050f29
x-ntap-sg-consistency: strong-site
Host: test.com

回應

回應HTTP標頭 說明

Date

回應的日期和時間。

Connection

是否開啟或關閉與伺服器的連線。

X-Trans-Id

要求的唯一交易識別碼。

Content-Length

回應本文的長度。

回應範例

HTTP/1.1 204 No Content
Date: Sat, 29 Nov 2015 01:02:18 GMT
Connection: CLOSE
X-Trans-Id: 1936575373
Content-Length: 0