4.15.07.00 – Ghi chú phát hành về Apigee Edge dành cho đám mây riêng tư

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 8 tháng 9 năm 2015, chúng tôi đã phát hành một bản phát hành tính năng chính của Apigee Edge dành cho đám mây riêng tư.

Kể từ bản phát hành hằng quý của Edge for Private Cloud (4.15.04.00) trước đây, các bản phát hành sau đây đã ra mắt và có trong bản phát hành hằng quý này:

• Đám mây: 15.04.15, 15.04.29, 15.05.27, 15.06.10 và 15.06.24
• Đám mây riêng tư: 4.15.04.01

Bạn có thể nâng cấp lên phiên bản Edge nào lên 4.15.07.00

Tuỳ thuộc vào phiên bản Edge hiện tại, bạn có thể:

• Nâng cấp trực tiếp lên 4.15.07.00
• Nâng cấp dần, nghĩa là bạn phải nâng cấp từ phiên bản hiện tại lên phiên bản Edge khác, sau đó nâng cấp lên 4.15.07.00.

Để biết thêm thông tin, hãy xem bài viết Bạn có thể nâng cấp phiên bản Edge dành cho đám mây riêng tư nào lên phiên bản 4.15.07.00.

Trước khi nâng cấp từ phiên bản 4.15.01.x hoặc từ phiên bản trước

1. Kiểm tra phiên bản Cassandra SSTable:
   1. Thay đổi thư mục thành /<install-root>/apigee4/data/cassandra/data.
   2. Chạy lệnh tìm,
      > tìm . -name *-ic-*
      Kết quả sẽ trả về một tập hợp các tệp .db nếu bạn đang chạy Cassandra 1.2 SSTable.
   3. Chạy lệnh tìm này:
      > tìm . -name *-hf-*
      Kết quả phải để trống, nghĩa là không có tệp .db nào ở định dạng hf. Nếu không thấy tệp nào ở định dạng hf, thì bạn đã hoàn tất và có thể nâng cấp lên 4.15.07.00.
      
      Định dạng hf là dành cho Cassandra 1.0 SSTables. Nếu có tệp *.db ở định dạng hf, bạn phải nâng cấp SSTable theo mô tả trong phần còn lại của quy trình này.
2. Nếu bạn tìm thấy bất kỳ tệp *.db nào ở định dạng hf, hãy nâng cấp SSTable bằng cách chạy lệnh sau trên mỗi nút Cassandra cho đến khi bạn đã nâng cấp tất cả các nút Cassandra:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h nâng cấp localhoststables -a
3. Lặp lại Bước 1 để kiểm tra nhằm đảm bảo rằng tất cả các tệp *.db đều ở định dạng ic cho phiên bản Cassandra 1.2.
4. Lặp lại các bước từ 1 đến 3 trên mọi nút Cassandra trong quá trình cài đặt Edge.
5. Nâng cấp lên Edge 4.15.07.00.
6. Sau khi nâng cấp lên phiên bản 4.15.07.00, hãy kiểm tra các tệp *.db để đảm bảo tất cả các tệp đó đều đã được nâng cấp lên phiên bản ổn định kiểu C* 2.0:
   > cd /<install-root>/apigee4/data/cassandra/data
   > tìm . -name *- cải tiến-*
   Lệnh này sẽ trả về một tập hợp các tệp .db nếu bạn đang chạy Cassandra 2.0.

Tính năng mới và tính năng nâng cao

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

Cài đặt và nâng cấp

Nâng cấp và gỡ cài đặt thành phần có chọn lọc

Giờ đây, các tập lệnh apigee-upgrade.sh và apigee-installer.sh cho phép bạn chọn các thành phần Edge để nâng cấp hoặc gỡ cài đặt. Trước đây, công cụ này đã nâng cấp hoặc gỡ cài đặt tất cả các thành phần trên nút. (OPDK-1377, OPDK-1175)

Khôi phục nâng cấp

