BIG-IP F5 icon

BIG-IP F5

Interact with F5 BIG-IP via the iControl REST API

Actions38

ASM → Import Policy

AI-generated

Summary

Starts an ASM import-policy background task on a BIG-IP by POSTing to /mgmt/tm/asm/tasks/import-policy, restoring a WAF policy from a policy history revision into an existing policy or a new one.

Inputs

  • Policy Reference Link — Self-link of the target ASM policy to import into. Sent as policyReference {link}. If empty, the field is omitted and a new policy is created.
  • Policy History Reference Link — Self-link of the policy revision (history entry) to restore. Sent as policyHistoryReference {link}; omitted if empty.
  • Request Options — Node-level settings: batching (items per batch, interval in ms), ignore SSL issues, proxy URL, and request timeout in ms (default 10000).

Output shape

The JSON response from the BIG-IP for the created import-policy task, one result per input item.

The import runs as an asynchronous background task. The source does not post-process the response. To poll for completion, use the Check Task Status operation with task type import-policy and the task ID from the response. Neither link is marked required, so an empty request body is possible.

Examples

Example 1: Roll back an existing WAF policy to an earlier revision

Set Policy Reference Link to the policy's self-link and Policy History Reference Link to the revision's self-link.

Example 2: Create a new policy from a history revision

Leave Policy Reference Link empty and set Policy History Reference Link to the revision self-link.

Example 3: Import against a BIG-IP with a self-signed certificate

Fill in the link fields and enable Ignore SSL Issues (Insecure) under Request Options.

Links

Discussion