Documentation
Table of Contents
> Objet Hôte
Les objets suivants sont directement liés à l'API host.
Hôte
L'objet hôte a les propriétés suivantes.
| Propriété | Type | Description |
|---|---|---|
| hostid | string | (lecture seule) ID de l'hôte. |
| host (obligatoire) |
string | Nom technique de l'hôte. |
| description | text | Description de l'hôte. |
| flags | integer | (lecture seule) Origine de l'hôte. Valeurs possibles : 0 - un hôte ordinaire ; 4 - un hôte découvert. |
| inventory_mode | integer | Mode de population d'inventaire hôte. Valeurs possibles : -1 - (par défaut) désactivé ; 0 - manuel ; 1 - automatique. |
| ipmi_authtype | integer | Algorithme d'authentification IPMI. Valeurs possibles : -1 - (par défaut) défaut ; 0 - aucun ; 1 - MD2 ; 2 - MD5 4 - straight ; 5 - OEM ; 6 - RMCP+. |
| ipmi_password | string | Mot de passe IPMI. |
| ipmi_privilege | integer | Niveau de privilège IPMI. Valeurs possibles : 1 - callback ; 2 - (par défaut) user ; 3 - operator ; 4 - admin ; 5 - OEM. |
| ipmi_username | string | Nom d'utilisateur IPMI. |
| maintenance_from | timestamp | (lecture seule) Heure de début de la maintenance effective. |
| maintenance_status | integer | (lecture seule) Statut de maintenance effective. Valeurs possibles : 0 - (par défaut) pas de maintenance ; 1 - maintenance effective. |
| maintenance_type | integer | (lecture seule) Type de maintenance effective Valeurs possibles : 0 - (par défaut) maintenance avec collecte de données ; 1 - maintenance sans collecte de données. |
| maintenanceid | string | (lecture seule) ID de la maintenance actuellement en vigueur sur l'hôte. |
| name | string | Nom visible de l'hôte. Par défaut : valeur de la propriété host . |
| proxy_hostid | string | ID du proxy utilisé pour surveiller l'hôte. |
| status | integer | Statut et fonction de l'hôte. Valeurs possibles : 0 - (par défaut) hôte surveillé ; 1 - hôte non surveillé. |
| tls_connect | integer | Connexions à l'hôte. Valeurs possibles : 1 - (par défaut) Pas de cryptage ; 2 - PSK ; 4 - certificat. |
| tls_accept | integer | Connexions de l'hôte. Les valeurs bitmap possibles sont : 1 - (par défaut) Pas de cryptage ; 2 - PSK ; 4 - certificat. |
| tls_issuer | string | Emetteur du certificat. |
| tls_subject | string | Sujet du certificat. |
| tls_psk_identity | string | (écriture seule)Identité PSK. Requis si tls_connect ou tls_accept ont PSK activé. |
| tls_psk | string | (écriture seule)La clé prépartagée, au moins 32 chiffres hexadécimaux. Requis si tls_connect ou tls_accept ont PSK activé. |
Notez que pour certaines méthodes (mise à jour, suppression) la combinaison de paramètres requise/optionnelle est différente.
Inventaire d'hôte
L'objet d'inventaire hôte a les propriétés suivantes.
Chaque propriété a son propre numéro d'identification unique, utilisé pour associer des champs d'inventaire hôte à des éléments.
| ID | Propriété | Type | Description | |
|---|---|---|---|---|
| 4 | alias | string | Alias. | 128 caractères |
| 11 | asset_tag | string | Tag caractéristique. | 64 caractères |
| 28 | chassis | string | Châssis. | 64 caractères |
| 23 | contact | string | Personne de contact. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 32 | contract_number | string | Numéro de contrat. | 64 caractères |
| 47 | date_hw_decomm | string | Matériel - Date de retrait. | 64 caractères |
| 46 | date_hw_expiry | string | Matériel - Date de fin de maintenance | 64 caractères |
| 45 | date_hw_install | string | Matériel - Date d'installation. | 64 caractères |
| 44 | date_hw_purchase | string | Matériel - Date d'achat. | 64 caractères |
| 34 | deployment_status | string | État du déploiement. | 64 caractères |
| 14 | hardware | string | Matériel. | 255 caractères |
| 15 | hardware_full | string | Matériel Détails complet. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 39 | host_netmask | string | Masque de sous-réseau de l'hôte. | 39 caractères |
| 38 | host_networks | string | Réseaux de l'hôte. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 40 | host_router | string | Hôte - Routeur. | 39 caractères |
| 30 | hw_arch | string | Architecture matérielle. | 32 caractères |
| 33 | installer_name | string | Nom de l'installeur. | 64 caractères |
| 24 | location | string | Emplacement. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 25 | location_lat | string | Latitude de l'emplacement. | 16 caractères |
| 26 | location_lon | string | Longitude de l'emplacement. | 16 caractères |
| 12 | macaddress_a | string | Adresse MAC A. | 64 caractères |
| 13 | macaddress_b | string | Adresse MAC B. | 64 caractères |
| 29 | model | string | Modèle. | 64 caractères |
| 3 | name | string | Nom. | 128 caractères |
| 27 | notes | string | Notes. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 41 | oob_ip | string | Adresse IP OOB. | 39 caractères |
| 42 | oob_netmask | string | Masque de sous-réseau OOB. | 39 caractères |
| 43 | oob_router | string | Routeur OOB. | 39 caractères |
| 5 | os | string | OS. | 128 caractères |
| 6 | os_full | string | Nom complet de l'OS. | 255 caractères |
| 7 | os_short | string | Nom court de l'OS. | 128 caractères |
| 61 | poc_1_cell | string | Contact Principal - Mobile. | 64 caractères |
| 58 | poc_1_email | string | Contact Principal - Courriel. | 128 caractères |
| 57 | poc_1_name | string | Contact Principal - Nom. | 128 caractères |
| 63 | poc_1_notes | string | Contact Principal - Notes. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 59 | poc_1_phone_a | string | Contact Principal - Téléphone 1. | 64 caractères |
| 60 | poc_1_phone_b | string | Contact Principal - Téléphone 2. | 64 caractères |
| 62 | poc_1_screen | string | Contact Principal - Identifiant. | 64 caractères |
| 68 | poc_2_cell | string | Contact Secondaire - Mobile. | 64 caractères |
| 65 | poc_2_email | string | Contact Secondaire - Courriel. | 128 caractères |
| 64 | poc_2_name | string | Contact Secondaire - Nom. | 128 caractères |
| 70 | poc_2_notes | string | Contact Secondaire - Notes. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 66 | poc_2_phone_a | string | Contact Secondaire - Téléphone 1. | 64 caractères |
| 67 | poc_2_phone_b | string | Contact Secondaire - Téléphone 2. | 64 caractères |
| 69 | poc_2_screen | string | Contact Secondaire - Identifiant. | 64 caractères |
| 8 | serialno_a | string | Numéro de série A. | 64 caractères |
| 9 | serialno_b | string | Numéro de série B. | 64 caractères |
| 48 | site_address_a | string | Site - Adresse 1. | 128 caractères |
| 49 | site_address_b | string | Site - Adresse 2. | 128 caractères |
| 50 | site_address_c | string | Site - Adresse 3. | 128 caractères |
| 51 | site_city | string | Site - Ville. | 128 caractères |
| 53 | site_country | string | Site - Pays. | 64 caractères |
| 56 | site_notes | string | Site - Notes. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 55 | site_rack | string | Site - Localisation baie. | 128 caractères |
| 52 | site_state | string | Site - Etat / province. | 64 caractères |
| 54 | site_zip | string | Site - Code postal. | 64 caractères |
| 16 | software | string | Logiciel. | 255 caractères |
| 18 | software_app_a | string | Application logicielle A. | 64 caractères |
| 19 | software_app_b | string | Application logicielle B. | 64 caractères |
| 20 | software_app_c | string | Application logicielle C. | 64 caractères |
| 21 | software_app_d | string | Application logicielle D. | 64 caractères |
| 22 | software_app_e | string | Application logicielle E. | 64 caractères |
| 17 | software_full | string | Détails du logiciel. | Dépend de la base de données utilisée : - 65535 caractères pour les bases de données SQL - 2048 caractères pour les bases de données Oracle |
| 10 | tag | string | Étiquette. | 64 caractères |
| 1 | type | string | Type. | 64 caractères |
| 2 | type_full | string | Détails du type. | 64 caractères |
| 35 | url_a | string | URL A. | 255 caractères |
| 36 | url_b | string | URL B. | 255 caractères |
| 37 | url_c | string | URL C. | 255 caractères |
| 31 | vendor | string | Fabricant. | 64 caractères |
Tag d'hôte
L'objet tag d'hôte a les propriétés suivantes.
| Propriété | Type | Description |
|---|---|---|
| tag (obligatoire) |
string | Nom du tag d'hôte. |
| value | string | Valeur du tag d'hôte. |