Nếu apigee-upgrade.sh không thành công trong quá trình nâng cấp, thì bạn hiện có thể sử dụng tập lệnh apigee-rollback.sh để khôi phục bản nâng cấp. Sau khi khắc phục mọi vấn đề về quá trình nâng cấp, bạn có thể thử nâng cấp lại. (OPDK-1275)

Tuỳ chọn tập lệnh trình cài đặt rút gọn

Tập lệnh cài đặt không còn có các tuỳ chọn dài, chẳng hạn như --help. Giờ đây, các trình xử lý này chỉ dùng các tuỳ chọn có một chữ cái, chẳng hạn như -h. (OPDK-1356)

Cài đặt Tài liệu thông minh

Khi cài đặt SmartDocs bằng tập lệnh setup-smartdocs.sh, bạn sẽ được nhắc nhập tổ chức, môi trường và máy chủ ảo. Các máy chủ này đảm bảo rằng SmartDocs được cài đặt ở vị trí mong muốn. Trước đây, những giá trị đó được mã hoá cứng trong tập lệnh. (OPDK-1310)

Chạy update-cass-pwd-in-config.sh mà không có lời nhắc

Tập lệnh update-cass-pwd-in-config.sh có thể chạy mà không cần lời nhắc nếu bạn đặt các biến môi trường ENABLE_CASS_AUTH, CASS_USERNAME và CASS_ACTIVITY. (OPDK-1309)

Bệ cạnh

Sau đây là các tính năng mới của nền tảng Edge có trong bản phát hành này.

OpenJDK 1.7 được hỗ trợ bởi Edge Private Cloud

Bản phát hành Edge này hỗ trợ Oracle JDK 1.7 và OpenJDK 7, đồng thời loại bỏ hỗ trợ cho JDK 1.6. (OPDK-1187)

Hỗ trợ hệ điều hành

Apigee Edge for Private Cloud đã mở rộng phạm vi hỗ trợ hệ điều hành để bao gồm Red Hat Enterprise Linux 6.6 và 7.0 (64 bit), CentOS 6.5, 6.6 và 7.0 (64 bit) và Oracle Linux 6.5.

Cassandra 2.0.15 đi kèm trong OPDK 15.07

Bản phát hành này cài đặt Cassandra 2.0.15. Nếu bạn đang nâng cấp cho một bản phát hành trước, phiên bản Cassandra của bạn sẽ được cập nhật. (OPDK-1197)

Hỗ trợ SHA2 để băm mã thông báo OAuth

Để bảo vệ mã thông báo OAuth tốt hơn trong trường hợp rò rỉ bảo mật cơ sở dữ liệu, Edge hỗ trợ thuật toán SHA2 để băm mã thông báo OAuth (bên cạnh SHA1). Với các thuộc tính mới ở cấp độ lợi ích, bạn có thể bật và định cấu hình chức năng băm cho mã thông báo mới cũng như giữ lại hoạt động băm cũ trên mọi mã thông báo đã tồn tại trước khi có tính năng mới này. Trước đây trong Edge dành cho Đám mây riêng tư, một thuộc tính có tên là hash.OAuth.tokens.enabled trong tệp keymanagement.properties (trên máy chủ quản lý và trình xử lý thông báo) đã bật tính năng băm SHA1 tự động cho mã thông báo OAuth. Thuộc tính này hiện không còn được dùng nữa.

Nếu trước đây bạn đã dùng thuộc tính hash.OAuth.tokens.enabled để bật tính năng băm SHA1, thì tập lệnh nâng cấp cho bản phát hành này sẽ tự động tạo các tài sản mới ở cấp tổ chức cho bạn. Để xác minh sau khi nâng cấp, hãy tải GET với tư cách quản trị viên hệ thống bằng API sau: https://{host}:{port}/v1/o/{your_org}.

• Để biết thông tin về cách bật tính năng băm mã thông báo trong tổ chức của bạn bằng các tài sản mới, hãy xem phần "Băm mã thông báo trong cơ sở dữ liệu" trong chủ đề Yêu cầu mã truy cập.
• Để biết thông tin về cách băm hàng loạt mã thông báo hiện có, hãy xem Hướng dẫn cách hoạt động của Edge dành cho đám mây riêng tư. (APIRT-1389)

