Cisco Secure Firewall Threat Defense REST API ガイド

偏向のない言語

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

翻訳について

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

マニュアルのコンテンツ
このマニュアル内で検索

検索結果

Updated:
2024年5月23日木曜日

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

設定変更の導入

設定変更の導入

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"
  }
}

このドキュメントは役に立ちましたか?

Feedbackフィードバック

シスコに問い合わせ