ONTAP tools REST APIについて学ぶ
ONTAP Tools for VMware vSphere 10は、仮想マシンのライフサイクル管理のための一連のツールです。これには、自動化プロセスの一部として使用できる堅牢なREST APIが含まれています。
基盤となるREST Webサービス
Representational State Transfer(REST)は、WebサービスAPIの設計など、分散Webアプリケーションを作成するための形式です。サーバベースのリソースを公開し、その状態を管理するための一連のテクノロジを確立します。
リソースはREST Webサービスアプリケーションの基本コンポーネントです。REST APIを設計する際の重要な初期タスクは次の2つです。
-
システムまたはサーバベースのリソースを特定する
-
リソースの状態および関連する状態遷移操作の定義
クライアントアプリケーションは、明確に定義されたメッセージフローを通じてリソースの状態を表示および変更できます。
Hypertext Transfer Protocol(HTTP)は、Webサービスのクライアントとサーバがリソースに関するメッセージの交換に使用するプロトコルです。一般的な操作であるCREATE、READ、UPDATE、およびDELETEに基づいてCRUDモデルに従います。HTTPプロトコルには、要求ヘッダーと応答ヘッダー、および応答ステータスコードが含まれています。
使用できるメッセージ形式はいくつかありますが、最も一般的なオプションはJavaScript Object Notation(JSON)です。JSONは、単純なデータ構造をプレーンテキストで表現するための業界標準であり、リソースと必要なアクションを記述した状態情報を転送するために使用されます。
セキュリティはREST APIの重要な側面です。ネットワーク経由のHTTPトラフィックの保護に使用されるTransport Layer Security(TLS)プロトコルに加えて、ONTAP tools for VMware vSphere 10 REST APIも認証にアクセストークンを使用します。アクセストークンを取得し、以降のAPI呼び出しで使用する必要があります。
ONTAP tools for VMware vSphere 10 REST APIは、ほとんどの要求を同期的に実行し、処理の完了時にステータスコードを返します。また、完了までに長い時間が必要なタスクの非同期処理もサポートされます。
ONTAP tools Manager環境
ONTAP tools Manager環境には、いくつかの側面を考慮する必要があります。
ONTAP tools for VMware vSphereは、 vSphere リモート プラグイン アーキテクチャを使用して導入されます。 REST API のサポートを含むソフトウェアは、別の仮想マシンで実行されます。
ONTAP tools for VMware vSphere 10 は、仮想マシンの機能へのゲートウェイを提供する単一の外部 IP アドレス(以前はロード バランサー)を公開します。このアドレスは初期設定時に指定します。このアドレスは、ONTAP tools Manager インターフェイスで使用されるほか、Swagger ドキュメント ページおよび REST API に直接アクセスする際にも使用されます。
ONTAP Tools for VMware vSphere 10 REST APIに加えて、ONTAPクラスタにも独自のREST APIがあります。ONTAP tools Managerは、ONTAP REST APIをクライアントとして使用してストレージ関連のタスクを実行します。これら2つのAPIは別個のものであることに注意することが重要です。詳細については、を参照してください "ONTAPの自動化"。