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

NetApp Astra Control Python SDK

提供者

NetApp Astra Control Python SDK 是一个开源软件包,可用于自动部署 Astra Control 。该软件包也是了解 Astra Control REST API 的宝贵资源,或许可以在创建您自己的自动化平台时使用。

注 为了简单起见,本页其余部分将 NetApp Astra Control Python SDK 称为 * SDK * 。

两个相关软件工具

SDK 包含两个不同但相关的工具,这些工具在访问 Astra Control REST API 时在不同的抽象级别运行。

Astra SDK

Astra SDK 提供核心平台功能。它包括一组 Python 类,用于抽象化底层 REST API 调用。这些类支持对各种 Astra Control 资源执行管理操作,包括应用程序,备份,快照和集群。

Astra SDK是软件包的一部分、并在单个软件包中提供 astraSDK.py 文件您可以将此文件导入到您的环境中并直接使用这些类。

注 NetApp Astra Control Python SDK* (或仅 SDK )是整个软件包的名称。* Astra SDK*是指单个文件中的核心Python类 astraSDK.py
工具包脚本

除了Astra SDK文件之外、还可以使用 toolkit.py 脚本也可用。此脚本可通过访问内部定义为 Python 函数的独立管理操作,在较高的抽象级别下运行。该脚本将导入 Astra SDK 并根据需要调用类。

如何访问

您可以通过以下方式访问 SDK 。

Python 软件包

SDK 可从获取 "Python 软件包索引" 名称为* actoolkit 。软件包将分配一个版本号,并将根据需要继续更新。您必须使用 * Pip 软件包管理实用程序将软件包安装到您的环境中。

安装后、可以通过放置来利用astraSDK.py类 import astraSDK 在脚本中。此外、 actoolkit 可以直接在命令提示符处调用、相当于 toolkit.py (actoolkit list clusters 与相同 ./toolkit.py list clusters)。

请参见 "PyPI : NetApp Astra Control Python SDK" 有关详细信息 …​

GitHub 源代码

此外,还可以从 GitHub 获取 SDK 源代码。存储库包括以下内容:

  • astraSDK.py (采用Python类的Astra SDK)

  • toolkit.py (基于功能的高级脚本)

  • 详细的安装要求和说明

  • 安装脚本

  • 其他文档

您可以克隆 "GitHub : NetApp/NetApp-Astra-toolkits." 存储库连接到本地环境。

安装和基本要求

在安装软件包并准备使用该软件包时,需要考虑多个选项和要求。

安装选项摘要

您可以通过以下方式之一安装 SDK :

  • 使用准备好的 "Docker:NetApp/Astra-toolkits." 映像、已安装所有必要的依赖项、包括 actoolkit

  • 使用Pip安装 actoolkit 从PyPI打包到Python环境

  • 克隆GitHub存储库并复制/修改两个核心Python文件、以便可以通过Python客户端代码访问它们

有关详细信息,请参见 PyPI 和 GitHub 页面。

Astra Control 环境的要求

直接使用Astra SDK中的Python类还是中的功能 toolkit.py 脚本、最终您将在部署Astra Control时访问REST API。因此,您需要一个 Astra 帐户以及一个 API 令牌。请参见 "开始之前" 有关详细信息,请参见本文档 * 入门 * 一节中的其他页面。

NetApp Astra Control Python SDK 的要求

SDK 具有与本地 Python 环境相关的几个前提条件。例如、您必须使用Python 3.8或更高版本。此外,还需要几个 Python 软件包。有关详细信息,请参见 GitHub 存储库页面或 PyPI 软件包页面。