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)