GET /api/hosts/:host_id/interfaces
Afficher toutes les interfaces d'un hôte

GET /api/domains/:domain_id/interfaces
Afficher toutes les interfaces par domaine

GET /api/subnets/:subnet_id/interfaces
Afficher toutes les interfaces par sous-réseau

Params

Param Name Description
host_id
Required

ID ou nom d'hôte

Validations:

  • Must be String

domain_id
Optional

ID du nom de domaine

Validations:

  • Must be String

subnet_id
Optional

ID ou nom du sous réseau

Validations:

  • Must be String

page
Optional

paginer les résultats

Validations:

  • Must be String

per_page
Optional

nombre d'entier par requête

Validations:

  • Must be String


GET /api/hosts/:host_id/interfaces/:id
Afficher une interface d'un hôte

Params

Param Name Description
host_id
Required

ID ou nom d'hôte

Validations:

  • Must be String

id
Required

ID ou nom de l'interface

Validations:

  • Must be String


POST /api/hosts/:host_id/interfaces
Créer une interface sur un hôte

Params

Param Name Description
host_id
Required

ID ou nom d'hôte

Validations:

  • Must be String

interface
Required

information de l'interface

Validations:

  • Must be a Hash

interface[mac]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Adresse MAC de l'interface. Requis pour les interfaces gérées des hôtes physiques.

Validations:

  • Must be String

interface[ip]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

interface de l'adresse IPv4

Validations:

  • Must be String

interface[ip6]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

interface de l'adresse IPv6

Validations:

  • Must be String

interface[type]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Type d'interface , p.e. bmc. Valeur par défaut interface

Validations:

  • Must be one of: interface, bmc, bond, bridge.

interface[name]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Nom DNS de l'interface

Validations:

  • Must be String

interface[subnet_id]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Foreman subnet ID of IPv4 interface

Validations:

  • Must be Fixnum

interface[subnet6_id]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Foreman subnet ID of IPv6 interface

Validations:

  • Must be Fixnum

interface[domain_id]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Domaine ID Foreman de l'interface. Requis pour les interfaces primaires des hôtes gérés.

Validations:

  • Must be Fixnum

interface[identifier]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Identifiant du périphérique. Ex : eth0 ou eth1.1

Validations:

  • Must be String