Cấu trúc thư mục phẳng cho tệp nhật ký

Bạn có thể định cấu hình Edge để lưu trữ tệp nhật ký trong một cấu trúc thư mục phẳng bằng cách đặt một thuộc tính enable.flat.directory.structure mới thành true trong tệp message-logging.properties. Để biết thêm thông tin, hãy xem Chính sách ghi nhật ký thư. (APIRT-1394)

Hiệu suất bộ nhớ đệm của môi trường

Để quản lý và sử dụng bộ nhớ đệm trong bộ nhớ hiệu quả hơn, chúng tôi đã ngừng sử dụng chế độ cài đặt "Phần tử tối đa trong bộ nhớ" cho các tài nguyên bộ nhớ đệm của môi trường. Tổng số phần tử có trên mọi tài nguyên bộ nhớ đệm (bao gồm cả bộ nhớ đệm mặc định) phụ thuộc vào tổng bộ nhớ được phân bổ cho bộ nhớ đệm đó. Theo mặc định, tổng bộ nhớ được phân bổ để lưu vào bộ nhớ đệm trong bộ nhớ trên một trình xử lý thư nhất định là 40% tổng bộ nhớ còn trống, được xác định bằng chế độ cài đặt thuộc tính bộ nhớ đệm trong tệp cache.properties của trình xử lý thư. Các phần tử sẽ chỉ bị loại khỏi bộ nhớ đệm trong bộ nhớ khi không có đủ bộ nhớ đệm hoặc các phần tử đó hết hạn.

Để quay lại hoạt động cũ của việc sử dụng thuộc tính "Phần tử tối đa trong bộ nhớ" để quản lý bộ nhớ đệm, hãy đặt thuộc tính overrideMaxElementsInCacheResource=false trong tệp cache.properties. (APIRT-1140)

Dịch vụ API

Sau đây là các tính năng mới của Dịch vụ API được đưa vào bản phát hành này.

Trình chỉnh sửa proxy mới làm Trình chỉnh sửa mặc định

Theo mặc định, trình chỉnh sửa proxy API mới được bật trong giao diện người dùng quản lý. Trình chỉnh sửa mới có nhiều điểm cải tiến về khả năng hữu dụng, bao gồm chế độ xem toàn diện hơn về các luồng có điều kiện và điểm cuối trên Trang tổng quan, mọi cấu hình trên trang Phát triển, thêm các luồng có điều kiện, điểm cuối và chính sách một cách trực quan hơn, khung hiển thị XML hoàn chỉnh hơn thay vì các đoạn trích nhỏ, tính năng tìm kiếm để thu thập thông tin tên tệp và văn bản, v.v. (theo giờ GMT-2279)

Chính sách mới về thông tin Xoá OAuth phiên bản 2.0

Chính sách mới "Xoá thông tin OAuth phiên bản 2.0" cho phép bạn xoá mã truy cập và mã uỷ quyền OAuth phiên bản 2. Chính sách này thay thế chức năng mà API quản lý cung cấp trước đó. Để biết thêm thông tin, hãy xem nội dung Xoá chính sách thông tin OAuthV2. (theo giờ GMT-2257)

Chính sách thông tin mới về việc xoá OAuth phiên bản 1.0

Chính sách mới "Xoá thông tin OAuth phiên bản 1.0" cho phép bạn xoá mã thông báo yêu cầu OAuth phiên bản 1.0, mã truy cập và mã xác minh. Chính sách này thay thế chức năng mà API quản lý cung cấp trước đó. Để biết thêm thông tin, hãy xem Chính sách thông tin về việc xoá OAuth V1. (APIRT-1351)

Chính sách Kiểm soát quyền truy cập

Chúng tôi đã cải tiến chính sách Kiểm soát quyền truy cập để cho phép đánh giá chi tiết hơn các địa chỉ IP nhằm đưa vào danh sách cho phép và đưa vào danh sách từ chối khi địa chỉ IP có trong tiêu đề HTTP X-FORWARDED-FOR.

