---
title: Malware Family
slug: homologacao-atmosphere/malware-family
description: Learn how to retrieve detailed malware reports using the malware report API. Simply provide the family name as a parameter, which can even include wildcard characters. This API, integrated with the X-Force Auth module, offers comprehensive information on 
docTags: 
createdAt: 2022-08-01T17:42:33.000Z
---

## Resumo

- Retorna um relatório de malware para o nome de família fornecido.

## Parâmetros

| **Parâmetro** | **Requerido** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários**                                                              |
| ------------- | ------------- | -------- | ---------------------------- | ---------------------------------------------------------------------------- |
| family        | Sim           | string   |                              | A família de malware, por exemplo, tsunami.<br /><br />Aceita `wildcard (*)` |

Utiliza parâmetros do módulo X-Force Auth.

## Exemplos

```yaml
#
xforce_malware:
  api_key: api_key_
  api_password: api_password_hash
  family: tsu*
register: result
```

## Valores retornados

| **Chave** | **Tipo**        | **Retornado quando** | **Descrição** |
| --------- | --------------- | -------------------- | ------------- |
| malware   | list of complex | Sucesso              |               |