第1章 OpenAPI サービスの設定


OpenAPI 仕様 (OAS) は、HTTP API 向けに、プログラミング言語に依存しない、標準のインターフェイスを定義します。ソースコード、追加のドキュメント、またはネットワークトラフィックの検査にアクセスしなくても、サービスの機能を理解することができます。OpenAPI を使用してサービスを定義すると、最小限の実装ロジックを使用してサービスを理解し、操作することができます。インターフェイスの記述によって低レベルのプログラミングが簡素化されるのと同様に、OpenAPI 仕様 によってサービス呼び出し時の推測作業がなくなります。

1.1. OpenAPI 関数定義

サーバーレスロジックでは、ワークフローが関数内で OpenAPI 仕様参照を使用してリモートサービスとやり取りすることが可能です。

OpenAPI 関数定義の例

{
   "functions": [
      {
         "name": "myFunction1",
         "operation": "specs/myopenapi-file.yaml#myFunction1"
      }
   ]
}

operation 属性は、次のパラメーターで構成される string です。

  • URI: エンジンはこれを使用して仕様ファイルを見つけます。
  • Operation identifier: この識別子は OpenAPI 仕様ファイルにあります。

サーバーレスロジックは、以下の URI スキームをサポートしています。

  • file: ファイルシステム内にあるファイルに使用します。
  • http または https: これらはリモートにあるファイルに使用します。

ビルド時に OpenAPI 仕様ファイルが利用可能であることを確認してください。サーバーレスロジックは、実行時にリクエストを送信するために内部コード生成機能を使用します。アプリケーションイメージをビルドした後、サーバーレスロジックはこれらのファイルにアクセスできなくなります。

ワークフローに追加する OpenAPI サービスに仕様ファイルがない場合は、仕様ファイルを作成するか、サービスを更新してファイルを生成して公開できます。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る