Create a REST API Macro from a New Command

Procedure

Step 1

Before you create a REST API macro, test the command in Security Cloud Control's REST API Interface to make sure the command syntax is correct and it returns reliable results.

Note

You can only create macros for a device once it has been onboarded to Security Cloud Control.

Step 2

Select an FDM-managed device you want to manage using the REST API, and in Device Actions on the right, click API Tool.

Step 3

Click the REST API macro favorites star to see what macros already exist.

Step 4

Click the plus button .

Step 5

Give the macro a unique name. Provide a description and notes for the REST API macro if you wish.

Step 6

Select a Request Method and enter the endpoint URL in the Request Endpoint field. See Cisco Firepower Threat Defense REST API Guide for detailed information.

Step 7

Replace the parts of the command that you would want to modify, when you run the command, with a parameter name surrounded by curly braces.

Step 8

Click OK. The macro you create is available for use on all the devices of that type, not just the one you initially specified.

To run the command see, Run a REST API Macro.