Khi bật tính năng kiểm tra nhiều địa chỉ IP trên tiêu đề (hãy liên hệ với bộ phận Hỗ trợ để thiết lập Feature.enableMultipleXForwardCheckForACL), phần tử <ValidateBasedOn> mới trong chính sách này sẽ cho phép bạn kiểm tra IP đầu tiên, IP cuối cùng hoặc tất cả IP trong tiêu đề. Để biết thêm thông tin, hãy xem Chính sách kiểm soát quyền truy cập.

Thực thể mới trong chính sách Thực thể truy cập

Chính sách về thực thể truy cập cấp quyền truy cập vào các thực thể mới sau: phạm vi khoá người tiêu dùng, mã uỷ quyền, mã yêu cầu và trình xác minh. Để biết thêm thông tin, hãy xem Chính sách về thực thể truy cập.

Chính sách của Trình thu thập số liệu thống kê: tự động chuyển đổi tên số liệu thống kê thành chữ thường

Khi tạo một tập hợp số liệu phân tích tuỳ chỉnh trong trình chỉnh sửa proxy API (trang Phát triển > Công cụ > Tập hợp Analytics tuỳ chỉnh), "Tên" của biến tập hợp (số liệu thống kê) phải là chữ thường. Nếu bạn nhập tên bằng chữ cái viết hoa, công cụ sẽ tự động chuyển đổi tên Số liệu thống kê thành chữ thường trong chính sách của Trình thu thập số liệu thống kê. (theo giờ GMT-740)

Xoá Dấu vết cổ điển trong trình chỉnh sửa proxy API

Phiên bản mới nhất của chức năng Theo dõi trong trình chỉnh sửa proxy API đã chuyển từ phiên bản beta sang giai đoạn phát hành rộng rãi. Bạn không thể truy cập vào tính năng "dấu vết kiểu cũ" bằng đường liên kết "Truy cập vào phiên bản dấu vết cũ" nữa.

Quyền truy cập vào Cộng đồng Apigee từ trình đơn Trợ giúp về giao diện người dùng quản lý

Bạn có thể truy cập vào Cộng đồng Apigee từ trình đơn Trợ giúp giao diện người dùng quản lý.

Thông báo lỗi trong giao diện người dùng quản lý

Sau đây là các tính năng nâng cao cho thông báo lỗi trong giao diện người dùng quản lý:

• Giao diện người dùng quản lý dùng để nhóm và hiển thị tất cả thông báo lỗi trên giao diện người dùng trong toàn bộ phiên đăng nhập trừ phi bạn loại bỏ các thông báo lỗi đó. Với bản cập nhật này, thông báo lỗi sẽ tự động được xoá khi bạn rời khỏi trang xảy ra lỗi. (theo giờ GMT-2254)
• Giao diện người dùng quản lý không còn chặn các thông báo lỗi trùng lặp nữa. (theo giờ GMT-2242)

Cải tiến về lỗi và hiệu suất của giao diện người dùng

Chúng tôi đã thực hiện các cải tiến chung cho nhiều khu vực của giao diện người dùng quản lý, bao gồm cả hiệu suất hiển thị trang và dọn dẹp thông báo lỗi.

Siêu liên kết vai trò trên trang Người dùng tổ chức trong giao diện người dùng quản lý

Trên trang Người dùng của tổ chức trong giao diện người dùng quản lý (Quản trị viên > Người dùng của tổ chức), tên vai trò hiện được gắn siêu liên kết, cho phép bạn nhanh chóng điều hướng đến các trang vai trò. (theo giờ GMT-1055)

Biến mục tiêu mới trong luồng thông báo

Các biến mới trong luồng thông báo cung cấp thông tin URL đầy đủ hơn cho điểm cuối mục tiêu và máy chủ mục tiêu:

• TargetEndpoint: request.url thay thế target.basepath.with.query.
• Máy chủ mục tiêu: loadbalancing.targetserver thay thế targetserver.name. Ngoài ra, target.basepath chỉ được điền khi phần tử <Path> được sử dụng trong phần tử HTTPTargetConnection <LoadBalancer> của TargetEndpoint.

