Lập phiên bản và hỗ trợ
Bài viết này cung cấp thông tin tổng quan về các chính sách thay đổi phiên bản và chia nhỏ đối với nhiều công cụ lập trình khác nhau.
Thông tin về hỗ trợ và ngừng sử dụng
API Power Platform là công cụ có thể lập trình đầu tiên nhận các phiên bản và tính năng mới trước các SDK khác như PowerShell, Trình kết nối quản lý và CLI Power Platform. Khi phiên bản mới của API REST được phát hành, các phiên bản trước đó sẽ bị gỡ bỏ. Microsoft sẽ tuyên bố một phiên bản bị lỗi thời ít nhất 12 tháng trước khi ngừng sử dụng điểm cuối API. Khi một phiên bản không được dùng nữa, phiên bản đó vẫn được hỗ trợ nguyên trạng. Nếu bạn gặp sự cố với phiên bản đó, chúng tôi sẽ yêu cầu bạn chuyển sang phiên bản hiện có sẵn. Khi một phiên bản ngừng hoạt động, nó không được hỗ trợ và sẽ sớm bị tắt.
Bằng cách tăng số phiên bản của API (ví dụ: từ 2021-10-01 lên 2022-04-01), Microsoft thông báo rằng phiên bản trước đó có sẵn rộng rãi (trong ví dụ này là 2021-10-01) sẽ ngay lập tức bị loại bỏ và sẽ ngừng hoạt động sau 12 tháng kể từ khi thông báo. Các phiên bản xem trước công khai cũng được xử lý tương tự. Microsoft có thể đưa ra ngoại lệ cho chính sách này vì các vấn đề liên quan đến sức khỏe và an ninh dịch vụ.
Đối với lệnh ghép ngắn PowerShell, các phiên bản gia tăng sẽ được cung cấp để giải quyết các đợt sửa lỗi nhỏ. Các phiên bản chính sẽ được tăng lên để phù hợp với các phiên bản API được cung cấp.
Các thay đổi tương thích và chia nhỏ
Microsoft sẽ cung cấp thông tin chi tiết về những thay đổi về khả năng lập trình trong các kế hoạch phát hành . Nếu các thay đổi về bản chất là không chia nhỏ, thì phiên bản API sẽ vẫn giữ nguyên và phiên bản PowerShell sẽ dần nhận được các phiên bản nhỏ. Nếu những thay đổi có tính chất phá vỡ, Microsoft sẽ tăng phiên bản API và phiên bản chính của PowerShell.
Sau đây là ví dụ về thay đổi kiểu chia nhỏ:
- URL hoặc yêu cầu/phản hồi cơ bản được thay đổi.
- Thuộc tính đã khai báo bị xóa hoặc đổi tên, hoặc loại của thuộc tính đó bị thay đổi.
- API hoặc tham số API bị xóa hoặc đổi tên.
- Tham số yêu cầu bắt buộc được thêm.
Sau đây là ví dụ về thay đổi kiểu không chia nhỏ:
- Các thuộc tính được thêm vào có giá trị rỗng hoặc có giá trị mặc định.
- Một thành phần được thêm vào liệt kê.
- Phân trang được đưa vào các bộ sưu tập hiện có.
- Mã lỗi được thay đổi.
- Thứ tự của các thuộc tính trong yêu cầu hoặc phản hồi được thay đổi.
Phiên bản có sẵn
| Phiên bản | Loại | Tham chiếu | Ngày ngừng sử dụng | Ngày ngừng hoạt động |
|---|---|---|---|---|
| Bản xem trước-01-03-2022 | Bản xem trước công khai | 2022-03-01-xem trước Tham chiếu | Không có | Không có |
| 01-10-2020 | Có sẵn công khai | 2020-10-01 Tham chiếu | Không có | Không có |
Lưu ý
Phiên bản thường có sẵn 2020-10-01 của API Power Platform dành riêng cho quản lý môi trường và cũng thường được gọi là API Nền tảng ứng dụng kinh doanh (BAP). Chức năng của tập hợp các điểm cuối này sẽ được cung cấp trong các phiên bản mới hơn của API Power Platform cùng với nhiều tính năng bổ sung sau phiên bản 2022-03-01-bản xem trước.
Các bước tiếp theo
Bây giờ bạn đã hiểu về chiến lược hỗ trợ và lập phiên bản, hãy cùng tìm hiểu cách xác thực với API Microsoft Power Platform.