Cisco IMC XML API について
Cisco IMC XML API は C シリーズ ラックマウント サーバ の Cisco Integrated Management Controller (Cisco IMC) ソフトウェアに対するプログラマチック インターフェイスです。この API は、HTTP または HTTPS 経由で XML ドキュメントを受け取ります。開発者は、任意のプログラミング言語を使用して API メソッドを含む XML ドキュメントを生成できます。Cisco IMC の設定およびステータス情報は、XML API を介して完全にアクセスできる、MIT(管理情報ツリー)と呼ばれる階層ツリー構造に格納されます。
Cisco IMC XML API は、Cisco UCS Manager XML API で利用可能なメソッドのサブセットおよび管理情報モデルを実装します。両方の API の動作は構文およびセマンティクスの面で似ており、両方で同じクライアント開発ツールおよび技術を使用できます。Cisco IMC XML API の範囲は、Cisco UCS Manager XML API とは対照的に単一の C シリーズ ラックマウント サーバ に制限されており、スイッチ、FEX モジュール、サーバ、およびその他のデバイスで構成される Cisco UCS ドメイン 全体を制御します。
Cisco IMC XML API を使用して、ユーザはサーバを設定、管理、およびモニタするために Cisco IMC にプログラムでアクセスします。この API は、Cisco IMC CLI および GUI インターフェイスからアクセスできる機能の大部分を提供します。
API の動作はトランザクション型で、Cisco IMC で保持される単一のデータ モデルで終了します。
API モデルには、次のプログラマチック エンティティが含まれます。
-
クラス:MIT のオブジェクトのプロパティおよび状態を定義します。
-
メソッド:1 つまたは複数のオブジェクトに対して API が実行するアクションです。
-
タイプ:オブジェクト ステート(たとえば、
equipmentPresence
)に値をマッピングするオブジェクトのプロパティです。
一般的な要求は Cisco IMC に着信し、FIFO の順にトランザクタ キューに配置されます。トランザクタはこのキューから要求を取得し、要求を解釈して認可チェックを実行します。要求の確認後、トランザクタが MIT を更新します。このすべての動作は、1 つのトランザクションで行われます。
イベント サブスクリプションがサポートされます。最大で 4 つの Cisco IMC XML API クライアントが、Cisco IMC からのイベント通知を受信するようにサブスクライブできます。イベント サブスクリプション操作によって接続セッションが確立され、Cisco IMC によって非同期的に送信される XML 形式のイベント通知メッセージをクライアントが受信できるようになります。
(注) |
リリース 1.5(1.x) では、Cisco IMC XML API はエラーに関連するイベントのみについてイベント通知を送信します。 |