junipernetworks.junos.junos_netconf 模块 – 配置 Junos Netconf 系统服务

注意

此模块是 junipernetworks.junos 集合 (版本 9.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install junipernetworks.junos。

要在剧本中使用它，请指定： junipernetworks.junos.junos_netconf。

junipernetworks.junos 1.0.0 中的新增功能

概要

  • 此模块提供了一个抽象层，用于启用和配置在 Junos 设备上运行的 netconf 系统服务。此模块可用于轻松启用 Netconf API。Netconf 提供了一个编程接口，用于处理根据 RFC 6242 定义的配置和状态资源。如果任务中未提及 netconf_port，则默认情况下 netconf 将仅在 830 端口上启用。

参数

参数

注释

netconf_port

别名：listens_on

整数

此参数指定 netconf 服务应监听 SSH 连接的端口。RFC 6242 中定义的默认端口是 830。

默认值： 830

状态

字符串

指定远程设备上 junos_netconf 资源的状态。如果 state 参数设置为 present，则将配置 netconf 服务。如果 state 参数设置为 absent，则将从配置中删除 netconf 服务。

选项

  • "present" ← (默认)

  • "absent"

备注

注意

  • 已在 vSRX JUNOS 版本 15.1X49-D15.4、vqfx-10000 JUNOS 版本 15.1X53-D60.4 上进行了测试。

  • 推荐连接方式是 network_cli。请参见 Junos OS 平台选项。

  • 此模块也适用于旧版剧本的 local 连接。

  • 如果任务中未提及 netconf_port 值，则默认情况下它将仅在 830 端口上启用。尽管 netconf_port 值可以是 1 到 65535 之间的任何值，但请避免在通常分配给其他服务的端口上配置访问。此做法避免了潜在的资源冲突。

  • 有关使用 CLI 和 netconf 的信息，请参见：ref:`Junos OS 平台选项指南 <junos_platform_options>`

  • 有关使用 Ansible 管理网络设备的更多信息，请参见：ref:`Ansible 网络指南 <network_guide>`

  • 有关使用 Ansible 管理 Juniper 网络设备的更多信息，请参见 https://ansible.org.cn/ansible-juniper。

示例

- name: enable netconf service on port 830
  junipernetworks.junos.junos_netconf:
    listens_on: 830
    state: present

- name: disable netconf service
  junipernetworks.junos.junos_netconf:
    state: absent

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键

描述

commands

字符串

返回发送到远程设备的命令

返回：当 changed 为 True 时

示例： "set system services netconf ssh port 830"

作者

  • Peter Sprygada (@privateip)