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 ứng dụng Riêng tư Đám mây.

Kể từ bản phát hành hàng quý trước đó của Edge dành cho Private Cloud (4.15.04.00), những phiên bản sau đã từng ra mắt và được đưa vào 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 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 khác Phiên bản Edge của bạn rồi 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 lên phiên bản Edge nào cho Đám mây riêng tư 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 một 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 kiếm này:
      > tìm . -name *-hf-*
      Kết quả phải trống, nghĩa là không có tệp .db ở định dạng hf. Nếu bạn không thấy tệp nào trong hf, thì bạn sẽ đã thực hiện và có thể nâng cấp lên 4.15.07.00.
      
      Định dạng hf dành cho Cassandra 1.0 SSTables. Nếu có bất kỳ tệp *.db nào ở định dạng hf, thì bạn phải nâng cấp SSTable như được mô tả trong phần còn lại của quy trình này.
2. Nếu bạn 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ả Cassandra nút:
   &gt; /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h nâng cấp localhost ổn định –a
3. Lặp lại Bước 1 để kiểm tra xem tất cả các tệp *.db có ở định dạng ic cho Cassandra 1.2 hay không .
4. Lặp lại từ bước 1 đến bước 3 đối với 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 4.15.07.00, hãy kiểm tra các tệp *.db để đảm bảo tất cả chúng đã được nâng cấp thành phiên bản ổn định kiểu C* 2.0:
   &gt; cd /&lt;install-root&gt;/apigee4/data/cassandra/data
   &gt; tìm . -tên *- lập trình-*
   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

Tập lệnh apigee-upgrade.sh và apigee-Uninstall.sh hiện 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ả thành phần trên nút. (OPDK-1377, OPDK-1175)

Nâng cấp khôi phục

Nếu apigee-upgrade.sh không thành công trong quá trình nâng cấp, giờ đây bạn có thể sử dụng apigee-rollback.sh để khôi phục nâng cấp. Sau khi khắc phục mọi vấn đề về việc 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

Các tập lệnh cài đặt không còn ở dạng dài các tuỳ chọn, chẳng hạn như --help. Chỉ hiện chọn các lựa chọn có một chữ cái, chẳng hạn như -h. (OPDK-1356)

Cài đặt SmartDocuments

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

