Skip to main content
本产品推出了新版本。
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

URL 格式

贡献者

用于通过 REST API 访问资源实例或集合的 URL 的常规结构由多个值组成。此结构反映了底层对象模型和系统设计。

帐户作为 root

指向每个 REST 端点的资源路径的根是 Astra 帐户。因此, URL 中的所有路径均以 ` /account/ { account_id }` 开头,其中 account_id 是帐户的唯一 UUIDv4 值。内部结构这反映了一种设计,其中所有资源访问都基于特定帐户。

端点资源类别

Astra 资源端点分为三类:

  • 核心(` / 核心` )

  • 受管应用程序(` /K8s` )

  • 拓扑(` / 拓扑` )

请参见 "Resources" 有关详细信息 …​

类别版本

这三个资源类别中的每一个都有一个全局版本,用于控制所访问资源的版本。按照约定和定义,迁移到资源类别的新主要版本(例如,从 ` /v1` 到 ` /v2` )将会导致 API 发生中断更改。

资源实例或集合

根据是否访问资源实例或集合,可以在路径中使用资源类型和标识符的组合。

示例