ansible.builtin.cp_mgmt_service_dce_rpc (v2.9.17) — module

Manages service-dce-rpc objects on Check Point over Web Services API

| "added in version" 2.9 of ansible.builtin"

Authors: Or Soffer (@chkp-orso)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.17

Description

Manages service-dce-rpc objects on Check Point devices including creating, updating and removing objects.

All operations are performed over Web Services API.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: add-service-dce-rpc
  cp_mgmt_service_dce_rpc:
    interface_uuid: 97aeb460-9aea-11d5-bd16-0090272ccb30
    keep_connections_open_after_policy_installation: false
    name: New_DCE-RPC_Service_1
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: set-service-dce-rpc
  cp_mgmt_service_dce_rpc:
    color: green
    interface_uuid: 44aeb460-9aea-11d5-bd16-009027266b30
    name: New_DCE-RPC_Service_1
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: delete-service-dce-rpc
  cp_mgmt_service_dce_rpc:
    name: New_DCE-RPC_Service_2
    state: absent

Inputs

    
name:
    description:
    - Object name.
    required: true
    type: str

tags:
    description:
    - Collection of tag identifiers.
    type: list

color:
    choices:
    - aquamarine
    - black
    - blue
    - crete blue
    - burlywood
    - cyan
    - dark green
    - khaki
    - orchid
    - dark orange
    - dark sea green
    - pink
    - turquoise
    - dark blue
    - firebrick
    - brown
    - forest green
    - gold
    - dark gold
    - gray
    - dark gray
    - light green
    - lemon chiffon
    - coral
    - sea green
    - sky blue
    - magenta
    - purple
    - slate blue
    - violet red
    - navy blue
    - olive
    - orange
    - red
    - sienna
    - yellow
    description:
    - Color of the object. Should be one of existing colors.
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - State of the access rule (present or absent).
    type: str

groups:
    description:
    - Collection of group identifiers.
    type: list

version:
    description:
    - Version of checkpoint. If not given one, the latest version taken.
    type: str

comments:
    description:
    - Comments string.
    type: str

details_level:
    choices:
    - uid
    - standard
    - full
    description:
    - 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.
    type: str

ignore_errors:
    description:
    - 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.
    type: bool

wait_for_task:
    default: true
    description:
    - Wait for the task to end. Such as publish task.
    type: bool

interface_uuid:
    description:
    - Network interface UUID.
    type: str

ignore_warnings:
    description:
    - Apply changes ignoring warnings.
    type: bool

auto_publish_session:
    default: false
    description:
    - Publish the current session if changes have been performed after task completes.
    type: bool

wait_for_task_timeout:
    default: 30
    description:
    - How many minutes to wait until throwing a timeout error.
    type: int

keep_connections_open_after_policy_installation:
    description:
    - Keep connections open after policy has been installed even if they are not allowed
      under the new policy. This overrides the settings in the Connection Persistence
      page. If you change this property, the change will not affect open connections,
      but only future connections.
    type: bool

Outputs

cp_mgmt_service_dce_rpc:
  description: The checkpoint object created or updated.
  returned: always, except when deleting the object.
  type: dict