community.general.oneview_network_set – Управление ресурсами набора сети HPE OneView
Примечание
Этот плагин является частью коллекции community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в playbook, укажите: community.general.oneview_network_set.
Обзор
- Предоставляет интерфейс для управления ресурсами набора сети. Может создавать, обновлять или удалять.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- hpOneView >= 4.0.0
- python >= 2.7.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| config путь | Путь к файлу конфигурации .json, содержащему конфигурацию клиента OneView. Файл конфигурации необязателен и, если используется, должен быть на хосте, на котором выполняются команды ansible. Если путь к файлу не указан, конфигурация загружается из переменных окружения. Для ссылок на примеры файлов конфигурации или на использование переменных окружения см. раздел примечаний. | |
| data строка / обязательно | Список свойств набора сети. | |
| state строка |
| Указывает желаемое состояние ресурса набора сети. - present обеспечит соответствие свойств данных спецификации OneView. - absent удалит ресурс из OneView, если он существует. |
| validate_etag логическое значение |
| При включённой валидации ETag запрос будет обработан только в том случае, если текущий ETag ресурса соответствует ETag, предоставленному в данных. |
Примечания
Примечание
- Пример файла конфигурации для параметра config можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible/blob/master/examples/oneview_config-rename.json
- Инструкции по использованию переменных окружения для конфигурации можно найти здесь: https://github.com/HewlettPackard/oneview-ansible#environment-variables
- Дополнительные playbook для модулей HPE OneView Ansible можно найти по адресу: https://github.com/HewlettPackard/oneview-ansible/tree/master/examples
- Версия API OneView, используемая непосредственно, повлияет на возвращаемые и ожидаемые поля в ресурсах. Информация о настройке нужной версии API OneView доступна по адресу: https://github.com/HewlettPackard/oneview-ansible#setting-your-oneview-version
Примеры
- name: Create a Network Set
community.general.oneview_network_set:
config: /etc/oneview/oneview_config.json
state: present
data:
name: OneViewSDK Test Network Set
networkUris:
- Test Ethernet Network_1 # can be a name
- /rest/ethernet-networks/e4360c9d-051d-4931-b2aa-7de846450dd8 # or a URI
delegate_to: localhost
- name: Update the Network Set name to 'OneViewSDK Test Network Set - Renamed' and change the associated networks
community.general.oneview_network_set:
config: /etc/oneview/oneview_config.json
state: present
data:
name: OneViewSDK Test Network Set
newName: OneViewSDK Test Network Set - Renamed
networkUris:
- Test Ethernet Network_1
delegate_to: localhost
- name: Delete the Network Set
community.general.oneview_network_set:
config: /etc/oneview/oneview_config.json
state: absent
data:
name: OneViewSDK Test Network Set - Renamed
delegate_to: localhost
- name: Update the Network set with two scopes
community.general.oneview_network_set:
config: /etc/oneview/oneview_config.json
state: present
data:
name: OneViewSDK Test Network Set
scopeUris:
- /rest/scopes/01SC123456
- /rest/scopes/02SC123456
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| network_set словарь | При состоянии 'present', но может быть пустым. | Содержит сведения о наборе сети. |
Авторы
- Felipe Bulsoni (@fgbulsoni)
- Thiago Miotto (@tmiotto)
- Adriane Cardozo (@adriane-cardozo)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/oneview_network_set_module.html