การกำหนดรุ่นและการสนับสนุน
บทความนี้แสดงภาพรวมของนโยบายการกำหนดรุ่นและการเปลี่ยนแปลงครั้งใหญ่สำหรับเครื่องมือความสามารถในการเขียนโปรแกรมต่างๆ
ข้อมูลการสนับสนุนและการเลิกใช้
API ของ Power Platform เป็นเครื่องมือการเขียนโปรแกรมแรกที่จะได้รับรุ่นและคุณลักษณะใหม่ก่อน SDK อื่น ๆ เช่น PowerShell, Management Connectors และ CLI ของ Power Platform เมื่อมีการเผยแพร่ REST API รุ่นใหม่ รุ่นก่อนหน้าจะถูกยกเลิก Microsoft จะประกาศเวอร์ชันที่ล้าสมัยอย่างน้อย 12 เดือนก่อนที่จะยุติการใช้ API ตำแหน่งข้อมูล เมื่อรุ่นเลิกใช้แล้ว รุ่นดังกล่าวจะยังได้รับการสนับสนุนตามที่เป็นอยู่ หากคุณประสบปัญหากับรุ่นนั้น เราจะขอให้คุณย้ายไปยังรุ่นที่มีอยู่ทั่วไปในปัจจุบัน เมื่อมีการเลิกใช้รุ่น รุ่นนั้นจะไม่รองรับและจะปิดในเร็วๆ นี้
การเพิ่มหมายเลขเวอร์ชันของ API (เช่น จาก 2021-10-01 เป็น 2022-04-01) Microsoft จะประกาศว่าเวอร์ชันที่พร้อมใช้งานทั่วไปก่อนหน้านี้ (ในตัวอย่างนี้ 2021-10-01) จะถูกยกเลิกทันที และจะถูกยกเลิก 12 เดือนหลังจากการประกาศ ซึ่งปฏิบัติแบบเดียวกันสำหรับรุ่นแสดงตัวอย่างสาธารณะ Microsoft อาจมีข้อยกเว้นต่อนโยบายนี้สำหรับปัญหาด้านสุขภาพและความปลอดภัยของบริการ
สำหรับ cmdlet ของ PowerShell รุ่นส่วนเพิ่มจะพร้อมใช้งานเพื่อแก้ไขข้อบกพร่องเล็กน้อย รุ่นหลักจะเพิ่มขึ้นเพื่อให้ตรงกับรุ่นของ API ใหม่ที่เกิดขึ้น
เข้ากันได้และการเปลี่ยนแปลงครั้งใหญ่
Microsoft จะให้รายละเอียดเกี่ยวกับการเปลี่ยนแปลงความสามารถในการเขียนโปรแกรมในแผนการเปิดตัว หากการเปลี่ยนแปลงไม่เป็นไปตามธรรมชาติ เวอร์ชัน API จะยังคงเหมือนเดิม และเวอร์ชัน PowerShell จะได้รับการเพิ่มเวอร์ชันรอง หากมีการเปลี่ยนแปลงเกิดขึ้น Microsoft จะเพิ่มเวอร์ชัน API และเวอร์ชันหลักของ PowerShell
นี่คือตัวอย่างของการเปลี่ยนแปลงครั้งใหญ่:
- URL หรือคำขอ/การตอบกลับพื้นฐาน มีการเปลี่ยนแปลง
- คุณสมบัติที่ประกาศถูกลบออกหรือเปลี่ยนชื่อ หรือมีการเปลี่ยนชนิด
- พารามิเตอร์ API หรือ API ถูกลบหรือถูกเปลี่ยนชื่อ
- พารามิเตอร์คำขอที่ต้องการถูกเพิ่ม
นี่คือตัวอย่างของการเปลี่ยนแปลงที่ไม่ใช่ครั้งใหญ่:
- มีการเพิ่มคุณสมบัติที่เป็นนัลได้ หรือมีค่าเริ่มต้น
- สมาชิกจะถูกเพิ่มในการแจงนับ
- การแบ่งหน้าถูกนำมาใช้กับคอลเลกชันที่มีอยู่
- มีการเปลี่ยนแปลงรหัสข้อผิดพลาด
- ลำดับคุณสมบัติในคำขอหรือการตอบกลับมีการเปลี่ยนแปลง
รุ่นที่พร้อมใช้งาน
| รุ่น | ชนิด | การอ้างอิง | วันที่เลิกใช้งาน | วันที่เลิกใช้งาน |
|---|---|---|---|---|
| การแสดงตัวอย่าง 2022-03-01 | การแสดงตัวอย่างสาธารณะ | 2022-03-01-ตัวอย่างอ้างอิง | ไม่ระบุ | ไม่ระบุ |
| 2020-10-01 | พร้อมใช้งานโดยทั่วไป | 2020-10-01 อ้างอิง | ไม่ระบุ | ไม่ระบุ |
หมายเหตุ
2020-10-01 รุ่นทั่วไปของ API ของ Power Platform มีความเฉพาะเจาะจงสำหรับการจัดการสภาพแวดล้อม และยังเรียกโดยทั่วไปว่า API ของ แพลตฟอร์มโปรแกรมประยุกต์ด้านธุรกิจ (BAP) ฟังก์ชันการทำงานของชุดปลายทางนี้จะพร้อมใช้งานในรุ่นที่ใหม่กว่าของ API ของ Power Platform พร้อมด้วยคุณสมบัติเพิ่มเติมมากมายหลังจากรุ่นตัวอย่าง 2022-03-01
ขั้นตอนถัดไป
เมื่อคุณเข้าใจกลยุทธ์การกำหนดรุ่นและการสนับสนุนแล้ว เรามาดูวิธีการตรวจสอบความถูกต้องด้วย API ของ Microsoft Power Platform