dellemc.unity.interface 模块 – 管理 Unity 存储系统上的接口

注意

此模块是 dellemc.unity 集合（版本 2.0.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install dellemc.unity。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在 Playbook 中使用它，请指定：dellemc.unity.interface。

dellemc.unity 1.4.0 中的新增功能

概要 

管理 Unity 存储系统上的接口包括将接口添加到 NAS 服务器、获取接口的详细信息以及删除配置的接口。

要求 

执行此模块的主机需要满足以下要求。

Dell Unity 存储设备版本 5.1 或更高版本。
Ansible-core 2.14 或更高版本。
Python 3.9、3.10 或 3.11。
Storops Python SDK 1.2.11。

参数 

参数	注释
ethernet_port_id 字符串	以太网端口的 ID。
ethernet_port_name 字符串	以太网端口的名称。
gateway 字符串	网络接口的网关。
interface_ip 字符串 / 必需	网络接口的 IP。
nas_server_id 字符串	将配置接口的 NAS 服务器的 ID。
nas_server_name 字符串	将配置接口的 NAS 服务器的名称。
netmask 字符串	网络接口的子网掩码。
password 字符串 / 必需	Unity 管理服务器的密码。
port 整数	通过该端口号与 Unity 管理服务器进行通信。默认值： `443`
prefix_length 整数	前缀长度与 netmask 互斥。
role 字符串	指示接口是配置为生产还是备份。选项 `"PRODUCTION"` `"BACKUP"`
state 字符串 / 必需	定义接口是否应该存在。选项 `"present"` `"absent"`
unispherehost 字符串 / 必需	Unity 管理服务器的 IP 或 FQDN。
username 字符串 / 必需	Unity 管理服务器的用户名。
validate_certs 别名：verifycert 布尔值	布尔变量，用于指定是否验证 SSL 证书。 `true` - 表示应验证 SSL 证书。 `false` - 表示不应验证 SSL 证书。选项 `false` `true` ← (默认)
vlan_id 整数	接口的 Vlan ID。

注释 

注意

支持 check_mode。
不支持接口的修改操作。
此集合中名为“dellemc.unity”的模块旨在支持 Dell Unity 存储平台。

示例 

- name: Add Interface as Backup to NAS Server
  dellemc.unity.interface:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    ethernet_port_name: "SP A 4-Port Card Ethernet Port 0"
    role: "BACKUP"
    interface_ip: "xx.xx.xx.xx"
    netmask: "xx.xx.xx.xx"
    gateway: "xx.xx.xx.xx"
    vlan_id: 324
    state: "present"

- name: Add Interface as Production to NAS Server
  dellemc.unity.interface:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    ethernet_port_name: "SP A 4-Port Card Ethernet Port 0"
    role: "PRODUCTION"
    interface_ip: "xx.xx.xx.xx"
    netmask: "xx.xx.xx.xx"
    gateway: "xx.xx.xx.xx"
    vlan_id: 324
    state: "present"

- name: Get interface details
  dellemc.unity.interface:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    interface_ip: "xx.xx.xx.xx"
    state: "present"

- name: Delete Interface
  dellemc.unity.interface:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    interface_ip: "xx.xx.xx.xx"
    state: "absent"

返回值 

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

键	描述
changed 布尔值	资源是否已更改。返回：始终示例： `true`
interface_details 字典	接口的详细信息。返回：当为 NAS 服务器配置接口时。示例： {"existed": true, "gateway": "xx.xx.xx.xx", "hash": 8785300560421, "health": {"UnityHealth": {"hash": 8785300565468}}, "id": "if_69", "ip_address": "10.10.10.10", "ip_port": {"UnityIpPort": {"hash": 8785300565300, "id": "spb_ocp_0_eth0"}}, "ip_protocol_version": "IpProtocolVersionEnum.IPv4", "is_disabled": false, "is_preferred": true, "mac_address": "0C:48:C6:9F:57:BF", "name": "36_APM00213404194", "nas_server": {"UnityNasServer": {"hash": 8785300565417, "id": "nas_10"}}, "netmask": "10.10.10.10", "replication_policy": null, "role": "FileInterfaceRoleEnum.PRODUCTION", "source_parameters": null, "v6_prefix_length": null, "vlan_id": 324}
existed 布尔值	指示接口是否存在。返回: 成功
gateway 字符串	网络接口的网关。返回: 成功
id 字符串	唯一标识符接口。返回: 成功
ip_address 字符串	接口的 IP 地址。返回: 成功
ip_port 字典	网络接口配置所在的端口。返回: 成功
id 字符串	ip_port 的 ID。返回: 成功
ip_protocol_version 字符串	IP 协议版本。返回: 成功
is_disabled 布尔值	指示接口是否被禁用。返回: 成功
is_preferred 布尔值	指示接口是否为首选。返回: 成功
mac_address 布尔值	ip_port 的 MAC 地址。返回: 成功
name 布尔值	系统配置的接口名称。返回: 成功
nas_server 字典	配置接口的 NAS 服务器的详细信息。返回: 成功
id 字符串	NAS 服务器的 ID。返回: 成功

作者

Meenakshi Dembi (@dembim)