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

URL 格式

贡献者

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

帐户作为 root

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

端点资源类别

Astra 资源端点分为三类:

  • 核心 (/core

  • 受管应用程序 (/k8s

  • 拓扑 (/topology

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

类别版本

这三个资源类别中的每一个都有一个全局版本,用于控制所访问资源的版本。根据约定和定义、移动到资源类别的新主要版本(例如 /v1 to /v2)将在API中引入中断更改。

资源实例或集合

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

示例
  • 资源路径

    根据上述结构、端点的典型路径为: /accounts/{account_id}/core/v1/users

  • 完整的 URL

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