基本的な動作特性
REST で共通のテクノロジとベストプラクティスは確立されますが、各 API の詳細は設計内容に応じて異なる場合があります。API を使用する前に、 ONTAP Select Deploy API の詳細と運用上の特性を把握しておく必要があります。
ハイパーバイザーホストと ONTAP Select ノードです
a_hypervisor host_ は、 ONTAP Select 仮想マシンをホストするコアハードウェアプラットフォームです。ONTAP Select 仮想マシンを導入してハイパーバイザーホストでアクティブにすると、その仮想マシンは _ ONTAP Select node_name とみなされます。Deploy REST API のバージョン 3 では、ホストオブジェクトとノードオブジェクトは別々になります。これにより、 1 つ以上の ONTAP Select ノードを同じハイパーバイザーホストで実行できる 1 対多の関係が実現します。
オブジェクト ID
各リソースインスタンスまたはオブジェクトには、作成時に一意の識別子が割り当てられます。これらの識別子は、 ONTAP Select Deploy の特定のインスタンス内でグローバルに一意です。新しいオブジェクトインスタンスを作成するAPI呼び出しを発行すると、関連付けられているid値が location
HTTP応答のヘッダー。リソースインスタンスを以降の呼び出しで参照する際には、この識別子を抽出して使用できます。
オブジェクト識別子の内容と内部構造は、いつでも変更される可能性があります。識別子を使用するのは、該当する API 呼び出しで関連付けられているオブジェクトを参照するときに必要に応じてのみです。 |
要求 ID
成功したすべての API 要求には、一意の識別子が割り当てられます。識別子は request-id
関連付けられたHTTP応答のヘッダー。要求 ID を使用すると、単一の API 要求と応答のトランザクションのアクティビティをまとめて参照できます。たとえば、要求 ID に基づいて、トランザクションのすべてのイベントメッセージを取得できます
同期呼び出しと非同期呼び出し
サーバがクライアントから受信した HTTP 要求を実行する主な方法は 2 つあります。
-
同期
サーバは要求をただちに実行し、ステータスコード200、201、または204で応答します。 -
非同期
サーバは要求を受け入れ、ステータスコード202で応答します。これは、サーバがクライアント要求を受け入れ、要求を完了するためのバックグラウンドタスクを開始したことを示します。最終的な成功または失敗はすぐには確認できないため、追加の API 呼び出しで確認する必要があります。
長時間実行されているジョブの完了を確認する
通常、完了までに時間がかかる処理は、
サーバーでのバックグラウンドタスク。Deploy REST APIでは、すべてのバックグラウンドタスクが
タスクを追跡し、現在の状態などの情報を提供するジョブオブジェクト。ジョブオブジェクト
は、バックグラウンドタスクが作成されたあとのHTTP応答で返されます。
ジョブオブジェクトを直接照会することで、関連する API 呼び出しの成功または失敗を確認できます。
ジョブ object_for 追加情報 を使用した非同期処理を参照してください。
ジョブオブジェクトを使用する以外にも、ジョブオブジェクトの成功または失敗を判断する方法があります。
次のようなリクエストがあります。
-
イベントメッセージ
元の応答で返された要求IDを使用すると、特定のAPI呼び出しに関連するすべてのイベントメッセージを取得できます。通常、イベントメッセージには成功または失敗の兆候が含まれており、エラー状態のデバッグ時にも役立ちます。 -
リソースの状態またはステータス
一部のリソースには、状態またはステータスの値が保持されています。この値を照会して、要求の成功または失敗を間接的に判断できます。
セキュリティ
Deploy API では、次のセキュリティテクノロジを使用します。
-
トランスポートレイヤのセキュリティ
Deployサーバとクライアントの間でネットワーク経由で送信されるすべてのトラフィックは、TLSを介して暗号化されます。暗号化されていないチャネル上で HTTP プロトコルを使用することはサポートされていません。TLS バージョン 1.2 がサポートされています。 -
HTTP認証
すべてのAPIトランザクションでベーシック認証が使用されます。base64 文字列のユーザ名とパスワードを含む HTTP ヘッダーがすべての要求に追加されます。