netapp_eseries.santricity.netapp_e_mgmt_interface 模块 – NetApp E 系列管理接口配置

注意

此模块是 netapp_eseries.santricity 集合（版本 1.4.1）的一部分。

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

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

要在 playbook 中使用它，请指定：netapp_eseries.santricity.netapp_e_mgmt_interface。

netapp_eseries.santricity 2.7.0 中的新功能

概要

• 配置 E 系列管理接口

参数

参数	注释
address 字符串	要分配给接口的 IPv4 地址。 应以 xx.xx.xx.xx 形式指定。 与 *config_method=dhcp* 互斥
api_password 字符串 / 必需	使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。
api_url 字符串 / 必需	SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。示例 https://prod-1.wahoo.acme.com/devmgr/v2
api_username 字符串 / 必需	使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。
channel 整数	要修改配置的端口。 通道表示端口号（通常从控制器上从左到右），从值 1 开始。 与 *name* 互斥。
config_method 字符串	用于网络接口端口的配置方法类型。 dhcp 与 *address*、*subnet_mask* 和 *gateway* 互斥。 选项 "dhcp" "static"
controller 字符串 / 必需	拥有要配置的端口的控制器。 控制器名称以字母表示，第一个控制器为 A，第二个为 B，依此类推。 当前的硬件型号具有 1 个或 2 个可用控制器，但这并不是一个有保证的硬性限制，未来可能会更改。 选项 "A" "B"
dns_address 字符串	主 IPv4 DNS 服务器地址
dns_address_backup 字符串	备用 IPv4 DNS 服务器地址 在主 DNS 服务器发生故障时查询
dns_config_method 字符串	用于 DNS 服务的配置方法类型。 dhcp 与 *dns_address* 和 *dns_address_backup* 互斥。 选项 "dhcp" "static"
gateway 字符串	用于接口的 IPv4 网关地址。 应以 xx.xx.xx.xx 形式指定。 与 *config_method=dhcp* 互斥
log_path 字符串	用于调试日志的本地文件路径
name 别名：port, iface 字符串	要修改配置的端口。 选项列表不一定全面。它取决于系统中存在的端口数量。 名称表示端口号（通常从控制器上从左到右），从值 1 开始。 与 *channel* 互斥。
ntp_address 字符串	主 IPv4 NTP 服务器地址
ntp_address_backup 字符串	备用 IPv4 NTP 服务器地址 在主 NTP 服务器发生故障时查询
ntp_config_method 字符串	用于 NTP 服务的配置方法类型。 disable 与 *ntp_address* 和 *ntp_address_backup* 互斥。 dhcp 与 *ntp_address* 和 *ntp_address_backup* 互斥。 选项 "disable" "dhcp" "static"
ssh 布尔值	启用对控制器的 ssh 访问以进行调试。 这是一个控制器级设置。 对于无法使用 ssh 的旧设备，将启用 rlogin/telnet。 选项 false true
ssid 字符串	要管理的阵列的 ID。此值对于每个阵列都必须是唯一的。 默认： "1"
state 别名：enable_interface 字符串	启用或禁用 IPv4 网络接口配置。 必须启用 IPv4 或 IPv6，否则会发生错误。 仅在启用或禁用 IPv4 网络接口时需要 选项 "enable" "disable"
subnet_mask 字符串	用于接口的子网掩码。 应以 xx.xx.xx.xx 形式指定。 与 *config_method=dhcp* 互斥
validate_certs 布尔值	是否应验证 https 证书？ 选项 false true ← (默认)

注意事项

注意

• 支持检查模式。

• 接口设置是同步应用的，但是对接口本身（通过 dhcp 接收新的 IP 地址等）的更改可能需要几秒钟或几分钟才能生效。

• 已知问题：专门对关闭端口的更改将导致失败。但是，这在即将推出的 NetApp E 系列固件版本（在固件版本 11.40.2 之后发布）中可能不是这种情况。

• E 系列 Ansible 模块需要 Web Services Proxy (WSP) 的实例才能管理存储系统，或者需要支持嵌入式 Web Services API 的 E 系列存储系统。

• 嵌入式 Web Services 目前在 E2800、E5700、EF570 和更新的硬件型号上可用。

• netapp_eseries.santricity.netapp_e_storage_system 可用于配置由 WSP 实例管理的系统。

示例

- name: Configure the first port on the A controller with a static IPv4 address
  netapp_e_mgmt_interface:
    channel: 1
    controller: "A"
    config_method: static
    address: "192.168.1.100"
    subnet_mask: "255.255.255.0"
    gateway: "192.168.1.1"
    ssid: "1"
    api_url: "10.1.1.1:8443"
    api_username: "admin"
    api_password: "myPass"

- name: Disable ipv4 connectivity for the second port on the B controller
  netapp_e_mgmt_interface:
    channel: 2
    controller: "B"
    enable_interface: no
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"

- name: Enable ssh access for ports one and two on controller A
  netapp_e_mgmt_interface:
    channel: "{{ item }}"
    controller: "A"
    ssh: yes
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
  loop:
    - 1
    - 2

- name: Configure static DNS settings for the first port on controller A
  netapp_e_mgmt_interface:
    channel: 1
    controller: "A"
    dns_config_method: static
    dns_address: "192.168.1.100"
    dns_address_backup: "192.168.1.1"
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"

- name: Configure static NTP settings for ports one and two on controller B
  netapp_e_mgmt_interface:
    channel: "{{ item }}"
    controller: "B"
    ntp_config_method: static
    ntp_address: "129.100.1.100"
    ntp_address_backup: "127.100.1.1"
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
  loop:
    - 1
    - 2

返回值

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

键	描述
enabled 布尔值	指示IPv4连接是否已启用或禁用。 这不一定表示已连接。例如，如果启用了dhcp但没有dhcp服务器，则该配置实际上不太可能有效。 返回: 成功时 示例: true
msg 字符串	成功消息 返回: 成功时 示例: "接口设置已更新。"

作者

• Michael Price (@lmprice)

• Nathan Swartz (@ndswartz)

集合链接

• 问题跟踪器
• 仓库 (源代码)