第1章 はじめに
Red Hat Virtualization Manager には、Representational State Transfer (REST) API が含まれています。ソフトウェア開発者やシステム管理者は、この API を使用することで、標準の Web インターフェイス以外で Red Hat Virtualization 環境を制御できるようになります。API は、開発者および管理者が Red Hat Virtualization 環境の機能を標準の Hypertext Transfer Protocol (HTTP) 経由で API にアクセスする外部アプリケーションやカスタムスクリプトと統合する場合に便利です。
API の利点は以下のとおりです。
- 幅広いクライアントサポート: HTTP プロトコルをサポートする各種プログラミング言語、フレームワークまたはシステムで API を使用できます。
- 自己記述型: 実行時に多くの詳細が発見されるため、クライアントアプリケーションでは、仮想化インフラストラクチャーの情報は最小限で済みます。
- リソースベースのモデル: リソースベースの REST モデルにより仮想化プラットフォームを自然な形で管理することが可能です。
これにより、開発者および管理者は以下のような作業を行うことができます。
- エンタープライズ IT システムとの統合
- サードパーティーの仮想化ソフトウェアとの統合
- 自動メンテナンスやエラーチェックなどのタスクの実行
- スクリプトを使って、Red Hat Virtualization 環境の反復タスクを自動化します。
本書は、Red Hat Virtualization API のリファレンスとしてのロールを果たします。本ガイドでは、開発者および管理者を対象に、指定の SDK を使用するか、直接、API を経由して Red Hat Virtualization 環境を利用する方法の手順と実例を記載しています。
1.1. Representational State Transfer
Representational State Transfer (REST) は、特定のサービスとその表現に焦点を当てた設計アーキテクチャーです。リソース表現は、情報の主要な抽象化で、サーバー上の特定の 1 つの管理要素に対応します。クライアントは Uniform Resource Identifier (URI) にある server 要素に要求を送信し、GET、POST、PUT、DELETE などの標準の HTTP メソッドで操作を実行します。これにより、クライアントとサーバー間でステートレスに通信が行われ、各要求が他の要求とは独立して機能し、要求完了必要なすべての情報が含まれます。
1.1.1. API の前提条件
Red Hat Virtualization API を使用するための前提条件
- API を含む Red Hat Virtualization Manager のネットワークインストール。
API サーバーから HTTP 要求を開始および受信するクライアントまたはプログラミングライブラリー。以下に例を示します。
- oVirt Python SDK
- oVirt Java SDK
- cURL コマンドラインツール
- RESTClient (RESTful Web サービスのデバッガー)
- HTTP (Hypertext Transfer Protocol) の知識 (REST API の対話に使用されるプロトコル)。RFC 2616: HTTP/1.1 を参照してください。
- API がリソース表現の構築に使用する Extensible Markup Language(XML) または JavaScript Object Notation(JSON) の知識。W3C の Extensible Markup Language (XML) 1.0 および ECMA-404: JSON data interchange syntax を参照してください。
