安全地更新自訂欄位和維護窗口,運行自動化並重試寫入。
API 和 MCP 支援排隊作業、排程電源、代理程式卸載、端點診斷、命令取消和第三方補丁政策。重複使用冪等性鍵並檢查收據。臨時管理員憑證只返回一次。流量監控需要現有權限;計費保留在應用程序中。
檢查您的權限
預設用於選擇特定功能;它們不會更改存取等級。 「設定」中的新憑證預設使用 FullAccess,但僅允許使用選定的功能。舊的 ReadWrite 憑證允許對自訂欄位和維護進行已核准的變更。自動化和設備控制需要 FullAccess 及其特定功能。寫入前請檢查 GET 和 /v1/operations/capabilities。公司範圍和目前所有者權限仍然有效。
避免覆蓋其他更改
讀取自訂欄位及其版本將您的新值和讀取的版本傳送到 PATCH /v1/custom-fields/{fieldId}.。如果出現 409 version_conflict 錯誤,則表示有人已先對其進行了更改。請再次讀取並確定您的更新是否仍然適用。
安全重試
對於 POST /v1/maintenance-windows,請傳送 Idempotency-Key 標頭。如果結果不確定,請重複使用相同的鍵和正文以檢索原始窗口,而不是建立副本。使用相同鍵但已更改的正文將被拒絕。 DELETE /v1/maintenance-windows/{windowId} 用於取消視窗。
追蹤操作回執
自動化和管理寫入操作在 JSON 正文中使用 idempotencyKey 並返回操作回執。 Completed 表示請求處理程序已完成;請檢查結果或網域運作情況,以了解裝置是否已完成工作。對於 OutcomeUnknown,請在決定執行操作之前檢查回執和目前狀態。切勿使用新金鑰自動重新傳送:此操作可能會執行兩次。