Actualitzar un grup d'informe
Actualitza la configuració d’un grup de reporte existent, incloent nom, descripció, destinació de política de pedaços, patró de cerca i dispositius intermedis. Aquest endpoint implementa semàntica de reemplaçament complet: tots els camps actualitzables han d’incloure’s en la sol·licitud. Ometre camps opcionals els netejarà (comportament idempotent). Pots configurar opcionalment dispositius intermedis (fins a 3) proporcionant identificadors de Workspace. Els dispositius intermedis s’utilitzen per a accions Wake-on-LAN en xarxes segures, permetent l’encesa remot de dispositius a través de passarel·les intermediàries. Els dispositius intermedis han de definir-se seqüencialment: no pots definir intermediate_device_2_id sense intermediate_device_1_id, ni intermediate_device_3_id sense intermediate_device_2_id. Tots els IDs de Workspace de dispositius intermedis han d’existir i pertànyer a l’organització. Retorna el recurs actualitzat (200) després d’una actualització exitosa.
curl --request PUT \
--url https://api.flexxible.net/v2/organizations/{organization_id}/reporting-groups/{reporting_group_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Grupo de reporte de producción actualizado",
"description": "Grupo de reporte actualizado para entornos de producción",
"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"
}
'{
"id": "<string>",
"name": "<string>",
"execute_flexx_analyzer_agent": true,
"organization_id": "<string>",
"product_config_id": "<string>",
"fishing_pattern": "<string>",
"fishing_pattern_field": "full_name",
"patch_policy_target_id": "<string>",
"policy_reporting_group": "<string>",
"overridden_agent_settings": {
"remote_support": "<string>",
"collect_device_location": true,
"auto_update_agents": true,
"collect_event_logs": true,
"event_log_ids": "<string>",
"event_logs_recurrence": 123,
"collect_disks": true,
"collect_services": true,
"collect_pnp_events": true,
"collect_public_ip": true,
"fra_system_actions_role": "<string>",
"unified_reporting": "<string>",
"unified_operations": "<string>",
"uninstall_protection": "off",
"web_apps": true
},
"effective_agent_settings": {
"remote_support": "<string>",
"collect_device_location": true,
"auto_update_agents": true,
"collect_event_logs": true,
"event_log_ids": "<string>",
"event_logs_recurrence": 123,
"collect_disks": true,
"collect_services": true,
"collect_pnp_events": true,
"collect_public_ip": true,
"fra_system_actions_role": "<string>",
"unified_reporting": "<string>",
"uninstall_protection": "off",
"resources_report_recurrence": 123,
"profile_storage_report_recurrence": 123,
"sync_broker_recurrence": 123,
"detect_new_citrix_subscriptions": true,
"proxy_type": "<string>",
"can_enable_flexx_agent_per_group": true,
"web_apps": true,
"fra_simplified_security": "<string>"
},
"intermediate_device_1_id": "<string>",
"intermediate_device_2_id": "<string>",
"intermediate_device_3_id": "<string>"
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}Autoritzacions
Paràmetres de ruta
Cos
Cos de la sol·licitud per actualitzar un grup de reporte existent. Aquest endpoint implementa semàntica de reemplaçament complet: tots els camps actualitzables han d'incloure's. Ometre camps opcionals els netejarà (comportament idempotent). Els dispositius intermedis s'utilitzen per a accions Wake on LAN en xarxes segures, permetent l'encesa remot de dispositius a través de passarel·les intermediàries. Els dispositius intermedis han de definir-se seqüencialment: no pots definir intermediate_device_2_id sense intermediate_device_1_id, ni intermediate_device_3_id sense intermediate_device_2_id. Tots els IDs de Workspace de dispositius intermedis han d'existir i pertànyer a l'organització.
Opcional. Camp sobre el qual s'aplica fishing_pattern. Obligatori si es proporciona fishing_pattern. Valors vàlids: full_name (nom complet del dispositiu), description (descripció del dispositiu), ou (unitat organitzativa), current_subnet (subxarxa actual).
full_name, description, ou, current_subnet "full_name"
Opcional. L'identificador únic del Workspace del primer dispositiu intermedi. Els dispositius intermedis s'utilitzen per a accions Wake-on-LAN en xarxes segures, permetent l'encesa remot dels dispositius objectiu a través de passarel·les intermediàries. Els dispositius intermedis han de definir-se seqüencialment i sense buits. Si es omet, es netejaran tots els dispositius intermedis. Si es proporcionen intermediate_device_2_id o intermediate_device_3_id, aquest camp és obligatori.
24^[0-9a-f]{24}$"507f1f77bcf86cd799439050"
Opcional. L'identificador únic del Workspace del segon dispositiu intermedi. S'utilitza per a accions Wake-on-LAN en xarxes segures. Requereix que es proporcioni intermediate_device_1_id. Si es omet mentre intermediate_device_1_id està proporcionat, aquest i intermediate_device_3_id es netejaran. Si es proporciona intermediate_device_3_id, aquest camp és obligatori.
24^[0-9a-f]{24}$"507f1f77bcf86cd799439051"
Opcional. L'identificador únic del Workspace del tercer dispositiu intermedi. S'utilitza per a accions Wake on LAN en xarxes segures. Requereix que es proporcionin intermediate_device_1_id i intermediate_device_2_id. Si es omet mentre intermediate_device_1_id i intermediate_device_2_id estan proporcionats, aquest camp es netejarà.
24^[0-9a-f]{24}$"507f1f77bcf86cd799439052"
Resposta
Grup de reporte actualitzat correctament. La resposta conté el recurs actualitzat.
curl --request PUT \
--url https://api.flexxible.net/v2/organizations/{organization_id}/reporting-groups/{reporting_group_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Grupo de reporte de producción actualizado",
"description": "Grupo de reporte actualizado para entornos de producción",
"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"
}
'{
"id": "<string>",
"name": "<string>",
"execute_flexx_analyzer_agent": true,
"organization_id": "<string>",
"product_config_id": "<string>",
"fishing_pattern": "<string>",
"fishing_pattern_field": "full_name",
"patch_policy_target_id": "<string>",
"policy_reporting_group": "<string>",
"overridden_agent_settings": {
"remote_support": "<string>",
"collect_device_location": true,
"auto_update_agents": true,
"collect_event_logs": true,
"event_log_ids": "<string>",
"event_logs_recurrence": 123,
"collect_disks": true,
"collect_services": true,
"collect_pnp_events": true,
"collect_public_ip": true,
"fra_system_actions_role": "<string>",
"unified_reporting": "<string>",
"unified_operations": "<string>",
"uninstall_protection": "off",
"web_apps": true
},
"effective_agent_settings": {
"remote_support": "<string>",
"collect_device_location": true,
"auto_update_agents": true,
"collect_event_logs": true,
"event_log_ids": "<string>",
"event_logs_recurrence": 123,
"collect_disks": true,
"collect_services": true,
"collect_pnp_events": true,
"collect_public_ip": true,
"fra_system_actions_role": "<string>",
"unified_reporting": "<string>",
"uninstall_protection": "off",
"resources_report_recurrence": 123,
"profile_storage_report_recurrence": 123,
"sync_broker_recurrence": 123,
"detect_new_citrix_subscriptions": true,
"proxy_type": "<string>",
"can_enable_flexx_agent_per_group": true,
"web_apps": true,
"fra_simplified_security": "<string>"
},
"intermediate_device_1_id": "<string>",
"intermediate_device_2_id": "<string>",
"intermediate_device_3_id": "<string>"
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}