SDK には、 Astra Control REST API にアクセスするときに異なる抽象化レベルで動作する 2 つの異なる関連ツールが含まれています。

Astra SDK は、コアプラットフォーム機能を提供します。基盤となる REST API 呼び出しを抽象化する一連の Python クラスが含まれています。このクラスは、アプリケーション、バックアップ、 Snapshot 、クラスタなど、さまざまな Astra Control リソースに対する管理操作をサポートしています。

Astra SDKは、パッケージの一部であり、1つにまとめられています astraSDK.py ファイル。このファイルを環境にインポートし、クラスを直接使用できます。

Astra SDKファイルに加えて、を使用します toolkit.py スクリプトも使用できます。このスクリプトは、 Python 関数として内部的に定義されている個別の管理アクションにアクセスできるようにすることで、抽象化のレベルを高めて動作します。このスクリプトは、 Astra SDK をインポートし、必要に応じてクラスに呼び出します。

SDK には、次の方法でアクセスできます。

SDK は、から入手できます "Python パッケージインデックス" 名前* actoolkit *。パッケージにはバージョン番号が割り当てられており、必要に応じて更新が続行されます。パッケージを環境にインストールするには、 * PIP * パッケージ管理ユーティリティを使用する必要があります。

インストールが完了したら、を配置することでastraSDK.pyクラスを利用できます import astraSDK スクリプト内で実行できます。さらに、 actoolkit コマンドプロンプトから直接呼び出すことができます。はと同じです toolkit.py (actoolkit list clusters はと同じです ./toolkit.py list clusters）。

を参照してください "PyPi ： NetApp Astra Control Python SDK" を参照してください。

SDK ソースコードは GitHub からも入手できます。リポジトリには次のものが含まれます。

のクローンを作成できます "GitHub ： NetApp / NetApp-Astra - ツールキット" ローカル環境へのリポジトリ。

パッケージのインストールおよび使用準備の一環として、いくつかのオプションと要件を考慮する必要があります。

次のいずれかの方法で SDK をインストールできます。

詳細については、 PyPi および GitHub のページを参照してください。

Astra SDKのPythonクラスを直接使用する場合も、の関数を使用する場合もあります toolkit.py スクリプトを使用すると、最終的には、Astra Control環境でREST APIにアクセスすることになります。そのため、 API トークンを持つ Astra アカウントが必要になります。を参照してください "作業を開始する前に" 詳細については、このドキュメントの「 * はじめに * 」セクションの他のページを参照してください。

SDK には、ローカル Python 環境に関連するいくつかの前提条件があります。たとえば、Python 3.8以降を使用する必要があります。また、必要な Python パッケージもいくつかあります。詳細については、 GitHub リポジトリページまたは PyPI パッケージページを参照してください。

開始するために必要なリソースをいくつかご紹介します。