Hỗ trợ Chỉ báo tên máy chủ (SNI)

Edge hỗ trợ việc sử dụng Chỉ báo tên máy chủ hướng về phía nam (từ trình xử lý thông báo đến điểm cuối nhắm mục tiêu). Nếu bạn muốn sử dụng DEX, hãy liên hệ với Bộ phận hỗ trợ API.

Bạn cần có Java 1.7.

Với sFTP là một phần mở rộng của TLS/SSL, nhiều mục tiêu HTTPS có thể được phân phát qua cùng một địa chỉ IP và cổng mà không yêu cầu tất cả các mục tiêu đó sử dụng cùng một chứng chỉ.

Bạn không cần phải định cấu hình riêng cho Edge. Nếu môi trường của bạn được định cấu hình cho hướng dẫn về phía nam (bên nam) (theo mặc định), Edge sẽ hỗ trợ môi trường đó.

Edge tự động trích xuất tên máy chủ từ URL yêu cầu và thêm tên này vào yêu cầu bắt tay SSL. Ví dụ: nếu máy chủ lưu trữ mục tiêu là https://example.com/request/path, thì Edge sẽ thêm phần mở rộng server_name như sau:

Để biết thêm thông tin về KDDI, hãy xem http://en.wikipedia.org/wiki/Server_Name_Indication.

"Thuật toán chữ ký" trong thông tin chi tiết về Chứng chỉ SSL

Một trường "Thuật toán chữ ký" mới đã được thêm vào thông tin chi tiết về chứng chỉ SSL. Trường này có thể xem được trong giao diện người dùng quản lý (Quản trị viên > Chứng chỉ SSL) và API quản lý (Lấy thông tin chi tiết về chứng chỉ từ Kho khoá hoặc Kho tin cậy). Trường này sẽ hiện "sha1WithRSAcipher" hoặc "sha256WithRSAcipher", tuỳ thuộc vào loại thuật toán băm dùng để tạo chứng chỉ.

Hiển thị chứng chỉ SSL sắp hết hạn

Trang Chứng chỉ SSL trong giao diện người dùng quản lý (Quản trị viên > Chứng chỉ SSL) cho biết thời điểm chứng chỉ SSL sẽ hết hạn trong vòng 10, 15, 30 hoặc 90 ngày, tùy thuộc vào lựa chọn của bạn trong trường thả xuống hết hạn mới.

Cấu hình lỗi bảo vệ khỏi mối đe doạ

Theo mặc định, Edge sẽ gửi mã trạng thái Lỗi máy chủ nội bộ HTTP 500 và lỗi ExecutionFailed nếu thông báo không vượt qua được chính sách Bảo vệ mối đe doạ JSON hoặc XML. Bạn có thể thay đổi hành vi của lỗi đó bằng một thuộc tính mới ở cấp tổ chức. Khi đặt thuộc tính tổ chức features.isPolicyHttpStatusEnabled thành true (đúng), hành vi sau đây sẽ xảy ra:

• Yêu cầu: Khi đi kèm chính sách bảo vệ khỏi các mối đe doạ, những thông báo không hợp lệ sẽ trả về mã trạng thái 400 cùng với thông báo lỗi tương ứng về chính sách.
• Phản hồi: Khi đính kèm chính sách bảo vệ khỏi các mối đe doạ với bất kỳ quy trình phản hồi nào, thông báo không hợp lệ vẫn trả về mã trạng thái 500 và một trong các thông báo lỗi tương ứng về chính sách sẽ được gửi (thay vì chỉ ExecutionFailed).

Khách hàng của Google Cloud phải liên hệ với Apigee Support để đặt thuộc tính tổ chức. Tính năng này sẽ được cung cấp cho khách hàng của Edge Private Cloud trong bản phát hành Private Cloud hằng quý tiếp theo.

Cập nhật giản đồ cho điểm cuối, proxy và các thực thể khác

