purestorage.flasharray.purefa_snmp_agent 模块 – 配置 FlashArray SNMP 代理

注意

此模块是 purestorage.flasharray 集合 (版本 1.32.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install purestorage.flasharray。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在剧本中使用它，请指定： purestorage.flasharray.purefa_snmp_agent。

purestorage.flasharray 1.16.0 中的新增功能

概要

  • 管理 Pure Storage FlashArray 上的 *localhost* SNMP 代理。

  • 此模块不是幂等的，并且由于无法与任务参数比较的隐藏参数，它将始终修改 SNMP 代理。

要求

在执行此模块的主机上需要以下要求。

  • python >= 3.3

  • purestorage >= 1.19

  • py-pure-client >= 1.26.0

  • netaddr

  • requests

  • pycountry

  • urllib3

参数

参数

注释

api_token

字符串

具有管理员权限用户的 FlashArray API 令牌。

auth_passphrase

字符串

仅限 SNMP v3。Purity//FA 用于使用指定的管理器对阵列进行身份验证的密码。

必须介于 8 到 63 个非空格 ASCII 字符之间。

auth_protocol

字符串

仅限 SNMP v3。要使用的加密协议

要删除隐私和身份验证协议，请将 *state* 设置为 *absent*，并将 *version* 设置为 *v3*

选项

  • "MD5"

  • "SHA"

community

字符串

仅限 SNMP v2c。Purity//FA 用于与指定的管理器通信的管理器社区 ID。

要删除字符串，请将 *state* 设置为 *absent*，并将 *version* 设置为 *v2c*

disable_warnings

布尔值

在 purestorage.flasharray 1.29.0 中添加

禁用调试日志中的不安全证书警告

选项

  • false ← (默认)

  • true

fa_url

字符串

FlashArray 管理 IPv4 地址或主机名。

privacy_passphrase

字符串

仅限 SNMP v3。用于加密 SNMP 消息的密码。必须介于 8 到 63 个非空格 ASCII 字符之间。

privacy_protocol

字符串

仅限 SNMP v3。要使用的加密协议

要删除隐私和身份验证协议，请将 *state* 设置为 *absent*，并将 *version* 设置为 *v3*

选项

  • "AES"

  • "DES"

state

字符串

用于设置或清除 SNMP v2c community 字符串或 SNMP v3 身份验证和隐私协议。

选项

  • "absent"

  • "present" ← (默认)

user

字符串

仅限 SNMP v3。用户 ID 必须介于 1 到 32 个字符之间。

version

字符串

要用于管理器的 SNMP 协议版本。

选项

  • "v2c" ← (默认)

  • "v3"

备注

注意

  • 此模块需要 purestorage 和 py-pure-client Python 库

  • 特定模块可能需要其他 Python 库。

  • 如果未将 *fa_url* 和 *api_token* 参数直接传递到模块，则必须设置 PUREFA_URL 和 PUREFA_API 环境变量

示例

- name: Clear SNMP agent v2c community string
  purestorage.flasharray.purefa_snmp_agent:
    version: v2c
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Clear SNMP agent v3 auth and privacy protocols
  purestorage.flasharray.purefa_snmp_agent:
    version: v3
    user: admin
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Update v2c SNMP agent
  purestorage.flasharray.purefa_snmp_agent:
    version: v2c
    community: public
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Update v3 SNMP manager
  purestorage.flasharray.purefa_snmp_agent:
    version: v3
    user: admin
    auth_protocol: MD5
    auth_passphrase: password
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

作者

  • Pure Storage Ansible 团队 (@sdodsley)