从 Apigee Edge 迁移到 Apigee X 的反模式

有一些应用没有使用 API 产品。

Apigee Edge 与 Apigee X 之间的区别：

缓存没有过期时间。

Apigee Edge 与 Apigee X 之间的区别：

对于非确定路径，过滤表达式的结果不在 JSONPath 规范中。请参阅 https://goessner.net/articles/JsonPath/。

Apigee Edge 与 Apigee X 之间的区别：

在浏览此示例结构时

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

使用 $..books[?(@.name == 'A')][0] 表达式，

使用 $..books[?(@.name == 'A')][0].name 表达式，

具有索引不存在的 JSONPath 表达式在 Apigee X 与 Apigee Edge 中的行为有所不同。如果找不到该路径，Apigee X 会返回 PathNotFoundException 错误。

Apigee Edge 与 Apigee X 之间的区别：

在浏览此示例结构时

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

使用 $.books[3] 表达式，

在 Apigee X 中，具有数组索引或切片的 JSONPath 表达式会返回一个数组对象。

Apigee Edge 与 Apigee X 之间的区别：

在浏览此示例结构时

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

使用 $.books 表达式，

使用 $.books[-1] 表达式，

使用 $.books[-2:] 表达式，

Apigee X 密钥库名称只能包含字母、数字和连字符。边缘密钥库名称不会施加这些限制。

API 代理的多个修订版本会部署在一个环境中，每个修订版本都具有不同的基本路径。

Apigee Edge 与 Apigee X 之间的区别：

客户端或 API 代理发送不符合 HTTP 标准的消息（请求或响应）。例如，标头名称无效、某些受限标头中出现重复等。

如果您的 API 执行出现以下一个或多个错误，则无法迁移到 Apigee X：

• INVALID_CHARACTERS_IN_HEADER
• MISSING_COLON
• MULTIPLE_CONTENT_LENGTH
• CONTENT_LENGTH_NOT_INTEGER
• INVALID_UPGRADE
• URL_HEADER_SIZE_TOO_LONG
• BODY_NOT_ALLOWED
• UNSUPPORTED_HTTP_VERSION
• ZERO_CONTENT_LENGTH_FOR_POST_OR_PUT
• UNSUPPORTED_RESPONSE_PREFIX

OAuth 2.0 令牌过期限制超出规定范围。

Apigee Edge 与 Apigee X 之间的区别：

Apigee Edge 的配置不符合定义的产品限制。一些记录在 Apigee Edge 中但未强制执行的产品限制在 Apigee X 上强制执行。

在 ServiceCallout 政策中，<LocalTargetConnection> 元素应包含 <APIProxy> 和 <ProxyEndpoint> 元素或 <Path> 元素，但不能同时包含二者。如需了解详情，请参阅 <LocalTargetConnection> 元素。

Apigee Edge 记录了此要求，但不强制执行。如果同时使用这两种配置遇到 <LocalTargetConnection>，Apigee X 会停止处理。

Apigee X 目标服务器名称只能包含字母、数字、连字符和英文句点。边缘目标服务器名称不会施加这些限制。

一个或多个虚拟主机使用 Apigee 提供的“免费试用”证书。这会使虚拟主机响应 ORG-ENV.apigee.net 等网域上的请求。

Apigee Edge 与 Apigee X 之间的区别：

目标端点有无法解析的域名。

Apigee Edge 与 Apigee X 之间的区别：