NetApp Astra Control Python SDK
建議變更
PDF
NetApp Astra Control Python SDK是開放原始碼套件、可用於自動化Astra Control部署。此套件也是瞭解Astra Control REST API的寶貴資源、可能是建立自己自動化平台的一部分。
|
為了簡化作業、NetApp Astra Control Python SDK將在本頁的其餘部分中稱為* SDK*。 |
兩種相關軟體工具
SDK包含兩種不同但相關的工具、可在存取Astra Control REST API時以不同的抽象層級運作。
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。
SDK可從取得 "Python套件索引" 名稱* actooltooltool包*。套件已指派版本編號、並將視需要繼續更新。您必須使用*子母畫面*套件管理公用程式、將套件安裝到您的環境中。
安裝完成後、您可以在指令碼中放置「匯入astraSDK」來使用astraSDK.py類別。此外、也可在命令提示字元上直接叫用「actoolkit'」、相當於「toolkit.py」（「actoolkitlist叢集」與「./toolkit.py list叢集」相同）。
請參閱 "PyPI：NetApp Astra Control Python SDK" 以取得更多資訊。
您也可以在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 SDK中的Python類別、或是「toolkit.py」指令碼中的功能、最終都能在Astra Control部署中存取REST API。因此、您需要Astra帳戶和API權杖。請參閱 "開始之前" 如需詳細資訊、請參閱本文件*入門*一節中的其他頁面。
SDK有幾項與本機Python環境相關的先決條件。例如、您必須使用Python 3.8或更新版本。此外、還需要幾個Python套件。如需詳細資訊、請參閱GitHub儲存庫頁面或PyPI套件頁面。