支援的Swift API端點
支援下列Swift API端點:資訊URL、驗證URL及儲存URL。StorageGRID
資訊URL
您可以StorageGRID 使用/info路徑、向Swift基礎URL發出Get要求、藉此判斷執行過程的功能和限制。
https://FQDN | Node IP:Swift Port/info/
在要求中:
-
FQDN
為完整網域名稱。 -
Node IP
是StorageGRID 指儲存節點的IP位址、或是指位於該網路上的閘道節點。 -
Swift Port
是儲存節點或閘道節點上用於Swift API連線的連接埠編號。
例如、下列資訊URL會向IP位址為10.99.106.103且使用連接埠18083的儲存節點要求資訊。
https://10.99.106.103:18083/info/
回應內容包括Swift實作的功能、即Json字典。用戶端工具可剖析Json回應、判斷實作的功能、並將其作為後續儲存作業的限制。
Swift的支援功能可未經驗證存取資訊URL。StorageGRID
驗證URL
用戶端可以使用Swift驗證URL來驗證租戶帳戶使用者身分。
https://FQDN | Node IP:Swift Port/auth/v1.0/
您必須在中提供租戶帳戶ID、使用者名稱和密碼作為參數 X-Auth-User
和 X-Auth-Key
要求標頭、如下所示:
X-Auth-User: Tenant_Account_ID:Username
X-Auth-Key: Password
在要求標頭中:
-
Tenant_Account_ID
是StorageGRID 建立Swift租戶時由支援人員指派的帳戶ID。這是租戶管理員登入頁面上使用的相同租戶帳戶ID。 -
Username
是租戶管理程式中建立的租戶使用者名稱。此使用者必須屬於具有Swift Administrator權限的群組。租戶的根使用者無法設定為使用 Swift REST API 。如果租戶帳戶已啟用Identity Federation、請提供LDAP伺服器的聯盟使用者名稱和密碼。或者、提供LDAP使用者的網域名稱。例如:
X-Auth-User: Tenant_Account_ID:Username@Domain_Name
-
Password
是租戶使用者的密碼。使用者密碼是在租戶管理程式中建立及管理的。
成功驗證要求的回應會傳回儲存URL和驗證權杖、如下所示:
X-Storage-Url: https://FQDN | Node_IP:Swift_Port/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_Port/v1/Tenant_Account_ID
[/container][/object]
X-Auth-Token: token
有些儲存回應標頭包含使用量統計資料、可能無法反映最近修改物件的準確數字。這些標頭可能需要幾分鐘的時間才能顯示準確的數字。
下列帳戶和容器作業的回應標頭是包含使用統計資料的範例:
-
X-Account-Bytes-Used
-
X-Account-Object-Count
-
X-Container-Bytes-Used
-
X-Container-Object-Count