Actions38
- APM Actions
- ASM Actions
- Authentication Actions
- LTM Actions
- System Actions
ASM → Merge Policies
AI-generatedSummary
Starts an ASM policy-merge task on a BIG-IP by POSTing to /mgmt/tm/asm/tasks/policy-merge, merging differences from an existing policy-diff result into the compared policies.
Inputs
- policyDiffLink (required) — Self-link of a policy-diff task result (e.g. /mgmt/tm/asm/policy-diffs/example), such as one produced by the Diff Policies operation. Sent as policyDiffReference: {"link": value}.
- mergeOptions.addMissingEntitiesToFirst — Boolean, sent as addMissingEntitiesToFirst. Whether entities found only in the second policy are added to the first. Defaults to true in the UI.
- mergeOptions.addMissingEntitiesToSecond — Boolean, sent as addMissingEntitiesToSecond. Whether entities found only in the first policy are added to the second. Defaults to true in the UI.
- mergeOptions.handleCommonEntities — How entities present in both policies are handled: Ignore (default), Merge, or Override. Sent as handleCommonEntities.
- requestOptions — Node-level HTTP settings: batching (items per batch, interval), ignore SSL issues, proxy, and timeout (default 10000 ms).
Output shape
The JSON response from the BIG-IP for the policy-merge task creation request, one result per input item.
The source declares no post-processing, so the response is returned as the API sends it. ASM tasks usually run asynchronously, so the response is likely a task record rather than the final result. Note that the Check Task Status operation's task type list does not include policy-merge. Options left unset are not sent, so the BIG-IP applies its own defaults, which may differ from the UI defaults shown.
Examples
Example 1: Merge a policy-diff result into both policies, combining entries they share.
Policy Diff Reference Link = /mgmt/tm/asm/policy-diffs/abc123; Merge Options: Handle Common Entities = Merge, both Add Missing Entities options true.
Example 2: Copy only missing entities into the first policy, leaving the second unchanged.
Policy Diff Reference Link = link from the Diff Policies output; Add Missing Entities To Second Policy = false; Handle Common Entities = Ignore.