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

Примечания

Примечание

Поддерживается 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 boolean	Изменился ли ресурс. Возвращается: всегда Пример: `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 boolean	Указывает, существует ли интерфейс. Возвращается: успех
gateway строка	Шлюз сетевого интерфейса. Возвращается: успех
id строка	Уникальный идентификатор интерфейса. Возвращается: успех
ip_address строка	IP-адрес интерфейса. Возвращается: успех
ip_port словарь	Порт, на котором настроен сетевой интерфейс. Возвращается: успех
id строка	Идентификатор ip_port. Возвращается: успех
ip_protocol_version строка	Версия IP-протокола. Возвращается: успех
is_disabled boolean	Указывает, отключен ли интерфейс. Возвращается: успех
is_preferred boolean	Указывает, является ли интерфейс предпочтительным. Возвращается: успех
mac_address boolean	MAC-адрес ip_port. Возвращается: успех
name boolean	Настроенное системой имя интерфейса. Возвращается: успех
nas_server словарь	Подробности сервера NAS, где настроен интерфейс. Возвращается: успех
id строка	Идентификатор сервера NAS. Возвращается: успех

Авторы

Meenakshi Dembi (@dembim)

Ссылки на сборку

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