> ## Documentation Index > Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Crear un grupo de reporte > 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_device_2_id sin intermediate_device_1_id, ni intermediate_device_3_id sin intermediate_device_2_id. 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. ## OpenAPI ````yaml /api-reference/openapi-v1.json post /v1/organizations/{organization_id}/reporting-groups openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: Api publica REST para portal servers: - url: https://api.staging.flxwvdexternal.com description: Staging API server security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/reporting-groups: post: tags: - Grupos de reporte summary: Crear un grupo de reporte description: >- 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_device_2_id sin intermediate_device_1_id, ni intermediate_device_3_id sin intermediate_device_2_id. 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. operationId: createReportingGroup parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador único de la organización example: 507f1f77bcf86cd799439011 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateReportingGroupRequestV1' examples: create-reporting-group-with-minimal-fields: summary: Crear un grupo de reporte solo con los campos obligatorios value: name: Grupo de reporte de Producción product_config_id: 507f1f77bcf86cd799439030 create-reporting-group-with-all-fields: summary: >- Crear un grupo de reporte con todos los campos disponibles, incluidos dispositivos intermedios value: name: Grupo de reporte de Desarrollo product_config_id: 507f1f77bcf86cd799439030 patch_policy_target_id: 507f1f77bcf86cd799439040 fishing_pattern: Estaciones de trabajo Windows fishing_pattern_field: full_name intermediate_device_1_id: 507f1f77bcf86cd799439050 intermediate_device_2_id: 507f1f77bcf86cd799439051 intermediate_device_3_id: 507f1f77bcf86cd799439052 create-reporting-group-with-single-intermediate-device: summary: >- Crear un grupo de reporte solo con el primer dispositivo intermedio value: name: Grupo de reporte de dispositivo único product_config_id: 507f1f77bcf86cd799439030 intermediate_device_1_id: 507f1f77bcf86cd799439050 responses: '201': description: >- Grupo de reporte creado correctamente. La respuesta contiene el recurso creado. content: application/json: schema: $ref: '#/components/schemas/ReportingGroupByIdV1' '400': $ref: '#/components/responses/BadRequest' description: >- 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_*_id - Valor de fishing_pattern_field inválido (debe ser uno de: full_name, description, ou, current_subnet) - Valor de fishing_pattern inválido (excede maxLength: 250) - Dispositivos intermedios no definidos secuencialmente (intermediate_device_2_id requiere intermediate_device_1_id, intermediate_device_3_id requiere intermediate_device_2_id) '401': $ref: '#/components/responses/Unauthorized' description: No autorizado - se requiere autenticación '404': $ref: '#/components/responses/NotFound' description: Organización no encontrada '422': $ref: '#/components/responses/UnprocessableEntity' description: >- 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 '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateReportingGroupRequestV1: type: object properties: name: type: string maxLength: 512 description: >- El nombre del grupo de reporte. Debe ser único dentro de la organización. example: Grupo de reporte de Producción product_config_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- El identificador único de la configuración de producto que se asociará con este grupo de reporte. La configuración de producto debe existir y pertenecer a la organización. example: 507f1f77bcf86cd799439030 patch_policy_target_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- Opcional. El identificador único del destino de política de parches que se asociará con este grupo de reporte. example: 507f1f77bcf86cd799439040 fishing_pattern: type: string maxLength: 250 description: >- Opcional. Un patrón de expresión regular usado para hacer coincidir dispositivos. Debe ser un patrón regex válido. Si se proporciona, también se debe especificar fishing_pattern_field. example: Estaciones de trabajo Windows fishing_pattern_field: type: string enum: - full_name - description - ou - current_subnet description: >- Opcional. Campo sobre el que se aplica fishing_pattern. Obligatorio si se proporciona fishing_pattern. Valores válidos: full_name (nombre completo del dispositivo), description (descripción del dispositivo), ou (unidad organizativa), current_subnet (subred actual). example: full_name intermediate_device_1_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- Opcional. El identificador único del primer Workspace de dispositivo intermedio. Los dispositivos intermedios se usan para acciones Wake on LAN en redes seguras, permitiendo el encendido remoto de dispositivos objetivo a través de puertas de enlace intermedias. Los dispositivos intermedios deben definirse secuencialmente sin huecos. Si se proporcionan intermediate_device_2_id o intermediate_device_3_id, este campo es obligatorio. example: 507f1f77bcf86cd799439050 intermediate_device_2_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- Opcional. El identificador único del segundo Workspace de dispositivo intermedio. Se usa para acciones Wake on LAN en redes seguras. Requiere que se proporcione intermediate_device_1_id. Si se proporciona intermediate_device_3_id, este campo es obligatorio. example: 507f1f77bcf86cd799439051 intermediate_device_3_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: >- Opcional. El identificador único del tercer Workspace de dispositivo intermedio. Se usa para acciones Wake on LAN en redes seguras. Requiere que se proporcionen intermediate_device_1_id e intermediate_device_2_id. example: 507f1f77bcf86cd799439052 required: - name - product_config_id description: >- Cuerpo de solicitud para crear un nuevo grupo de reporte. Los grupos de reporte organizan dispositivos y gestionan configuraciones, políticas de parches y enrutamiento de dispositivos intermedios. ReportingGroupByIdV1: type: object properties: id: type: string description: ID del grupo de reporte name: type: string description: Nombre del grupo de reporte organization_id: type: string nullable: true description: Identificador de la organización product_config_id: type: string nullable: true description: Identificador de la configuración del producto fishing_pattern: type: string nullable: true description: Nombre del fishing pattern fishing_pattern_field: type: string enum: - full_name - description - ou - current_subnet nullable: true description: >- Campo sobre el que se aplica fishing_pattern. Valores posibles: full_name, description, ou, current_subnet. patch_policy_target_id: type: string nullable: true description: Identificador del destino de política de parches policy_reporting_group: type: string nullable: true description: Identificador del grupo de reporte de política overridden_agent_settings: $ref: '#/components/schemas/ReportingGroupAgentSettingsV1' nullable: true description: Ajustes del agente sobrescritos a nivel de grupo de reporte effective_agent_settings: $ref: '#/components/schemas/ReportingGroupEffectiveAgentSettingsV1' nullable: true description: >- Ajustes efectivos del agente (combinados desde la configuración del producto y sobrescrituras) execute_flexx_analyzer_agent: type: boolean description: Si la ejecución del agente Flexx Analyzer está habilitada intermediate_device_1_id: type: string nullable: true description: >- ID de Workspace del primer dispositivo intermedio (buscado por sysId) intermediate_device_2_id: type: string nullable: true description: >- ID de Workspace del segundo dispositivo intermedio (buscado por sysId) intermediate_device_3_id: type: string nullable: true description: >- ID de Workspace del tercer dispositivo intermedio (buscado por sysId) required: - id - name - execute_flexx_analyzer_agent ReportingGroupAgentSettingsV1: type: object properties: remote_support: type: string nullable: true description: Configuración de soporte remoto collect_device_location: type: boolean nullable: true description: Si la recopilación de ubicación del dispositivo está habilitada auto_update_agents: type: boolean nullable: true description: Si la actualización automática de agentes está habilitada collect_event_logs: type: boolean nullable: true description: Si la recopilación de registros de eventos está habilitada event_log_ids: type: string nullable: true description: IDs de registros de eventos event_logs_recurrence: type: number nullable: true description: Recurrencia de registros de eventos collect_disks: type: boolean nullable: true description: Si la recopilación de discos está habilitada collect_services: type: boolean nullable: true description: Si la recopilación de servicios está habilitada collect_pnp_events: type: boolean nullable: true description: Si la recopilación de eventos PnP está habilitada collect_public_ip: type: boolean nullable: true description: Si la recopilación de IP pública está habilitada fra_system_actions_role: type: string nullable: true description: Rol de acciones del sistema FRA unified_reporting: type: string nullable: true description: Configuración de reporte unificado unified_operations: type: string nullable: true description: Configuración de operaciones unificadas uninstall_protection: type: string nullable: true enum: - 'off' - 'on' description: >- Valores posibles: off, on. Si no hay un estado aplicable, devuelve null. web_apps: type: boolean nullable: true description: Si las web apps están habilitadas ReportingGroupEffectiveAgentSettingsV1: type: object description: >- Ajustes efectivos del agente (incluye campos de configuración del producto más sobrescrituras) properties: remote_support: type: string nullable: true collect_device_location: type: boolean nullable: true auto_update_agents: type: boolean nullable: true collect_event_logs: type: boolean nullable: true event_log_ids: type: string nullable: true event_logs_recurrence: type: number nullable: true collect_disks: type: boolean nullable: true collect_services: type: boolean nullable: true collect_pnp_events: type: boolean nullable: true collect_public_ip: type: boolean nullable: true fra_system_actions_role: type: string nullable: true unified_reporting: type: string nullable: true uninstall_protection: type: string nullable: true enum: - 'off' - 'on' description: >- Valores posibles: off, on. Si no hay un estado aplicable, devuelve null. resources_report_recurrence: type: number nullable: true profile_storage_report_recurrence: type: number nullable: true sync_broker_recurrence: type: number nullable: true detect_new_citrix_subscriptions: type: boolean nullable: true proxy_type: type: string nullable: true can_enable_flexx_agent_per_group: type: boolean nullable: true web_apps: type: boolean nullable: true fra_simplified_security: type: string nullable: true ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error responses: BadRequest: description: Solicitud incorrecta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: No autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: No encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnprocessableEntity: description: Entidad no procesable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Demasiadas solicitudes content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````