設定変更の導入

設定変更の導入

POST、PUT、および DELETE の各コールは 脅威に対する防御 デバイスを直接更新しますが、デバイスはすぐにはアクティブになりません。デバイスがトラフィック処理時に新しい設定を使用するためには、設定変更を展開する必要があります。

手順


ステップ 1

Deployment グループで POST /operational/deploy リソースを使用して、展開を開始します。

たとえば、curl コマンドは次のようになります。


curl -X POST --header 'Content-Type: application/json' 
--header 'Accept: application/json'
'https://ftd.example.com/api/fdm/[最新(latest)]/operational/deploy'

ステップ 2

応答を評価して、展開ジョブがキューに入ったことを確認します。

正常な応答(ステータス コード 200)は次のようになります。状態に注意してください。


{
  "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/[最新(latest)]/operational/deploy/
62bf405f-796c-11e8-8640-a9156b92ec49"
  }
}

(注)  

 

cliErrorMessage および name は API v2 で追加された属性で、v1 の応答には含まれていません。

ステップ 3

GET /operational/deploy/{objId} リソースを使用して、ジョブのステータスを確認します。

たとえば、curl コマンドは次のようになります。


curl -X GET --header 'Accept: application/json'
'https://ftd.example.com/api/fdm/[最新(latest)]/operational/deploy/
a7a227fb-82ab-11e7-8186-0dc471ff0672'

応答は次のようになります。状態 DEPLOYED が、ジョブが正常に完了したことを示していることに注意してください。modifiedObjects パラメータは、展開ジョブで変更されたオブジェクトを表示します。この場合、new-network という名前のネットワーク オブジェクトに対する 1 つの変更があります。


{
  "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/[最新(latest)]/operational/deploy/
62bf405f-796c-11e8-8640-a9156b92ec49"
  }
}