资源和端点
建议更改
PDF
Astra Control REST 资源摘要
Astra Control REST API 中提供的主要资源端点分为三类。除了需要说明的情况外，可以使用一整套 CRUD 操作（创建，读取，更新，删除）来访问每个资源。
-
版本 * 列表示首次引入资源时的 Astra 版本。对于新添加到当前版本的资源，此字段为粗体。
核心资源
核心资源端点可提供建立和维护 Astra 运行时环境所需的基础服务。
| 资源 | 版本。 | Description |
|---|---|---|
Account |
21.12 |
通过帐户资源，您可以管理多租户 Astra Control 部署环境中的隔离租户。 |
ASUP |
21.08. |
ASUP 资源表示转发给 NetApp 支持部门的 AutoSupport 捆绑包。 |
凭据 |
21.04 |
凭据资源包含可用于 Astra 用户，集群，分段和存储后端的安全相关信息。 |
授权 |
21.08. |
授权资源表示根据活动许可证和订阅可供帐户使用的功能和容量。 |
事件 |
21.04 |
事件资源表示系统中发生的所有事件，包括归类为通知的子集。 |
执行钩 |
21.12 |
执行钩资源表示自定义脚本，您可以在执行受管应用程序的快照之前或之后运行这些脚本。 |
功能 |
21.08. |
这些功能资源表示选定的 Astra 功能，您可以查询这些功能来确定它们是否已在系统中启用。访问权限仅限于只读。 |
挂钩源 |
21.12 |
hook 源资源表示与执行 hook 一起使用的实际源代码。将源代码与执行控制分开具有多种优势，例如允许共享脚本。 |
许可证 |
21.08. |
许可证资源表示可用于 Astra 帐户的许可证。 |
通知 |
21.04 |
通知资源表示具有通知目标的 Astra 事件。访问权限按用户提供。 |
软件包 |
* 。 22.04* |
软件包资源用于注册和访问软件包定义。软件包由多个组件组成，包括文件，映像和其他项目。 |
角色绑定 |
21.04 |
角色绑定资源表示特定用户对和帐户之间的关系。除了这两者之间的链接之外，还会通过特定角色为每个指定一组权限。 |
正在设置 … |
21.08. |
设置资源表示一组密钥值对，用于描述特定 Astra 帐户的功能。 |
订阅。 |
21.08. |
订阅资源表示 Astra 帐户的活动订阅。 |
令牌 |
21.04 |
令牌资源表示可通过编程方式访问 Astra Control REST API 的令牌。 |
未读通知 |
21.04 |
未读通知资源表示已分配给特定用户但尚未读取的通知。 |
升级 |
* 。 22.04* |
通过升级资源，您可以访问软件组件并启动升级。 |
用户 |
21.04 |
用户资源表示 Astra 用户能够根据其定义的角色访问系统。 |
受管应用程序资源
通过受管应用程序资源端点，可以访问受管 Kubernetes 应用程序。
| 资源 | 版本。 | Description |
|---|---|---|
应用程序资产 |
21.04 |
应用程序资产资源表示管理 Astra 应用程序所需的内部状态信息集合。 |
应用程序备份 |
21.04 |
应用程序备份资源表示受管应用程序的备份。 |
应用程序快照 |
21.04 |
应用程序快照资源表示受管应用程序的快照。 |
执行挂机覆盖 |
21.12 |
使用执行挂钩覆盖资源，您可以根据需要为特定应用程序禁用预加载的 NetApp 默认执行挂钩。 |
受管应用程序 |
21.04 |
托管应用程序资源代表由 Astra 管理的 Kubernetes 应用程序。 |
计划 |
21.04 |
计划资源表示在数据保护策略中为受管应用程序计划的数据保护操作。 |
拓扑资源
通过拓扑资源端点可以访问非受管应用程序和存储资源。
| 资源 | 版本。 | Description |
|---|---|---|
应用程序 |
21.04 |
应用程序资源表示所有 Kubernetes 应用程序，包括那些不受 Astra 管理的应用程序。 |
存储分段 |
21.08. |
存储分段资源表示用于存储由 Astra 管理的应用程序备份的 S3 云分段。 |
云 |
21.08. |
云资源表示 Astra 客户端为管理集群和应用程序而可以连接到的云。 |
集群 |
21.08. |
集群资源表示不受 Kubernetes 管理的 Kubernetes 集群。 |
集群节点 |
21.12 |
集群节点资源允许您访问 Kubernetes 集群中的各个节点，从而提供额外的解析。 |
受管集群 |
21.08. |
受管集群资源表示当前由 Kubernetes 管理的 Kubernetes 集群。 |
托管存储后端 |
21.12 |
通过托管存储后端资源，您可以访问后端存储提供程序的抽象表示形式。这些存储后端可供受管集群和应用程序使用。 |
命名空间 |
21.12 |
命名空间资源用于访问 Kubernetes 集群中使用的命名空间。 |
存储后端 |
21.08. |
存储后端资源表示可由 Astra 管理的集群和应用程序使用的存储服务提供商。 |
存储类 |
21.08. |
存储类资源表示已发现并可供特定受管集群使用的不同存储类或类型。 |
Volume |
21.04 |
卷资源表示与受管应用程序关联的 Kubernetes 存储卷。 |
最新版本中的新端点
当前的 22.04 Astra Control 版本增加了以下 REST 端点。此外，已升级多个现有资源的版本。
-
/accouns/ ｛ account_id ｝ /core/v1/packages
-
/accouns/ ｛ account_id ｝ /core/v1/packages/｛ package_id ｝
-
/accouns/ ｛ account_id ｝ /core/v1/upgrades
-
/accouns/ ｛ account_id ｝ /core/v1/upgrades// ｛ upgrade_id ｝
-
/accouns/ ｛ account_id ｝ /topology/v1/appBackups
-
/accouns/ ｛ account_id ｝ /topology/v1/appBackups/ ｛ appBackup_id ｝
-
/accouns/ ｛ account_id ｝ /topology/v1/cloud / ｛ clune_id ｝ /clusters/ ｛ cluster_id ｝ /clusterNode
-
/accouns/ ｛ account_id ｝ /topology/v1/cloud / ｛ clune_id ｝ /cluster/ ｛ cluster_id ｝ /clusterNodes/｛ clusterNode_id ｝
-
/accouns/ ｛ account_id ｝ /topology/v1/managedClusters/ ｛ managedCluster_id ｝ /apps/ ｛ app_id ｝ /appAssets
-
/accouns/ ｛ account_id ｝ /topology/v1/managedClusters/ ｛ managedCluster_id ｝ /apps/ ｛ app_id ｝ /appAssets/ ｛ appasset_id ｝
-
/accouns/ ｛ account_id ｝ /topology/v1/managedClusters/ ｛ managedCluster_id ｝ /clusterNode
-
/accouns/ ｛ account_id ｝ /topology/v1/managedClusters/ ｛ managedCluster_id ｝ /clusterNodes/ ｛ clusterNode_id ｝
其他资源和端点
您可以使用多种其他资源和端点来支持 Astra 部署。
|
这些资源和端点当前未包含在 Astra Control REST API 参考文档中。 |
- OpenAPI
-
通过 OpenAPI 端点可以访问当前的 OpenAPI JSON 文档和其他相关资源。
- OpenMetrics
-
通过 OpenMetrics 端点，您可以通过 OpenMetrics 资源访问帐户指标。Astra 控制中心部署模式支持此功能。