Apigee の技術機能の概要

このページの内容は Apigee と Apigee ハイブリッドに該当します。

Apigee Edge のドキュメントを表示する。

このトピックでは、Apigee の特長を要約し、Apigee と Apigee ハイブリッドの特長と機能を比較します。

次の表に、このトピックで比較されている Apigee API 管理プロダクトを示します。

プロダクト ホストされている場所 管理者
Apigee Google Cloud Apigee
Apigee ハイブリッド Google Cloud とお客様のプライベート データセンターの両方 Apigee が管理プレーンを管理し、お客様がランタイム プレーンを管理します。

Apigee の機能の概要

次の表に、Apigee（およびハイブリッド）の機能レベルの概要を示します。

機能 Apigee とハイブリッドでのサポート
API プロキシ リビジョン

デプロイ時に変更不可
Apigee Adapter for Istio 非推奨: 代わりに Apigee Adapter for Envoy を使用することをおすすめします。
アプリの整理 AppGroup またはデベロッパーとアプリの関連付けを使用してアプリを整理します。クライアント アプリのオーナー権限の編成をご覧ください。
デプロイ
  • 非同期デプロイ
  • デプロイ ステータスの取得は、ランタイム プレーンが管理プレーンで最後に「チェックイン」された時刻に基づき行われます。
環境
  • 環境グループのサポート
  • Apigee の UI と API によるセルフサービス
  • サービス トポロジの柔軟性
  • MP Pod は 1 つの環境のみを提供可能

詳細については、環境と環境グループについてをご覧ください。
gRPC ベースのプロキシのサポート

gRPC ターゲット サーバーへの単項 gRPC プロトコル API リクエストを処理します。gRPC API プロキシの作成をご覧ください。
HTTP/1.1 ヘッダー フィールド名の大文字 / 小文字

バックエンドへの転送時に、HTTP/1.1 ヘッダー フィールド名を小文字に変換します。この動作は、大文字と小文字の区別の保持が必要なアプリケーションに影響する可能性があります。

キーストア / トラストストア
  • ノースバウンドは Kubernetes Secret として管理される
KVM
  • Apigee UI で、暗号化された環境スコープの KVM を作成できます。KVM は常に暗号化されます。UI で KVM エントリを追加、更新、表示することはできません。
  • デバッグ（Trace）セッションで KVM 情報を非表示にするには、GET コマンドですべての変数と一緒に private. 属性を使用します。private. 属性が使用されていない場合、KVM は暗号化されています。ただし、KVM 情報はデバッグ（Trace）セッションで復号され、例外はスローされません。
  • KVM エントリは、keyvaluemaps.entries API または KeyValueMapOperations ポリシーを使用して管理できます。
  • KVM と同じユースケースの一部で、プロパティ セットを使用できます。プロパティ セットの使用をご覧ください。
  • <MapName> 要素を使用すると、KeyValueMapOperations ポリシーが実行時に動的に使用する KVM を識別できます。

UI で KVM を作成する方法の詳細については、Key-Value マップの使用をご覧ください。適切なデータ永続性メカニズムの選択方法については、構成データへのアクセスをご覧ください。
収益化 収益化の概要をご覧ください。
Node.js
  • Node.js API プロキシはサポートされていません。
  • Node.js アプリケーションは Kubernetes（同じクラスタまたは別のクラスタ）内の別のコンテナとしてホストすることをおすすめします。
OAuth 新しい Revoke OAuthv2 ポリシーは、エンドユーザー ID、アプリ ID、またはその両方によってトークンを取り消します。
ポリシー ポリシーの概要をご覧ください。
関連情報 組織レベルのリソースは使用できません。
ロールと権限
  • Google Cloud コンソールの IAM サービスを介して管理されます。
  • キュレートされた事前定義ロールがいくつか用意されています。
  • 他の Google Cloud 権限を含めることができるカスタムロールを作成できます。

詳細については、ユーザーとロールをご覧ください。
[Build a Proxy] ウィザードの SOAP サービス 非対応。Apigee と一緒に使用する SOAP ユーティリティを提供するオープンソース プロジェクト wsdl2apigee をご覧ください。
セッションのトレース / デバッグ Trace のサポートをご覧ください。
仮想ホスト

