16.08.17 – Ghi chú phát hành Apigee Edge về Đám mây công khai

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. Thông tin

Vào thứ Ba, ngày 30 tháng 8 năm 2016, chúng tôi đã phát hành phiên bản mới của Apigee Edge cho Đám mây công khai.

Thông tin cập nhật và tính năng mới

Sau đây là các tính năng mới và nội dung cập nhật trong bản phát hành này.

Tải trọng JSON trong thông báo Chỉ định và Gây ra lỗi

Với điểm cải tiến này, bạn không cần giải pháp thay thế để đảm bảo định dạng thông báo JSON phù hợp và có thể chỉ định các biến bằng dấu ngoặc nhọn mà không tạo ra JSON không hợp lệ. Ví dụ: mã sau đây sẽ chèn giá trị của message.content vào thông báo JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

Nếu bạn sử dụng giải pháp thay thế, mã của bạn sẽ tiếp tục hoạt động như bình thường. Bạn cũng có thể sử dụng variablePrefix và variableSuffix thay vì dấu ngoặc nhọn để biểu thị các biến.

Hãy xem phần tử <Set><Payload> trong tài liệu tham khảo về chính sách Gán thông báo và chính sách Gây lỗi. (APIRT-1160)

Các điểm cải tiến về chính sách chuyển đổi XML sang JSON

Chính sách XML sang JSON đã được cải thiện với các chức năng sau. Bạn có thể định cấu hình chính sách để:

• Xử lý một số phần tử XML dưới dạng mảng trong quá trình chuyển đổi, thao tác này sẽ đặt các giá trị trong dấu ngoặc vuông "[ ]" trong tài liệu JSON.
• Loại bỏ hoặc xoá các cấp trong hệ thống phân cấp tài liệu XML trong tài liệu JSON cuối cùng.

Để biết thêm thông tin, hãy xem chính sách XML sang JSON. (APIRT-1144)

Nhiều ký tự đại diện trong đường dẫn tài nguyên Sản phẩm API

Khi xác định đường dẫn tài nguyên trong API Product, bạn có thể thêm ký tự đại diện vào nhiều vị trí trong đường dẫn tài nguyên. Ví dụ: /team/*/invoices/** cho phép các lệnh gọi API có bất kỳ giá trị nào sau /team và mọi đường dẫn tài nguyên sau invoices/. Một URI được phép trong lệnh gọi API sẽ là proxyBasePath/team/finance/invoices/company/a.

Nếu sau bản phát hành này, đường dẫn tài nguyên API Product hiện có của bạn ngừng hoạt động như dự kiến, hãy đặt thuộc tính sau trên tổ chức của bạn để quay lại hành vi trước đó: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Hàm mã hoá trong JavaScript

Một nhóm hàm JavaScript crypto hiệu suất cao mới có sẵn để tạo, nhận và cập nhật các đối tượng sau: MD5, SHA-1, SHA256, SHA512. Đối tượng crypto cũng cho phép bạn lấy ngày ở nhiều định dạng. Để biết thêm thông tin, hãy xem Mô hình đối tượng JavaScript. (APIRT-2886)

Kiểm tra phiên bản JAR của chú thích Java

Khi tải một tài nguyên JAR Java lên một proxy API, mã trạng thái HTTP 400 sẽ được trả về (thay vì 500) nếu phiên bản của tài nguyên Java không tương thích với phiên bản Java được Edge hỗ trợ, được liệt kê trong phần Phần mềm được hỗ trợ và các phiên bản được hỗ trợ. (MGMT-3420)

Xác thực tài nguyên proxy API

Khi bạn lưu trữ các tệp tài nguyên của proxy API (chẳng hạn như JavaScript hoặc JAR Java) ở phạm vi môi trường hoặc tổ chức, khung xác thực sẽ không còn yêu cầu bạn phải đưa các tài nguyên đó vào cấp độ proxy API trong một gói proxy để nhập nhằm vượt qua quy trình xác thực. Quy trình xác thực tài nguyên hiện diễn ra tại thời điểm triển khai, chứ không phải tại thời điểm nhập. (MGMT-1430)

Định cấu hình thời gian chờ cho từng proxy API

Bạn có thể định cấu hình các proxy API để hết thời gian chờ sau một khoảng thời gian cụ thể (với trạng thái hết thời gian chờ của cổng 504). Trường hợp sử dụng chính là dành cho những khách hàng sử dụng Đám mây riêng tư có các proxy API mất nhiều thời gian hơn để thực thi. Ví dụ: giả sử bạn cần các proxy cụ thể hết thời gian chờ sau 3 phút. Bạn có thể sử dụng một thuộc tính api.timeout mới trong cấu hình cho một proxy API. Sau đây là cách thực hiện với ví dụ 3 phút:

1. Trước tiên, hãy nhớ định cấu hình bộ cân bằng tải, bộ định tuyến và trình xử lý thông báo để hết thời gian chờ sau 3 phút.
2. Sau đó, hãy định cấu hình các proxy liên quan để hết thời gian chờ sau 3 phút. Chỉ định giá trị bằng mili giây. Ví dụ:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. Tuy nhiên, lưu ý rằng việc tăng thời gian chờ của hệ thống có thể dẫn đến các vấn đề về hiệu suất, vì tất cả các proxy không có chế độ cài đặt api.timeout đều sử dụng thời gian chờ mới, cao hơn của bộ cân bằng tải, bộ định tuyến và bộ xử lý thông báo. Vì vậy, hãy định cấu hình các proxy API khác không yêu cầu thời gian chờ lâu hơn để sử dụng thời gian chờ thấp hơn. Ví dụ: đoạn mã sau đây đặt thời gian chờ của một proxy API thành 1 phút:
   <Property name="api.timeout">60000</Property>

Những khách hàng sử dụng đám mây không thể sửa đổi thời gian chờ của Edge cũng có thể định cấu hình thời gian chờ của proxy API, miễn là thời gian chờ ngắn hơn thời gian chờ tiêu chuẩn của trình xử lý thông báo Edge là 57 giây.

Bạn không thể điền sẵn giá trị bằng một biến. Thuộc tính này được đề cập trong Tài liệu tham khảo về thuộc tính điểm cuối. (APIRT-1778)

Chính sách TLS/SSL để ghi nhật ký thông báo

<KeyStore> và <TrustStore> có thể được đặt trong cấu hình SSLInfo trên chính sách Ghi nhật ký tin nhắn, cho phép TLS/SSL một chiều và hai chiều với dịch vụ ghi nhật ký. Bạn định cấu hình SSLInfo trên chính sách Ghi nhật ký thông báo theo cách tương tự như cách bạn thực hiện trên TargetEndpoint của proxy. Tuy nhiên, TLS/SSL Ghi nhật ký thông báo chỉ hỗ trợ giao thức TCP. (APIRT-1858)

Các lỗi đã được khắc phục

Các lỗi sau đây đã được khắc phục trong bản phát hành này. Danh sách này chủ yếu dành cho những người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được giải quyết hay chưa. Báo cáo này không được thiết kế để cung cấp thông tin chi tiết cho tất cả người dùng.