RemoteGymp · API v1

डेटा लिखें

कस्टम फ़ील्ड और मेंटेनेंस विंडो अपडेट करें, ऑटोमेशन चलाएं और सुरक्षित रूप से लिखने की दोबारा कोशिश करें।

API और MCP कतारबद्ध कार्यों, अनुसूचित पावर, एजेंट अनइंस्टॉल, एंडपॉइंट डायग्नॉस्टिक्स, कमांड रद्दीकरण और तृतीय-पक्ष पैच नीतियों का समर्थन करते हैं। आइडेम्पोटेंसी कीज़ का पुन: उपयोग करें और रसीदों को जांचें। अस्थायी व्यवस्थापक प्रमाण-पत्र केवल एक बार लौटाए जाते हैं। ट्रैफिक मॉनिटरिंग के लिए मौजूदा अधिकार आवश्यक है; बिलिंग एप्लिकेशन में बनी रहती है।

  1. अपनी परमिशन चेक करें

    प्रीसेट अलग-अलग कैपेबिलिटी चुनते हैं; वे एक्सेस लेवल नहीं बदलते हैं। सेटिंग्स में नए क्रेडेंशियल डिफ़ॉल्ट रूप से FullAccess का इस्तेमाल करते हैं, लेकिन सिर्फ़ चुनी गई कैपेबिलिटी की ही इजाज़त है। पुराने ReadWrite क्रेडेंशियल मंज़ूर कस्टम-फ़ील्ड और मेंटेनेंस बदलावों की इजाज़त देते हैं। ऑटोमेशन और डिवाइस कंट्रोल के लिए FullAccess के साथ उनकी खास कैपेबिलिटी की ज़रूरत होती है। लिखने से पहले GET /v1/operations/capabilities चेक करें। कंपनी का स्कोप और मौजूदा ओनर की परमिशन अभी भी लागू होती हैं।

  2. किसी दूसरे बदलाव को ओवरराइट करने से बचें

    कस्टम फ़ील्ड और उसका वर्शन पढ़ें। अपनी नई वैल्यू और जो वर्शन आपने पढ़ा है, उसे PATCH /v1/custom-fields/{fieldId}. पर भेजें। 409 version_conflict का मतलब है कि किसी ने इसे पहले बदल दिया है। इसे दोबारा पढ़ें और तय करें कि आपका अपडेट अभी भी सही है या नहीं।

  3. सुरक्षित रूप से दोबारा कोशिश करें

    POST /v1/maintenance-windows के लिए, एक Idempotency-Key हेडर भेजें। पक्का नतीजा न मिलने पर, डुप्लीकेट बनाने के बजाय ओरिजिनल विंडो पाने के लिए वही की और बॉडी दोहराएं। उसी की वाली बदली हुई बॉडी रिजेक्ट हो जाती है। DELETE /v1/maintenance-windows/{windowId} एक विंडो कैंसिल कर देता है।

  4. फॉलो एक्शन रिसीट

    ऑटोमेशन और मैनेजमेंट राइट्स JSON बॉडी में idempotencyKey का इस्तेमाल करते हैं और एक ऑपरेशन रिसीट देते हैं। Completed का मतलब है कि रिक्वेस्ट हैंडलर खत्म हो गया है; यह जानने के लिए कि डिवाइस ने काम पूरा किया है या नहीं, रिज़ल्ट या डोमेन रन चेक करें। OutcomeUnknown के लिए, क्या करना है, यह तय करने से पहले रसीद और मौजूदा स्थिति की जांच करें। कभी भी नई की के तहत ऑटोमैटिकली दोबारा न भेजें: यह एक्शन दो बार चल सकता है।

एपीआई संदर्भ →

सामग्री संशोधन 3f225a253 · OpenAPI SHA-256: b12c42306a89