वर्ज़निंग और समर्थन
यह लेख विभिन्न प्रोग्राम क्षमता उपकरण के लिए वर्ज़निंगआलेख और परिवर्तनशील नीतियों का अवलोकन प्रदान करता है।
समर्थन और बहिष्करण जानकारी
Power Platform API अन्य SDK जैसे PowerShell, प्रबंधक कनेक्टर, और Power Platform CLI से पहले नए संस्करण और सुविधाएँ प्राप्त करने वाला पहला प्रोग्रामेबल टूल है. जैसे ही REST API का नया संस्करण जारी किया जाता है, पुराने संस्करण समाप्त हो जाएंगे. Microsoft API एंडपॉइंट को बंद करने से कम से कम 12 महीने पहले संस्करण को अप्रचलित घोषित कर दिया जाएगा। जब किसी संस्करण को अप्रचलित किया जाता है, तब भी वह यथावत समर्थित रहता है. यदि आप उस संस्करण के साथ किसी समस्या का सामना करते हैं, तो हम अनुरोध करेंगे कि आप वर्तमान में सामान्य रूप से उपलब्ध संस्करण पर चले जाएँ. जब कोई संस्करण सेवानिवृत्त हो जाता है, तो यह समर्थित नहीं होता है और जल्द ही बंद हो जाएगा.
API की संस्करण संख्या में वृद्धि करके (उदाहरण के लिए, 2021-10-01 से 2022-04-01 तक), Microsoft घोषणा करता है कि पहले से उपलब्ध संस्करण (इस उदाहरण में, 2021-10-01) को तुरंत हटा दिया गया है और घोषणा के 12 महीने बाद उसे हटा दिया जाएगा। सार्वजनिक पूर्वावलोकन संस्करणों के लिए समान व्यवहार किया जाता है. Microsoft सेवा स्वास्थ्य और सुरक्षा मुद्दों के लिए इस नीति में अपवाद किया जा सकता है।
PowerShell cmdlets के लिए, मामूली बग फिक्स हल करने के लिए वृद्धिशील संस्करण उपलब्ध कराए जाएंगे। होने वाले नए API संस्करणों के मिलान के लिए प्रमुख संस्करणों को बढ़ाया जाएगा.
संगत और टूटने वाले परिवर्तन
Microsoft रिलीज़ योजनाओं में प्रोग्रामेबिलिटी परिवर्तनों का विवरण प्रदान करेगा। यदि परिवर्तन प्रकृति में गैर-ब्रेकिंग हैं, तो API संस्करण समान रहेगा, और PowerShell संस्करण को मामूली संस्करण वृद्धि प्राप्त होगी। यदि परिवर्तन प्रकृति में ब्रेकिंग हैं, तो Microsoft API संस्करण और PowerShell प्रमुख संस्करण में वृद्धि होगी।
यहाँ परिवर्तन के उदाहरण हैं:
- URL या मूलभूत अनुरोध/प्रतिक्रिया को बदल दिया गया है।
- घोषित गुण को हटा दिया जाता है या उसका नाम बदल दिया जाता है, या उसका प्रकार बदल दिया जाता है।
- API या API मापदंडों को हटा दिया जाता है या नाम बदल दिया जाता है।
- आवश्यक अनुरोध पैरामीटर जोड़ा गया।
यहाँ गैर-परिवर्तन के उदाहरण हैं:
- ऐसे गुण जोड़े जाते हैं जो शून्य होते हैं या उनका डिफ़ॉल्ट मान होता है।
- एक सदस्य को एक गणना में जोड़ा जाता है।
- पेजिंग को मौजूदा संग्रह में पेश किया गया है।
- त्रुटि कोड बदल दिए गए हैं।
- अनुरोधों या प्रतिक्रियाओं में गुणों का क्रम बदल दिया जाता है।
उपलब्ध संस्करण
| संस्करण | प्रकार | संदर्भ | प्रतिवाद दिनांक | पाबंदी दिनांक |
|---|---|---|---|---|
| 2022-03-01-पूर्वावलोकन | सार्वजनिक पूर्वावलोकन | 2022-03-01-पूर्वावलोकन संदर्भ | N/A | N/A |
| 01-10-2020 | आम तौर पर उपलब्ध | 2020-10-01 संदर्भ | N/A | N/A |
नोट
Power Platform API का 2020-10-01 आम तौर पर उपलब्ध संस्करण परिवेश प्रबंधन के लिए विशिष्ट है और इसे आमतौर पर व्यावसायिक ऐप्लिकेशन प्लेटफ़ॉर्म (BAP) API के रूप में भी जाना जाता है. एंडपॉइंट्स के इस सेट की कार्यक्षमता Power Platform API के नए संस्करणों में 2022-03-01-preview संस्करण के बाद कई अतिरिक्त सुविधाओं के साथ उपलब्ध कराई जाएगी.
अगले कदम
अब जब आप वर्जनिंग और समर्थन युक्ति समझ गए हैं, तो आइए देखते हैं कि Microsoft Power Platform API को कैसे प्रमाणित करें.