Grups de report

Crear un grup de informe

Crea un nou grup de reporte per a l’organització especificada. Els grups de reporte s’utilitzen per organitzar i gestionar configuracions de dispositius, ajustaments de producte i polítiques de pedaços. 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 ID del grup de reporte creat després d’una creació satisfactòria.

POST

organizations

{organization_id}

reporting-groups

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/reporting-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Grupo de reporte de Producción",
  "product_config_id": "507f1f77bcf86cd799439030"
}
'

{
  "id": "<string>",
  "name": "<string>",
  "execute_flexx_analyzer_agent": true,
  "organization_id": "<string>",
  "product_config_id": "<string>",
  "fishing_pattern": "<string>",
  "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>",
    "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>",
    "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

Authorization

string

header

requerit

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paràmetres de ruta

organization_id

string

requerit

El identificador únic de l'organització

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Cos

application/json

Cos de sol·licitud per crear un nou grup de reporte. Els grups de reporte organitzen dispositius i gestionen configuracions, polítiques de pegats i enrutament de dispositius intermedis.

name

string

requerit

El nom del grup de reporte. Ha de ser únic dins de l'organització.

Maximum string length: 512

Exemple:

"Grupo de reporte de Producción"

product_config_id

string

requerit

L'identificador únic de la configuració de producte que s'associarà amb aquest grup de reporte. La configuració de producte ha d'existir i pertànyer a l'organització.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Exemple:

"507f1f77bcf86cd799439030"

patch_policy_target_id

string

Opcional. L'identificador únic del destí de política de pegats que s'associarà amb aquest grup de reporte.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Exemple:

"507f1f77bcf86cd799439040"

fishing_pattern

string

Opcional. Un patró d'expressió regular utilitzat per coincidir dispositius. Ha de ser un patró regex vàlid. Si es proporciona, també s'ha d'especificar fishing_pattern_field.

Maximum string length: 250

Exemple:

"Estaciones de trabajo Windows"

fishing_pattern_field

enum<string>

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).

Opcions disponibles:

full_name,

description,

ou,

current_subnet

Exemple:

"full_name"

intermediate_device_1_id

string

Opcional. L'identificador únic del primer Workspace de dispositiu intermedi. Els dispositius intermedis s'utilitzen per a accions Wake on LAN en xarxes segures, permetent l'encesa remot de dispositius objectiu a través de passarel·les intermediàries. Els dispositius intermedis han de definir-se seqüencialment sense buits. Si es proporcionen intermediate_device_2_id o intermediate_device_3_id, aquest camp és obligatori.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Exemple:

"507f1f77bcf86cd799439050"

intermediate_device_2_id

string

Opcional. L'identificador únic del segon Workspace de dispositiu intermedi. S'utilitza per accions Wake on LAN en xarxes segures. Requereix que es proporcioni intermediate_device_1_id. Si es proporciona intermediate_device_3_id, aquest camp és obligatori.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Exemple:

"507f1f77bcf86cd799439051"

intermediate_device_3_id

string

Opcional. L'identificador únic del tercer Workspace de dispositiu intermedi. S'utilitza per accions Wake on LAN en xarxes segures. Requereix que es proporcionin intermediate_device_1_id i intermediate_device_2_id.

Maximum string length: 24

Pattern: ^[0-9a-f]{24}$

Exemple:

"507f1f77bcf86cd799439052"

Resposta

Grup de reporte creat correctament. La resposta conté el recurs creat.

string

requerit

ID del grup de report

name

string

requerit

Nom del grup de report

execute_flexx_analyzer_agent

boolean

requerit

Si l'execució de l'agent Flexx Analyzer està habilitada

organization_id

string | null

Identificador de l'organització

product_config_id

string | null

Identificador de la configuració del producte

fishing_pattern

string | null

Nom del fishing pattern

fishing_pattern_field

enum<string> | null

Camp sobre el qual s'aplica fishing_pattern. Valors possibles: full_name, description, ou, current_subnet.

Opcions disponibles:

full_name,

description,

ou,

current_subnet

patch_policy_target_id

string | null

Identificador del destí de política de pegats

policy_reporting_group

string | null

Identificador del grup de reporte de política

overridden_agent_settings

object | null

Ajustaments de l'agent sobrescrits a nivell de grup de reporte

Show child attributes

effective_agent_settings

object | null

Ajustaments efectius de l'agent (combinats des de la configuració del producte i sobrescritures)

Show child attributes

intermediate_device_1_id

string | null

ID de Workspace del primer dispositiu intermedi (buscat per sysId)

intermediate_device_2_id

string | null

ID de Workspace del segon dispositiu intermedi (buscat per sysId)

intermediate_device_3_id

string | null

ID de Workspace del tercer dispositiu intermedi (buscat per sysId)

Llistar grups d'informe

Recuperar un grup d'informe

Següent

⌘I

curl --request POST \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/reporting-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Grupo de reporte de Producción",
  "product_config_id": "507f1f77bcf86cd799439030"
}
'

{
  "id": "<string>",
  "name": "<string>",
  "execute_flexx_analyzer_agent": true,
  "organization_id": "<string>",
  "product_config_id": "<string>",
  "fishing_pattern": "<string>",
  "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>",
    "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>",
    "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>"
  }
}