ハイブリッドの場合:

  • Ingress は Anthos Service Mesh を介して実装されます。
  • 鍵と証明書は Kubernetes に直接デプロイされます。

Apigee の場合:

  • 各インスタンスは自己署名証明書を使用して HTTPS エンドポイントを公開します。証明書を照会すると、証明書の CA をダウンロードできます。

トレース / デバッグのサポート

Apigee とハイブリッド Trace のサポートを次の表に示します。

機能 Apigee とハイブリッドのサポート
適時性 わずかな遅延、非同期
セッション名 / ID ユーザーからセッション名を取得しない
フィルタ 複雑なフィルタリング論理のサポート（AND 論理演算、OR 論理演算など）。任意のフロー変数（フロー変数のリファレンスを参照）へのアクセス。構文は、条件リファレンスにある条件と同じです。
セッション タイムアウト

デバッグ セッションの長さのみを定義します。Message Processor がデバッグモードで実行するリクエストを受信したときが開始ポイントになります。

セッションが API で開始した場合のデフォルト値は 5 分、UI で開始した場合は 10 分です。

データは 24 時間保持された後、ハイブリッドによって自動的に削除されます。
セッションの有効性 セッション作成リクエストの有効期間。この時間内にデバッグ セッションが開始しない場合、Synchronizers はセッション作成リクエストを無視します。前提条件に記載されているように、Synchronizers のクロックを同期させてください。
トレースのリクエスト数 Message Processor あたりのデフォルトは 10、最大値は 15 です。
API Apigee は Debug Session API と Debug Session Data API を公開します。

API の概要

Apigee API と機能の概要を以下に示します。

動作 Apigee API
ベースドメイン apigee.googleapis.com
メディアの種類 application/json
認証 OAuth2
キーのタイムスタンプ String 形式 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
expand=false クエリ パラメータの構造 
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
先頭にアンダースコアが付いたクエリ パラメータ サポート対象外（optimal=true）
ペイロード内の次のプロパティ:
  • created_by
  • modified_by
  • self
 非対応
ペイロード内のデフォルト値 含まれない
エラー処理の構造 
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
キャッシュ削除のレスポンス 戻り値: 204 No Content
Cache API オペレーション list と delete のみ。API プロキシをデプロイすると、有効期間の短い L1 キャッシュが自動的に作成されます。詳細については、キャッシュの仕組みをご覧ください。

Apigee 指標 API

Apigee 指標 API の概要:

機能 Apigee API
API エンドポイント apigee.googleapis.com
日次分析メール サポート対象の API が存在しない
Async Query List API userId プロパティはレスポンスから除外されます。メソッド: organizations.environments.queries.list をご覧ください。
カスタム レポート API createdBy プロパティと lastModifiedBy プロパティはレスポンスから削除されました。レポート API をご覧ください。

Apigee ハイブリッドの特徴

次の表に、ハイブリッドの特徴の概要を示します。

サービス ハイブリッド Area
アナリティクス ランタイム プレーンのデータ収集 Pod は、fluentd と UDCA（Universal Data Collection Agent）を使用して分析情報を収集し、データを管理プレーンの UAP（統合アナリティクス プラットフォーム）に読み込みます。
API プロキシ ゲートウェイ Message Processor（MP）が受信リクエストを処理します。MP は、ランタイム プレーンで 1 つ以上のコンテナ化アプリとして実装されています。
永続性 Cassandra が、KMS、KVM、割り当て、キャッシュ機能のための永続性（データストア）を提供します。
デプロイ Synchronizer により、管理プレーンとランタイム プレーンの間で API プロキシ構成、環境情報、その他のデータが最新の状態に保たれます。
管理ユーザー インターフェース Apigee UI は、管理プレーンでホストされるコンテナ化されたアプリです。
ロード バランシング Istio Ingress コントローラが、ランタイム プレーンの Router / Message Processor（RMP）コンテナ化アプリにリクエストを渡します。
API Apigee API には Management Server と MART を介してアクセスします。MART はローカル Cassandra データストアとインタラクションして、Apigee API の API プロバイダとして機能し、ランタイム データ エンティティにアクセスして管理します。
指標 すべてのサービスに対応する単一の Prometheus サーバーがクラスタごとに存在し、このサーバーによって管理されます。