Cisco Secure Firewall Threat Defense REST API ガイド

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。

マニュアルのコンテンツ

このマニュアル内で検索

ご利用いただける言語

Download Options

Book Title

Cisco Secure Firewall Threat Defense REST API ガイド

Chapter Title

設定変更の導入

PDF - Complete Book (2.58 MB) PDF - This Chapter (1.16 MB)
View with Adobe Reader on a variety of devices

検索結果

Updated:: 2019年3月19日火曜日

章のタイトル：設定変更の導入

設定変更の導入

設定変更の導入

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

手順

ステップ 1

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

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


curl -X POST --header 'Content-Type: application/json' 
--header 'Accept: application/json'
'https://ftd.example.com/api/fdm/v2/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/v2/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/v2/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/v2/operational/deploy/
62bf405f-796c-11e8-8640-a9156b92ec49"
  }
}