Chúng tôi đã cập nhật giản đồ tham chiếu cho các thực thể không phải chính sách như TargetEndpoint, ProxyEndpoint, APIProxy và nhiều thực thể khác. Xem https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)

Các dịch vụ dành cho nhà phát triển

Sau đây là các tính năng mới của Dịch vụ dành cho nhà phát triển trong bản phát hành này.

Phạm vi cung cấp rộng rãi

SmartDocs phát triển từ giai đoạn thử nghiệm beta sang giai đoạn phát hành rộng rãi. Các bản cập nhật và tính năng mới bao gồm:

• Hỗ trợ Swagger 2.0, bao gồm cả tính năng nhập bằng tệp hoặc URL, bao gồm tính năng hỗ trợ cho các đối tượng bảo mật được đặt tên tuỳ chỉnh.
• Cải thiện thiết kế hình ảnh trong các mẫu tạo tài liệu thông minh.
• Các tính năng nâng cao cho quy trình công việc và khả năng hữu dụng trong Cổng thông tin cho nhà phát triển có trong trình đơn Nội dung > SmartDocs trong Drupal.
• Phần đã được gọi là xác thực "Mã thông báo tuỳ chỉnh" giờ đây được gọi là "Khoá API".
• Xác thực các đối tượng "bảo mật" được xác định ở cấp bản sửa đổi.
• Cấu hình xác thực ứng dụng ở cấp mẫu. Các bản sửa đổi mới không còn đặt lại mọi thông tin đăng nhập của ứng dụng SmartDocs được định cấu hình sẵn nữa.

Để tìm hiểu thêm về nội dung mô tả tính năng, hãy xem bài đăng trên blog này.

Để xem tài liệu về SmartDocs, hãy xem phần Sử dụng SmartDocs để ghi tài liệu API.

Tên ứng dụng dành cho nhà phát triển hiển thị trong giao diện người dùng quản lý

Các ứng dụng dành cho nhà phát triển trong Edge có cả Tên nội bộ không thay đổi và Tên hiển thị mà bạn có thể thay đổi. Trên trang Ứng dụng dành cho nhà phát triển trong giao diện người dùng quản lý (Xuất bản > Ứng dụng dành cho nhà phát triển > tên ứng dụng), "Tên" nội bộ của ứng dụng hiển thị cùng với "Tên hiển thị", giúp bạn dễ dàng xác định trực quan ứng dụng theo tên nội bộ để khắc phục sự cố và quản lý API.

Dịch vụ Analytics

Sau đây là các tính năng mới của Dịch vụ Analytics được đưa vào bản phát hành này.

Giới hạn thời gian lưu trữ dữ liệu được lưu giữ

Khi tạo báo cáo phân tích bằng API hoặc giao diện người dùng quản lý, theo mặc định, bạn không thể truy cập vào dữ liệu cũ hơn 6 tháng kể từ ngày hiện tại. Nếu bạn muốn truy cập dữ liệu cũ hơn 6 tháng, hãy liên hệ với Nhóm hỗ trợ API.

Phiên bản cũ của báo cáo tuỳ chỉnh bị xoá khỏi giao diện người dùng quản lý

Phiên bản cũ (không bắt buộc) của báo cáo phân tích tuỳ chỉnh không còn xuất hiện trong giao diện người dùng quản lý nữa.

Hiệu suất của tiện ích Mức độ tương tác của nhà phát triển

Chúng tôi đã cải thiện tiện ích phễu trên trang tổng quan số liệu phân tích chính (mục Mức độ tương tác của nhà phát triển) để mang lại hiệu suất tốt hơn.

Kiếm tiền

Sau đây là các tính năng kiếm tiền mới có trong bản phát hành này.

Thông báo qua email về gói giá

Loại thông báo mới qua email về Gói giá giúp bạn thông báo cho nhà phát triển khi họ đạt đến một hạn mức giao dịch hoặc hạn mức nhất định qua các gói giá theo gói hoặc trong băng tần mà họ đã mua. Để biết thông tin chi tiết, hãy xem phần Thiết lập thông báo bằng mẫu thông báo.

