[comment]: # ({b933518c-49270b24})
# 13 Carte d'hôte

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

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

Ces paramètres et les valeurs de propriété possibles pour les objets de champ du widget de tableau de bord correspondants permettent de configurer
le widget [*Host card*](/manual/web_interface/frontend_sections/dashboards/widgets/host_card) dans les méthodes `dashboard.create` et `dashboard.update`.

::: noteimportant
Les propriétés `fields` du widget ne sont pas validées lors de la création ou de la mise à jour d’un tableau de bord.
Cela permet aux utilisateurs de modifier les [widgets intégrés](/manual/web_interface/frontend_sections/dashboards/widgets) et de créer des [widgets personnalisés](/devel/modules/tutorials/widget), mais introduit également le risque de créer ou de mettre à jour des widgets de manière incorrecte.
Pour garantir la réussite de la création ou de la mise à jour du widget *Host card*, veuillez vous référer au comportement des paramètres décrit dans les tableaux ci-dessous.
:::

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

[comment]: # ({13078533-7ad965d8})
### Paramètres

Les paramètres suivants sont pris en charge pour le widget *Carte d'hôte*.

|Paramètre|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Intervalle d'actualisation*|<|0|rf_rate|0 - Pas d'actualisation ;<br>10 - 10 secondes ;<br>30 - 30 secondes ;<br>60 - *(par défaut)* 1 minute ;<br>120 - 2 minutes ;<br>600 - 10 minutes ;<br>900 - 15 minutes.|
|*Hôte*|<|3|hostid.0|ID de [l'hôte](/manual/api/reference/host/get).<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* si *Hôte (Widget/Tableau de bord)* n'est pas défini<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|<|*Hôte (Widget/Tableau de bord)*|1|hostid.\_reference|Au lieu de l'ID de [l'hôte](/manual/api/reference/host/get) :<br>`DASHBOARD.hostid` - définit le [sélecteur d'hôte](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) du tableau de bord comme source de données pour l'hôte ;<br>`ABCDE._hostid` - définit un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (avec son paramètre *Référence* défini sur "`ABCDE`") comme source de données pour l'hôte.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* si *Hôte* n'est pas défini<br><br>Ce paramètre n'est pas pris en charge lors de la configuration du widget sur un [tableau de bord de modèle](/manual/api/reference/templatedashboard/object).|
|*Afficher les problèmes supprimés*|<|0|show_suppressed|0 - *(par défaut)* Désactivé ;<br>1 - Activé.|
|*Afficher*|<|0|sections.0|0 - Groupes d'hôtes ;<br>1 - Description ;<br>2 - Surveillance ;<br>3 - Disponibilité ;<br>4 - Surveillé par ;<br>5 - Modèles ;<br>6 - Inventaire ;<br>7 - Tags.<br><br>Remarque : Le nombre dans le nom de propriété fait référence à l'ordre des sections dans la liste des sections. Pour configurer plusieurs sections, créez un objet de champ de widget de tableau de bord pour chaque section avec un nombre incrémenté dans le nom de propriété.|

Les paramètres suivants sont pris en charge si *Afficher* est défini sur "Inventaire".

|Paramètre|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Champs d'inventaire*|0|inventory.0|ID de [l'inventaire](/manual/api/reference/host/object#host-inventory).<br><br>Remarque : Pour configurer plusieurs champs d'inventaire, créez un objet de champ de widget de tableau de bord pour chaque champ d'inventaire avec un nombre incrémenté dans le nom de propriété.|

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

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

Les exemples suivants visent uniquement à décrire la configuration des objets de champ du widget de tableau de bord pour le widget *Host card*.
Pour plus d’informations sur la configuration d’un tableau de bord, consultez [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({baeb35ec-095f7dfe})
#### Configuration d’un widget *Carte d’hôte*

Configurez un widget *Carte d’hôte* qui affiche les sections suivantes : « Monitoring », « Availability », « Monitored by », « Inventory » et « Tags ».

[Requête](/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
}
```

Réponse :

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

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

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

-   [Champ de widget de tableau de bord](/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})