cp_mgmt_logical_server
Manages logical-server objects on Checkpoint over Web Services API through native controller HTTPAPI with owned sessions
Collection: check_point.mgmt
Full Name: check_point.mgmt.cp_mgmt_logical_server
Controller module — runs on the local controller, not on remote hosts.
Synopsis
Manages logical-server objects on Checkpoint over Web Services API through native controller HTTPAPI with owned sessions
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| auto_publish_session | bool | false | Publish this owned session explicitly after the operation; default false. | |
| balance_method | str | Load balancing method for the logical server. | ||
| color | str | Color of the object. Should be one of existing colors. | ||
| comments | str | Comments string. | ||
| details_level | str | The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed representation of the object. | ||
| ignore_errors | bool | Apply changes ignoring errors. You won’t be able to publish such a changes. If ignore-warnings flag was omitted - warnings will also be ignored. | ||
| ignore_warnings | bool | Apply changes ignoring warnings. | ||
| ip_address | str | IPv4 or IPv6 address. If both addresses are required use ipv4-address and ipv6-address fields explicitly. | ||
| ipv4_address | str | IPv4 address. | ||
| ipv6_address | str | IPv6 address. | ||
| name | str | yes | Object name. | |
| persistence_mode | bool | Indicates if persistence mode is enabled for the logical server. | ||
| persistency_type | str | Persistency type for the logical server. | ||
| server_group | str | Server group associated with the logical server.Identified by name or UID. | ||
| server_type | str | Type of server for the logical server. | ||
| state | str | present | Desired object presence. | |
| tags | list | Collection of tag identifiers. | ||
| version | str | Management API version path; omitted uses the default API version. | ||
| wait_for_task | bool | true | Wait for returned asynchronous task identifiers; default true. | |
| wait_for_task_timeout | int | 30 | Polling deadline in minutes; default 30, negative values use 30, maximum 1440. |
Example
yaml
- name: add-logical-server
check_point.mgmt.cp_mgmt_logical_server:
balance_method: domain
ip_address: 1.1.1.1
name: logicalServer1
persistence_mode: true
persistency_type: by_server
server_group: testGroup
server_type: other
state: present
- name: set-logical-server
check_point.mgmt.cp_mgmt_logical_server:
name: logicalServer1
server_type: http
state: present
- name: delete-logical-server
check_point.mgmt.cp_mgmt_logical_server:
name: logicalServer1
state: absent