interface[managed]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Cette interface doit-elle être gérée par les smart proxies DHCP et DNS et être configurée pendant le provisioning ?

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[primary]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Cette interface doit-elle être utilisée pour choisir le FQDN de l'hôte ? Chaque hôte géré doit avoir une interface primaire.

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[provision]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Cette interface doit-elle être utilisée pour les communications TFTP et PXE (ou SSH pour les images d'hôtes) ? Chaque hôte géré doit avoir une interface de provisioning.

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[username]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Seulement pour les interfaces BMC.

Validations:

  • Must be String

interface[password]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Seulement pour les interfaces BMC.

Validations:

  • Must be String

interface[provider]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Fournisseur de l'interface. Ex. IPMI. Seulement pour les interfaces BMC.

Validations:

  • Must be one of: IPMI.

interface[virtual]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Périphérique Alias ou VLAN

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[tag]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Tag VLAN. Cet attribut a précédence sur l'ID VLAN du sous-réseau. Seulement pour les interfaces virtuelles.

Validations:

  • Must be String

interface[attached_to]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Identifiant de l'interface auquel est rattachée cette interface. Ex. eth1. Seulement pour les interfaces virtuelles.

Validations:

  • Must be String

interface[mode]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Mode d'agrégat de l'interface. Par exemple balance-rr. Seulement pour les interfaces bond.

Validations:

  • Must be one of: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb.

interface[attached_devices]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Identifiants des interfaces rattachées. Par ex. ['eth0', 'eth1']. Pour les interfaces bond, il s'agit des esclaves. Seulement pour les interfaces de type bond ou bridge.

Validations:

  • Must be an array of any type

interface[bond_options]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Options séparées par des espaces. Ex : miimon=100. Seulement pour les interfaces bond.

Validations:

  • Must be String

interface[compute_attributes]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Autres attributs pour la ressource de calcul spécifiques à cet interface.

Validations:

  • Must be Hash


PUT /api/hosts/:host_id/interfaces/:id
Mise à jour d'une interface d'un hôte

Params

Param Name Description
host_id
Required

ID ou nom d'hôte

Validations:

  • Must be String

id
Required

ID de l'interface

Validations:

  • Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

interface
Required

information de l'interface

Validations:

  • Must be a Hash

interface[mac]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Adresse MAC de l'interface. Requis pour les interfaces gérées des hôtes physiques.

Validations:

  • Must be String

interface[ip]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

interface de l'adresse IPv4

Validations:

  • Must be String

interface[ip6]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

interface de l'adresse IPv6

Validations:

  • Must be String

interface[type]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Type d'interface , p.e. bmc. Valeur par défaut interface

Validations:

  • Must be one of: interface, bmc, bond, bridge.

interface[name]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Nom DNS de l'interface

Validations:

  • Must be String

interface[subnet_id]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Foreman subnet ID of IPv4 interface

Validations:

  • Must be Fixnum

interface[subnet6_id]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Foreman subnet ID of IPv6 interface

Validations:

  • Must be Fixnum

interface[domain_id]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Domaine ID Foreman de l'interface. Requis pour les interfaces primaires des hôtes gérés.

Validations:

  • Must be Fixnum

interface[identifier]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Identifiant du périphérique. Ex : eth0 ou eth1.1

Validations:

  • Must be String

interface[managed]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Cette interface doit-elle être gérée par les smart proxies DHCP et DNS et être configurée pendant le provisioning ?

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[primary]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Cette interface doit-elle être utilisée pour choisir le FQDN de l'hôte ? Chaque hôte géré doit avoir une interface primaire.

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[provision]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Cette interface doit-elle être utilisée pour les communications TFTP et PXE (ou SSH pour les images d'hôtes) ? Chaque hôte géré doit avoir une interface de provisioning.

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[username]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Seulement pour les interfaces BMC.

Validations:

  • Must be String

interface[password]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Seulement pour les interfaces BMC.

Validations:

  • Must be String

interface[provider]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Fournisseur de l'interface. Ex. IPMI. Seulement pour les interfaces BMC.

Validations:

  • Must be one of: IPMI.

interface[virtual]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Périphérique Alias ou VLAN

Validations:

  • Must be 'true' or 'false' or '1' or '0'

interface[tag]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Tag VLAN. Cet attribut a précédence sur l'ID VLAN du sous-réseau. Seulement pour les interfaces virtuelles.

Validations:

  • Must be String

interface[attached_to]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Identifiant de l'interface auquel est rattachée cette interface. Ex. eth1. Seulement pour les interfaces virtuelles.

Validations:

  • Must be String

interface[mode]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Mode d'agrégat de l'interface. Par exemple balance-rr. Seulement pour les interfaces bond.

Validations:

  • Must be one of: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb.

interface[attached_devices]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Identifiants des interfaces rattachées. Par ex. ['eth0', 'eth1']. Pour les interfaces bond, il s'agit des esclaves. Seulement pour les interfaces de type bond ou bridge.

Validations:

  • Must be an array of any type

interface[bond_options]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Options séparées par des espaces. Ex : miimon=100. Seulement pour les interfaces bond.

Validations:

  • Must be String

interface[compute_attributes]
Optional , <span class="translation_missing" title="translation missing: fr.apipie.nil_allowed">Nil Allowed</span>

Autres attributs pour la ressource de calcul spécifiques à cet interface.

Validations:

  • Must be Hash


DELETE /api/hosts/:host_id/interfaces/:id
Supprimer une interface d'hôte

Params

Param Name Description
host_id
Required

ID ou nom d'hôte

Validations:

  • Must be String

id
Required

ID de l'interface

Validations:

  • Must be String