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つの重要なタスクがあります:
-
システムまたはサーバーベースのリソースを特定する
-
リソースの状態と関連する状態遷移操作を定義します
クライアントアプリケーションは、明確に定義されたメッセージフローを通じて、リソースの状態を表示および変更できます。
ハイパーテキスト転送プロトコル(HTTP)は、Webサービスクライアントとサーバーがリソースに関するメッセージを交換するために使用するプロトコルです。これは、作成、読み取り、更新、削除という一般的な操作に基づくCRUDモデルに従っています。HTTPプロトコルには、リクエストヘッダーとレスポンスヘッダー、およびレスポンスステータスコードが含まれます。
利用可能なメッセージ形式はいくつかありますが、最も人気のあるオプションはJavaScriptオブジェクト表記法(JSON)です。JSONは、シンプルなデータ構造をプレーンテキストで表現するための業界標準であり、リソースや必要なアクションを記述する状態情報を転送するために使用されます。
セキュリティはREST APIの重要な側面です。ネットワーク上のHTTPトラフィックを保護するために使用されるトランスポート層セキュリティ(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 10 は、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の自動化"を参照してください。