Actualice los campos personalizados y las ventanas de mantenimiento, ejecute la automatización y vuelva a intentar las escrituras de forma segura.
La API y MCP soportan trabajos en cola, programación de energía, desinstalación de agentes, diagnóstico de endpoints, cancelación de comandos y políticas de parches de terceros. Reutilice claves de idempotencia e inspeccione recibos. Se devuelven credenciales de administrador temporales una sola vez. El monitoreo de tráfico requiere un derecho existente; la facturación permanece en la aplicación.
Verifique sus permisos.
Los preajustes seleccionan capacidades individuales; no modifican el nivel de acceso. Las nuevas credenciales en Configuración utilizan FullAccess de forma predeterminada, pero solo se permiten las capacidades seleccionadas. Las credenciales antiguas ReadWrite permiten cambios aprobados en campos personalizados y mantenimiento. La automatización y el control de dispositivos requieren FullAccess, además de sus capacidades específicas. Verifique GET y /v1/operations/capabilities antes de escribir. El ámbito de la empresa y los permisos del propietario actual siguen vigentes.
Evite sobrescribir otro cambio.
Lea el campo personalizado y su versión. Envíe su nuevo valor y la versión que leyó a PATCH /v1/custom-fields/{fieldId}.. Un error 409 version_conflict indica que alguien lo modificó primero. Léalo de nuevo y decida si su actualización sigue siendo apropiada.
Reintente de forma segura.
Para POST /v1/maintenance-windows, envíe un encabezado Idempotency-Key. Tras un resultado incierto, repita la misma clave y cuerpo para recuperar la ventana original en lugar de crear una duplicada. Se rechaza un cuerpo modificado con la misma clave. DELETE /v1/maintenance-windows/{windowId} cancela una ventana.
Siga los recibos de acción.
Las escrituras de automatización y administración utilizan idempotencyKey en el cuerpo JSON y devuelven un recibo de operación. Completed indica que el gestor de solicitudes ha finalizado; compruebe el resultado o la ejecución del dominio para saber si el dispositivo ha terminado el trabajo. Para OutcomeUnknown, inspeccione el recibo y el estado actual antes de decidir qué hacer. Nunca reenvíe automáticamente con una clave nueva: la acción podría ejecutarse dos veces.