Đang 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 giá trị Các biến môi trường ENABLE_CASS_ lượt hiển thị , CASS_USERNAME và CASS_passwords. (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 Edge Private Cloud hỗ trợ

Bản phát hành này của Edge 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 cho Private Cloud đã mở rộng khả năng hỗ trợ hệ điều hành cho Red Hat Enterprise Linux 6.6 và 7.0 (64-bit), CentOS 6.5, 6.6 & 7.0 (64-bit) và Oracle Linux 6,5.

Cassandra 2.0.15 có trong OPDK 15.07

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

Hỗ trợ SHA2 cho việc băm mã thông báo OAuth

Để tăng cường bảo vệ mã thông báo OAuth trong trường hợp xảy ra vi phạm bảo mật cơ sở dữ liệu, Edge hỗ trợ SHA2 các thuật toán để băm mã thông báo OAuth (ngoài SHA1). Có cấp ưu đãi mới thuộc tính, bạn có thể bật và định cấu hình băm cho các mã thông báo mới cũng như giữ lại 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 Private Cloud, có tên băm.oauth.tokens.enabled trong tệp keymanagement.properties (trên tệp máy chủ quản lý và trình xử lý thư) đã bật tính năng băm tự động SHA1 cho mã thông báo OAuth. Chiến dịch này thuộc tính hiện không được dùng nữa.

Nếu trước đó bạn đã sử dụng thuộc tính hash.oauth.tokens.enabled để bật tùy chọn băm SHA1, tập lệnh nâng cấp cho bản phát hành này sẽ tự động tạo các thuộc tính cấp tổ chức mới cho bạn. Người nhận xác minh sau khi nâng cấp, hãy thực hiện GET với tư cách là quản trị viên hệ thống bằng API này: 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 "Mã thông báo băm trong cơ sở dữ liệu" trong phần Yêu cầu mã truy cập chủ đề.
• Để biết thông tin về việc băm hàng loạt các mã thông báo hiện có, hãy xem Edge cho Cloud riêng tư Hướng dẫn thao tác. (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 cấu trúc thư mục phẳng bằng cách đặt đặt thuộc tính enable.flat.directory.structure thành true trong message-logging.properties . Để biết thêm thông tin, hãy xem Chính sách ghi nhật ký tin nhắn. (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, phần tử tối đa trong bộ nhớ chế độ cài đặt tài nguyên bộ nhớ đệm của môi trường không được dùng nữa. Tổng số phần tử có trên tất cả 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ổ cho chức năng lưu vào bộ nhớ đệm trong bộ nhớ trên một trình xử lý thông báo nhất định là 40% tổng bộ nhớ có sẵn, được xác định bằng chế độ cài đặt thuộc tính bộ nhớ đệm trong thông báo của bạn bộ xử lý cache.properties. Các phần tử sẽ chỉ bị xoá khỏi bộ nhớ đệm trong bộ nhớ khi có không đủ bộ nhớ đệm hoặc các phần tử hết hạn.

Để quay lại hành vi sử dụng "Các phần tử tối đa trong bộ nhớ" cũ thuộc tính cho 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 của Dịch vụ API mới có trong bản phát hành này.

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

Trình chỉnh sửa proxy API mới được bật theo mặc định trong giao diện người dùng quản lý. Trình chỉnh sửa mới bao gồm nhiều 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, tất cả cấu hình trên trang Phát triển, thêm trực quan hơn luồng có điều kiện, điểm cuối và chính sách, chế độ xem XML hoàn chỉnh hơn thay vì các đoạn mã nhỏ, tìm kiếm để thu thập thông tin tên tệp, văn bản và nhiều nội dung khác. (MGMT-2279)

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

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

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

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

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

Chính sách Kiểm soát quyền truy cập đã được cải tiến để cho phép đánh giá chi tiết hơn các địa chỉ IP để đưa vào danh sách cho phép và 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), một phần tử <ValidateBasedOn> mới trong chính sách cho phép bạn kiểm tra lại 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 về Thực thể truy cập

Chính sách Thực thể truy cập cho phép truy cập vào các thực thể mới sau đây: phạm vi khoá của người dùng, uỷ quyền, requesttoken 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 người thu thập 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ụ) &gt; Tập hợp Analytics tuỳ chỉnh), biến trình thu thập (số liệu thống kê) "Tên" phải là chữ thường. Nếu bạn nhập tên bằng chữ hoa, công cụ sẽ tự động chuyển đổi Tên thống kê thành chữ thường trong chính sách Trình thu thập thống kê. (MGMT-740)

Xoá tính năng Theo dõi kiểu cũ 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ừ bản beta sang bản phát hành rộng rãi. Quyền truy cập vào tính năng "dấu vết kiểu cũ" bằng "Truy cập phiên bản theo dõi cổ điển" đường liên kết không còn hoạt động nữa.

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

