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にアップロードできます。

  1. [ セキュリティ] > [API セキュリティ] > [API 定義] に移動します。

  2. [追加] をクリックします。

  3. OAS仕様のアップロード」を選択します。

    注:

    OAS 仕様ファイルが YAML または JSON 形式であることを確認してください。また、このファイルに外部参照を含めることはできません。現在、NetScaler コンソールはSwaggerバージョン2.0をサポートしています。

  4. ローカルコンピューターからOAS仕様を参照し、NetScaler コンソールにアップロードします。

API 定義を作成する

NetScalerコンソールのGUIで独自のAPI定義を作成できます。

  1. [ セキュリティ] > [API セキュリティ] > [API 定義] に移動します。

  2. [追加] をクリックします。

  3. [ 定義を作成 ] を選択し、次の項目を指定します。

    • 名前 -API定義の名前。

    • API 定義 -定義には、タイトル、バージョン、ベースパス、およびホストを含める必要があります。[ Host ] フィールドで、ドメイン名または IP アドレスを指定できます。

    • API リソース -定義に複数の API リソースを追加します。各リソースには、パスとサポートされているメソッドがあります。[追加] をクリックします。リソースが「 追加リソース」テーブルに追加されます 。API リソースを削除するには 、「削除」をクリックします。

    API 定義を作成する

  4. [作成] をクリックします。

API 定義の表示

[ API 定義 ] ページには、アップロードされた定義が一覧表示されます。[ 表示 ] をクリックして、次の API 定義の詳細を表示します。

  • 「名前 」-API 定義の名前を表示します。

  • API 定義」-定義のタイトル 、バージョン、ベースパス、ホストを表示します。

  • API リソース — API 定義内の API リソースと、それらを操作するためのメソッドを一覧表示します。

API 定義を作成またはアップロードする