Déploiement des modifications de configuration

Déploiement des modifications de configuration

Bien que les appels POST, PUT et DELETE mettent directement à jour le dispositif Défense contre les menaces, ils ne sont pas actifs immédiatement. Vous devez déployer les modifications de configuration avant que le dispositif utilise vos nouveaux paramètres lors du traitement du trafic.

Procédure


Étape 1

Utilisez la ressource POST /operational/deploy dans le groupe Deployment (Déploiement) pour lancer un déploiement.

Par exemple, la commande curl ressemblerait à ce qui suit :


curl -X POST --header 'Content-Type: application/json' 
--header 'Accept: application/json'
'https://ftd.example.com/api/fdm/dernière version/operational/deploy'

Étape 2

Évaluez la réponse pour vérifier que la tâche de déploiement a été mise en attente.

Une bonne réponse (code d’état 200) ressemble à ce qui suit. Notez l’état.


{
  "id": "62bf405f-796c-11e8-8640-a9156b92ec49",
  "statusMessage": null,
  "statusMessages": null,
  "modifiedObjects": {},
  "cliErrorMessage": null,
  "queuedTime": 1530036705491,
  "startTime": -1,
  "endTime": -1,
  "state": "QUEUED",
  "name": "User (admin) Triggered Deployment",
  "links": {
    "self": "https://ftd.example.com/api/fdm/dernière version/operational/deploy/
62bf405f-796c-11e8-8640-a9156b92ec49"
  }
}

Remarque

 

Les attributs cliErrorMessage (messageD’ErreurDuClient) et name (nom) ont été ajoutés dans la v2 de l’API; ils ne sont pas inclus dans les réponses de la v1.

Étape 3

Utilisez la ressource GET /operational/deploy/{objId} pour vérifier l’état de la tâche.

Par exemple, la commande curl ressemblerait à ce qui suit :


curl -X GET --header 'Accept: application/json'
'https://ftd.example.com/api/fdm/dernière version/operational/deploy/
a7a227fb-82ab-11e7-8186-0dc471ff0672'

La réponse pourrait ressembler à ce qui suit. Notez que l’état, DEPLOYED (DÉPLOYÉ), indique que la tâche s’est terminée avec succès. Le paramètre modifiedObjects (objetsModifiés) répertorie les objets qui ont été modifiés dans la tâche de déploiement. Dans ce cas, il y a une seule modification, apportée à un objet réseau nommé new-network (nouveau-réseau).


{
  "id": "62bf405f-796c-11e8-8640-a9156b92ec49",
  "statusMessage": "Deployed Successfully",
  "statusMessages": [
    "Deployed Successfully"
  ],
  "modifiedObjects": {
    "NetworkObject": [
      "new-network"
    ]
  },
  "cliErrorMessage": null,
  "queuedTime": 1530036705491,
  "startTime": 1530036705924,
  "endTime": 1530036822612,
  "state": "DEPLOYED",
  "name": "User (admin) Triggered Deployment",
  "links": {
    "self": "https://ftd.example.com/api/fdm/dernière version/operational/deploy/
62bf405f-796c-11e8-8640-a9156b92ec49"
  }
}