Application Integration を使用する

このページは、現在 Apigee を使用していて、同じ Google Cloud プロジェクトで Application Integration も使用することを考慮している方を対象としています。

概要

Apigee Integrations アドオンを有効にしているすべての Apigee サブスクリプション ユーザーは、Application Integration にリダイレクトされるようになりました。Application Integration は追加料金なしで使用できます。Application Integration が設定され、Apigee の既存のすべての統合が自動的に同期されて使用できるようになります。そのため、追加の構成を行うことなく、既存の Google Cloud プロジェクトをそのまま使用して Application Integration を利用することができます。

Application Integration の詳細については、Application Integration の概要をご覧ください。

注: US multi-region(us) のロケーションで構成されている既存の統合は、Application Integration で使用できません。詳しくは、米国リージョンでのサポート終了をご覧ください。

Apigee ポータルから Application Integration にリダイレクトできます。

ヒント: Application Integration の使用を開始したら、Application Integration の API リファレンスと IAM 権限を使用することをおすすめします。

変更点

次の表に、Google Cloud プロジェクトで想定される相違点または変更点の概要を示します。

Apigee リソース / 機能	予想される相違点 / 変更点
IAM 権限	統合では、Application Integration の事前定義された IAM ロールを使用します。 IAM 権限の変更をご覧ください。
サービス アカウント	すべての統合に使用される、新しいデフォルトのサービス アカウントが作成されます。 サービス アカウントの変更をご覧ください。
REST API	Apigee Integration REST API には、Application Integration REST API に対応するデータ型があります。 REST API の変更をご覧ください。
メール送信タスクと承認タスク	すべての送信メールの送信者メールアドレスが変更されます。 統合タスクの変更をご覧ください。
コネクタタスク	Apigee ポータルでコネクタタスクを構成することはできません。 コネクタタスクの変更をご覧ください。

IAM 権限の変更

Apigee Integration IAM のロールが割り当てられている既存のすべてのユーザー アカウントまたはプリンシパルには、同等の事前定義された Application Integration IAM 権限が付与されます。

Application Integration の IAM 権限の形式は次のとおりです。

形式

integrations.integrationRESOURCE.ACTION

例

integrations.integrationVersions.get

カスタム IAM ロールの制限事項

Google Cloud プロジェクトでカスタムの IAM ロールを定義している場合は、次の制限が適用されます。

• Apigee Integration 権限を含むカスタム IAM ロールを持つサービス アカウントを使用する Apigee プロキシが失敗することがあります。Application Integration IAM 権限でカスタム IAM ロールを更新することをおすすめします。

IAM のロールと権限の詳細については、アクセス制御の概要をご覧ください。

サービス アカウントの変更

Google Cloud プロジェクトに、Application Integration サービス エージェントの (roles/integrations.serviceAgent) IAM ロールを持つ新しいデフォルトのサービス アカウントが作成されます。

新しい Application Integration のデフォルトのサービス アカウントは、次の統合オペレーションに使用されます。

• 統合を実行する。
• Cloud Functions のタスクを使用して Cloud Functions の関数を呼び出す。
• コネクタタスクを使用して Integration Connectors を呼び出す。
• サービス アカウント タイプの認証プロファイルのサービス アカウント トークンを作成する。
• 認証プロファイルの Cloud KMS 鍵の暗号化と復号を行う。

Application Integration のデフォルトのサービス アカウントには、次のメールアドレスがあります。

形式

  [e-mail]

例

  [e-mail]

サービス アカウントの詳細については、アクセス制御の概要をご覧ください。

注:

• 別の Google Cloud プロジェクトに属するサービス アカウント タイプの認証プロファイルを使用している場合は、新しい Application Integration のデフォルト サービス アカウントにサービス アカウント トークン作成者の IAM ロールを割り当てます。
• そのほかの Apigee リソースとオペレーションには、引き続き既存のデフォルトの Apigee サービス アカウント（[e-mail]）を使用します。

REST API の変更

一般に、ほとんどの Apigee Integration API には、それぞれに相当する Application Integration API があります。

次の表は、Application Integration と比較した場合の Apigee Integration の REST API の主な変更点を示しています。

	Apigee Integration（Apigee プロキシを含む）	Application Integration
REST リソース	projects/PROJECT_ID/locations/REGION/products/apigee/integration/INTEGRATION_NAME	projects/PROJECT_ID/locations/REGION/integration/INTEGRATION_NAME

注: Apigee Integration の既存のリソースパスは、Application Integration の使用を開始した後も引き続き機能します。

Application Integration API の詳細については、Application Integration REST API をご覧ください。

統合タスクの変更

メール送信タスクと承認タスクは、[e-mail] を使用してメール通知を送信します。さらに、承認タスクを使用して送信されるすべての承認リクエスト メールは、Application Integration にリンクされます。

コネクタタスクの変更

コネクタタスクは Application Integration でのみ構成できます。