Apigee で統合機能を有効にするには、トライアルの評価(評価)組織を作成するか、Apigee サブスクリプションを所有している場合は統合の料金を支払います。
評価組織で統合を有効にする
評価組織を使用すると、使用量に対する課金なしで、Apigee 統合機能を試すことができます。評価組織のプロビジョニング方法については、評価組織のプロビジョニングをご覧ください。
統合機能を試すことのみを目的としている場合は、評価組織を使用します。評価組織で作成された統合には制限があるためです。
詳細については、評価組織と有料組織の比較をご覧ください。
評価組織では、統合とコネクタのアドオンがすでに有効になっています。統合から外部データソースにアクセスするには、コネクタ アドオンが必要です。そのため、評価組織をプロビジョニングした後は、評価組織に対して次の API を有効にするだけで統合機能を使用できます。
- Application Integration API(integrations.googleapis.com)
- Connectors API (connectors.googleapis.com)
API を有効にする方法については、サービスの有効化をご覧ください。
有料組織で統合を有効にする
制限なしで Apigee の統合を使用する場合は、統合の料金を支払います。Apigee Integration は、サブスクリプションのアドオン サービスとして利用できます。
Apigee Integration の利用資格をすでに購入していて、Google Cloud プロジェクトか Apigee 組織の利用資格を有効にする場合は、Apigee サポートにお問い合わせください。ただし、Apigee Integration の利用資格を購入するには、Apigee の営業担当者にお問い合わせください。Apigee Integration が有効になったら、次のタスクを行います。
- 次の API を有効にします。
- Apigee API(apigee.googleapis.com)
- Application Integration API(integrations.googleapis.com)
- Secret Manager API(secretmanager.googleapis.com)
- Connectors API (connectors.googleapis.com)
API を有効にする方法については、サービスの有効化をご覧ください。
- Apigee 組織の統合とコネクタのアドオンを有効にします。
統合に使用する新しい組織を作成する場合は、次のコマンドを実行します。
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{"name":"${ORG_ID}", "analyticsRegion":"us-west1", "authorized_network":"${NETWORK_ID}", "runtimeType":"CLOUD", "runtimeDatabaseEncryptionKeyName":"${ENCRYPTION_KEY_NAME}", "addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig":{"enabled":true}}}' "https://apigee.googleapis.com/v1/organizations?parent=projects/${PROJECT_ID}"
既存の組織を使用する場合は、次のコマンドを実行します。
curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}:setAddons" -XPOST -d '{"addonsConfig":{"integrationConfig":{"enabled":true},"connectorsPlatformConfig":{"enabled":true}}}'
- 次のコマンドを使用して、アドオンが正常に有効になっているかどうかを確認します。
curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}"
このコマンドを実行すると、次のようなメッセージが表示されます。
{ "name": "Test....", "createdAt": "1615483867669", "lastModifiedAt": "1615483873468", …... "addonsConfig": { "integrationConfig": { "enabled": true, "connectorsPlatformConfig": { "enabled": true } } }
- 次の IAM ロールをデフォルトの Apigee サービス アカウント(
service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com
)に割り当てます。- Apigee Integration 起動元(
roles/integrations.apigeeIntegrationInvokerRole
)
サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。
- Apigee Integration 起動元(
次のステップ
- チュートリアルの API トリガーとの統合を作成するを開始する