Skip to main content
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

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檔案之外、也提供「toolkit.py」指令碼。此指令碼可存取內部定義為Python功能的獨立管理動作、以更高的抽象層級運作。指令碼會匯入Astra SDK、並視需要呼叫類別。

如何存取

您可以使用下列方式存取SDK。

Python套件

SDK可從取得 "Python套件索引" 名稱* actooltooltool包*。套件已指派版本編號、並將視需要繼續更新。您必須使用*子母畫面*套件管理公用程式、將套件安裝到您的環境中。

安裝完成後、您可以在指令碼中放置「匯入astraSDK」來使用astraSDK.py類別。此外、也可在命令提示字元上直接叫用「actoolkit'」、相當於「toolkit.py」(「actoolkitlist叢集」與「./toolkit.py list叢集」相同)。

請參閱 "PyPI:NetApp Astra Control Python SDK" 以取得更多資訊。

GitHub原始程式碼

您也可以在GitHub取得SDK原始程式碼。儲存庫包含下列項目:

  • 「astrasdk.py」(使用Python類別的Astra SDK)

  • 「toolit.py」(較高層級的功能型指令碼)

  • 詳細的安裝要求與指示

  • 安裝指令碼

  • 其他文件

您可以複製 "GitHub:NetApp/NetApp-Astra工具套件" 儲存庫。

安裝與基本需求

在安裝套件及準備使用套件時、需要考量幾種選項和需求。

安裝選項摘要

您可以使用下列其中一種方法來安裝SDK:

  • 使用準備好的 "Docker:NetApp/Astra工具套件" 映像、安裝了所有必要的相依性、包括「actoolkit」

  • 使用Pip將PyPI的「actoolkit」套件安裝到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套件頁面。