Lưu ý
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử đăng nhập hoặc thay đổi thư mục.
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử thay đổi thư mục.
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
Khi một phiên bản mới của API REST được phát hành, các phiên bản trước đó sẽ ngừng hoạt động. Microsoft tuyên bố một phiên bản đã ngừng hoạt động ít nhất 12 tháng trước khi ngừng sử dụng một điểm cuối API. Khi một phiên bản bị phản đối, phiên bản đó sẽ được hỗ as-is. Nếu bạn gặp phải sự cố với phiên bản đó, chúng tôi yêu cầu bạn chuyển sang phiên bản hiện ổn định. Khi một phiên bản ngừng hoạt động, phiên bả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. 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ụ.
Các công cụ và SDK khác nhau được tạo trên nền tảng API Power Platform như Power Platform CLI, bộ nối Admin V2 và PowerShell, được cập nhật lên các phiên bản API mới hơn trên cơ sở từng hành động và minh bạch đối với người dùng cuối.
Các thay đổi tương thích và chia nhỏ
Microsoft cung cấp 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 không đột phá trong tự nhiên, phiên bản API vẫn giữ nguyên và phiên bản PowerShell nhận được một gia số phiên bản phụ. Nếu các thay đổi được phá vỡ trong tự nhiên, Microsoft gia tăng phiên bản API và phiên bản chính 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.
Dưới đây là ví dụ về các thay đổi không ngắt:
- 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.
Available versions
| Version | Type | Reference | Deprecation date | Decommission date |
|---|---|---|---|---|
| 2024-10-01 | Stable | Reference | N/A | N/A |
| 2020-10-01 | Generally available | 2020-10-01 Ref | N/A | N/A |
Note
Phiên bản API Power Platform 2020-10-01 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 điểm cuối này được cung cấp trong các phiên bản mới hơn của API Power Platform.
Next steps
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.