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

支援的Swift API端點

貢獻者

支援下列Swift API端點:資訊URL、驗證URL及儲存URL。StorageGRID

資訊URL

您可以StorageGRID 使用/info路徑、向Swift基礎URL發出Get要求、藉此判斷執行過程的功能和限制。

「https://FQDN|Node IP:Swift Port/info/」

在要求中:

  • 「_FQDN」是完整網域名稱。

  • 「節點IP」是StorageGRID 指儲存節點或位於該網路上之閘道節點的IP位址。

  • 「Swift Port_」是儲存節點或閘道節點上用於Swift API連線的連接埠號碼。

例如、下列資訊URL會向IP位址為10.99.106.103且使用連接埠18083的儲存節點要求資訊。

回應內容包括Swift實作的功能、即Json字典。用戶端工具可剖析Json回應、判斷實作的功能、並將其作為後續儲存作業的限制。

Swift的支援功能可未經驗證存取資訊URL。StorageGRID

驗證URL

用戶端可以使用Swift驗證URL來驗證租戶帳戶使用者身分。

「https://FQDN|Node IP:Swift Port/auth/v1.0 /」

您必須提供租戶帳戶ID、使用者名稱和密碼做為「X-AUTH使用者」和「X-AUTH金鑰」要求標頭中的參數、如下所示:

「X-AUuth使用者:Tenant_Account_ID:使用者名稱

「X-AUTH金鑰:Password

在要求標頭中:

  • Tenant_Account_ID」是StorageGRID 指在建立Swift租戶時、由支援部指派的帳戶ID。這是租戶管理員登入頁面上使用的相同租戶帳戶ID。

  • usernam_」是租戶使用者在租戶管理程式中建立的名稱。此使用者必須屬於具有Swift Administrator權限的群組。租戶的root使用者無法設定為使用Swift REST API。

    如果租戶帳戶已啟用Identity Federation、請提供LDAP伺服器的聯盟使用者名稱和密碼。或者、提供LDAP使用者的網域名稱。例如:

    「X-AUTH使用者:Tenant_Account_ID:使用者名稱@網域名稱

  • 「密碼」是租戶使用者的密碼。使用者密碼是在租戶管理程式中建立及管理的。

成功驗證要求的回應會傳回儲存URL和驗證權杖、如下所示:

「X-Storage-URL: https://FQDN[] |Node_ip:Swift連接埠/v1/Tenant_Account_ID`

「X-AUTH-Token:token

「X-Storage-Token:token

根據預設、權杖自產生時間起24小時內有效。

會針對特定租戶帳戶產生權杖。一個帳戶的有效權杖並未授權使用者存取另一個帳戶。

儲存URL

用戶端應用程式可以發出Swift REST API呼叫、以便針對閘道節點或儲存節點執行支援的帳戶、容器和物件作業。儲存要求會被定址至驗證回應中傳回的儲存URL。要求也必須包含從驗證要求傳回的X-auth-Token標頭和值。

https://FQDN |IP:Swift連接埠/v1/Tenant_Account_ID

「X-AUTH-Token:token

有些儲存回應標頭包含使用量統計資料、可能無法反映最近修改物件的準確數字。這些標頭可能需要幾分鐘的時間才能顯示準確的數字。

下列帳戶和容器作業的回應標頭是包含使用統計資料的範例:

  • 「X-Account-bytes -已用」

  • 「X-Account-Object-Count」

  • 「X-Container-bytes -已用」

  • 「X-Container-Object-Count」