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