Apigee Edge sang các mẫu chống di chuyển Apigee X

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Là khách hàng hiện tại của Apigee Edge, bạn có thể chọn di chuyển bản cài đặt của mình sang Apigee X để tận dụng các tính năng mới hoặc khả năng hỗ trợ khác theo khu vực.

Trang này mô tả các phản mẫu trong cấu hình mà bạn cần giải quyết trước khi chuyển sang Apigee X, cũng như các thay đổi khác về hành vi mà bạn nên lưu ý trước khi di chuyển.

Danh sách rộng hơn về Apigee Edge phản mẫu mô tả các phương pháp sử dụng nên tránh trong mọi trường hợp. Trang này mô tả các phương pháp sử dụng cụ thể không được khuyến nghị để chặn quá trình di chuyển. Hãy giải quyết các vấn đề này ngay để ngăn chặn sự cố khi chuyển sang Apigee X.

Ứng dụng không có sản phẩm API

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Có những ứng dụng không có(các) sản phẩm API.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Apigee Edge Apigee X
Bạn có thể định cấu hình một ứng dụng và thông tin đăng nhập không liên kết với bất kỳ sản phẩm API nào. Ứng dụng này có quyền truy cập hiệu quả vào tất cả các Sản phẩm API. Mỗi ứng dụng phải được định cấu hình để truy cập vào ít nhất một Sản phẩm API. Không có cách nào để cung cấp quyền truy cập vào tất cả các Sản phẩm API một cách ngầm ẩn. Bạn có thể định cấu hình cho một ứng dụng có quyền truy cập vào tất cả các Sản phẩm API, nhưng bạn cần phải thực hiện việc này một cách rõ ràng.
Không.

Giải pháp: Ứng dụng không có sản phẩm API

Liên kết mọi thông tin đăng nhập ứng dụng với ít nhất một sản phẩm API. Để biết thêm thông tin về cách thực hiện việc này, hãy xem bài viết Đăng ký ứng dụng và quản lý khoá API.

Một cách dễ dàng là chỉ định quyền truy cập của từng ứng dụng cho tất cả Sản phẩm API. Tính năng này tương đương với những tính năng có thể thực hiện trong Apigee Edge. Thách thức đặt ra là nếu bạn muốn theo đuổi phương pháp "ít đặc quyền nhất", thì bạn sẽ cần xác định danh sách sản phẩm API tối thiểu mà mỗi thông tin đăng nhập ứng dụng phải có quyền truy cập. Bạn có thể phân tích vấn đề này bằng các báo cáo của Apigee Edge Analytics dựa trên mã ứng dụng khách.

Bộ nhớ đệm không có thời gian hết hạn

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

(Các) bộ nhớ đệm không có thời gian hết hạn.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Apigee Edge Apigee X
Hỗ trợ việc tạo, cập nhật và xoá các chỉ số mô tả tài nguyên bộ nhớ đệm. Không hỗ trợ tạo, cập nhật hoặc xoá chỉ số mô tả tài nguyên bộ nhớ đệm.
Không

Độ phân giải: Bộ nhớ đệm không có thời gian hết hạn

Đặt thời gian hết hạn cho tất cả các bộ nhớ đệm.

Biểu thức lọc JSONPath trên đường dẫn không xác định

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Đối với các đường dẫn không xác định, việc truy vấn kết quả của biểu thức lọc không thuộc phạm vi thông số JSONPath. Hãy truy cập vào https://goessner.net/articles/JsonPath/.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Khi điều hướng cấu trúc mẫu này,

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

Với biểu thức $..books[?(@.name == 'A')][0],

Apigee Edge Apigee X
Thông tin đầu ra ‘{"name": "A"}’ Thông tin đầu ra []

Với biểu thức $..books[?(@.name == 'A')][0].name,

Apigee Edge Apigee X
Thông tin đầu ra "A" Thông tin đầu ra []

Độ phân giải: Biểu thức lọc JSONPath trên đường dẫn không xác định

Tìm và thay thế các truy vấn bị ảnh hưởng.

Biểu thức JSONPath cho các chỉ mục không có sẵn

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Biểu thức JSONPath có chỉ mục không hiện có có các hành vi khác nhau trong Apigee X so với Apigee Edge. Apigee X sẽ trả về lỗi PathNotFoundException khi không tìm thấy đường dẫn.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Khi điều hướng cấu trúc mẫu này,

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

