RemoteGymp · API v1

Adatok írása

Frissítse az egyéni mezőket és a karbantartási ablakokat, futtassa az automatizálást, és próbálja meg biztonságosan újraírni az írást.

Az API és az MCP támogatja a sorba állított feladatokat, ütemezett kikapcsolást, ügynök eltávolítást, végpontdiagnosztikát, parancsműveletek megszakítását és harmadik fél javítócsomag-házirendeket. Ismételten használja az idempotencia kulcsokat és ellenőrizze a bizonylatokat. Az ideiglenes adminisztrátori hitelesítő adatok egyszer kerülnek visszaadásra. A forgalomfigyelés meglévő jogosultságot igényel; a számlázás az alkalmazásban marad.

  1. Ellenőrizze az engedélyeit

    Az előre beállított értékek egyéni képességeket választanak ki; nem változtatják meg a hozzáférési szintet. A Beállításokban található új hitelesítő adatok alapértelmezés szerint a FullAccess-t használják, de csak a kiválasztott képességek engedélyezettek. A régebbi ReadWrite hitelesítő adatok jóváhagyott egyéni mező- és karbantartási módosításokat tesznek lehetővé. Az automatizáláshoz és az eszközvezérléshez FullAccess-re, valamint a hozzájuk tartozó konkrét képességekre van szükség. Az írás előtt ellenőrizze a GET /v1/operations/capabilities-t. A vállalati hatókör és a jelenlegi tulajdonos engedélyei továbbra is érvényesek.

  2. Kerülje az újabb módosítások felülírását

    Olvassa el az egyéni mezőt és annak verzióját. Küldd el az új értéket és a beolvasott verziót a PATCH /v1/custom-fields/{fieldId}. címre. A 409-es hibakód (version_conflict) azt jelenti, hogy valaki először megváltoztatta. Olvasd el újra, és döntsd el, hogy a frissítésed továbbra is megfelelő-e.

  3. Próbáld újra biztonságosan

    A POST /v1/maintenance-windows esetén küldj egy Idempotency-Key fejlécet. Bizonytalan eredmény után ismételd meg ugyanazt a kulcsot és törzset az eredeti ablak lekéréséhez, ahelyett, hogy duplikátumot hoznál létre. Az ugyanazzal a kulccsal módosított törzset a rendszer elutasítja. A DELETE /v1/maintenance-windows/{windowId} megszakítja az ablakot.

  4. Műveleti bizonylatok követése

    Az automatizálási és felügyeleti írások a idempotencyKey-t használják a JSON törzsben, és egy műveleti bizonylatot adnak vissza. A Completed azt jelenti, hogy a kéréskezelő befejeződött; ellenőrizze az eredményt vagy a tartomány futtatását, hogy megtudja, befejezte-e az eszköz a munkát. A OutcomeUnknown esetében a teendők eldöntése előtt ellenőrizze a nyugtát és az aktuális állapotot. Soha ne küldjön automatikusan újra új kulcs alatt: a művelet kétszer is lefuthat.

API referencia →

Tartalom felülvizsgálata 3f225a253 · OpenAPI SHA-256: b12c42306a89