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 một phiên bản mới của Apigee Edge dành cho đám mây công cộng.
Tính năng mới và thông tin cập nhật
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 công cụ Gán thông báo và Tăng lỗi
Với tính năng nâng cao này, bạn không cần đưa ra giải pháp nào để đảm bảo định dạng thông báo JSON chính xác. Ngoài ra, bạn có thể chỉ định các biến bằng dấu ngoặc nhọn mà không cần tạo JSON không hợp lệ. Ví dụ: nội dung 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ư bình thường. Bạn cũng có thể sử dụng {/3}Prefix và variableSuffix thay vì dấu ngoặc nhọn để chỉ ra 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 chỉ định thông báo và Chính sách về lỗi gia tăng. (APIRT-1160)
Cải tiến chính sách XML sang JSON
Chính sách XML sang JSON đã được cải tiến với những tính năng sau. Bạn có thể thiết lập chính sách này để:
- Coi một số phần tử XML là mảng trong quá trình chuyển đổi, việc này sẽ đặt các giá trị trong 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, hãy xem Chính sách XML sang JSON. (APIRT-1144)
Nhiều ký tự đại diện trong đường dẫn đế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 các 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ó một giá trị bất kỳ sau /team
và mọi đường dẫn tài nguyên sau invoices/
. URI được phép đối với 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 đến sản phẩm API hiện có ngừng hoạt động như dự kiến, hãy thiết lập thuộc tính sau trong tổ chức của bạn để chuyển về hành vi trước đó: features.enableStandardWildCardMatchForAPIProductResources = true
(theo giờ GMT-3273)
Hàm mã hoá trong JavaScript
Hiện đã có một tập hợp các hàm crypto
hiệu suất cao mới cho JavaScript để 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 thông tin 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)
Kiểm tra phiên bản JAR chú thích Java
Khi tải tài nguyên JAR Java 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 Java được hỗ trợ trên Edge, được liệt kê trong Phần mềm được hỗ trợ và phiên bản được hỗ trợ. (theo giờ GMT-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 proxy API (chẳng hạn như JavaScript hoặc tệp JAR Java) ở phạm vi môi trường hoặc tổ chức, khung xác thực không còn yêu cầu bạn đưa những tài nguyên đó ở cấp proxy API vào gói proxy để nhập nhằm vượt qua quy trình xác thực. Việc xác thực tài nguyên giờ đây 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. (theo giờ GMT-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 các proxy API để hết thời gian chờ sau một thời gian chỉ định (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 dùng nền tảng đám mây riêng tư có proxy API cần nhiều thời gian thực thi hơn. Ví dụ: giả sử bạn cần các proxy cụ thể để hết thời gian chờ là 3 phút. Bạn có thể dùng thuộc tính api.timeout
mới trong cấu hình cho proxy API. Sau đây là cách thực hiện qua ví dụ trong 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 đó, định cấu hình các proxy có liên quan để hết thời gian chờ 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> ...
- Tuy nhiên, lưu ý rằng việc tăng thời gian chờ 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ờ của trình cân bằng tải, bộ định tuyến và trình xử lý thông báo mới có thời gian chờ cao hơn. 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ờ dài hơn để sử dụng thời gian chờ thấp hơn. Ví dụ sau đây đặt proxy API hết thời gian chờ sau 1 phút:
<Property name="api.timeout">60000</Property>
Những khách hàng sử dụng dịch vụ đá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 giá trị bằng biến. Thuộc tính này được đề cập trong Tài liệu tham khảo về thuộc tính thiết bị đầu cuối. (APIRT-1778)
Chính sách TLS/SSL để ghi nhật ký thư
Bạn có thể đặt <KeyStore>
và <TrustStore>
trong
cấu hình SSLInfo
của chính sách Ghi nhật ký thư,
cho phép TLS/SSL hai 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 giống như cách bạn thực hiện trên proxy
TargetEndpoint. Tuy nhiên, TLS/SSL của tính năng Ghi nhật ký thư chỉ hỗ trợ giao thức TCP.
(APIRT-1858)
Đã sửa 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 người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được khắc phục hay chưa. Tính năng này không nhằm cung cấp thông tin chi tiết cho tất cả người dùng.
ID vấn đề | Nội dung mô tả |
---|---|
SECENG-609 | Các lệnh gọi thời gian chạy không thực hiện được trong quá trình xoá kho lưu trữ tin cậy được liên kết hoặc khi chứng chỉ hợp lệ trong kho lưu trữ tin cậy bị xoá |
MGMT-3404 | Xem/truy xuất nhật ký Node.js và triển khai proxy rất chậm |
MGMT-3400 | Lệnh gọi đến API quản lý /userroles sẽ không thành công nếu người dùng thực hiện lệnh gọi có dấu "+" trong 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 | Các mục nhập danh sách trong kho lưu trữ có giá trị rỗng ở một trong các mục nhập không hoạt động đối với các tổ chức (CPS và không phải CPS) |
MGMT-3226 | Việc truy vấn ở cấp tổ chức/môi trường không nên lấy tất cả dữ liệu khiến API bị lỗi Release_160302 gặp lỗi khiến việc liệt kê 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 tài nguyên trên 16 MB, thì bản sửa lỗi này sẽ khắc phục được vấn đề. |
AXAPP-2429 | API Analytics sử dụng response_status_code sẽ trả về lỗi truy cập dữ liệu |
AXAPP-2386 | Khắc phục nội dung báo cáo trống trong báo cáo qua email hằng ngày của Analytics |
AXAPP-2347 | Không nhận được email tóm tắt 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 đặt ở chế độ riêng tư |
APIRT-3140 | Chính sách chú thích dịch vụ không hoạt động trong các lệnh gọi API HEAD |
APIRT-3131 | Không chính xác do hiển thị cho một Proxy API khi sử dụng tính năng kiếm tiền với 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 được thực hiện không hiệu quả 100% |
APIRT-3117 | MP đạt 100% mức sử dụng CPU và ngừng phân phát lưu lượng truy cập |
APIRT-3016 | Lỗi "Hết thời gian chờ cuộc gọi" của bộ định tuyến trong quá trình triển khai |
APIRT-2975 | Không tải được gói chứng chỉ lên |
APIRT-2955 | Không thể che một số thuộc tính nhất định của dữ liệu phản hồi JSON cho tiêu đề FHIR-complaint Content-Type 'application/json+fhir' |
APIRT-2946 | Chính sách OAuthV2-RefreshToken không ẩn các thuộc tính mặc dù chế độ hiển thị được đặt thành false |
APIRT-2908 | Bắt buộc thực thi TLS1.2 cho lệnh gọi API nội bộ sau khi cập nhật TLS1.2 trên máy chủ ảo |
APIRT-2901 | Phản hồi được nén được trả về từ bộ nhớ đệm được nén hai lần |
APIRT-2873 | MP gửi NullPointerException liên quan đến VerifyAPIKey sau khi xoá sản phẩm/nhà phát triển/proxies |
APIRT-2871 | Các chính sách IOIntensive xuất hiện 2 lần trong Trace |
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 | Giao thông không thể lưu thông do đang gửi lỗi không xác định |
APIRT-2647 | Lỗi"Luồng đầu vào cơ bản trả về 0 byte" đối với tài sản không phải sản phẩm/nhà phát triển |
APIRT-2630 | Vấn đề gián đoạn khi cố gắng đọc giá trị từ bộ nhớ đệm |
APIRT-2620 | Nhóm chuỗi 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 đề được sửa đổi gần đây nhất trong chính sách Bộ nhớ đệm phản hồi |
APIRT-2605 | Không được phép ghi đè các biến"tổ chức" và "môi trường" bằng chính sách |
APIRT-2566 | Chính sách OAuthV2 trả về các tiêu đề Tùy chọn xác thực tầm nhìn 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 hoạt động quản lý và mps |
APIRT-2386 | Phạm vi chuỗi trống được tạo trong một sản phẩm API có phạm vi OAuth được phép trống |
APIRT-2383 | Các chính sách chuyển đổi XSL có vẻ như không ghi lại bất kỳ dữ liệu nào khi có lỗi |
APIRT-2364 | Các biến của luồng lỗi OAuth không được cập nhật về lỗi |
APIRT-2216 | Sự kiện do máy chủ gửi – luồng sự kiện có vấn đề trong phiên bản chính thức |
APIRT-2079 | Lệnh gỡ lỗi cURL không dừng sau khi hết thời gian chờ cho phiên đã tạo |
APIRT-1495 | Tính năng Bảo vệ khỏi mối đe doạ XML không phát hiện được loại nội dung fhir |
APIRT-347 | Chính sách NDK không được xác thực đúng khi nhập (không chỉ định kết quả cho các biến đầu ra như được ghi trong tài liệu) |