▷Ansible community.zabbix.zabbix_host - Ejemplo de creación / actualización / eliminación de hosts Zabbix ✔️ Foro Ayuda 【 2024 】

Ya no busques más por otras webs ya que has llegado al lugar perfecto, poseemos la respuesta que necesitas encontrar pero sin complicarte.

Nota

Este complemento es parte del colección community.zabbix (versión 1.2.0).

Para instalarlo use: ansible-galaxy collection install community.zabbix.

Para usarlo en un libro de jugadas, especifique: community.zabbix.zabbix_host.

Sinopsis
Requisitos
Parámetros
Notas
Ejemplos de

Sinopsis

Este módulo le permite crear, modificar y eliminar entradas de host de Zabbix y grupos asociados y datos de plantilla.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

pitón> = 2.6
zabbix-api> = 0.5.4

Parámetros

Parámetro			Opciones / Valores predeterminados	Comentarios
ca_certcuerda				Emisor de certificado requerido Funciona solo con> = Zabbix 3.0 alias: tls_issuer
descripcióncuerda				Descripción del anfitrión en Zabbix.
fuerzabooleano			Opciones: no sí ←	Sobrescriba la configuración del host, incluso si ya está presente.
host_groupslista / elementos = cadena				Lista de grupos de hosts de los que forma parte el host.
nombre_hostcuerda / requerido				Nombre del anfitrión en Zabbix.nombre_host es el identificador único que se utiliza y no se puede actualizar mediante este módulo.
http_login_passwordcuerda				Contraseña de autenticación básica
http_login_usercuerda				Inicio de sesión de autenticación básica
interfaceslista / elementos = diccionario			Defecto: []	Lista de interfaces que se crearán para el host (consulte el ejemplo a continuación) .Para obtener más información, consulte la documentación de la interfaz del host enhttps://www.zabbix.com/documentation/4.0/manual/api/reference/hostinterface/object
	a granelentero		Opciones: 0 1 Defecto: 1	Ya sea para usar solicitudes SNMP masivas Solo válido cuando la interfaz tipo = ‘snmp’.0 (no use solicitudes masivas), 1 (use solicitudes masivas) Funciona solo con Zabbix <= 4.4 y se ignora silenciosamente en versiones superiores. detalles con Zabbix> = 5.0.
	detallesdiccionario		Defecto:	Detalles adicionales para las interfaces de host SNMP. tipo = ‘snmp’.Funciona solo con Zabbix> = 5.0.
		authpassphrasecuerda	Defecto: “”	Frase de contraseña de autenticación SNMPv3. securitylevel = 1(authNoPriv) o securitylevel = 2(AuthPriv).
		authprotocolentero	Opciones: 0 1 Defecto: 0	Protocolo de autenticación SNMPv3. Se utiliza cuando securitylevel = 1(authNoPriv) o securitylevel = 2(AuthPriv) .0 (MD5), 1 (SHA)
		a granelentero	Opciones: 0 1 Defecto: 1	Si usar solicitudes masivas de SNMP 0 (no use solicitudes masivas), 1 (use solicitudes masivas)
		comunidadcuerda		Cadena de comunidad SNMPv1 y SNMPv2 Requerido cuando versión = 1 o versión = 2.
		contextnamecuerda	Defecto: “”	Nombre de contexto SNMPv3.
		privpassphrasecuerda	Defecto: “”	Frase de contraseña de privacidad SNMPv3. Se usa cuando securitylevel = 2(AuthPriv).
		privprotocolentero	Opciones: 0 1 Defecto: 0	Protocolo de privacidad SNMPv3. Se utiliza cuando securitylevel = 2(authPriv) .0 (DES), 1 (AES)
		nivel de seguridadentero	Opciones: 0 1 2 Defecto: 0	Nivel de seguridad SNMPv3 0 (noAuthNoPriv), 1 (authNoPriv), 2 (authPriv).
		nombre de seguridadcuerda	Defecto: “”	Nombre de seguridad SNMPv3.
		versiónentero	Opciones: 1 2 3 Defecto: 2	Versión SNMP 1 (SNMPv1), 2 (SNMPv2c), 3 (SNMPv3)
	dnscuerda		Defecto: “”	Nombre DNS de la interfaz de host. Requerido si useip = 0.
	ipcuerda		Defecto: “”	Dirección IP utilizada por la interfaz del host. useip = 1.
	principalentero		Opciones: 0 1 Defecto: 0	Si la interfaz se usa como predeterminada.Si se proporcionan múltiples interfaces con el mismo tipo, solo una puede ser predeterminada.0 (no predeterminada), 1 (predeterminada)
	Puertocuerda			Puerto utilizado por la interfaz del host Si no se especifica, se utiliza el puerto predeterminado para cada tipo de interfaz 10050 si tipo = ‘agente’161 si tipo = ‘snmp’623 si tipo = ‘ipmi’12345 si tipo = ‘jmx’
	escribecuerda / requerido		Opciones: agente 1 snmp 2 ipmi 3 jmx 4	Tipo de interfaz para agregar También se aceptan valores numéricos para el tipo de interfaz 1 = agente2 = snmp3 = ipmi4 = jmx
	useipentero		Opciones: 0 1 Defecto: 0	Conéctese a la interfaz de host con la dirección IP en lugar del nombre DNS 0 (no use ip), 1 (use ip)
