Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 info
Apigee Edge をご利用のお客様は、新しい機能やリージョンでの可用性を活用するために、インストールを Apigee X に移行することをおすすめします。
このページでは、Apigee X に移行する前に対応する必要がある構成のアンチパターンと、移行前に把握しておくべき動作の変更について説明します。
Apigee Edge のアンチパターンの広範なリストには、どのような場合でも避けるべき使用方法が記載されています。このページでは、移行をブロックする特定の推奨されない使用方法について説明します。Apigee X への移行時に問題が発生しないように、今すぐ解決してください。
API プロダクトのないアプリ | ||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
API プロダクトのないアプリがあります。 Apigee Edge と Apigee X の違い:
|
× |
解決策: API プロダクトのないアプリすべてのアプリ認証情報を 1 つ以上の API プロダクトに関連付けます。この方法の詳細については、アプリの登録と API キーの管理をご覧ください。 簡単な方法は、各アプリにすべての API プロダクトへのアクセス権を割り当てることです。これは、Apigee Edge で可能なことと同等です。最小権限のアプローチを採用する場合は、各アプリの認証情報がアクセスする必要がある API プロダクトの最小リストを決定する必要があります。これは、クライアント ID に基づいて Apigee Edge Analytics レポートで分析できます。 |
||||||||||||||||||||||
有効期限のないキャッシュ | ||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
キャッシュに有効期限がありません。 Apigee Edge と Apigee X の違い:
|
いいえ |
解決策: 有効期限のないキャッシュすべてのキャッシュの有効期限を設定します。 |
||||||||||||||||||||||
非確定パスの JSONPath フィルタ式 | ||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
非確定パスの場合、フィルタ式の結果のクエリは JSONPath 仕様の一部ではありません。https://goessner.net/articles/JsonPath/ をご覧ください。 Apigee Edge と Apigee X の違い: この例の構造をナビゲートする場合、 {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}式
式
|
はい |
解決策: 非確定パスの JSONPath フィルタ式影響を受けるクエリを検索して置換します。 |
||||||||||||||||||||||
存在しないインデックスの JSONPath 式 | ||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
インデックスが存在しない JSONPath 式は、Apigee X と Apigee Edge で動作が異なります。パスが見つからない場合、Apigee X は Apigee Edge と Apigee X の違い: この例の構造をナビゲートする場合、 {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}式
|
はい |
解決策: 存在しないインデックスの JSONPath 式影響を受けるクエリを検索して置換します。 |
||||||||||||||||||||||
配列インデックスを含む JSONPath 式が配列オブジェクトを返さない | ||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
配列インデックスまたはスライスを含む JSONPath 式は、Apigee X で配列オブジェクトを返します。 Apigee Edge と Apigee X の違い: この例の構造をナビゲートする場合、 {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}式
式
式
|
はい |
解決策: 配列インデックスを含む JSONPath 式が配列オブジェクトを返さないアップグレード後に異なる結果を返す可能性がある式を検索して置換します。 |
||||||||||||||||||||||
キーストア名の制限事項 |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
Apigee X キーストア名に使用できるのは、英数字とハイフンのみです。Edge キーストア名にはこれらの制限はありません。 |
いいえ |
解決策: キーストア名の制限事項キーストア名を確認し、必要に応じてサポートされていない文字を削除するように名前を更新します。 |
||||||||||||||||||||||
API プロキシにデプロイされた複数のベースパス |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
API プロキシの複数のリビジョンが環境にデプロイされ、各リビジョンに異なるベースパスが設定されている。 Apigee Edge と Apigee X の違い:
|
いいえ |
解決策: API プロキシに複数のベースパスがデプロイされているベースパスに関係なく、バンドルの 1 つのリビジョンのみが環境にデプロイされるように、すべてのバンドルを更新します。 |
||||||||||||||||||||||
準拠していない HTTP メッセージ |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
クライアントまたは API プロキシが、HTTP 標準に準拠していないメッセージ(リクエストまたはレスポンス)を送信します。たとえば、無効なヘッダー名、一部の制限付きヘッダーの重複などです。 API の実行で次のエラーが 1 つ以上発生している場合は、Apigee X に移行できません。
|
はい、その可能性があります。 |
解決策: 準拠していない HTTP メッセージApigee X に移行する前に、HTTP プロトコルのエラーを修正する必要があります。エラーがクライアント アプリケーションから発生した場合は、クライアント アプリのデベロッパーに問題を修正するよう依頼する必要があります。 |
||||||||||||||||||||||
OAuth 2.0 トークンの有効期限が無効 |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
OAuth 2.0 トークンの有効期限が指定された範囲外です。 Apigee Edge と Apigee X の違い:
|
いいえ |
解決策: OAuth 2.0 トークンの有効期限が無効
OAuthV2 ポリシーを使用し、 |
||||||||||||||||||||||
商品の上限を超えています |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
Apigee Edge の構成が、定義されたプロダクトの上限に準拠していません。Apigee Edge では適用されないが、Apigee X では適用されるプロダクトの上限があります。 |
いいえ |
解決策: 商品の上限を超えているApigee X に移行する前に、プロダクトの上限を超える使用量を修正します。 |
||||||||||||||||||||||
エンドポイントとパスの両方のターゲット接続指定子を含む ServiceCallout ポリシー |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
ServiceCallout ポリシーでは、
Apigee Edge はこの要件を文書化していますが、強制していません。Apigee X は、両方の構成を含む |
いいえ |
解決策: エンドポイントとパスの両方のターゲット接続指定子を含む ServiceCallout ポリシー
ServiceCallout ポリシーの構成を確認し、準拠していない |
||||||||||||||||||||||
ターゲット サーバー名の制限 |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
Apigee X ターゲット サーバー名に使用できるのは、英数字、ハイフン、ピリオドのみです。エッジ ターゲット サーバー名には、これらの制限は適用されません。 |
いいえ |
解決策: ターゲット サーバー名の制限ターゲット サーバー名を確認し、必要に応じてサポートされていない文字を削除するように名前を更新します。 |
||||||||||||||||||||||
仮想ホストのトライアル証明書 |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
1 つ以上の仮想ホストが、Apigee 提供の「無料トライアル」証明書を使用している。これにより、仮想ホストは Apigee Edge と Apigee X の違い:
|
はい |
解決策: 仮想ホストのトライアル証明書独自のドメインを構成し、証明書を適切にプロビジョニングする必要があります。
|
||||||||||||||||||||||
解決されていない DNS |
||||||||||||||||||||||||
| 概要 | クライアント サイドの変更が必要ですか? | 解決策 | ||||||||||||||||||||||
|
ターゲット エンドポイントに解決されていないドメイン名があります。 Apigee Edge と Apigee X の違い:
|
いいえ |
解決策: DNS が解決されない有効なドメイン名でターゲット エンドポイントを更新します。 |
||||||||||||||||||||||