Bạn có thể truy cập vào Cộng đồng Apigee thông qua trình đơn trợ giúp của 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 cho toàn bộ trừ phi bạn loại bỏ chúng. Với bản cập nhật này, các thông báo lỗi sẽ được xoá tự động khi bạn rời khỏi trang mà lỗi đó xảy ra. (MGMT-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. (MGMT-2242)

Cải thiện hiệu suất giao diện người dùng và lỗi

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

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

Trên trang Người dùng tổ chức trong giao diện người dùng quản lý (Quản trị viên > Người dùng tổ chức), vai trò tên hiện được siêu liên kết, cho phép bạn điều hướng nhanh đến các trang vai trò. (MGMT-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 các điểm cuối mục tiêu và máy chủ đích:

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

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ủ theo hướng về phía nam (từ trình xử lý thư đến đích điểm cuối). Nếu bạn muốn sử dụng SNI, hãy liên hệ với Bộ phận hỗ trợ Apigee.

Bạn cần có Java 1.7.

Với SNI, 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 như nhau Địa chỉ IP và cổng mà không yêu cầu tất cả các đích đó sử dụng cùng một chứng chỉ.

Không cần cấu hình dành riêng cho Edge. Nếu môi trường của bạn được định cấu hình theo hướng nam SNI (Đám mây viền theo mặc định), Edge hỗ trợ công nghệ này.

Edge tự động trích xuất tên máy chủ từ URL yêu cầu và sẽ thêm đường liên kết 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 thêm tiện ích server_name như hình minh hoạ bên dưới:

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

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

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

Hiển thị các 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ị > 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, tuỳ thuộc vào lựa chọn của bạn trong trường thả xuống ngày 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ột mã trạng thái Lỗi máy chủ nội bộ HTTP 500 và ExecutionFailed nếu một 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 lỗi đó với một thuộc tính cấp tổ chức mới. Khi thiết lập tổ chức thuộc tính features.isPolicyHttpStatusEnabled thành true, sau đây xảy ra:

• Yêu cầu: Có chính sách bảo vệ chống mối đe doạ đính kèm với bất kỳ quy trình yêu cầu nào, thông báo không hợp lệ trả về mã trạng thái 400 cùng với thông báo lỗi chính sách tương ứng.
• Phản hồi: Chính sách bảo vệ chống lại mối đe doạ đi kèm 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à hệ thống sẽ gửi một trong các thông báo lỗi chính sách tương ứng (thay vì chỉ ExecutionFailed).

Khách hàng của Cloud phải liên hệ với Bộ phận hỗ trợ Apigee để đặt thuộc tính tổ chức. Khách hàng của Edge Private Cloud sẽ có thể sử dụng tính năng này vào thời gian tới Bản phát hành Private Cloud hằng quý.

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

Giản đồ tham chiếu đã được cập nhật cho các thực thể không liên quan đến chính sách như TargetEndpoint, ProxyEndpoint, APIProxy và nhiều ứng dụng khác. Hãy 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.

Khả năng phát hành rộng rãi của SmartDocuments

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

• Hỗ trợ cho Swagger 2.0, bao gồm nhập theo tệp hoặc URL, bao gồm hỗ trợ cho đối tượng bảo mật có tên tuỳ chỉnh.
• Cải tiến thiết kế trực quan trong các mẫu tạo SmartDocs.
• Khả năng hữu dụng và các cải tiến về quy trình công việc trong Cổng thông tin dành cho nhà phát triển, được cung cấp thông qua phần Nội dung &gt; Trình đơn SmartDocs trong Drupal.
• Yếu tố được gọi là "Mã thông báo tuỳ chỉnh" xác thực hiện được gọi là "Khoá API".
• "Bảo mật" xác thực đối tượng được xác định ở cấp sửa đổi.
• Cấu hình xác thực ứng dụng khách ở cấp mẫu. Các bản sửa đổi mới không còn bị đặt lại mọi thông tin đăng nhập ứng dụng SmartDocs được định cấu hình sẵn.

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

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

Tên ứng dụng của nhà phát triển xuất hiện trong giao diện người dùng quản lý

Các ứng dụng của nhà phát triển trong Edge có cả Tên nội bộ không thay đổi và Tên hiển thị thay đổi được. 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 được hiển thị cùng với "Tên hiển thị", giúp người dùng để xác định trực quan ứng dụng theo tên nội bộ nhằm khắc phục sự cố và quản lý API.

Dịch vụ Analytics

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

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

Khi bạn tạo báo cáo phân tích bằng giao diện người dùng quản lý hoặc API, dữ liệu được lưu hơn 6 tháng trước từ ngày hiện tại không thể truy cập được theo mặc định. 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 Bộ phận hỗ trợ Apigee.

Phiên bản cũ của báo cáo tuỳ chỉnh sẽ 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 được cung cấp trong giao diện người dùng quản lý.

Hiệu suất của tiện ích Hoạt động 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 chính về số liệu phân tích (phần Mức độ tương tác của nhà phát triển) nhằm 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 về Gói giá qua email cho phép bạn thông báo cho nhà phát triển khi họ đạt đến trong các gói giá theo gói hoặc gói giá theo phạm vi số lượng mà người dùng đã mua. Cho chi tiết, hãy xem Thiết lập thông báo bằng mẫu thông báo.

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

Trong một gói giá, có thể có hai khoảng thời gian khác nhau:

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

Hai khoảng thời gian đó hiện đã được đồng bộ hoá. Khi có cả phí định kỳ khác 0 và Băng tần số lượng hoặc thẻ giá theo Gói nằm trong một gói giá, kỳ tính phí định kỳ được áp dụng cho cả hai. Ví dụ: nếu có phí định kỳ hằng tháng, thì gói thẻ giá cũng được đặt lại hằng tháng (theo mặc định ở mức đầ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 là hằng tháng, sau đó việc sử dụng gói được đặt lại một tháng sau ngày 19.

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

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 tuỳ ý thu thập dữ liệu thuộc tính tuỳ chỉnh từ giao dịch và giờ đây bạn có thể đưa các thuộc tính giao dịch tuỳ chỉnh đó vào phần doanh thu tóm tắt . 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 Apigee Edge dành cho Private Cloud có thể đặt cờ bằng lệnh gọi API sau đây và Thông tin xác thực Quản trị viên hệ thống.

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>"

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

Quá trình nâng cấp SmartDocs

Nếu bạn đã sử dụng SmartDocs trong giai đoạn beta, các tính năng và khả năng mới trong phiên bản phát hành rộng rãi, bạn cần phải nâng cấp SmartDocs trong phiên bản phát triển của mình cổng thông tin.

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 nhưng bạn phải thực hiệ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 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 trong cổng thông tin dành cho nhà phát triển của mình, Tài liệu thông minh được tạo từ mô hình API nằm trong dịch vụ Quản lý API Edge của Apigee Các dịch vụ. Mọi thay đổi bạn thực hiện đối với mô hình API trong Edge sẽ giống nhau trên tất cả Pantheon của bạn (tương tự như cách nhà phát triển tồn tại trong môi trường Pantheon).

Cách nâng cấp từ phiên bản thử nghiệm của Smart Docs sang giai đoạ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 phát triển hoặc kiểm thử của bạn trên Đền Pantheon.
2. Tạo 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 chúng vào một bản sửa đổi này.
   • Nếu bạn vẫn đang duy trì mô hình API thông qua mô-đun SmartDocs, xuất dưới dạng Tệp JSON của SmartDocs và nhập vào mô hình mới của bạn 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. Trên thẻ Nội dung > Smart Docs > kiểu máy, hãy chọn Cài đặt bảo mật.
   
4. Kiểm tra bất kỳ xác thực được định cấu hình sẵn nào trong trang cài đặt mô hình (Nội dung > SmartDocs) bằng cách nhấp vào Cài đặt trong phần Hoạt động .
   
5. Cập nhật mọi mẫu tuỳ chỉnh để sử dụng phiên bản 6 của tài sản CSS và JS, đồng thời thực hiện các thay đổi để phản ánh bất kỳ tên đối tượng mới nào, chẳng hạn như authSchemes và apiSchema. Để biết thông tin về cách cập nhật SmartDocs mẫu, hãy xem phần Sử dụng API SmartDocs sang 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 chính thức của bạn đến bản phát hành 15.05.27.

Nếu bạn là khách hàng sử dụng Edge Enterprise và có câu hỏi hoặc thắc mắc về việc nâng cấp vui lòng gửi email tới hồ sơ marsh@apigee.com và cnovak@apigee.com. Nếu không, vui lòng sử dụng Cộng đồng Apigee để tham gia của bạn.

Tính năng thay đổi và cải tiến trong tương lai

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

Đổi thành Cách hoạt động của chính sách Bộ nhớ đệm phản hồi

Sắp có trong bản phát hành tương lai (sẽ được xác định), hành vi mặc định của &lt;ExcludeErrorResponse&gt; 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, phản hồi với bất kỳ mã trạng thái HTTP (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 Theo mặc định, chính sách Bộ nhớ đệm phản hồi sẽ được đặt thành true. Tức là theo mặc định, chỉ những phản hồi có HTTP Mã trạng thái từ 200 đến 205 sẽ được lưu vào bộ nhớ đệm. Để ghi đè hành vi này và lưu các 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> đến true một cách rõ ràng.

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

Đã 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.

Vấn đề đã biết

Bản phát hành này gặp các 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