既存の WSDL サービスからの REST プロキシー API の作成

ファイルをアップロードすると、WSDL が評価され、その WSDL が有効かどうかを示すメッセージが表示されます。

.zip ファイルをアップロードする場合は、.zip ファイルにオプション・ファイルを組み込んで追加のディレクティブを指定できます。 詳細については、 「WSDLサービスのインポート時にオプションファイルを使用する」 を参照してください。

• 「タイトル」には、特殊文字を含めることができます。ただし、ユーザー・インターフェースに簡単に表示できるように短いものにしてください。
• 「名前」 は自動的に入力されます。 「名前」 フィールドの値は、 デベロッパーズ・ツールキット CLI コマンドで API を識別するために使用される単一のストリングです。 下書きのAPIを管理するためのCLIコマンドについては、 ツールキットのCLIリファレンスドキュメントを参照してください。
• Version は、API の OpenAPI 定義の info.version プロパティーの値に対応します。 version.release.modification というバージョン番号付け方式 (例えば 1.0.0) が推奨されます。
• 「基本パス」は API の URL セグメントであり、ホスト名や、パスおよび操作の追加セグメントは含まれません。 基本パスに特殊文字を含めることはできません。また、特殊文字が空の場合でも、 / 文字で開始する必要があります。
• オプションの「説明」は、API の識別に役立ちます。

• クライアント ID を使用した保護 - このオプションは、アプリケーションがクライアント ID (API キー) を提供する必要がある場合に選択します。 これにより、 X-IBM-Client-Id パラメーターが API の要求ヘッダーに組み込まれます。 このオプションを選択すると、API 呼び出しをキーごと (クライアント ID ごと) に制限するかどうかを選択できます。
  • キー単位で API 呼び出しレートを制限する - このオプションを選択した場合、必要なレート制限を構成する必要があります。 レート制限は、ある期間 (時、分、月、または日) 内に許可されている呼び出し最大数を制御します。 例えば、1 時間当たり 100 回の呼び出しです。
• CORS - このオプションは、API の CORS (cross-origin resource sharing) サポートを有効にする場合に選択します。 これにより、別のドメインから API にアクセスできるようになります。
  注:

  • CORS サポートは.でのみ利用 DataPower® API Gateway可能です。
  • CORS を有効にした場合、API ゲートウェイは cors プリフロー・ポリシーを実行して、API に対して発行されたすべての CORS 要求を処理します。
  • CORS が有効にされていて、プリフライト要求が受け取られた場合、以下の API アクションのみが実行されます。
    • cors プリフロー・ポリシーは、適切な応答ヘッダーを構成します。
    • 応答ヘッダーが設定されます。
  • プリフライト要求が受け取られると、request.attributes.isCORSPreflight フラグが true に設定されます。
  • すべてのプリフライト要求において、security プリフロー・ポリシーと client-identification プリフロー・ポリシーは、CORS が有効にされているかどうかに関係なく、常にスキップされます。

「要約」パネルに、定義が作成されたことを示すメッセージが表示され、選択されたセキュリティー・オプションおよびレート制限が適用されます。

ActivateAPIを選択した場合、ウィザードはテストで使用できるAPIエンドポイント URLを入力します。 「クライアント ID を使用した保護」も選択した場合は、ウィザードに、使用できるクライアント ID およびクライアント秘密鍵が表示されます。