Đồng bộ hoá Phí định kỳ và giai đoạn cơ sở tổng hợp

Trong một kế hoạch giá, có thể có hai khoảng thời gian khác nhau có hiệu lực:

• Kỳ hạn Phí định kỳ, được định cấu hình trên thẻ Phí của gói giá, được xác định thời điểm nhà phát triển bị tính phí định kỳ.
• Giai đoạn Cơ sở tổng hợp, được xác định trên thẻ giá cho các gói Theo dải số lượng hoặc Gói, được xác định khi nhà phát triển đặt lại việc sử dụng gói.

2 khoảng thời gian đó hiện đã được đồng bộ hoá. Khi một gói giá có cả phí định kỳ khác 0 và bảng giá theo Mức âm lượng theo số lượng lớn hoặc Gói giá, thì kỳ tính phí định kỳ sẽ được dùng cho cả hai gói. Ví dụ: nếu bạn thu phí định kỳ hằng tháng, thì hệ thống cũng sẽ đặt lại các gói bảng giá hằng tháng (theo mặc định vào đầu tháng).

Nếu không có phí định kỳ, các gói sẽ được đặt lại dựa trên Cơ sở tổng hợp được xác định trên thẻ giá. Ví dụ: Nếu nhà phát triển bắt đầu sử dụng bảng giá vào ngày 19 của tháng và Cơ sở tổng hợp hằng tháng, thì việc sử dụng gói sẽ được đặt lại sau ngày 19 của tháng.

Cơ sở tổng hợp sẽ không được dùng nữa và sẽ bị xoá khỏi tính năng kiếm tiền trong một bản phát hành sau này. Để biết thêm thông tin, hãy xem phần Chỉ định chi tiết về gói giá.

Thuộc tính tuỳ chỉnh trong báo cáo doanh thu tóm tắt

Chính sách ghi lại giao dịch cho phép bạn thu thập dữ liệu thuộc tính tuỳ chỉnh từ các giao dịch (không bắt buộc). Giờ đây, bạn có thể thêm các thuộc tính giao dịch tuỳ chỉnh đó vào báo cáo tóm tắt doanh thu. Bằng cách thêm thuộc tính MINT.SUMMARY_CUSTOM_ATTRIBUTES vào tổ chức của mình, bạn có thể cho biết thuộc tính tuỳ chỉnh nào được thêm vào bảng cơ sở dữ liệu để sử dụng trong báo cáo.

Khách hàng của Apigee Edge dành cho đám mây riêng tư có thể gắn cờ bằng lệnh gọi API và thông tin đăng nhập của Quản trị viên hệ thống sau đây.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

Lưu ý rằng mảng thuộc tính tuỳ chỉnh trong lệnh gọi API được mã hoá URL.

Quy trình nâng cấp Tài liệu thông minh

Nếu bạn đang dùng SmartDocs trong giai đoạn thử nghiệm, thì các tính năng và chức năng mới trong phiên bản phát hành rộng rãi sẽ yêu cầu bạn nâng cấp SmartDocs trong cổng thông tin dành cho nhà phát triển.

Mọi trang SmartDocs đã được xuất bản trong cổng thông tin dành cho nhà phát triển của bạn sẽ tiếp tục hoạt động, nhưng bạn phải tuân theo quy trình cập nhật trước khi chỉnh sửa hoặc xuất bản bất kỳ thay đổi nào đối với trang hiện có hoặc trang mới.

Xin lưu ý rằng mặc dù bạn có thể kết xuất và xuất bản SmartDocs bên trong cổng thông tin dành cho nhà phát triển, nhưng SmartDocs được tạo từ mô hình API hoạt động trong Dịch vụ quản lý API Edge của Apigee. Mọi thay đổi bạn thực hiện đối với một mô hình API trong Edge sẽ giống nhau trên tất cả các môi trường Pantheon của bạn (tương tự như cách nhà phát triển tồn tại trong các môi trường Pantheon).

Cách nâng cấp từ SmartDocs thử nghiệm lên phiên bản phát hành rộng rãi

