プロキシアクセスを介して ONTAP API にアクセスする
ゲートウェイ API を使用すると、 Active IQ Unified Manager クレデンシャルを使用して ONTAP REST API を実行し、ストレージオブジェクトを管理するという利点が得られます。これらの API は、 Unified Manager Web UI から API ゲートウェイ機能を有効にすると使用できます。
Unified Manager REST API では、 ONTAP クラスタである Unified Manager データソースで実行する一連の操作のみがサポートされます。その他の機能は、 ONTAP API を使用して利用できます。ゲートウェイAPIを使用すると、Unified Managerをパススルーインターフェイスにして、管理対象のONTAP クラスタですべてのAPI要求をトンネリングできます。各データセンタークラスタに個別にログインする必要はありません。単一の管理ポイントとして機能し、 Unified Manager インスタンスで管理される ONTAP クラスタ全体で API を実行できます。API ゲートウェイ機能を使用すると、個別にログインしなくても、複数の ONTAP クラスタを一元的に管理できます。ゲートウェイ API を使用すると、 ONTAP REST API 処理を実行して Unified Manager にログインしたまま ONTAP クラスタを管理できます。
|
すべてのユーザは、 GET 処理を使用してクエリを実行できます。アプリケーション管理者は、すべての ONTAP REST 処理を実行できます。 |
ゲートウェイは、ヘッダーと本文の形式を ONTAP API と同じにすることで、 API 要求をトンネリングするプロキシとして機能します。Unified Manager のクレデンシャルを使用して特定の処理を実行することで、個々のクラスタのクレデンシャルを渡すことなく ONTAP クラスタにアクセスして管理することができます。クラスタ認証とクラスタ管理は引き続き管理されますが、 API 要求は特定のクラスタで直接実行されます。API から返される応答は、対応する ONTAP REST API を ONTAP から直接実行した場合と同じです。
HTTP 動詞 | パス( URL ) | 説明 | ||
---|---|---|---|---|
|
|
この取得メソッドは、 ONTAP REST 呼び出しをサポートする Unified Manager で管理されているすべてのクラスタのリストを取得します。クラスタの詳細を確認し、クラスタ UUID または Universal Unique Identifier ( UUID )に基づいて他の方法を実行するように選択できます。
|
||
|
|
これは単一ポイントのプロキシ API で、 POST 、削除、パッチ処理がサポートされ、すべての ONTAP REST API に対応しています。ONTAP でサポートされている場合は、 API に制限は適用されません。トンネリングまたはプロキシ機能をディセーブルにすることはできません。 。 。 |
API ゲートウェイトンネリングの概要
ゲートウェイ API を使用すると、 Unified Manager を介して ONTAP オブジェクトを管理できます。Unified Manager はクラスタと認証の詳細を管理し、 ONTAP REST エンドポイントに要求をリダイレクトします。ゲートウェイ API は、ヘッダーおよび応答本文内の Engine of Application State ( HATEOAS )リンクとして、 URL および Hypermedia を API ゲートウェイベース URL で変換します。ゲートウェイ API は、 ONTAP REST URL を追加して必要な ONTAP REST エンドポイントを実行するプロキシのベース URL として機能します。
|
ONTAP APIをAPIゲートウェイ経由で正常に実行するには、APIが実行されているONTAP クラスタの同じバージョンでサポートされている必要があります。ONTAP クラスタでサポートされていないAPIを実行しても、結果は返されません。 |
この例では、ゲートウェイAPI(プロキシベースURL)は次のようになります。 /gateways/{uuid}/
取得されるONTAP APIは次のとおりです。 /storage/volumes
。path パラメータの値として、 ONTAP API REST URL を追加する必要があります。
|
パスを追加する際には、「」が削除されていることを確認してください/ |
追加されるURLは次のとおりです。 /gateways/{uuid}/storage/volumes
を実行している GET
処理の場合、生成されるURLは次のとおりです。 GEThttps://<hostname\>/api/gateways/<cluster_UUID\>/storage/volumes
。 /api
ONTAP REST URLのタグが付加されたURLから削除され、ゲートウェイAPIのタグは保持されます。
-
cURL コマンドの例 *
curl -X GET "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes" -H "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>"
API は、クラスタ内のストレージボリュームのリストを返します。応答形式は、 ONTAP から同じ API を実行した場合と同じです。ONTAP REST ステータスコードが返されます。
API スコープを設定します
すべての API には、クラスタのスコープ内にコンテキストセットがあります。Storage VM ベースで動作する API のスコープはクラスタでもあります。つまり、 API 処理は管理対象クラスタ内の特定の Storage VM に対して実行されます。を実行すると /gateways/{uuid}/{path}
APIを使用して、処理を実行するクラスタのクラスタUUID(Unified ManagerデータソースUUID)を入力していることを確認してください。そのクラスタ内の特定の Storage VM にコンテキストを設定する場合は、その Storage VM キーを X-Dot -svm-UUID パラメータとして指定するか、 Storage VM の名前を X-Dot -SVM-name パラメータとして入力します。パラメータが文字列ヘッダーのフィルタとして追加され、そのクラスタ内の Storage VM の範囲内で処理が実行されます。
-
cURL コマンドの例 *
curl -X GET "https://<hostname>/api/gateways/e4f33f90-f75f-11e8-9ed9-00a098e3215f/storage/volume" -H "accept: application/hal+json" -H "X-Dot-SVM-UUID: d9c33ec0-5b61-11e9-8760-00a098e3215f" -H "Authorization: Basic <Base64EncodedCredentials>"
ONTAP REST APIの使用方法の詳細については、を参照してくださいhttps://docs.netapp.com/us-en/ontap-automation/index.html["ONTAP REST API の自動化"]