HTTP プロトコルに基づいて、HTTP API を使用して分散システムのサービスを迅速に公開できます。このトピックでは、Cloud-native API Gateway コンソールで HTTP API を作成する方法について説明します。
シナリオ
Cloud-native API Gateway は、API を作成する 2 つの方法（インスタンス内とインスタンス外）を提供しており、以下のシナリオに適しています。
インスタンス内で API を作成する
専用の リソース 管理: API は、特定のインスタンス内でのみ使用され、特定の リソース または内部ロジックを管理します。
セキュリティ と隔離: データまたは機能は、セキュリティ を確保するために厳密に隔離する必要があり、インスタンス内でのみ呼び出されます。
簡素化されたサービス構成: 特定のインスタンス内での API の構成と管理を簡素化します。
インスタンス外で API を作成する
インスタンス間の共有アクセス: 複数のインスタンスが API 定義情報を共有します。
一元管理と監視: アクセス制御、ロギング、およびトラフィック管理の統合。
Cloud-native API Gateway インスタンス内で作成した API は、そのインスタンス内でのみ表示および管理できます。
Cloud-native API Gateway インスタンス外で作成した API は、インスタンス内では変更または削除できません。API が Cloud-native API Gateway インスタンス外で作成された場合、その API は外部 API のリストからのみ削除できます。
Cloud-native API Gateway コンソールで HTTP API を作成する
Cloud-native API Gateway インスタンス内またはインスタンス外で API を作成できます。
外部 API
Cloud-native API Gateway コンソール にログインします。左側のナビゲーションウィンドウで、[API] をクリックします。上部のナビゲーションバーで、リージョンを選択します。
[API を作成] をクリックします。[HTTP API] カードで、[作成] をクリックします。
内部 API
Cloud-native API Gateway コンソール にログインします。左側のナビゲーションウィンドウで、[インスタンス] をクリックします。上部のナビゲーションバーで、リージョンを選択します。
[インスタンス] ページで、管理する Cloud-native API Gateway インスタンスの ID をクリックします。左側のナビゲーションウィンドウで、[API] をクリックします。表示されるページの右上隅にある [API を作成] をクリックします。
[HTTP API] カードで、[作成] をクリックします。
[HTTP API を作成] パネルで、パラメーターを構成し、[OK] をクリックします。
パラメーター
説明
API 名
作成する API の名前を入力します。API 名はグローバルに一意である必要があります。
説明
API の説明を入力します。
リソースグループ
使用する リソースグループ を選択します。[リソースグループの作成] をクリックして、リソースグループ を作成できます。
Ingress をインポートして HTTP API を作成する
前提条件
Cloud-native API Gateway コンソールで、Container Service for Kubernetes (ACK) タイプのサービスソースが作成されています。詳細については、「サービスソースを管理する」をご参照ください。
手順
Cloud-native API Gateway インスタンス内またはインスタンス外で API を作成できます。
外部 API
Cloud-native API Gateway コンソール にログインします。左側のナビゲーションウィンドウで、[API] をクリックします。上部のナビゲーションバーで、リージョンを選択します。
[API を作成] をクリックします。[API を作成] ダイアログボックスの [HTTP API] カードで、[Ingress をインポート] をクリックします。
内部 API
Cloud-native API Gateway コンソール にログインします。左側のナビゲーションウィンドウで、[インスタンス] をクリックします。上部のナビゲーションバーで、リージョンを選択します。
[インスタンス] ページで、管理する Cloud-native API Gateway インスタンスの ID をクリックします。左側のナビゲーションウィンドウで、[API] をクリックします。表示されるページの右上隅にある [API を作成] をクリックします。
[HTTP API] カードで、[Ingress をインポート] をクリックします。
[HTTP API] カードで、[Ingress をインポート] をクリックします。[Ingress をインポート] パネルで、パラメーターを構成し、[OK] をクリックします。
パラメーター
説明
API 名
API の名前を指定します。[説明を追加] をクリックして、Ingress の説明を追加できます。
説明
API の説明を入力します。説明は最大 255 文字まで入力できます。
インスタンス
対応する Cloud-native API Gateway インスタンスを選択します。
ソースクラスター
Ingress が属する ACK クラスターを選択します。
リソースグループ
使用する リソースグループ を選択します。
名前空間
リッスンする名前空間を指定します。このパラメーターを空のままにすると、すべての名前空間のすべての Ingress リソース がリッスンされます。
IngressClass
リッスンする IngressClass を指定します。このパラメーターを空のままにすると、すべてのタイプの Ingress リソース がリッスンされます。
Ingress ステータスの更新
このオプションを有効にすると、リッスンされた Ingress のステータスエンドポイントは、ゲートウェイインスタンスの ingress エンドポイントに置き換えられます。