Với biểu thức $.books[3],

Apigee Edge Apigee X
Thông tin đầu ra null Kết quả trả về PathNotFoundException lỗi

Độ phân giải: biểu thức JSONPath cho chỉ mục không có

Tìm và thay thế các truy vấn bị ảnh hưởng.

Biểu thức JSONPath có chỉ mục mảng không trả về đối tượng mảng

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Biểu thức JSONPath có chỉ mục mảng hoặc các lát cắt sẽ trả về một đối tượng mảng trong Apigee X.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Khi điều hướng cấu trúc mẫu này,

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

Với biểu thức $.books,

Apigee Edge Apigee X
Thông tin đầu ra {“name”:”A”, “name”: “B”} Thông tin đầu ra [{“name”:”A”, “name”: “B”}]

Với biểu thức $.books[-1],

Apigee Edge Apigee X
Thông tin đầu ra {“name”: “B”} Thông tin đầu ra [{“name”: “B”}]

Với biểu thức $.books[-2:],

Apigee Edge Apigee X
Thông tin đầu ra {“name”:”A”, “name”: “B”} Thông tin đầu ra [{“name”:”A”, “name”: “B”}]

Giải pháp: Biểu thức JSONPath có chỉ mục mảng không trả về đối tượng mảng

Tìm và thay thế biểu thức có thể trả về kết quả khác sau khi nâng cấp.

Hạn chế về tên kho khoá

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Tên kho khoá Apigee X chỉ có thể chứa chữ cái, số và dấu gạch nối. Tên kho khoá Edge không áp đặt những hạn chế này.

Không

Giải pháp: Hạn chế tên kho khoá

Kiểm tra tên kho khoá và cập nhật tên để xoá các ký tự không được hỗ trợ nếu cần.

Triển khai nhiều đường dẫn cơ sở cho một proxy API

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Nhiều bản sửa đổi của proxy API được triển khai trong một môi trường và mỗi bản sửa đổi có một đường dẫn cơ sở khác nhau.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Apigee Edge Apigee X
Hỗ trợ triển khai nhiều bản sửa đổi của một proxy API, trong đó mỗi bản sửa đổi có thể có một đường dẫn cơ sở khác nhau. Không hỗ trợ triển khai nhiều bản sửa đổi của proxy API mặc dù proxy có nhiều đường dẫn cơ sở.
Không

Giải pháp: Nhiều đường dẫn cơ sở được triển khai cho một proxy API

Cập nhật tất cả các gói để chỉ triển khai một bản sửa đổi của gói trong một môi trường, bất kể đường dẫn cơ sở là gì.

Thông báo HTTP không tuân thủ

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Ứng dụng hoặc Proxy API gửi thông báo (yêu cầu hoặc phản hồi) không tuân thủ tiêu chuẩn HTTP. Ví dụ: tên tiêu đề không hợp lệ, trường hợp trùng lặp trong một số tiêu đề bị hạn chế, v.v.

Bạn không thể di chuyển sang Apigee X nếu quá trình thực thi API của bạn gặp một hoặc nhiều lỗi sau:

  • 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
Có, có thể.

Giải pháp: Thông báo HTTP không tuân thủ

Bạn phải khắc phục mọi lỗi trong giao thức HTTP trước khi chuyển sang Apigee X. Nếu lỗi bắt nguồn từ một ứng dụng, bạn phải yêu cầu nhà phát triển của ứng dụng đó khắc phục lỗi.

Thời gian hết hạn của mã thông báo OAuth 2.0 không hợp lệ

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Giới hạn thời gian hết hạn của mã thông báo OAuth 2.0 nằm ngoài phạm vi quy định.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Apigee Edge Apigee X
Hiện không có quy tắc hạn chế nào về thời gian hết hạn của mã thông báo OAuth 2.0 được thực thi nhưng đã có kế hoạch thực thi. Xem các nguyên tắc trong phần OAuth trên trang Giới hạn. Bạn phải đặt mã truy cập và thời gian hết hạn mã làm mới cho OAuth 2.0. Các phạm vi được hỗ trợ là:
  • 180 giây <= Thời gian hết hạn mã truy cập OAuth 2.0 <= 30 ngày
  • 1 ngày <= Thời gian hết hạn mã làm mới OAuth 2.0 <= 2 năm
