支援的Swift API端點
-
此文件 PDF 的網站
![](/zh-tw/storagegrid-116/images/pdf-zip.png)
個別的 PDF 文件集合
Creating your file...
支援下列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」