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

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* 是指单个文件 astraSDK.py 中的核心 Python 类。

工具包脚本

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

如何访问

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

Python 软件包

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

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

GitHub 源代码

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

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

  • toolkit .py (基于函数的高级脚本)

  • 详细的安装要求和说明

  • 安装脚本

  • 其他文档

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

安装和基本要求

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

安装选项摘要

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

  • 使用 Pip 将 PyPI 中的软件包安装到 Python 环境中

  • 克隆 Git Hub 存储库,然后执行以下任一操作:

    • 将软件包部署为 Docker 容器(其中包括您需要的所有内容)

    • 复制这两个核心 Python 文件,以便可以通过 Python 客户端代码访问它们

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

Astra Control 环境的要求

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

NetApp Astra Control Python SDK 的要求

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

有用资源摘要