Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию community.vmware (версия 4.7.1).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

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

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

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

Обзор

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

Требования

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

  • vSphere Automation SDK
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

datastore_name

псевдонимы: datastore

строка

Имя хранилища данных, на котором создаётся резервное хранилище контента.

Это необходимо, если state=present.

Этот параметр игнорируется, когда state=absent.

В настоящее время поддерживается только создание резервного хранилища данных.

hostname

строка

Имя хоста или IP-адрес сервера vCenter vSphere.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST.

library_description

строка

Описание хранилища контента.

Требуется только, если state=present.

Этот параметр игнорируется, когда state=absent.

Процесс обновления хранилища контента позволяет изменять только описание.

library_name

строка / обязательно

Имя хранилища контента VMware для управления.

library_type

строка

Тип хранилища контента.

Требуется только, если state=resent.

Этот параметр игнорируется, когда state=absent.

Варианты:

  • "local" ← (по умолчанию)
  • "subscribed"

password

псевдонимы: pass, pwd

строка

Пароль сервера vCenter vSphere.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD.

port

целое число

Номер порта vCenter vSphere.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT.

По умолчанию: 443

protocol

строка

Протокол подключения.

Варианты:

  • "http"
  • "https" ← (по умолчанию)

proxy_host

строка

Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их.

Формат — имя хоста или IP-адрес.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_HOST.

proxy_port

целое число

Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_PORT.

ssl_thumbprint

строка

Отпечаток SHA1 SSL подписанного хранилища контента для подписки.

Требуется, если library_type=subscribed и хранилище https.

Этот параметр игнорируется, когда state=absent.

Информацию можно извлечь с помощью openssl, используя следующий пример: echo | openssl s_client -connect test-library.com:443 |& openssl x509 -fingerprint -noout

По умолчанию: ""

state

строка

Состояние хранилища контента.

Если установлено значение present, и хранилище не существует, то хранилище контента создаётся.

Если установлено значение present, и хранилище существует, то хранилище контента обновляется.

Если установлено значение absent, и хранилище существует, то хранилище контента удаляется.

Если установлено значение absent, и хранилище не существует, то действия не выполняются.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

subscription_url

строка

URL хранилища контента для подписки.

Требуется, если library_type=subscribed.

Этот параметр игнорируется, когда state=absent.

По умолчанию: ""

update_on_demand

булево

Загружать ли весь контент по запросу.

Если установлено значение true, весь контент будет загружен по запросу.

Если установлено значение false, контент будет загружен заранее.

Требуется, если library_type=subscribed.

Этот параметр игнорируется, когда state=absent.

Варианты:

  • false ← (по умолчанию)
  • true

username

псевдонимы: admin, user

строка

Имя пользователя сервера vCenter vSphere.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.

validate_certs

boolean

Разрешает подключение, когда сертификаты SSL недействительны.

Установите в false при недоверии к сертификатам.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Все модули требуют права на запись в API и поэтому не поддерживаются в бесплатной лицензии ESXi.
  • Все имена переменных и объектов VMware чувствительны к регистру.

Примеры

- 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": "Test description", "library_id": "d0b92fa9-7039-4f29-8e9c-0debfcb22b72", "library_type": "LOCAL", "msg": "Content Library 'demo-local-lib-4' created."}

Авторы

  • Pavan Bidkar (@pgbidkar)

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

  • Отслеживание ошибок
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API