Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về 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 Apigee Edge mới cho Public Cloud.
Thông tin cập nhật và tính năng mới
Sau đây là các tính năng và nội dung cập nhật mới trong bản phát hành này.
Tải trọng JSON trong Chỉ định Thông báo và báo cáo lỗi
Với tính năng nâng cao này, bạn không cần giải quyết vấn đề gì để đảm bảo định dạng thông báo JSON đúng cách và có thể chỉ định biến bằng dấu ngoặc nhọn mà không tạo JSON không hợp lệ. Ví dụ: sau đây sẽ chèn giá trị của message.content trong thông báo JSON:
<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>
Nếu bạn đã áp dụng một giải pháp, mã của bạn sẽ tiếp tục hoạt động như cũ. Bạn cũng có thể sử dụng BiếnPrefix và VariableSuffix thay vì dấu ngoặc nhọn để biểu thị các biến.
Hãy xem phần <Set><Payload> trong Chính sách gán tin nhắn và Chính sách về lỗi lớn hơn tài liệu tham khảo. (APIRT-1160)
Cải tiến chính sách từ XML sang JSON
Chúng tôi đã cải thiện chính sách XML thành JSON với các chức năng sau. Bạn có thể định cấu hình chính sách nhằm:
- Coi một số phần tử XML như các mảng trong quá trình chuyển đổi, các phần tử này đặt các giá trị ở dạng hình vuông dấu ngoặc vuông '[ ]' trong tài liệu JSON.
- Xoá hoặc loại bỏ các cấp của hệ 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, xem phần XML chính sách 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 Sản phẩm API, bạn có thể đưa ký tự đại diện vào nhiều vị trí trong một
đường dẫn tài nguyên. Ví dụ: /team/*/invoices/**
cho phép gọi API bằng bất kỳ
một giá trị sau /team
và mọi đường dẫn tài nguyên
sau invoices/
. URI được phép trên 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 sản phẩm API hiện có không hoạt động như mong đợi, hãy đặt
thuộc tính sau trên tổ chức của bạn để chuyển về thuộc tính trước
hành vi: features.enableStandardWildCardMatchForAPIProductResources = true
(MGMT-3273)
Hàm mã hoá trong JavaScript
Đã có một bộ hàm crypto
JavaScript mới, hiệu suất cao
để tạo, tải và cập nhật các đối tượng sau đây có các đối tượng: 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 bài viết Mô hình đối tượng JavaScript.
(APIRT-2886)
Phiên bản JAR của chú thích Java đang kiểm tra
Khi tải tài nguyên Java JAR lên 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 Edge được hỗ trợ phiên bản Java, được liệt kê trong Phần mềm được hỗ trợ và phiên bản được hỗ trợ. (MGMT-3420)
Xác thực tài nguyên proxy API
Khi bạn có các tệp tài nguyên proxy API (chẳng hạn như JavaScript hoặc JAR Java) được lưu trữ tại môi trường hoặc tổ chức, khung xác thực không còn yêu cầu bạn cũng đưa các tài nguyên đó ở cấp độ proxy API vào gói proxy để nhập nhằm vượt qua quá trình xác thực. Việc 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 các proxy API riêng lẻ
Bạn có thể định cấu hình proxy API để hết thời gian chờ sau một khoảng thời gian được chỉ định (với thời gian chờ cổng vào 504
trạng thái). Trường hợp sử dụng chính là dành cho những khách hàng sử dụng Cloud riêng tư có proxy API cần
thời gian thực thi lâu hơn. Ví dụ: giả sử bạn cần các proxy cụ thể để hết thời gian chờ ở 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 proxy API. Dưới đây là cách thực hiện
bạn sẽ làm điều đó với ví dụ 3 phút:
- Trước tiên, hãy nhớ định cấu hình trình 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.
- Sau đó, hãy định cấu hình các proxy có liên quan để hết thời gian chờ sau 3 phút. Chỉ định giá trị trong
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> ...
- 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 sẽ dùng trình cân bằng tải, bộ định tuyến và
trình xử lý thư hết thời gian chờ. 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ụ: lệnh sau đây đặt một proxy API hết thời gian chờ sau 1
phút:
<Property name="api.timeout">60000</Property>
Khách hàng Cloud (những người 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ờ 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ý tin nhắn Edge là 57 giây.
Bạn không thể điền giá trị bằng biến. Cơ sở lưu trú này thuộc phạm vi điều chỉnh của Tài liệu tham khảo về thuộc tính điểm cuối. (APIRT-1778)
TLS/SSL để ghi nhật ký thư Chính sách
Bạn có thể đặt <KeyStore>
và <TrustStore>
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 và hai chiều bằng dịch vụ ghi nhật ký. Bạn định cấu hình SSLInfo trong chính sách Ghi nhật ký thư giống như cách bạn
sẽ trên proxy
Điểm cuối mục tiêu. Tuy nhiên, TLS/SSL để ghi nhật ký thư chỉ hỗ trợ giao thức TCP.
(APIRT-1858)
Đã khắc phục lỗi
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 đang kiểm tra để xem nếu phiếu yêu cầu hỗ trợ của họ đã được khắc phục. Tính năng này không được thiết kế nhằm cung cấp thông tin chi tiết về tất cả người dùng.
ID vấn đề | Mô tả |
---|---|
SECENG-609 | Các lệnh gọi trong thời gian chạy không gặp lỗi trong quá trình xoá kho tin cậy đã liên kết hoặc khi chứng chỉ hợp lệ trong kho tin cậy bị xoá |
MGMT-3404 | Việc xem/truy xuất nhật ký Node.js và triển khai proxy rất chậm |
MGMT-3400 | Không gọi được API quản lý /userroles nếu người dùng thực hiện lệnh gọi có "+" đăng nhập vào tên |
MGMT-3368 | java.lang.ArrayIndexOutOfBoundsException: 1, khi nhập gói Proxy API có chứa thư mục tài nguyên/nút/tài nguyên |
MGMT-3364 | OAuthV2: kiểm tra Redirect_uri |
MGMT-3319 | Liệt kê các mục trong kho lưu trữ có giá trị rỗng ở một trong các mục nhập không hoạt động dành cho tổ chức (CPS và không phải CPS) |
MGMT-3226 | Truy vấn ở cấp tổ chức/môi trường không lấy được tất cả dữ liệu gây ra API
không thành công Release_160302 có lỗi khiến danh sách tài nguyên ở cấp tổ chức/môi trường không thành công nếu kích thước tích luỹ của các tài nguyên lớn hơn 16MB, bản sửa lỗi này sẽ xử lý nó. |
AXAPP-2429 | API Analytics sử dụng response_status_code trả về quyền truy cập dữ liệu lỗi |
AXAPP-2386 | Khắc phục nội dung báo cáo trống trong báo cáo email hằng ngày của Analytics |
AXAPP-2347 | Không nhận được email tóm tắt về số liệu phân tích hằng ngày |
APIRT-3141 | Chú thích Java không thành công khi gọi ExecutionResult() mới vì hàm khởi tạo đã được chuyển sang chế độ riêng tư |
APIRT-3140 | Chính sách ServiceAnnotation không hoạt động trong các lệnh gọi API HEAD |
APIRT-3131 | CreateBy không chính xác xuất hiện cho Proxy API khi sử dụng tính năng kiếm tiền có nhà cung cấp dịch vụ xác thực bên ngoài |
APIRT-3121 | Việc thay đổi tệp tài nguyên tổ chức không hiệu quả 100% |
APIRT-3117 | MP đạt mức sử dụng CPU 100% và đã ngừng phân phát lưu lượng truy cập |
APIRT-3016 | Bộ định tuyến "Cuộc gọi đã hết thời gian chờ" lỗi triển khai |
APIRT-2975 | Không tải được gói chứng chỉ lên |
APIRT-2955 | Không thể che giấu một số thuộc tính của dữ liệu phản hồi JSON cho đơn kiện FHIR Tiêu đề Loại nội dung "application/json+fhir" |
APIRT-2946 | Chính sách OAuthV2-RefreshToken không ẩn các thuộc tính mặc dù màn hình được đặt thành sai |
APIRT-2908 | Bắt buộc phải thực thi TLS1.2 cho lệnh gọi API nội bộ sau khi cập nhật TLS1.2 máy chủ ảo |
APIRT-2901 | Phản hồi tệp zip mà hệ thống trả về từ bộ nhớ đệm sẽ được nén hai lần |
APIRT-2873 | Các MP gửi NullPointerException liên quan đến VerifyAPIKey sau khi xoá products/developers/proxies |
APIRT-2871 | Chính sách IOIntensive xuất hiện 2 lần trong Theo dõi |
APIRT-2825 | Lỗi ngữ pháp trong phản hồi lỗi accesstoken |
APIRT-2750 | Lỗi lưu lượng truy cập ở mức cao trong tổ chức cụ thể |
APIRT-2685 | Lưu lượng truy cập không thể lưu chuyển khi có lỗi không xác định |
APIRT-2647 | "Luồng đầu vào cơ bản trả về 0 byte" lỗi với nonprod/dev |
APIRT-2630 | Vấn đề bị gián đoạn khi tìm cách đọc giá trị từ bộ nhớ đệm |
APIRT-2620 | Nhóm luồng riêng cho một số bước chặn |
APIRT-2610 | Chính sách về java.lang.ClassCastException với bộ nhớ đệm phản hồi |
APIRT-2608 | Lỗi phân tích cú pháp tiêu đề lần sửa đổi gần đây nhất trong chính sách Bộ nhớ đệm phản hồi |
APIRT-2605 | "tổ chức" và "môi trường" các biến không được phép ghi đè thông qua chính sách |
APIRT-2566 | Chính sách OAuthV2 trả về tiêu đề WWW-KYC không đúng định dạng |
APIRT-2491 | Không cập nhật được TargetServer do hết thời gian chờ RPC giữa thời gian quản lý và mili giây |
APIRT-2386 | Phạm vi chuỗi trống được tạo trong một sản phẩm API có OAuth được phép trống các phạm vi |
APIRT-2383 | Chính sách Chuyển đổi XSL dường như không ghi lại bất kỳ dữ liệu nào theo lỗi |
APIRT-2364 | Biến quy trình lỗi của OAuth không được cập nhật khi gặp lỗi |
APIRT-2216 | Sự kiện do máy chủ gửi – luồng sự kiện gặp vấn đề trong phiên bản chính thức |
APIRT-2079 | Cuộc gọi cURL gỡ lỗi không dừng sau khi hết thời gian chờ cho buổi tập luyện |
APIRT-1495 | Tính năng Bảo vệ chống mối đe doạ XML không phát hiện được Content-Type |
APIRT-347 | Chính sách {8/} không được xác thực đúng khi nhập (không chỉ định kết quả để xuất các biến như trong tài liệu) |