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

URL 格式

贡献者
PDF

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

帐户作为 root

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

端点资源类别

Astra 资源端点分为三类：

  • 核心（` / 核心` ）

  • 受管应用程序（` /K8s` ）

  • 拓扑（` / 拓扑` ）

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

类别版本

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

资源实例或集合

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

示例

  • 资源路径

    根据上述结构，端点的典型路径为： ` /accouns/ ｛ account_id ｝ /core/v1/users` 。

  • 完整的 URL

    相应端点的完整URL为： https://astra.netapp.io/accounts/{account_id}/core/v1/users。