Crear un nuevo grupo de reporte para una organización
POST/v1/organizations/:organization_id/reporting-groups
Crea un nuevo grupo de reporte para la organización especificada. Los grupos de reporte se usan para organizar y gestionar configuraciones de dispositivos, ajustes de producto y políticas de parches. Puedes 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 puedes 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. Devuelve el ID del grupo de reporte creado tras una creación satisfactoria.
Solicitud
Respuestas
- 201
- 400
- 401
- 404
- 422
- 429
- 500
Grupo de reporte creado correctamente. La respuesta contiene el ID del grupo de reporte creado.
Solicitud incorrecta. Causas comunes: - Faltan campos obligatorios (name, product_config_id) - Valores de campo inválidos - Formato de ID inválido para campos product_config_id, patch_policy_target_id o intermediate_device - Valor de fishing_pattern_field inválido (debe ser uno de: FullName, Description, OU, CurrentSubnet) - Valor de fishing_pattern inválido (excede maxLength: 250) - Dispositivos intermedios no definidos secuencialmente (intermediate_device2 requiere intermediate_device1, intermediate_device3 requiere intermediate_device2)
No autorizado - se requiere autenticación
Organización no encontrada
Entidad no procesable. Causas comunes: - La configuración de producto no se encontró o no pertenece a la organización - Los IDs de Workspace de dispositivos intermedios no existen o no pertenecen a la organización
Demasiadas solicitudes
Error interno del servidor