Actualizar un grupo de reporte existente
PUT/v1/organizations/:organization_id/reporting-groups/:reporting_group_id
Actualiza la configuración de un grupo de reporte existente, incluyendo nombre, descripción, destino de política de parches, patrón de búsqueda y dispositivos intermedios. Este endpoint implementa semántica de reemplazo completo: todos los campos actualizables deben incluirse en la solicitud. Omitir campos opcionales los limpiará (comportamiento idempotente). Puede configurar opcionalmente dispositivos intermedios (hasta 3) proporcionando identificadores de Workspace. Los dispositivos intermedios se usan para acciones Wake-on-LAN en redes seguras, permitiendo el encendido remoto de dispositivos a través de puertas de enlace intermedias. Los dispositivos intermedios deben definirse secuencialmente: no puede definir intermediate_device2 sin intermediate_device1, ni intermediate_device3 sin intermediate_device2. Todos los IDs de Workspace de dispositivos intermedios deben existir y pertenecer a la organización. No devuelve contenido (204) tras una actualización exitosa.
Solicitud
Respuestas
- 204
- 400
- 401
- 404
- 422
- 429
- 500
Grupo de reporte actualizado correctamente. No se devuelve contenido.
Solicitud incorrecta. Causas comunes: - Faltan campos obligatorios (name) - Valores de campo no válidos - Valor de fishing_pattern_field no válido (debe ser uno de: FullName, Description, OU, CurrentSubnet) - Valor de fishing_pattern no válido (supera maxLength: 250) - Formato de ID no válido para los campos patch_policy_target_id o intermediate_device - Dispositivos intermedios no definidos secuencialmente (intermediate_device2 requiere intermediate_device1, intermediate_device3 requiere intermediate_device2)
No autorizado - autenticación requerida
No encontrado. Causas comunes: - Grupo de reporte no encontrado o que no pertenece a la organización - Destino de política de parches no encontrado
Entidad no procesable. Causas comunes: - Los IDs de Workspace de dispositivos intermedios no existen o no pertenecen a la organización
Demasiadas solicitudes
Error interno del servidor