modo_inventariocuerda			Opciones: automático manual discapacitado	Configure el modo de inventario.
Inventory_zabbixdiccionario				Agregue datos para un inventario de zabbix (por ejemplo, etiqueta) (consulte el ejemplo a continuación) .Revise la documentación de la interfaz para obtener más información sobre las propiedades admitidas.https://www.zabbix.com/documentation/3.2/manual/api/reference/host/object#host_inventory
ipmi_authtypeentero				Algoritmo de autenticación de IPMI. Consulte la documentación del objeto de host para obtener más información sobre las propiedades admitidas https://www.zabbix.com/documentation/3.4/manual/api/reference/host/objectLos valores posibles son, `0` (ninguno), `1` (MD2), `2` (MD5), `4` (derecho), `5` (OEM), `6` (RMCP +), siendo -1 la API predeterminada.Tenga en cuenta que la API de Zabbix tratará la configuración ausente como predeterminada al actualizar cualquiera de las ipmi_-opciones; esto significa que si intenta configurar cualquiera de las cuatro opciones individualmente, el resto se restablecerá a los valores predeterminados.
ipmi_passwordcuerda				Contraseña de IPMI. Consulte también la última nota en el ipmi_authtype documentación
ipmi_privilegeentero				Nivel de privilegio de IPMI. Consulte la documentación del objeto de host para obtener más información sobre las propiedades admitidas https://www.zabbix.com/documentation/3.4/manual/api/reference/host/objectLos valores posibles son `1` (llamar de vuelta), `2` (usuario), `3` (operador), `4` (administración), `5` (OEM), con `2` siendo la API por defecto. También vea la última nota en el ipmi_authtype documentación
ipmi_usernamecuerda				Nombre de usuario de IPMI. También vea la última nota en el ipmi_authtype documentación
link_templateslista / elementos = cadena				Lista de plantillas vinculadas al host.
contraseña de inicio de sesióncuerda / requerido				Contraseña de usuario de Zabbix.
login_usercuerda / requerido				Nombre de usuario de Zabbix.
macroslista / elementos = diccionario				Lista de macros de usuario para asignar al host zabbix. macros =[] con fuerza = si limpiará todas las macros de usuario existentes del host. alias: user_macros
	descripcióncuerda		Defecto: “”	Descripción de la macro de usuario Funciona solo con> = Zabbix 4.4.
	macrocuerda / requerido			Nombre de la macro de usuario. Puede estar en formato nativo de zabbix “$ MACRO” o en formato corto “MACRO”.
	escribecuerda		Opciones: texto ← secreto	Tipo de macro. Funciona solo con> = Zabbix 5.0. Dado que la API no devuelve el valor para las macros secretas, no hay una forma confiable de detectar cambios en el contenido del valor de la macro secreta. Para actualizar el valor de la macro secreta, actualice la descripción junto a para que pase el cheque.
	valorcuerda / requerido			Valor de la macro de usuario.
