Atualizar um grupo de relatórios
PUT/v1/organizations/:organization_id/reporting-groups/:reporting_group_id
Atualiza a configuração de um grupo de relatório existente, incluindo nome, descrição, destino de política de patches, padrão de busca e dispositivos intermediários. Este endpoint implementa semântica de substituição completa: todos os campos atualizáveis devem ser incluídos na solicitação. Omissão de campos opcionais irá limpá-los (comportamento idempotente). Pode configurar opcionalmente dispositivos intermediários (até 3) fornecendo identificadores de Workspace. Dispositivos intermediários são usados para ações Wake-on-LAN em redes seguras, permitindo o ligamento remoto de dispositivos através de gateways intermediários. Dispositivos intermediários devem ser definidos sequencialmente: você não pode definir intermediate_device_2_id sem intermediate_device_1_id, nem intermediate_device_3_id sem intermediate_device_2_id. Todos os IDs de Workspace de dispositivos intermediários devem existir e pertencer à organização. Retorna o recurso atualizado (200) após uma atualização bem-sucedida.
Solicitação
Respostas
- 200
- 400
- 401
- 404
- 422
- 429
- 500
Grupo de relatório atualizado corretamente. A resposta contém o recurso atualizado.
Requisição incorreta. Causas comuns: - Campos obrigatórios em falta (name) - Valores de campo não válidos - Valor de fishing_pattern_field não válido (deve ser um dos: full_name, description, ou, current_subnet) - Valor de fishing_pattern não válido (supera maxLength: 250) - Formato de ID não válido para os campos patch_policy_target_id ou intermediate_device_*_id - Dispositivos intermediários não definidos sequencialmente (intermediate_device_2_id requer intermediate_device_1_id, intermediate_device_3_id requer intermediate_device_2_id)
Não autorizado - autenticação requerida
Não encontrado. Causas comuns: - Grupo de relatório não encontrado ou que não pertence à organização - Destino de política de patches não encontrado
Entidade não processável. Causas comuns: - Os IDs de Workspace de dispositivos intermediários não existem ou não pertencem à organização
Solicitações em excesso
Erro interno do servidor