ทําให้ไลบรารีตัวแปรเป็นแบบอัตโนมัติโดยใช้ API

คุณสามารถใช้ Microsoft Fabric REST API เพื่อทําให้การจัดการไลบรารีตัวแปรในการจัดการวงจรชีวิตของแอปพลิเคชัน (ALM) เป็นไปโดยอัตโนมัติอย่างสมบูรณ์

หากคุณใช้ API เป็นส่วนหนึ่งของการจัดการวงจรการใช้งาน จะมีการตรวจสอบสิทธิ์สําหรับการอ้างอิงรายการระหว่างการอัปเดต Git และการปรับใช้ไปป์ไลน์

ข้อกําหนดเบื้องต้น

หากต้องการใช้ API คุณจําเป็นต้องมี:

• ข้อกําหนดเบื้องต้นเดียวกันกับรายการไลบรารีตัวแปร
• โทเค็น Microsoft Entra สําหรับบริการ Fabric ใช้โทเค็นในส่วนหัวการรับรองความถูกต้องของการเรียกใช้ API สําหรับข้อมูลเกี่ยวกับวิธีการรับโทเค็น ดู การเริ่มต้นใช้งานด่วน Fabric API

API ไลบรารีตัวแปร

คุณสามารถใช้ ไลบรารีตัวแปร REST API เพื่อทําหน้าที่ต่อไปนี้:

• สร้างไลบรารีตัวแปร: สร้างไลบรารีตัวแปรในพื้นที่ทํางานที่ระบุ
• รับไลบรารีตัวแปร: ดึงคุณสมบัติของไลบรารีตัวแปร คุณยังสามารถดึงค่าที่ใช้งานอยู่ที่ตั้งไว้โดยใช้ VariableLibraryProperties พารามิเตอร์
• อัปเดตไลบรารีตัวแปร: อัปเดตคุณสมบัติของไลบรารีตัวแปร คุณยังสามารถอัปเดตค่าที่ใช้งานอยู่ได้โดยใช้ VariableLibraryProperties พารามิเตอร์
• ลบไลบรารีตัวแปร: ลบไลบรารีตัวแปรที่ระบุ
• แสดงรายการไลบรารีตัวแปร: แสดงรายการไลบรารีตัวแปรในพื้นที่ทํางานที่ระบุ
• รับคําจํากัดความของไลบรารีตัวแปร: ดึงคํา จํากัดความ สาธารณะของไลบรารีตัวแปร
• อัปเดตคําจํากัดความของไลบรารีตัวแปร: แทนที่ คําจํากัดความ ของไลบรารีตัวแปร

ไลบรารีตัวแปร REST API สนับสนุนบริการหลัก

ตัวอย่าง

สําหรับตัวอย่างวิธีการใช้ API โปรดดู เอกสารประกอบ REST สําหรับ API แต่ละรายการ

สําหรับรายละเอียดของโครงสร้างคําจํากัดความของไลบรารีตัวแปร โปรดดู คําจํากัดความของไลบรารีตัวแปร

ข้อควรพิจารณาและข้อจํากัด

ข้อจํากัดของขนาด

• สามารถมี ตัวแปรได้สูงสุด 1,000 ตัวและชุด ค่าได้สูงสุด 1,000 ชุด ตราบใดที่คุณมีคุณสมบัติตรงตามข้อกําหนดทั้งสองข้อนี้:

  • จํานวนเซลล์ทั้งหมดในชุดค่าทางเลือกน้อยกว่า 10,000 เซลล์
  • ขนาดของสินค้าไม่เกิน 1 MB

  ข้อกําหนดเหล่านี้จะได้รับการตรวจสอบเมื่อคุณบันทึกการเปลี่ยนแปลง

• เขตข้อมูลหมายเหตุสามารถมีอักขระได้สูงสุด 2,048 อักขระ

• เขตข้อมูลคําอธิบายของชุดค่าสามารถมีอักขระได้สูงสุด 2,048 อักขระ

ข้อจํากัดสําหรับชุดค่าทางเลือก

• ชุดค่าทางเลือกในไลบรารีตัวแปรจะปรากฏตามลําดับที่คุณเพิ่ม ในปัจจุบัน คุณไม่สามารถจัดลําดับใหม่ใน UI หากต้องการเปลี่ยนลําดับ แก้ไขไฟล์ JSON โดยตรง
• ชื่อของชุดค่าแต่ละชุดต้องไม่ซ้ํากันภายในไลบรารีตัวแปร
• ชื่อตัวแปรต้องไม่ซ้ํากันภายในไลบรารีตัวแปร คุณสามารถมีตัวแปรสองตัวที่มีชื่อเดียวกันในพื้นที่ทํางานได้หากอยู่ในรายการที่แตกต่างกัน
• มีค่าที่ใช้งานอยู่หนึ่งค่า (และเพียงค่าเดียว) ที่ตั้งค่าไว้ในไลบรารีตัวแปรในแต่ละครั้ง คุณไม่สามารถลบค่าที่ตั้งค่าในขณะที่ค่านั้นทํางานอยู่ หากต้องการลบ ให้กําหนดค่าชุดค่าอื่นให้ใช้งานก่อน คุณสามารถตั้งค่าที่ใช้งานอยู่ที่แตกต่างกันสําหรับแต่ละขั้นตอนของไปป์ไลน์การปรับใช้