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 साठी, काय करायचे हे ठरवण्यापूर्वी रिसिप्ट आणि सध्याची स्थिती तपासा. नवीन की अंतर्गत कधीही आपोआप पुन्हा पाठवू नका: ॲक्शन दोनदा चालू शकते.

API संदर्भ →

सामग्री पुनरावलोकन 3f225a253 · OpenAPI SHA-256: b12c42306a89