Saltar al contingut principal

Crear operacions

POST 
/v2/organizations/:organization_id/operations

Crea una o més operacions basades en l'abast i els objectius enviats.

Tipus d'operació actualment disponibles:execute_microservice, delete_workspaces, force_update_custom_fields, shutdown_workspaces, restart_workspaces, suspend_workspaces, power_off_workspaces, force_restart_workspaces, wake_on_lan_workspaces, send_popup, send_flexxible_notification, disconnect_sessions, logoff_sessions, force_logoff_sessions, collect_agent_logs, change_reporting_group, windows_service_action i close_notification, get_installed_patches, get_pending_patches i get_plug_and_play_devices.

Devuelve los recursos de operación creados con el mismo contrato canónico de consulta por id.

Ejecución parcial

Las operaciones se crean solo para los objetivos elegibles. Los objetivos no elegibles no bloquean la solicitud: se devuelven en not_supported_devices, agrupados por motivo. Si se omiten todos los objetivos, la respuesta sigue siendo 201 con data vacío. Los fallos de autorización de la organización y las validaciones globales de la solicitud devuelven 4xx y no crean ninguna operación.

Objetivos admitidos por tipo

  • Solo sessions: disconnect_sessions, logoff_sessions y force_logoff_sessions.
  • workspaces o sessions: execute_microservice, send_popup y send_flexxible_notification.
  • Solo workspaces: el resto de tipos.
  • windows_service_action admite exactamente un objetivo por solicitud.

Contenido de payload por tipo

payload es un objeto cuyo contenido depende de type. Se rechazan con 400 los campos no admitidos para el tipo enviado. Consulte los ejemplos de solicitud para ver cada forma completa.

  • execute_microservice: microservice_id (requerido) y parameters (opcional).
  • shutdown_workspaces y restart_workspaces: scheduled_at (opcional).
  • wake_on_lan_workspaces: intermediate_workspace_id (requerido). Debe ser un Workspace conectado que actúe como intermediario.
  • send_popup: message (requerido).
  • send_flexxible_notification: message, start_date, end_date, level_type (informative, maintenance o issue), blink, ask_for_acknowledgement, disable_minimize y timezone (requeridos); tooltip y link (opcionales).
  • collect_agent_logs: start_time (requerido); end_time y filter_files (opcionales).
  • change_reporting_group: reporting_group_id (requerido). Se rechaza la solicitud cuando supera los 100 Workspaces no aptos.
  • windows_service_action: action (start, stop o restart) y services_name (requeridos). El servicio FlexxAgent service no se puede detener ni reiniciar.
  • delete_workspaces, force_update_custom_fields, suspend_workspaces, power_off_workspaces, force_restart_workspaces, disconnect_sessions, logoff_sessions y force_logoff_sessions: no admiten payload.

Compatibilidad de parámetros para execute_microservice

payload.parameters solo aplica a ejecuciones de microservicios PowerShell en Windows y solo está soportado en dispositivos con el nuevo agente instalado.

Los valores enviados en payload.parameters se transmiten como texto (string). La interpretación de tipos depende de la definición de parámetros y del parseo implementado en el script del microservicio.

Para ese contexto, tipos de datos de los parámetros recomendados:

  • string, integer, double, decimal y datetime.
  • Para double y decimal, use notación con punto decimal (.).
  • Para datetime, use formato ISO 8601 (por ejemplo: 2026-07-09T10:30:00Z).
  • Al ejecutarse en el destino, los valores datetime pueden representarse en hora local.
  • La ejecución correcta también depende de la calidad y validaciones del script.

Sol·licitud​

Respostes​

Operacions creades correctament.