वर्ज़निंग और समर्थन

यह लेख विभिन्न प्रोग्राम क्षमता उपकरण के लिए वर्ज़निंगआलेख और परिवर्तनशील नीतियों का अवलोकन प्रदान करता है।

समर्थन और बहिष्करण जानकारी

REST API का एक नया संस्करण जारी किया गया है, के रूप में, पुराने संस्करण सेवानिवृत्त हो जाते हैं। Microsoft किसी API समापन बिंदु को रिटायर करने से कम से कम 12 महीने पहले बहिष्कृत किए गए संस्करण की घोषणा करता है. जब किसी वर्शन को बहिष्कृत कर दिया जाता है, तो वह as-isका समर्थन करता है. अगर आपको उस वर्शन में कोई समस्या आती है, तो हम आपसे अनुरोध करते हैं कि आप मौजूदा स्थिर वर्शन पर जाएं. जब कोई संस्करण सेवानिवृत्त हो जाता है, तो यह समर्थित नहीं होता है और जल्द ही बंद कर दिया जाएगा।

API की संस्करण संख्या में वृद्धि करके (उदाहरण के लिए, 2021-10-01 से 2022-04-01 तक), Microsoft घोषणा करता है कि पहले से उपलब्ध संस्करण (इस उदाहरण में, 2021-10-01) को तुरंत हटा दिया गया है और घोषणा के 12 महीने बाद उसे हटा दिया जाएगा। Microsoft सेवा स्वास्थ्य और सुरक्षा मुद्दों के लिए इस नीति में अपवाद किया जा सकता है।

Power Platform API के शीर्ष पर उत्पन्न होने वाले विभिन्न टूल और SDK जैसे Power Platform CLI, Admin V2 कनेक्टर और PowerShell, प्रति क्रिया के आधार पर नए API संस्करणों में अपडेट किए जाते हैं और अंतिम उपयोगकर्ताओं के लिए पारदर्शी होते हैं.

संगत और टूटने वाले परिवर्तन

Microsoft रिलीज़ योजनाओं में प्रोग्रामेबिलिटी परिवर्तनों का विवरण प्रदान करता है। यदि परिवर्तन प्रकृति में गैर-ब्रेकिंग हैं, तो एपीआई संस्करण समान रहता है, और 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

Power Platform API का 2020-10-01 आम तौर पर उपलब्ध संस्करण पर्यावरण प्रबंधन के लिए विशिष्ट है और इसे आमतौर पर Business Application Platform (BAP) API के रूप में भी जाना जाता है। एंडपॉइंट्स के इस सेट की कार्यक्षमता Power Platform API के नए संस्करणों में उपलब्ध कराई गई है.

Next steps

अब जब आप वर्जनिंग और समर्थन युक्ति समझ गए हैं, तो आइए देखते हैं कि Microsoft Power Platform API को कैसे प्रमाणित करें.