community.vmware.vmware_content_library_manager – Создание, обновление и удаление библиотеки контента VMware

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.7.0).

Для его установки используйте: ansible-galaxy collection install community.vmware.

Для использования в книге задач укажите: community.vmware.vmware_content_library_manager.

Обзор
Требования
Параметры
Примечания
Примеры
Значения возврата

Обзор

Модуль для управления библиотекой контента VMware
Функция библиотеки контента была введена в vSphere версии 6.0, поэтому этот модуль не поддерживается в более ранних версиях vSphere.
Все переменные и имена объектов VMware чувствительны к регистру.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

python >= 2.6
PyVmomi
vSphere Automation SDK

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datastore_name строка		Имя хранилища данных, на котором создается резервная библиотека контента. Требуется только если state задано как `present`. Этот параметр игнорируется, когда state задано как `absent`. В настоящее время поддерживается только создание резервной библиотеки на основе хранилища данных. псевдонимы: datastore
hostname строка		Имя хоста или IP-адрес сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`.
library_description строка	По умолчанию: ""	Описание библиотеки контента. Требуется только если state задано как `present`. Этот параметр игнорируется, когда state задано как `absent`. Процесс обновления библиотеки контента позволяет изменять только описание.
library_name строка / обязательно		Имя библиотеки контента VMware для управления.
library_type строка	Варианты: local ← подписанная	Тип библиотеки контента. Требуется только если state задано как `present`. Этот параметр игнорируется, когда state задано как `absent`.
password строка		Пароль сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`.
protocol строка	Варианты: http https ←	Протокол подключения.
ssl_thumbprint строка добавлен в 1.7.0 community.vmware		Отпечаток SHA1 SSL подписанной библиотеки контента для подписки. Требуется только если library_type задано как `subscribed` и библиотека использует https. Этот параметр игнорируется, когда state задано как `absent`. Информация может быть извлечена с помощью openssl, используя следующий пример: `echo \| openssl s_client -connect test-library.com:443 \|& openssl x509 -fingerprint -noout`
state строка	Варианты: present ← absent	Состояние библиотеки контента. Если задано `present`, и библиотека не существует, то создается библиотека контента. Если задано `present`, и библиотека существует, то библиотека контента обновляется. Если задано `absent`, и библиотека существует, то библиотека контента удаляется. Если задано `absent`, и библиотека не существует, никаких действий не выполняется.
subscription_url строка добавлен в 1.7.0 community.vmware		URL библиотеки контента для подписки. Требуется только если library_type задано как `subscribed`. Этот параметр игнорируется, когда state задано как `absent`.
update_on_demand логическое добавлен в 1.7.0 community.vmware	Варианты: no ← yes	Загружать ли весь контент по требованию. Если задано `True`, весь контент будет загружен по требованию. Если задано `False`, контент будет загружен заранее. Требуется только если library_type задано как `subscribed`. Этот параметр игнорируется, когда state задано как `absent`.
username строка		Имя пользователя сервера vCenter vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. псевдонимы: admin, user
validate_certs логическое	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в `False`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`.

Примечания

Примечание

Проверено на vSphere 6.5, 6.7 и 7.0

Примеры

- name: Create Local Content Library
  community.vmware.vmware_content_library_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    library_name: test-content-lib
    library_description: 'Library with Datastore Backing'
    library_type: local
    datastore_name: datastore
    state: present
  delegate_to: localhost

- name: Create Subscribed Content Library
  community.vmware.vmware_content_library_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    library_name: test-content-lib
    library_description: 'Subscribed Library with Datastore Backing'
    library_type: subscribed
    datastore_name: datastore
    subscription_url: 'https://library.url'
    ssl_thumbprint: 'aa:bb:cc:dd:ee:ff:gg:hh:ii:jj:kk:ll:mm:nn:oo:pp:qq:rr:ss:tt'
    update_on_demand: true
    state: present
  delegate_to: localhost

- name: Update Content Library
  community.vmware.vmware_content_library_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    library_name: test-content-lib
    library_description: 'Library with Datastore Backing'
    state: present
  delegate_to: localhost

- name: Delete Content Library
  community.vmware.vmware_content_library_manager:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    library_name: test-content-lib
    state: absent
  delegate_to: localhost

Значения возврата

Общие значения возврата описаны в этом разделе, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
content_library_info словарь	при успехе	успешное создание библиотеки и library_id Пример: {'library_description': 'Тестовое описание', 'library_id': 'd0b92fa9-7039-4f29-8e9c-0debfcb22b72', 'library_type': 'LOCAL', 'msg': "Библиотека контента 'demo-local-lib-4' создана."}

Авторы

Pavan Bidkar (@pgbidkar)

© 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/vmware/vmware_content_library_manager_module.html