หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้แสดงภาพรวมของนโยบายการกำหนดรุ่นและการเปลี่ยนแปลงครั้งใหญ่สำหรับเครื่องมือความสามารถในการเขียนโปรแกรมต่างๆ
ข้อมูลการสนับสนุนและการเลิกใช้
เมื่อมีการเผยแพร่ REST API เวอร์ชันใหม่ เวอร์ชันก่อนหน้าจะถูกยกเลิก Microsoft ประกาศเวอร์ชันที่เลิกใช้อย่างน้อย 12 เดือนก่อนที่จะเลิกใช้จุดสิ้นสุด API เมื่อมีการเลิกใช้เวอร์ชัน เวอร์ชันจะรองรับ as-is ถ้าคุณประสบปัญหากับเวอร์ชันนั้น เราขอให้คุณย้ายไปยังเวอร์ชันที่เสถียรในขณะนี้ เมื่อเวอร์ชันถูกปลดเกษียณ จะไม่ได้รับการสนับสนุนและจะปิดในไม่ช้า
การเพิ่มหมายเลขเวอร์ชันของ API (เช่น จาก 2021-10-01 เป็น 2022-04-01) Microsoft จะประกาศว่าเวอร์ชันที่พร้อมใช้งานทั่วไปก่อนหน้านี้ (ในตัวอย่างนี้ 2021-10-01) จะถูกยกเลิกทันที และจะถูกยกเลิก 12 เดือนหลังจากการประกาศ Microsoft อาจมีข้อยกเว้นต่อนโยบายนี้สำหรับปัญหาด้านสุขภาพและความปลอดภัยของบริการ
เครื่องมือต่าง ๆ และ SDK ที่สร้างขึ้นจาก Power Platform API เช่น Power Platform CLI ตัวเชื่อมต่อ V2 ของผู้ดูแลระบบ และ PowerShell ได้รับการอัปเดตเป็นเวอร์ชัน API ที่ใหม่กว่าตามการดําเนินการและโปร่งใสสําหรับผู้ใช้ปลายทาง
เข้ากันได้และการเปลี่ยนแปลงครั้งใหญ่
Microsoft มีรายละเอียดของการเปลี่ยนแปลงความสามารถในการโปรแกรมในแผนการเผยแพร่ หากมีการเปลี่ยนแปลงในลักษณะที่เวอร์ชัน API ยังคงเหมือนเดิม และเวอร์ชัน PowerShell จะได้รับการเพิ่มเวอร์ชันรอง ถ้าการเปลี่ยนแปลงในลักษณะที่ผิด Microsoft จะเพิ่มเวอร์ชัน API และเวอร์ชันหลักของ PowerShell
นี่คือตัวอย่างของการเปลี่ยนแปลงครั้งใหญ่:
- URL หรือคำขอ/การตอบกลับพื้นฐาน มีการเปลี่ยนแปลง
- คุณสมบัติที่ประกาศถูกลบออกหรือเปลี่ยนชื่อ หรือมีการเปลี่ยนชนิด
- พารามิเตอร์ API หรือ API ถูกลบหรือถูกเปลี่ยนชื่อ
- พารามิเตอร์คำขอที่ต้องการถูกเพิ่ม
นี่คือตัวอย่างของการเปลี่ยนแปลงที่ไม่แยกย่อย:
- มีการเพิ่มคุณสมบัติที่เป็นนัลได้ หรือมีค่าเริ่มต้น
- สมาชิกจะถูกเพิ่มในการแจงนับ
- การแบ่งหน้าถูกนำมาใช้กับคอลเลกชันที่มีอยู่
- มีการเปลี่ยนแปลงรหัสข้อผิดพลาด
- ลำดับคุณสมบัติในคำขอหรือการตอบกลับมีการเปลี่ยนแปลง
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
2020-10-01 เวอร์ชันที่พร้อมใช้งานโดยทั่วไปของ Power Platform API นั้นเฉพาะสําหรับการจัดการสภาพแวดล้อม และเรียกอีกอย่างว่า API แพลตฟอร์มแอปพลิเคชันธุรกิจ (BAP) ฟังก์ชันการทํางานของชุดจุดสิ้นสุดนี้พร้อมใช้งานใน Power Platform API เวอร์ชันที่ใหม่กว่า
Next steps
เมื่อคุณเข้าใจกลยุทธ์การกำหนดรุ่นและการสนับสนุนแล้ว เรามาดูวิธีการตรวจสอบความถูกต้องด้วย API ของ Microsoft Power Platform