統合の呼び出しタスクを使用すると、Google Cloud プロジェクト内で作成された他の統合を呼び出すことができます。
統合の呼び出しタスクは、メインの統合(親統合)を使用して制御される複数の小規模な統合(サブ統合)を定義する必要がある場合に便利です。サブ統合を実行した後、メイン統合でサブ統合のレスポンスを読み取ることもできます。
始める前に
- 統合の呼び出しタスクでは、API トリガーを使用して他の統合とサブ統合を識別し、呼び出します。したがって、API トリガーを使用して呼び出す統合を構成する必要があります。API トリガーの構成については、API トリガーをご覧ください。
- 統合にユーザー管理のサービス アカウントが関連付けられていることを確認します。統合にユーザー管理のサービス アカウントが構成されていない場合は、デフォルトで、デフォルトのサービス アカウント(
service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com
)が認証に使用されます。 - サービス アカウントに IAM ロール Application Integration の起動元が付与されていることを確認します。サービス アカウントへのロールの付与については、サービス アカウントに対するアクセス権の管理をご覧ください。
統合の呼び出しタスクを構成する
統合の呼び出しタスクを構成するには:
- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
- [Create Integration] ダイアログで名前と説明を入力します。
- サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
- [Create] をクリックします。
インテグレーション デザイナーでインテグレーションが開きます。
- 統合デザイナーのナビゲーション バーで、[+ Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
- 統合エディタで、[Call Integration] 要素をクリックして配置します。
- デザイナーで [Call Integration] タスク要素をクリックして、[Call Integration] タスク構成ペインを表示します。
- 以下のサブ統合の詳細を構成します。
- API トリガー ID: 呼び出す統合の API トリガー ID を入力します。1 つの統合を呼び出すことも、同じトリガー ID で複数の統合を呼び出すこともできます。
- この API トリガー ID のすべての統合を実行する: 同じ API トリガー ID を持つすべての統合を呼び出すには、このオプションを選択します。
たとえば、統合
A
と統合B
が同じ API トリガー ID を持つ場合、統合A
と統合B
の両方が実行されます。 - Run a single integration: [Integration name] フィールドで指定された統合のみを呼び出すには、このオプションを選択します。サブ統合からのレスポンスにアクセスしてマッピングするには、サブ統合のレスポンス変数をマッピングするで説明されているフィールドを構成します。
- 実行方法: 呼び出すサブ統合の実行モードを選択します。
- SYNC: サブ統合を同期モードで実行します。このモードでは、メイン統合はサブ統合が完了するのを待ってから、ダウンストリーム タスクを続行します。
-
ASYNC: 非同期モードでサブ統合を実行します。このモードでは、メイン統合はサブ統合の完了を待ちません。サブ統合を呼び出した直後に、メインの統合によってダウンストリームのタスクが実行されます。
このオプションを選択した場合は、[Execution delay (in milliseconds)] を設定します。設定した場合、統合が実行されるまでの遅延時間を指定します。
プロパティへの変更は自動的に保存されます。
サブ統合レスポンス変数をマッピングする
次の表に、メイン統合とサブ統合の間で変数をマッピングする構成プロパティを示します。プロパティ | 説明 |
---|---|
Map to sub-integration input(s)
|
メイン統合からサブ統合に値をマッピングします。このフィールドでは、Key-Value ペアの形式の値を指定します。ここで、キーはメイン統合の変数で、値はサブ統合の対応する入力変数です。 たとえば、メイン統合の |
Map values to sub-integration output(s)
|
サブ統合の出力変数をメインの統合変数にマッピングします。 [マッピング元のサブ統合の出力] をクリックして、サブ統合を選択します。[マッピング先の統合変数] をクリックして、対応するメインの統合変数を選択します。 |
ベスト プラクティス
統合の呼び出しタスクに適用される使用量上限については、使用量上限をご覧ください。
エラー処理方法
タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式と、さまざまな種類のエラー処理方式の詳細については、エラー処理方法をご覧ください。