netapp_eseries.santricity.na_santricity_iscsi_interface 模块 – NetApp E 系列管理 iSCSI 接口配置
注意
此模块是 netapp_eseries.santricity 集合 (版本 1.4.1) 的一部分。
如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install netapp_eseries.santricity。
要在 playbook 中使用它，请指定： netapp_eseries.santricity.na_santricity_iscsi_interface。
概要
配置 E 系列 iSCSI 接口的设置
参数
参数 |
注释 |
|---|---|
要分配给接口的 IPv4 地址。 应以 xx.xx.xx.xx 的形式指定。 与 config_method=dhcp 互斥 |
|
用于向 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。 |
|
SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。 |
|
用于向 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。 |
|
要为此接口使用的配置方法类型。 dhcp 与 address、subnet_mask 和 gateway 互斥。 选项
|
|
拥有要配置的端口的控制器。 控制器名称按字母顺序排列，第一个控制器为 A，第二个为 B，依此类推。 当前硬件型号有 1 个或 2 个可用控制器，但这并非严格的限制，将来可能会更改。 选项
|
|
要用于接口的 IPv4 网关地址。 应以 xx.xx.xx.xx 的形式指定。 与 config_method=dhcp 互斥 |
|
最大传输单元 (MTU)，以字节为单位。 这允许您配置更大的 MTU 值，以启用巨型帧（任何值 > 1500）。 通常，您的主机、交换机和其他组件不仅需要支持巨型帧，还需要正确配置它。因此，除非您知道自己在做什么，否则最好将其保留为默认值。 默认值： |
|
要修改的控制器 iSCSI 底板或 HIC 端口。 从 1 开始计数控制器的 iSCSI 端口（从左到右），确定端口。先数底板端口，然后数 HIC 端口。 |
|
此选项将更改接口端口速度。 仅支持已接受的速度，并且必须采用 [0-9]+[gm] 的形式（即 25g）。 在将下行接口设置为已接受的网络速度之前，它们将报告为未知速度。 当端口的速度自动配置时，请勿使用此选项，否则它将失败。有关端口的功能，请参阅系统管理器。 |
|
要管理的阵列的 ID。此值对于每个阵列必须唯一。 默认值： |
|
启用时，将使用提供的配置。 禁用时，将清除 IPv4 配置并禁用 IPv4 连接。 选项
|
|
要用于接口的子网掩码。 应以 xx.xx.xx.xx 的形式指定。 与 config_method=dhcp 互斥 |
|
是否应验证 https 证书？ 选项
|
备注
注意
支持检查模式。
接口设置是同步应用的，但接口本身的更改（通过 dhcp 接收新的 IP 地址等）可能需要几秒钟或几分钟才能生效。
如果没有任何 iSCSI 接口，此模块在 E 系列系统上将无用/不可用。
此模块需要 Web Services API 版本 >= 1.3。
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
na_santricity_iscsi_interface:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
port: "1"
controller: "A"
config_method: static
address: "192.168.1.100"
subnet_mask: "255.255.255.0"
gateway: "192.168.1.1"
speed: "25g"
- name: Disable ipv4 connectivity for the second port on the B controller
na_santricity_iscsi_interface:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
port: "2"
controller: "B"
state: disabled
- name: Enable jumbo frames for the first 4 ports on controller A
na_santricity_iscsi_interface:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
port: "{{ item }}"
controller: "A"
state: enabled
mtu: 9000
config_method: dhcp
loop:
- 1
- 2
- 3
- 4
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段：
键 |
描述 |
|---|---|
成功消息 返回：成功时 示例： |