Không

Giải pháp: Thời gian hết hạn của mã thông báo OAuth 2.0 không hợp lệ

Dùng chính sách OAuthV2 rồi chỉ định thời gian hết hạn trong <ExpiresIn><RefreshTokenExpiresIn>.

Đã vượt quá giới hạn về sản phẩm

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Cấu hình của Apigee Edge không tuân thủ các giới hạn đã xác định về sản phẩm. Một số giới hạn đối với sản phẩm đã được ghi nhận nhưng không được thực thi trên Apigee Edgeare trên Apigee X.

Không

Giải pháp: Đã vượt quá giới hạn về sản phẩm

Khắc phục mọi trường hợp sử dụng vượt quá giới hạn sản phẩm trước khi chuyển sang Apigee X.

Chính sách chú thích dịch vụ có cả thông số kết nối mục tiêu đường dẫn và điểm cuối

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Trong chính sách về Chú thích dịch vụ, phần tử <LocalTargetConnection> phải bao gồm các phần tử <APIProxy><ProxyEndpoint> hoặc <Path>, nhưng không được bao gồm cả hai. Để biết thêm thông tin, hãy xem phần tử <LocalTargetConnection>.

Apigee Edge đã ghi lại yêu cầu này nhưng không thực thi. Apigee X sẽ ngừng xử lý nếu gặp <LocalTargetConnection> với cả hai cấu hình.

Không

Giải pháp: Chính sách Chú thích dịch vụ với cả thông số kết nối mục tiêu của điểm cuối và đường dẫn

Kiểm tra cấu hình chính sách Chú thích dịch vụ và loại bỏ mọi cấu hình <LocalTargetConnection> không tuân thủ.

Hạn chế tên máy chủ mục tiêu

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Tên máy chủ đích Apigee X chỉ có thể chứa chữ cái, số, dấu gạch nối và dấu chấm. Tên máy chủ đích không áp dụng những hạn chế này.

Không

Giải pháp: Hạn chế tên máy chủ mục tiêu

Kiểm tra tên máy chủ mục tiêu và cập nhật tên để xoá các ký tự không được hỗ trợ nếu cần.

Chứng chỉ dùng thử trong máy chủ ảo

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

Một hoặc nhiều máy chủ ảo sử dụng chứng chỉ "dùng thử miễn phí" do Apigee cung cấp. Điều này khiến máy chủ ảo phản hồi các yêu cầu trên các miền như ORG-ENV.apigee.net.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Apigee Edge Apigee X
Tự động định cấu hình vhost "mặc định" để hỗ trợ tên miền có dạng ORG-ENV.apigee.net. Có một chứng chỉ ký tự đại diện, còn gọi là "chứng chỉ dùng thử miễn phí", cho phép sử dụng TLS trên các miền này. Các miền Apigee cũ có dạng ORG-ENV.apigee.net hiện không được cung cấp trong Apigee X. Bạn phải định cấu hình tên miền của riêng mình và cung cấp chứng chỉ một cách phù hợp.

Giải pháp: Chứng chỉ dùng thử trong máy chủ ảo

Bạn phải định cấu hình miền của riêng mình và cung cấp các chứng chỉ một cách thích hợp.

Mọi ứng dụng khách phụ thuộc vào tên miền cũ của biểu mẫu ORG-ENV.apigee.net đều phải được sửa đổi để gọi miền mới.

DNS chưa được giải quyết

Tóm tắt Cần thay đổi phía máy khách? Độ phân giải

(Các) điểm cuối đích có tên miền chưa được phân giải.

Điểm khác biệt giữa Apigee Edge và Apigee X:

Apigee Edge Apigee X
Nếu không phân giải được DNS, thì Apigee sẽ thêm .apigee.com vào tên miền và DNS sẽ phân giải thành công bằng mã phản hồi 4xx. Nếu phân giải DNS không thành công, Apigee sẽ không thực thi yêu cầu và trả về mã phản hồi 5xx.
Không

Giải pháp: DNS chưa được giải quyết

Cập nhật điểm cuối đích bằng tên miền hợp lệ.