API 定義を作成またはアップロードする
API定義は、OpenAPI仕様規格(Swagger 2.0、OpenAPI 3.0.x)を用いてAPIを記述した文書である。この定義には、API リソースパスとそれらを操作するメソッドを含めることができます。API定義をNetScalerコンソールに追加して、APIゲートウェイ(NetScaler)にデプロイすることができます。
API 定義は、次のいずれかの方法で作成できます。
注:
現在、NetScalerコンソールは、 Swagger 2.0またはopenapi 3.0.1**を使用するOAS仕様ファイルの解析をサポートしています。
OAS 仕様をアップロードする
OAS仕様をNetScalerコンソールのGUIにアップロードできます。
-
[ セキュリティ] > [API セキュリティ] > [API 定義] に移動します。
-
[追加] をクリックします。
-
「 OAS仕様のアップロード」を選択します。
注:
OAS 仕様ファイルが YAML または JSON 形式であることを確認してください。また、このファイルに外部参照を含めることはできません。現在、NetScaler コンソールはSwaggerバージョン2.0をサポートしています。
-
ローカルコンピューターからOAS仕様を参照し、NetScaler コンソールにアップロードします。
API 定義を作成する
NetScalerコンソールのGUIで独自のAPI定義を作成できます。
-
[ セキュリティ] > [API セキュリティ] > [API 定義] に移動します。
-
[追加] をクリックします。
-
[ 定義を作成 ] を選択し、次の項目を指定します。
-
名前 -API定義の名前。
-
API 定義 -定義には、タイトル、バージョン、ベースパス、およびホストを含める必要があります。[ Host ] フィールドで、ドメイン名または IP アドレスを指定できます。
-
API リソース -定義に複数の API リソースを追加します。各リソースには、パスとサポートされているメソッドがあります。[追加] をクリックします。リソースが「 追加リソース」テーブルに追加されます 。API リソースを削除するには 、「削除」をクリックします。
-
-
[作成] をクリックします。
API 定義の表示
[ API 定義 ] ページには、アップロードされた定義が一覧表示されます。[ 表示 ] をクリックして、次の API 定義の詳細を表示します。
-
「名前 」-API 定義の名前を表示します。
-
「API 定義」-定義のタイトル 、バージョン、ベースパス、ホストを表示します。
-
API リソース — API 定義内の API リソースと、それらを操作するためのメソッドを一覧表示します。