1. Cập nhật và kiểm thử bản phát hành 15.05.27 trong môi trường dev hoặc kiểm thử trên Pantheon.
2. Tạo một mô hình mới để thay thế mọi mô hình API hiện có mà bạn đang sử dụng.
   • Nếu bạn đang nhập các tài liệu Swagger hoặc WADL, hãy nhập lại các tài liệu đó vào một bản sửa đổi mới.
   • Nếu bạn vẫn duy trì mô hình API thông qua mô-đun SmartDocs, hãy xuất dưới dạng JSON của SmartDocs rồi nhập vào mô hình mới bằng tệp đính kèm.
3. Đặt thuộc tính bảo mật của bản sửa đổi mô hình của bạn. Trên trang Nội dung > SmartDocs > mẫu, chọn Cài đặt bảo mật.
   
4. Kiểm tra mọi quy trình xác thực được định cấu hình sẵn trên trang cài đặt mô hình (Nội dung > SmartDocs) bằng cách nhấp vào Settings (Cài đặt) trong cột Operations (Hoạt động).
   
5. Hãy cập nhật mọi mẫu tuỳ chỉnh để sử dụng các thành phần CSS và JS phiên bản 6, đồng thời thực hiện các thay đổi để phản ánh mọi tên đối tượng mới, chẳng hạn như authSchemes và apiSchema. Để biết thông tin về cách cập nhật mẫu SmartDocs, xem phần Sử dụng SmartDocs cho API tài liệu.
6. Kết xuất lại và xuất bản bản sửa đổi mô hình.
7. Sau khi xác thực tài liệu mới, hãy cập nhật cổng phát hành công khai lên bản phát hành 15.05.27.

Nếu bạn là khách hàng doanh nghiệp Edge và có câu hỏi hoặc thắc mắc về quá trình nâng cấp, vui lòng gửi email đến marsh@apigee.com và cnovak@apigee.com. Nếu không, vui lòng sử dụng Cộng đồng API để nhận được phản hồi phù hợp nhất.

Các điểm thay đổi và cải tiến về tính năng trong tương lai

Phần này giúp bạn xem trước các điểm thay đổi và cải tiến về tính năng dự kiến trong tương lai:

Thay đổi đối với hành vi của chính sách Bộ nhớ đệm phản hồi

Ra mắt trong bản phát hành sau này (sẽ được xác định), hành vi mặc định của phần tử <ExcludeErrorResponse> của chính sách Bộ nhớ đệm phản hồi sẽ thay đổi.

Hành vi hiện tại: Phần tử <ExcludeErrorResponse> trong chính sách bộ nhớ đệm phản hồi là false theo mặc định. Điều này có nghĩa là theo mặc định, các phản hồi có mã trạng thái HTTP bất kỳ (bao gồm cả 3xx) sẽ được lưu vào bộ nhớ đệm theo chính sách Bộ nhớ đệm phản hồi.

Hành vi trong tương lai: Phần tử <ExcludeErrorResponse> trong chính sách Bộ nhớ đệm của phản hồi sẽ được đặt mặc định thành true. Điều này có nghĩa là theo mặc định, chỉ những phản hồi có mã trạng thái HTTP 200 đến 205 mới được lưu vào bộ nhớ đệm. Để ghi đè hành vi này và phản hồi vào bộ nhớ đệm cho tất cả mã trạng thái, bạn cần đặt phần tử <ExcludeErrorResponse> thành true một cách rõ ràng.

Giải pháp hiện tại: Đối với các bản phát hành Private Cloud 4.15.07.00 trở về trước, nếu bạn chỉ muốn lưu phản hồi vào bộ nhớ đệm đối với mã Trạng thái 200 đến 205, bạn phải đặt phần tử <ExcludeErrorResponse> thành true một cách rõ ràng.

Đã sửa lỗi

Các lỗi sau đây đã được khắc phục trong bản phát hành này.

Vấn đề đã biết

Bản phát hành này gặp một số vấn đề đã biết sau đây.

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart