Модуль dellemc.unity.interface — управление интерфейсами в системе хранения Unity

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.unity. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.unity.interface.

Добавлено в dellemc.unity 1.4.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Управление интерфейсами в системе хранения Unity включает добавление интерфейсов на NAS-сервер, получение сведений об интерфейсах и удаление настроенных интерфейсов.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

Устройство хранения Dell Unity версии 5.3 или более поздней.
Ansible-core 2.17 или более поздней версии.
Python 3.11, 3.12 или 3.13.
Python SDK Storops 1.2.12.

Параметры

Параметр	Комментарии
ethernet_port_id string	Идентификатор порта Ethernet.
ethernet_port_name string	Имя порта Ethernet.
gateway string	Шлюз сетевого интерфейса.
interface_ip string / обязательный	IP-адрес сетевого интерфейса.
nas_server_id string	Идентификатор NAS-сервера, для которого будет настроен интерфейс.
nas_server_name string	Имя NAS-сервера, для которого будет настроен интерфейс.
netmask string	Маска подсети сетевого интерфейса.
password string / обязательный	Пароль сервера управления Unity.
port integer	Номер порта, через который осуществляется обмен данными с сервером управления Unity. По умолчанию: `443`
prefix_length integer	Длина префикса не может использоваться одновременно с netmask.
role string	Указывает, настроен ли интерфейс как основной или резервный. Варианты: `"PRODUCTION"` `"BACKUP"`
state string / обязательный	Указывает, должен ли интерфейс существовать. Варианты: `"present"` `"absent"`
unispherehost string / обязательный	IP-адрес или полное доменное имя сервера управления Unity.
username string / обязательный	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, указывающая, следует ли проверять SSL-сертификат. `true` — означает, что SSL-сертификат необходимо проверить. `false` — означает, что SSL-сертификат проверять не нужно. Варианты: `false` `true` ← (по умолчанию)
vlan_id integer	Идентификатор VLAN интерфейса.

Примечания

Примечание

Поддерживается check_mode.
Операция изменения интерфейса не поддерживается.
Модули этой коллекции под названием «dellemc.unity» предназначены для поддержки платформы хранения Dell Unity.

Примеры

- name: Add Interface as Backup to NAS Server
  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
  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
  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
  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 boolean	Изменился ли ресурс. Возвращается: всегда Пример: `true`
interface_details dictionary	Сведения об интерфейсе. Возвращается: если интерфейс настроен для 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 boolean	Указывает, существует ли интерфейс. Возвращается: при успешном выполнении
gateway string	Шлюз сетевого интерфейса. Возвращается: при успешном выполнении
id string	Уникальный идентификатор интерфейса. Возвращается: при успешном выполнении
ip_address string	IP-адрес интерфейса. Возвращается: при успешном выполнении
ip_port dictionary	Порт, на котором настроен сетевой интерфейс. Возвращается: при успешном выполнении
id string	Идентификатор ip_port. Возвращается: при успешном выполнении
ip_protocol_version string	Версия протокола IP. Возвращается: при успешном выполнении
is_disabled boolean	Указывает, отключен ли интерфейс. Возвращается: при успешном выполнении
is_preferred boolean	Указывает, является ли интерфейс предпочтительным. Возвращается: при успешном выполнении
mac_address boolean	MAC-адрес ip_port. Возвращается: при успешном выполнении
name boolean	Имя интерфейса, заданное системой. Возвращается: при успешном выполнении
nas_server dictionary	Сведения о NAS-сервере, на котором настроен интерфейс. Возвращается: при успешном выполнении
id string	Идентификатор NAS-сервера. Возвращается: при успешном выполнении

Авторы

Meenakshi Dembi (@dembim)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/unity/interface_module.html