apoderadocuerda				El nombre del proxy Zabbix que se utilizará.
server_urlcuerda / requerido				URL del servidor Zabbix, con protocolo (http o https). `url` es un alias para `server_url`. alias: url
estadocuerda			Opciones: regalo ← ausente	Estado del anfitrión. `present`, se creará si el host no existe o actualizará el host si los datos asociados son diferentes. `absent` eliminará un host si existe.
estadocuerda			Opciones: activado ← discapacitado	Monitoreo del estado del host.
etiquetaslista / elementos = diccionario				Lista de etiquetas de host para asignar al host zabbix Funciona solo con> = Zabbix 4.2. etiquetas =[] con fuerza = si limpiará todas las etiquetas del host. alias: host_tags
	etiquetacuerda / requerido			Nombre de la etiqueta de host.
	valorcuerda		Defecto: “”	Valor de la etiqueta de host.
se acabó el tiempoentero			Defecto: 10	El tiempo de espera de la solicitud de API (segundos).
tls_acceptentero			Defecto: 1	Especifica qué tipos de conexiones están permitidas para las conexiones entrantes. El parámetro tls_accept acepta valores de 1 a 7 Valores posibles, 1 (sin cifrado), 2 (PSK), 4 (certificado). Los valores se pueden combinar. Funciona solo con> = Zabbix 3.0
tls_connectentero			Defecto: 1	Especifica qué cifrado usar para las conexiones salientes. Valores posibles, 1 (sin cifrado), 2 (PSK), 4 (certificado). Funciona solo con> = Zabbix 3.0
tls_pskcuerda				El valor de PSK es una cadena de dígitos hexadecimales difícil de adivinar. La clave previamente compartida, al menos 32 dígitos hexadecimales. Requerido si cualquiera tls_connect o tls_accept tiene PSK habilitado Funciona solo con> = Zabbix 3.0
tls_psk_identitycuerda				Es un nombre único por el que los componentes de Zabbix hacen referencia a este PSK específico No coloque información confidencial en la cadena de identidad de PSK, se transmite a través de la red sin cifrar. Funciona solo con> = Zabbix 3.0
tls_subjectcuerda				Asunto del certificado requerido Funciona solo con> = Zabbix 3.0
validate_certsbooleano			Opciones: no sí ←	Si se establece en False, los certificados SSL no se validarán. Esto solo debe usarse en sitios controlados personalmente que utilicen certificados autofirmados.
nombre_visiblecuerda				Nombre visible del anfitrión en Zabbix.

Notas

Nota

Si utiliza login_password = zabbix, la palabra “zabbix” se sustituye por “****”En toda la salida del módulo, porque contraseña de inicio de sesión usos no_log. Ver estas preguntas frecuentes para más información.

Ejemplos de

-name: Create a new host or update an existing host's info
  local_action:module: community.zabbix.zabbix_host
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    visible_name: ExampleName
    description: My ExampleHost Description
    host_groups:- Example group1
      - Example group2
    link_templates:- Example template1
      - Example template2
    status: enabled
    state: present
    inventory_mode: manual
    inventory_zabbix:tag:" your_tag "alias:" your_alias "notes:"Special Informations:  default('None') "location:" your_location "site_rack:" your_site_rack "os:" your_os "hardware:" your_hardware "ipmi_authtype:2ipmi_privilege:4ipmi_username: username
    ipmi_password: password
    interfaces:-type:1main:1useip:1ip: 10.xx.xx.xx
        dns:""port:"10050"-type:4main:1useip:1ip: 10.xx.xx.xx
        dns:""port:"12345"proxy: a.zabbix.proxy
    macros:-macro:'$EXAMPLEMACRO'value: ExampleMacroValue
      -macro: EXAMPLEMACRO2
        value: ExampleMacroValue2
        description: Example desc that work only with Zabbix 4.4 and higher
    tags:-tag: ExampleHostsTag
      -tag: ExampleHostsTag2
        value: ExampleTagValue

-name: Update an existing host's TLS settings
  local_action:module: community.zabbix.zabbix_host
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    visible_name: ExampleName
    host_groups:- Example group1
    tls_psk_identity: test
    tls_connect:2tls_psk: 123456789abcdef123456789abcdef12

Autores

Ensenada (@cove)
Tony Minfei Ding (! DESCONOCIDO)
Harrison Gu (@harrisongu)
Werner Dijkerman (@ dj-wasabi)
Eike Frost (@eikef)

Si aceptas, eres capaz de dejar un escrito acerca de qué le añadirías a esta división.

¡Haz clic para puntuar esta entrada!

(Votos: 0 Promedio: 0)

Tags : Ansible Collection community.zabbix /

Ansible community.zabbix.zabbix_host – Ejemplo de creación / actualización / eliminación de hosts Zabbix