cisco.nxos.nxos_snmp_host 模块 – (已弃用，在 2024-01-01 之后移除) 管理 SNMP 主机配置。

注意

此模块是 cisco.nxos 集合（版本 9.2.1）的一部分。

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

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

要在 playbook 中使用它，请指定：cisco.nxos.nxos_snmp_host。

cisco.nxos 1.0.0 中的新增功能

已弃用 

参数	注释
community 字符串	团体字符串或 v3 用户名。
snmp_host 字符串 / 必需	目标主机的 IP 地址或主机名。
snmp_type 字符串	要发送到主机的消息类型。如果未指定此项，则使用陷阱类型。选择 `"trap"` `"inform"`
src_intf 字符串	源接口。必须是完全限定的接口名称。如果 state = absent，则删除该接口。
state 字符串	管理资源的状态。如果 state = present，则将主机添加到配置中。如果仅给出 vrf 和/或 vrf_filter 和/或 src_intf，它们将添加到现有主机配置中。如果 state = absent，则如果给出 community 参数，则删除主机。可以仅通过提供这些参数而不提供 community 参数来删除 vrf 和/或 src_int 和/或 vrf_filter。选择 `"present"` ←（默认） `"absent"`
udp 字符串	UDP 端口号 (0-65535)。默认值: `"162"`
v3 字符串	当版本为 v3 时使用此项。SNMPv3 安全级别。选择 `"noauth"` `"auth"` `"priv"`
version 字符串	SNMP 版本。如果未指定此项，则使用 v1。选择 `"v1"` `"v2c"` `"v3"`
vrf 字符串	用于将流量发送到源的 VRF。如果 state = absent，则删除 vrf。
vrf_filter 字符串	要过滤的 VRF 的名称。如果 state = absent，则从过滤器中删除 vrf。

注意

在 VIRL 上针对 NXOSv 7.3.(0)D1(1) 进行了测试
对 Cisco MDS 的有限支持
如果配置了 state=absent，则会删除主机配置。
有关使用 CLI 和 NX-API 的信息，请参阅：ref:`NXOS 平台选项指南 <nxos_platform_options>`
有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

# ensure snmp host is configured
- cisco.nxos.nxos_snmp_host:
    snmp_host: 192.0.2.3
    community: TESTING
    state: present

通用返回值记录在此处，以下是此模块独有的字段

键	描述
commands 列表 / 元素=字符串	发送到设备的命令已返回: 始终示例: `["snmp-server host 192.0.2.3 filter-vrf another_test_vrf"]`