ansible.builtin.zabbix_proxy (v2.8.13) — module

Create/delete/get/update Zabbix proxies

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

Authors: Alen Komic (@akomic)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.8.13

Description

This module allows you to create, modify, get and delete Zabbix proxy entries.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create a new proxy or update an existing proxy
  local_action:
    module: zabbix_proxy
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    proxy_name: ExampleProxy
    description: ExampleProxy
    status: active
    state: present
    interface:
        type: 0
        main: 1
        useip: 1
        ip: 10.xx.xx.xx
        dns: ""
        port: 10050

Inputs

    
state:
    choices:
    - present
    - absent
    default: present
    description:
    - State of the proxy.
    - On C(present), it will create if proxy does not exist or update the proxy if the
      associated data is different.
    - On C(absent) will remove a proxy if it exists.
    required: false

status:
    choices:
    - active
    - passive
    default: active
    description:
    - Type of proxy. (4 - active, 5 - passive)
    required: false

ca_cert:
    aliases:
    - tls_issuer
    description:
    - Certificate issuer.
    required: false

tls_psk:
    description:
    - The preshared key, at least 32 hex digits. Required if either I(tls_connect) or
      I(tls_accept) has PSK enabled.
    required: false

interface:
    default: {}
    description:
    - Dictionary with params for the interface when proxy is in passive mode
    - 'Available values are: dns, ip, main, port, type and useip.'
    - Please review the interface documentation for more information on the supported
      properties
    - U(https://www.zabbix.com/documentation/3.2/manual/api/reference/proxy/object#proxy_interface)
    required: false

proxy_name:
    description:
    - Name of the proxy in Zabbix.
    required: true

tls_accept:
    choices:
    - no_encryption
    - PSK
    - certificate
    default: no_encryption
    description:
    - Connections from proxy.
    required: false

description:
    description:
    - Description of the proxy.
    required: false

tls_connect:
    choices:
    - no_encryption
    - PSK
    - certificate
    default: no_encryption
    description:
    - Connections to proxy.
    required: false

tls_subject:
    description:
    - Certificate subject.
    required: false

http_login_user:
    description:
    - Basic Auth login
    required: false
    type: str

tls_psk_identity:
    description:
    - PSK identity. Required if either I(tls_connect) or I(tls_accept) has PSK enabled.
    required: false

http_login_password:
    description:
    - Basic Auth password
    required: false
    type: str