--- title: "API de configuration - Ajout, mise à jour et suppression de staticHost" slug: "configuration-api-adding-updating-and-removing-statichost" updated: 2026-07-30T02:52:27Z published: 2026-07-30T02:52:27Z canonical: "knowledge.catonetworks.com/configuration-api-adding-updating-and-removing-statichost" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # API de configuration - Ajout, mise à jour et suppression de staticHost Nous recommandons fortement qu'avant de commencer à utiliser l'API Cato, vous consultiez la [politique de support pour l'API Cato](/v1/docs/support-policy-for-the-cato-api). Cet article explique comment utiliser l'API Cato pour gérer les hôtes définis pour un site avec ces commandes : - addStaticHost - updateStaticHost - removeStaticHost ## Vue d'ensemble de staticHost Utilisez les API de mutation staticHost pour ajouter, mettre à jour et supprimer des hôtes pour un site dans votre compte et définir les paramètres suivants pour l'hôte : - Nom de l'hôte - Adresse IP de l'hôte - Adresse MAC (facultatif - utilisée pour réserver une attribution d'IP DHCP pour l'hôte) Pour les comptes revendeurs, vous pouvez créer des clés API séparées dans chaque compte client avec lequel vous configurez les paramètres API Cato. ### Localisation du siteID pour un Site L'ID du site n'est pas affiché dans l'application de gestion Cato, vous pouvez localiser l'ID du site : - Utilisation de la requête API entityLookup (voir [Cato API - EntityLookup](/v1/docs/cato-api-entitylookup)), utilisez le `type` avec la valeur **site** Vous pouvez également utiliser le paramètre `search` avec la valeur comme le nom du site, et la requête renvoie l'ID du site - Numéro dans l'URL pour l'application de gestion Cato, lorsque vous avez sélectionné un site (Réseau > Sites > {site name}). Par exemple, l'ID du site est 12345 pour l'URL suivante : https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ## Détails des arguments pour addStaticHost et updateStaticHost Les mêmes arguments sont utilisés pour créer ou mettre à jour un hôte derrière un site en utilisant l'API de configuration de Cato. Pour `addStaticHost`, les arguments sont obligatoires sauf indication contraire. Pour `updateStaticHost`, incluez les arguments des paramètres d'hôte que vous mettez à jour. - hostId - Pour `updateStaticHost`, entrez l'ID de l'hôte que vous mettez à jour Pour `addStaticHost`, cet ID est généré lors de la création du nouvel hôte - name - Nom de l'hôte derrière le site - ip - Adresse IP de l'hôte derrière le site - macAddress - (facultatif) Adresse MAC de l'hôte derrière le site L'adresse MAC de l'hôte est utilisée pour la réservation DHCP pour les hôtes avec une adresse IP statique ### StaticHost hostId Le `hostId` est l'ID interne Cato pour l'entité hôte. Le `networkRangeId` peut être récupéré en utilisant l'API en lecture seule [entityLookup](/v1/docs/cato-api-entitylookup), utilisez le `type` avec la valeur **host** ### StaticHost name Utilisez l'argument `name` pour définir le nom de l'hôte. ### StaticHost ip Utilisez l'argument `ip` pour définir l'adresse IP de l'hôte. ### StaticHost macAddress (facultatif) Utilisez l'argument `macAddress` pour définir l'adresse MAC de l'hôte pour la réservation DHCP. Pour les comptes qui utilisent Cato comme serveur DHCP, l'adresse IP des hôtes définis avec une adresse MAC est réservée et ne peut pas être attribuée à un autre hôte. Assurez-vous que l'adresse IP de l'hôte n'est pas dans la plage DHCP pour un segment de réseau défini pour le site. ## removeStaticHost Utilisez l'API `removeStaticHost` pour supprimer un hôte défini pour un site. Vous devez uniquement utiliser le `hostId` avec cette API. ## Exemple de script Postman ```plaintext mutation addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {    site(accountId: $accountId) {      addStaticHost(        siteId: $siteId,        input: $input      ) {      hostId    }  } } ``` **Variables GraphQL** ```plaintext {    "accountId": "26",    "siteId": 126,    "input": {        "primaryManagementIp": "192.168.4.2",        "secondaryManagementIp": "192.168.4.3",        "vrid": 100    } } ``` **Ressources Associées** - [Utilisation de l'API de Création de Site Cato avec Postman](/v1/docs/using-the-cato-site-creation-api-with-postman) - [Scripts API de Configuration](https://support.catonetworks.com/hc/en-us/articles/8130916998429)