此產品有較新版本可以使用。
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。
URL格式
貢獻者
建議變更
用於透過REST API存取資源執行個體或集合的URL一般結構由數個值組成。此結構反映基礎物件模型和系統設計。
帳戶為root
每個REST端點的資源路徑根目錄為Astra帳戶。因此URL中的所有路徑都以開頭 /account/{account_id}
其中 account_id
為帳戶的唯一UUIDv4值。內部架構反映出所有資源存取都以特定帳戶為基礎的設計。
端點資源類別
Astra資源端點分為三種不同類別:
-
核心 (
/core
) -
託管應用程式 (
/k8s
) -
拓撲 (
/topology
)
請參閱 "資源" 以取得更多資訊。
類別版本
這三種資源類別各有一個全域版本、可控制所存取資源的版本。根據慣例和定義、移至資源類別的新主要版本(例如 /v1
至 /v2
)將會在API中引入中斷變更。
資源執行個體或集合
根據資源執行個體或集合是否被存取、路徑中可以使用資源類型和識別碼的組合。
範例
-
資源路徑
根據上述結構、端點的典型路徑為:
/accounts/{account_id}/core/v1/users
。 -
完整URL