[comment]: # ({b933518c-49270b24})
# 13 Cartão de host

[comment]: # ({/b933518c-49270b24})

[comment]: # ({9c4a7c19-dbef1114})
### Descrição

Esses parâmetros e os possíveis valores de propriedade para os respectivos objetos de campo do widget de dashboard permitem configurar o widget [*Host card*](/manual/web_interface/frontend_sections/dashboards/widgets/host_card) nos métodos `dashboard.create` e `dashboard.update`.

::: noteimportant
As propriedades `fields` do widget não são validadas durante a criação ou atualização de um dashboard.
Isso permite que os usuários modifiquem [widgets internos](/manual/web_interface/frontend_sections/dashboards/widgets) e criem [widgets personalizados](/devel/modules/tutorials/widget), mas também introduz o risco de criar ou atualizar widgets incorretamente.
Para garantir a criação ou atualização bem-sucedida do widget *Host card*, consulte o comportamento dos parâmetros descritos nas tabelas abaixo.
:::

[comment]: # ({/9c4a7c19-dbef1114})

[comment]: # ({13078533-7ad965d8})
### Parâmetros

Os seguintes parâmetros são suportados para o widget *Host card*.

|Parâmetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-|--------|--|--------|-------------------------------|
|*Intervalo de atualização*|<|0|rf_rate|0 - Sem atualização;<br>10 - 10 segundos;<br>30 - 30 segundos;<br>60 - *(padrão)* 1 minuto;<br>120 - 2 minutos;<br>600 - 10 minutos;<br>900 - 15 minutos.|
|*Host*|<|3|hostid.0|ID do [Host](/manual/api/reference/host/get).<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se *Host (Widget/Dashboard)* não estiver definido<br><br>Este parâmetro não é suportado ao configurar o widget em um [dashboard de template](/manual/api/reference/templatedashboard/object).|
|<|*Host (Widget/Dashboard)*|1|hostid.\_reference|Em vez do ID do [Host](/manual/api/reference/host/get):<br>`DASHBOARD.hostid` - define o [seletor de host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) do dashboard como a fonte de dados para o host;<br>`ABCDE._hostid` - define um [widget compatível](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (com seu parâmetro *Referência* definido como "`ABCDE`") como a fonte de dados para o host.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se *Host* não estiver definido<br><br>Este parâmetro não é suportado ao configurar o widget em um [dashboard de template](/manual/api/reference/templatedashboard/object).|
|*Mostrar problemas suprimidos*|<|0|show_suppressed|0 - *(padrão)* Desabilitado;<br>1 - Habilitado.|
|*Mostrar*|<|0|sections.0|0 - Grupos de host;<br>1 - Descrição;<br>2 - Monitoramento;<br>3 - Disponibilidade;<br>4 - Monitorado por;<br>5 - Templates;<br>6 - Inventário;<br>7 - Tags.<br><br>Nota: O número no nome da propriedade referencia a ordem da seção na lista de seções. Para configurar várias seções, crie um objeto de campo de widget de dashboard para cada seção com um número incrementado no nome da propriedade.|

Os seguintes parâmetros são suportados se *Mostrar* estiver definido como "Inventário".

|Parâmetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nome|valor|
|-----|-|-----|-------------------|
|*Campos de inventário*|0|inventory.0|ID do [Inventário](/manual/api/reference/host/object#host-inventory).<br><br>Nota: Para configurar vários campos de inventário, crie um objeto de campo de widget de dashboard para cada campo de inventário com um número incrementado no nome da propriedade.|

[comment]: # ({/13078533-7ad965d8})

[comment]: # ({8ad3bebf-9735261c})
### Exemplos

Os exemplos a seguir têm como objetivo apenas descrever a configuração dos objetos de campo do widget do painel para o widget *Host card*.
Para obter mais informações sobre como configurar um painel, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/8ad3bebf-9735261c})

[comment]: # ({baeb35ec-095f7dfe})
#### Configurando um widget *Host card*

Configure um widget *Host card* que exibe estas seções: "Monitoring", "Availability", "Monitored by", "Inventory" e "Tags".

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "hostcard",
                        "name": "Host card",
                        "x": 0,
                        "y": 0,
                        "width": 14,
                        "height": 7,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostid.0",
                                "value": 10084
                            },
                            {
                                "type": 0,
                                "name": "show_suppressed",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "sections.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "sections.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "sections.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "sections.3",
                                "value": 6
                            },
                            {
                                "type": 0,
                                "name": "sections.4",
                                "value": 7
                            },
                            {
                                "type": 0,
                                "name": "inventory.0",
                                "value": 25
                            },
                            {
                                "type": 0,
                                "name": "inventory.1",
                                "value": 26
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/baeb35ec-095f7dfe})

[comment]: # ({e9d30322-bc2b8a1f})
### Veja também

-   [Campo do widget do dashboard](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-bc2b8a1f})