Cloud-native API Gateway では、インスタンスの内部または外部で API を作成できます。コンソールで API を作成するか、OpenAPI ファイルをインポートして API を作成できます。このトピックでは、REST API を作成して操作を追加する方法について説明します。
シナリオ
インスタンスの内部と外部で API を作成する 2 つのメソッドは、次のシナリオに適用されます。
インスタンス内での API の作成
専用のリソース管理: API は、特定のリソースまたは内部ロジックを管理するために、特定のインスタンス内でのみ使用されます。
セキュリティと隔離: データまたは機能は、セキュリティのために厳格な隔離を必要とし、インスタンス内からのみ呼び出されます。
簡素化されたサービス構成: このメソッドは、特定のインスタンス内での API の構成と管理を簡素化します。
インスタンス外での API の作成
インスタンス間の共有アクセス: 複数のインスタンスが API 定義情報を共有できます。
一元化された管理とモニタリング: このメソッドは、統一されたアクセスの制御、ログの記録、およびトラフィック管理を提供します。
コンソールでの REST API の作成
Cloud-native API Gateway は、インスタンス内とインスタンス外の 2 つの方法で API を作成することをサポートしています。
インスタンス外の API
Cloud-native API Gateway コンソールにログインします。
左側のナビゲーションウィンドウで、[API] をクリックします。上部のメニューバーで、リージョンを選択します。
[API の作成] をクリックします。
[REST API] カードで、[作成] をクリックします。[REST API の作成] パネルで、パラメーターを設定し、[確認] をクリックします。
設定項目
説明
API 名
API のカスタム名を入力します。API 名はグローバルに一意である必要があります。
ベースパス
API のベースパス。特定の操作にアクセスする場合、完全なパスは
http(s)://{ドメイン名}/{ベースパス}/{操作パス}です。バージョン管理
API のバージョン管理を有効にするかどうかを指定します。異なるバージョンの API は独立した API として扱われます。同じ API 名を共有しますが、基本情報と操作の詳細は異なる場合があります。特定のバージョンにアクセスするには、バージョン識別子を指定する必要があります。
[バージョン管理] を有効にする場合は、[使用方法] を設定する必要があります。
説明[使用方法] を [クエリ] に設定した場合は、[クエリの追加] パラメーターを設定する必要があります。
[使用方法] を [ヘッダー] に設定した場合は、[ヘッダーの追加] パラメーターを設定する必要があります。
使用方法
[パス]、[クエリ]、および [ヘッダー] をサポートしています。
[パス] を使用する場合、完全なアクセスパスは /API ベースパス/バージョン番号/操作パス です。
[クエリ] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストパラメーターで、[クエリの追加] パラメーターをバージョン番号に設定する必要があります。
[ヘッダー] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストヘッダーで、[ヘッダーの追加] パラメーターをバージョン番号に設定する必要があります。
説明
API の説明を入力します。
リソースグループ
ターゲットリソースグループを選択します。右側の [リソースグループの作成] をクリックできます。
[API の作成] をクリックします。
[REST API] カードで、[作成] をクリックします。[REST API の作成] パネルで、パラメーターを設定し、[確認] をクリックします。
設定項目
説明
API 名
API のカスタム名を入力します。API 名はグローバルに一意である必要があります。
ベースパス
API のベースパス。特定の操作にアクセスする場合、完全なパスは
http(s)://{ドメイン名}/{ベースパス}/{操作パス}です。バージョン管理
API のバージョン管理を有効にするかどうかを指定します。異なるバージョンの API は独立した API として扱われます。同じ API 名を共有しますが、基本情報と操作の詳細は異なる場合があります。特定のバージョンにアクセスするには、バージョン識別子を指定する必要があります。
[バージョン管理] を有効にする場合は、[使用方法] を設定する必要があります。
説明[使用方法] を [クエリ] に設定した場合は、[クエリの追加] パラメーターを設定する必要があります。
[使用方法] を [ヘッダー] に設定した場合は、[ヘッダーの追加] パラメーターを設定する必要があります。
使用方法
[パス]、[クエリ]、および [ヘッダー] をサポートしています。
[パス] を使用する場合、完全なアクセスパスは /API ベースパス/バージョン番号/操作パス です。
[クエリ] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストパラメーターで、[クエリの追加] パラメーターをバージョン番号に設定する必要があります。
[ヘッダー] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストヘッダーで、[ヘッダーの追加] パラメーターをバージョン番号に設定する必要があります。
説明
API の説明を入力します。
リソースグループ
ターゲットリソースグループを選択します。右側の [リソースグループの作成] をクリックできます。
インスタンス内の API
Cloud-native API Gateway コンソールにログインします。
左側のナビゲーションウィンドウで、[インスタンス] をクリックします。上部のメニューバーで、リージョンを選択します。
[インスタンス] ページで、ターゲットの [インスタンス ID] をクリックして [概要] ページに移動します。次に、左側のナビゲーションウィンドウで [API] をクリックし、[API の作成] をクリックします。
[REST API] カードで、[作成] をクリックします。[REST API の作成] パネルで、パラメーターを設定し、[確認] をクリックします。
設定項目
説明
API 名
API のカスタム名を入力します。API 名はグローバルに一意である必要があります。
ドメイン
API のドメイン名を選択します。複数のドメイン名を選択できます。
新しいドメイン名を作成するには、[ドメイン名の追加] をクリックします。
ベースパス
API のベースパス。特定の操作にアクセスする場合、完全なパスは
http(s)://{ドメイン名}/{ベースパス}/{操作パス}です。バージョン管理
API のバージョン管理を有効にするかどうかを指定します。異なるバージョンの API は独立した API として扱われます。同じ API 名を共有しますが、基本情報と操作の詳細は異なる場合があります。特定のバージョンにアクセスするには、バージョン識別子を指定する必要があります。
[バージョン管理] を有効にする場合は、[使用方法] を設定する必要があります。
説明[使用方法] を [クエリ] に設定した場合は、[クエリの追加] パラメーターを設定する必要があります。
[使用方法] を [ヘッダー] に設定した場合は、[ヘッダーの追加] パラメーターを設定する必要があります。
使用方法
[パス]、[クエリ]、および [ヘッダー] をサポートしています。
[パス] を使用する場合、完全なアクセスパスは /API ベースパス/バージョン番号/操作パス です。
[クエリ] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストパラメーターで、[クエリの追加] パラメーターをバージョン番号に設定する必要があります。
[ヘッダー] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストヘッダーで、[ヘッダーの追加] パラメーターをバージョン番号に設定する必要があります。
説明
API の説明を入力します。
リソースグループ
ターゲットリソースグループを選択します。右側の [リソースグループの作成] をクリックできます。
シナリオ
現在の操作のシナリオを選択します。
基本シナリオ: [単一サービス]。
カナリアリリースシナリオ: [比率別 (マルチサービス)]、[コンテンツ別 (マルチサービス)]、[タグベースのルーティング (比率別)]。
説明重みを持つすべてのターゲットサービスのトラフィック比率の合計は 100% である必要があります。
バックエンドサービス
このゲートウェイまたは VPC の下のバックエンドサービスを関連付けます。ゲートウェイの下にバックエンドサービスが存在しない場合は、[サービスの作成] をクリックして作成します。
重要新しいサービスを作成すると、サービスポート情報がすぐに表示されない場合があります。[サービス名] ドロップダウンリストを展開し、[更新] をクリックする必要があります。ポート情報は非同期で同期されるため、完全なサービスポート情報が読み込まれて表示されるまでに時間がかかる場合があります。
OpenAPI ファイルをインポートして REST API を作成する
Cloud-native API Gateway では、特定のインスタンス上、またはインスタンスとは独立した 2 つの方法で API を作成できます。
インスタンス外の API
Cloud-native API Gateway コンソールにログインします。
左側のナビゲーションウィンドウで、[API] をクリックします。上部のメニューバーで、リージョンを選択します。
[API の作成] をクリックします。
[REST API] カードで、[インポート] をクリックします。[OpenAPI から作成] パネルで、パラメーターを設定し、[ドライランと作成] をクリックします。
設定項目
説明
API 名
API のカスタム名を入力します。API 名はグローバルに一意である必要があります。
アップロード方法
[ローカルファイル] と [OSS からインポート] をサポートしています。
説明ローカルアップロードと OSS インポートの両方のファイルは、OpenAPI 仕様に準拠している必要があります。
OpenAPI ファイル
このパラメーターは、[ローカルファイル] を選択したときに設定されます。ファイルを選択するか、テキストコンテンツを貼り付けることができます。ファイルサイズは 30 MB に制限されています。
リージョンの選択
このパラメーターは、[OSS からインポート] を選択したときに設定されます。リージョンを選択して、その OSS リソースを選択します。
OSS バケット
このパラメーターは、[OSS からインポート] を選択したときに設定されます。OSS バケットを選択します。リージョン属性のないバケットはサポートされていません。
バージョン管理
API のバージョン管理を有効にするかどうかを指定します。異なるバージョンの API は独立した API として扱われます。同じ API 名を共有しますが、基本情報と操作の詳細は異なる場合があります。特定のバージョンにアクセスするには、バージョン識別子を指定する必要があります。
[バージョン管理] を有効にする場合は、[使用方法] を設定する必要があります。
説明[使用方法] を [クエリ] に設定した場合は、[クエリの追加] パラメーターを設定する必要があります。
[使用方法] を [ヘッダー] に設定した場合は、[ヘッダーの追加] パラメーターを設定する必要があります。
使用方法
[パス]、[クエリ]、および [ヘッダー] をサポートしています。
[パス] を使用する場合、完全なアクセスパスは /API ベースパス/バージョン番号/操作パス です。
[クエリ] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストパラメーターで、[クエリの追加] パラメーターをバージョン番号に設定する必要があります。
[ヘッダー] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストヘッダーで、[ヘッダーの追加] パラメーターをバージョン番号に設定する必要があります。
説明
API の説明を入力します。
リソースグループ
ターゲットリソースグループを選択します。右側の [リソースグループの作成] をクリックできます。
インスタンス内の API
Cloud-native API Gateway コンソールにログインします。
左側のナビゲーションウィンドウで、[インスタンス] をクリックします。上部のメニューバーで、リージョンを選択します。
[インスタンス] ページで、ターゲットの [インスタンス ID] をクリックして [概要] ページに移動します。次に、左側のナビゲーションウィンドウで [API] をクリックし、[API の作成] をクリックします。
[REST API] カードで、[インポート] をクリックします。[OpenAPI から作成] パネルで、パラメーターを設定し、[ドライランと作成] をクリックします。
設定項目
説明
API 名
API のカスタム名を入力します。API 名はグローバルに一意である必要があります。
ドメイン
API のドメイン名を選択します。複数のドメイン名を選択できます。
新しいドメイン名を作成するには、[ドメイン名の追加] をクリックします。
アップロード方法
[ローカルファイル] と [OSS からインポート] をサポートしています。
説明ローカルアップロードと OSS インポートの両方のファイルは、OpenAPI 仕様に準拠している必要があります。
OpenAPI ファイル
このパラメーターは、[ローカルファイル] を選択したときに設定されます。ファイルを選択するか、テキストコンテンツを貼り付けることができます。ファイルサイズは 30 MB に制限されています。
リージョンの選択
このパラメーターは、[OSS からインポート] を選択したときに設定されます。リージョンを選択して、その OSS リソースを選択します。
OSS バケット
このパラメーターは、[OSS からインポート] を選択したときに設定されます。OSS バケットを選択します。リージョン属性のないバケットはサポートされていません。
バージョン管理
API のバージョン管理を有効にするかどうかを指定します。異なるバージョンの API は独立した API として扱われます。同じ API 名を共有しますが、基本情報と操作の詳細は異なる場合があります。特定のバージョンにアクセスするには、バージョン識別子を指定する必要があります。
[バージョン管理] を有効にする場合は、[使用方法] を設定する必要があります。
説明[使用方法] を [クエリ] に設定した場合は、[クエリの追加] パラメーターを設定する必要があります。
[使用方法] を [ヘッダー] に設定した場合は、[ヘッダーの追加] パラメーターを設定する必要があります。
使用方法
[パス]、[クエリ]、および [ヘッダー] をサポートしています。
[パス] を使用する場合、完全なアクセスパスは /API ベースパス/バージョン番号/操作パス です。
[クエリ] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストパラメーターで、[クエリの追加] パラメーターをバージョン番号に設定する必要があります。
[ヘッダー] を使用する場合、完全なアクセスパスは /API ベースパス/操作パス です。リクエストヘッダーで、[ヘッダーの追加] パラメーターをバージョン番号に設定する必要があります。
説明
API の説明を入力します。
リソースグループ
ターゲットリソースグループを選択します。右側の [リソースグループの作成] をクリックできます。
シナリオ
現在の操作のシナリオを選択します。
基本シナリオ: [単一サービス]。
カナリアリリースシナリオ: [比率別 (マルチサービス)]、[コンテンツ別 (マルチサービス)]、[タグベースのルーティング (比率別)]。
説明重みを持つすべてのターゲットサービスのトラフィック比率の合計は 100% である必要があります。
バックエンドサービス
このゲートウェイまたは VPC の下のバックエンドサービスを関連付けます。ゲートウェイの下にバックエンドサービスが存在しない場合は、[サービスの作成] をクリックして作成します。
重要新しいサービスを作成すると、サービスポート情報がすぐに表示されない場合があります。[サービス名] ドロップダウンリストを展開し、[更新] をクリックする必要があります。ポート情報は非同期で同期されるため、完全なサービスポート情報が読み込まれて表示されるまでに時間がかかる場合があります。
操作の追加
REST API の詳細ページで、[操作の追加] をクリックします。
[操作の作成] パネルで、パラメーターを設定し、[追加] をクリックします。
設定項目
説明
操作名
操作のカスタム名を入力します。名前は API 内でグローバルに一意である必要があります。
操作パス
操作の特定のパス。
メソッド
操作のリクエストメソッド。操作パスとメソッドの組み合わせは、API 内でグローバルに一意である必要があります。
説明
インターフェイスの説明。
リクエスト定義
[ヘッダー]、[クエリ]、および [パラメーターパス] パラメーターを、[本文] パラメーターとともに定義できます。
パスパラメーターは、操作パスで変数を定義する 3 つの方法をサポートしています。
/books/{bookId}
/books/[bookId]
/books/:bookId
{bookId} フォーマットを使用します。
説明リクエスト定義は、SDK とドキュメントを生成するためにのみ使用されます。実行時には検証されません。
レスポンス定義
さまざまな応答コードのデータ構造を定義します。
応答コード定義は、ドキュメントを生成するためにのみ使用されます。実行時には検証されません。
Mock
Mock 構成は、API が Mock シナリオで公開された場合にのみ有効になります。
説明REST API の Mock 構成機能は、インスタンス外の API でサポートされています。インスタンス内の API ではサポートされていません。
コンシューマー認証
コンシューマー認証を有効または無効にします。この機能はデフォルトで無効になっています。コンシューマー認証を有効にする場合は、現在の操作に コンシューマー権限付与 をアタッチする必要があります。そうしないと、操作にアクセスできません。