Модуль vmware.vmware_rest.vcenter_resourcepool — создание пула ресурсов.
Примечание
Этот модуль входит в коллекцию vmware.vmware_rest (версия 4.10.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: vmware.vmware_rest.vcenter_resourcepool.
Добавлено в vmware.vmware_rest 0.3.0
Краткое описание
- Создаёт пул ресурсов.
Требования
На хосте, выполняющем этот модуль, необходимы следующие компоненты.
- vSphere 7.0.3 или новее
- python >= 3.6
- aiohttp
Параметры
Параметр | Комментарии |
|---|---|
cpu_allocation dictionary | Распределение ресурсов ЦП. Если значение не задано или пусто, распределение ресурсов ЦП пула ресурсов не изменится. Допустимые атрибуты: - Если значение не задано или пусто, reservation будет установлено в 0. ([‘present’]) - Если значение не задано или пусто, expandable_reservation будет установлено в true. ([‘present’]) - Если значение не задано или пусто, limit будет установлено в -1. ([‘present’]) - - Допустимые ключи: - level (string): Этот параметр задаёт возможные значения уровня распределения. Допустимые значения этого поля: - - - - - shares (integer): Если для level задано значение CUSTOM, это количество выделенных долей. В противном случае значение игнорируется. У этого значения нет единицы измерения. Это относительная величина, зависящая от настроек других пулов ресурсов. Это поле необязательное и имеет значение только тогда, когда для level задано значение CUSTOM. |
memory_allocation dictionary | Распределение ресурсов ЦП. Если значение не задано или пусто, распределение ресурсов ЦП пула ресурсов не изменится. Допустимые атрибуты: - Если значение не задано или пусто, reservation будет установлено в 0. ([‘present’]) - Если значение не задано или пусто, expandable_reservation будет установлено в true. ([‘present’]) - Если значение не задано или пусто, limit будет установлено в -1. ([‘present’]) - - Допустимые ключи: - level (string): Этот параметр задаёт возможные значения уровня распределения. Допустимые значения этого поля: - - - - - shares (integer): Если для level задано значение CUSTOM, это количество выделенных долей. В противном случае значение игнорируется. У этого значения нет единицы измерения. Это относительная величина, зависящая от настроек других пулов ресурсов. Это поле необязательное и имеет значение только тогда, когда для level задано значение CUSTOM. |
name string | Имя пула ресурсов. Если значение не задано или пусто, имя пула ресурсов не изменится. Обязательно при state=[‘present’] |
parent string | Родительский элемент создаваемого пула ресурсов. При передаче клиентами значения этой структуры в качестве параметра поле должно содержать идентификатор ресурса, возвращаемый методом vmware.vmware_rest.vcenter_resourcepool_info. Обязательно при state=[‘present’] |
resource_pool string | Идентификатор удаляемого пула ресурсов. Параметр должен содержать идентификатор ресурса, возвращаемый методом vmware.vmware_rest.vcenter_resourcepool_info. Обязательно при state=[‘absent’, ‘present’] |
session_timeout float добавлено в vmware.vmware_rest 2.1.0 | Настройки тайм-аута клиентского сеанса. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с. |
state string | Варианты:
|
vcenter_hostname string / обязательный | Имя хоста или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_password string / обязательный | Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_rest_log_file string | Этот необязательный параметр позволяет указать расположение файла журнала. В этом файле будет записываться взаимодействие по HTTP REST. Файл будет сохранён на хосте, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_username string / обязательный | Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_validate_certs boolean | Разрешает подключение при недействительных сертификатах SSL. Если сертификатам нельзя доверять, установите значение Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Варианты:
|
Примечания
Примечание
- Проверено на vSphere 7.0.3
Примеры
- name: Get the existing resource pools
vmware.vmware_rest.vcenter_resourcepool_info:
register: resource_pools
- name: Create an Ad hoc resource pool
vmware.vmware_rest.vcenter_resourcepool:
name: my_resource_pool
parent: '{{ resource_pools.value[0].resource_pool }}'
cpu_allocation:
expandable_reservation: true
limit: 40
reservation: 0
shares:
level: NORMAL
memory_allocation:
expandable_reservation: false
limit: 2000
reservation: 0
shares:
level: NORMAL
register: my_resource_pool
- name: Remove a resource pool
vmware.vmware_rest.vcenter_resourcepool:
resource_pool: '{{ my_resource_pool.id }}'
state: absent
- name: Create a generic resource pool
vmware.vmware_rest.vcenter_resourcepool:
name: my_resource_pool
parent: '{{ resource_pools.value[0].resource_pool }}'
register: my_resource_pool
- name: Modify a resource pool
vmware.vmware_rest.vcenter_resourcepool:
resource_pool: '{{ my_resource_pool.id }}'
cpu_allocation:
expandable_reservation: true
limit: -1
reservation: 0
shares:
level: NORMAL
memory_allocation:
expandable_reservation: false
limit: 1000
reservation: 0
shares:
level: NORMAL
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
id string | moid ресурса Возвращается: При успешном выполнении Пример: |
value dictionary | Создание универсального пула ресурсов Возвращается: При успешном выполнении Пример: |
Ссылки на коллекцию
© 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/vmware/vmware_rest/vcenter_resourcepool_module.html