ONTAP REST APIの移行に関する考慮事項
変更を提案
PDF
ONTAPI API (ZAPI) は、 NetApp ONTAPソフトウェアに含まれる独自の呼び出しのオリジナル セットです。 API は、ネットワーク管理 SDK を通じて提供され、データ ストレージ管理および管理タスクの自動化をサポートします。 ONTAPI を使用している場合は、REST API で利用できる拡張されたONTAP機能セットを活用するために、 ONTAP REST API への移行を計画する必要があります。
一般的な設計上の違い
ONTAP REST API とコマンドラインインターフェイスでは、設計が根本的に異なります。CLI のコマンドおよびパラメータは、 REST API 呼び出しに直接マッピングされません。また、似ているように見えても、入力パラメータの詳細が異なる場合があります。たとえば、数値の単位はバイト数またはサフィックス（ KB など）を使用して指定できます。を参照してください "API 要求を制御する入力変数" および "API リファレンス" を参照してください。
データ SVM は REST API を通じて公開されます
ONTAP では、いくつかのタイプの Storage Virtual Machine （ SVM ）がサポートされています。ただし、 ONTAP REST API を通じて直接公開されるのはデータ SVM だけです。クラスタとノードについての構成情報は REST API で使用できますが、クラスタとノードは別々の SVM として扱われません。
REST API を使用して ONTAP CLI にアクセスします
ONTAPI APIおよびCLIユーザがONTAP REST APIに移行できるように、ONTAPにはONTAP CLIにアクセスするためのRESTエンドポイントが用意されています。このパススルー機能を使用して、任意の CLI コマンドを実行できます。 RESTエンドポイントの使用はAutoSupportデータに返されます。これにより、NetAppはREST APIのギャップを特定し、ONTAPの今後のリリースで改善を行うことができます。
CLIコマンドを問題するには、次のルールに基づいて適切に形成されたREST API呼び出しを行う必要があります。
-
リソースパス
-
フィールド名
-
HTTP メソッド
CLIアクセスのベースリソースパスは次のとおりです。 /private/cli。REST API を使用した CLI へのアクセスの詳細については、 ONTAP API オンラインドキュメントページを参照してください。NetAppは、コードサンプルやその他の有用な情報を含むGitHubリポジトリも維持しています。を参照してください "ONTAP REST Python GitHub リポジトリ - CLI パススルーサンプル" を参照してください。
ONTAPI での SnapDiff の可用性に対する変更
SnapDiff v1とv2はONTAPI（ZAPI）管理フレームワークに基づいており、特定のバージョンのONTAPではいくつかのユーザビリティ制限があります。SnapDiff v3 APIはONTAPIを使用せず、ONTAP 9.8以降のリリースでサポートされています。ONTAPリリース全体におけるSnapDiff APIの可用性は次のように定義されます：
-
ONTAP 9.7 以前のリリース： v1 および v2 （ ONTAPI のみ）
-
ONTAP 9.8以降のリリース：v1、v2、v3。一部制限事項があります。ONTAPリリースに基づくSnapDiffサポートの詳細については、 "よくある質問：SnapDiff の ONTAP サポート"を参照してください。
バックアップアプリケーションがSnapDiffをサポートしていることを確認し、使用しているONTAPバージョンに基づく相互運用性の制限事項に注意してください。詳細については、 "ONTAP リリースノート"も参照してください。