Gestion des VLAN

Lors de la souscription d’un service L2, un VLAN doit être attribué au service. Vous pouvez le pré-définir dès le devis ou le choisir pendant le processus d’activation du contrat de service.

Principe

Chaque service L2 se voit attribuer un VLAN sur la porte de livraison (delivery door) choisie. Le VLAN peut être défini à deux moments :

  1. Au moment du devis — en précisant le VLAN souhaité sur la section du devis, avant signature.
  2. Pendant l’activation — lorsque le contrat de service est en cours d’activation, le workflow vous demande de choisir un VLAN.

Dans les deux cas, le système vérifie que le VLAN demandé est disponible sur le groupe de VLANs associé à la porte de livraison.

Pré-définir le VLAN sur un devis

Une fois votre devis créé, vous pouvez définir le VLAN souhaité sur une section via la route POST /commercial_offer_sections/{id}/attributes.

Le body accepte les attributs suivants, qui peuvent être utilisés ensemble dans le même appel :

Attribut Type Description
delivery_door_sc_id integer Identifiant du contrat de service de la porte de livraison
vlan_requested integer Identifiant du VLAN souhaité (vid)

Exemple avec curl

curl --location --request POST "${url_api}/external-api/v2/commercial_offer_sections/123/attributes" \
  --header "Authorization: Token ${token}" \
  --header "Content-Type: application/json" \
  --data '{
    "delivery_door_sc_id": 456,
    "vlan_requested": 100
  }'

La section du devis ne doit pas encore avoir été souscrite (pas de contrat de service associé). Si le devis a déjà été signé et souscrit, il faut utiliser la route de sélection de VLAN sur le contrat de service (voir ci-dessous).

Choisir le VLAN pendant l’activation d’un contrat de service

Pendant le processus d’activation d’un service L2, le workflow peut vous demander de sélectionner un VLAN. Vous pouvez le faire via la route POST /service_contracts/{id}/vlan.

Exemple avec curl

curl --location --request POST "${url_api}/external-api/v2/service_contracts/789/vlan" \
  --header "Authorization: Token ${token}" \
  --header "Content-Type: application/json" \
  --data '{
    "vid": 100
  }'

Réponse

{
    "id": 789,
    "success": true,
    "lastLog": "vlan pre-defined"
}

Erreurs possibles

Code Message Cause
400 only on l2 Le contrat de service n’est pas de type L2
400 no vlan action required for service pack Aucun workflow d’activation en cours ne nécessite un choix de VLAN
400 vlan action is no longer required for service pack Le choix du VLAN a déjà été effectué

Modes de sélection

Le système supporte plusieurs modes de sélection de VLAN selon la configuration du service :

Mode Description
predefined Le VLAN a été pré-défini par le client (via le devis ou l’API)
client Le client choisit le VLAN pendant l’activation
auto Le système attribue automatiquement un VLAN disponible
noc Le NOC (centre d’opérations réseau) attribue le VLAN manuellement

Le mode de sélection est défini sur la porte de collecte au moment de sa création et peut être modifié sur demande auprès de nos équipes. Si vous pré-définissez un VLAN via l’API (sur le devis ou sur le contrat de service), le mode predefined est automatiquement appliqué.