Модуль community.vmware.vmware_resource_pool — добавление/удаление пулов ресурсов в vCenter/из vCenter

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_resource_pool.

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

Обзор

Этот модуль можно использовать для добавления пула ресурсов в vCenter и его удаления из vCenter.

Параметры

Параметр	Описание
cluster строка	Имя кластера, для которого настраивается пул ресурсов. Этот параметр обязателен, если не указан `esxi_hostname` или `parent_resource_pool`. Параметры `cluster`, `esxi_hostname` и `parent_resource_pool` являются взаимоисключающими.
cpu_allocation_shares целое число	Количество выделенных долей CPU. Это значение задаётся только при условии `cpu_shares=custom`. По умолчанию: `4000`
cpu_expandable_reservations логическое значение	В пуле ресурсов с расширяемым резервированием резервирование может превышать указанное значение. Варианты: `false` `true` ← (по умолчанию)
cpu_limit целое число	Использование ресурсов виртуальной машиной/пулом ресурсов не превысит это ограничение, даже если доступны дополнительные ресурсы. Значение по умолчанию -1 означает отсутствие ограничения. По умолчанию: `-1`
cpu_reservation целое число	Объём ресурсов, гарантированно доступный виртуальной машине или пулу ресурсов. По умолчанию: `0`
cpu_shares строка	Доли памяти используются при конкуренции за ресурсы. Варианты: `"high"` `"custom"` `"low"` `"normal"` ← (по умолчанию)
datacenter строка / обязательный	Имя центра обработки данных.
esxi_hostname строка	Имя хоста, для которого настраивается пул ресурсов. Хост не должен входить в кластер. Этот параметр обязателен, если не указан `cluster` или `parent_resource_pool`. Параметры `cluster`, `esxi_hostname` и `parent_resource_pool` являются взаимоисключающими.
hostname строка	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
mem_allocation_shares целое число	Количество выделенных долей памяти. Это значение задаётся только при условии `mem_shares=custom`. По умолчанию: `163840`
mem_expandable_reservations логическое значение	В пуле ресурсов с расширяемым резервированием резервирование может превышать указанное значение. Варианты: `false` `true` ← (по умолчанию)
mem_limit целое число	Использование ресурсов виртуальной машиной/пулом ресурсов не превысит это ограничение, даже если доступны дополнительные ресурсы. Значение по умолчанию -1 означает отсутствие ограничения. По умолчанию: `-1`
mem_reservation целое число	Объём ресурсов, гарантированно доступный виртуальной машине или пулу ресурсов. По умолчанию: `0`
mem_shares строка	Доли памяти используются при конкуренции за ресурсы. Варианты: `"high"` `"custom"` `"low"` `"normal"` ← (по умолчанию)
parent_resource_pool строка	Имя родительского пула ресурсов. Этот параметр обязателен, если не указан `cluster` или `esxi_hostname`. Параметры `cluster`, `esxi_hostname` и `parent_resource_pool` являются взаимоисключающими.
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Укажите имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_PORT`.
resource_pool строка / обязательный	Имя пула ресурсов, которым нужно управлять.
state строка	Добавить пул ресурсов или удалить его Варианты: `"present"` ← (по умолчанию) `"absent"`
username псевдонимы: admin, user строка	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
validate_certs логическое значение	Разрешает подключение, если SSL-сертификаты недействительны. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Для всех модулей требуется доступ на запись через API, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Указать хранилище сертификатов можно с помощью переменной окружения REQUESTS_CA_BUNDLE. Обратите внимание: при задании этой переменной в некоторых случаях может игнорироваться значение ‘false’ для параметра ‘validate_certs’. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Add resource pool to vCenter
  community.vmware.vmware_resource_pool:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datacenter: '{{ datacenter_name }}'
    cluster: '{{ cluster_name }}'
    resource_pool: '{{ resource_pool_name }}'
    mem_shares: normal
    mem_limit: -1
    mem_reservation: 0
    mem_expandable_reservations: true
    cpu_shares: normal
    cpu_limit: -1
    cpu_reservation: 0
    cpu_expandable_reservations: true
    state: present
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Описание
instance словарь	метаданные нового пула ресурсов Возвращается: всегда Пример: `"None"`
resource_pool_config словарь	данные конфигурации пула ресурсов; добавлено в версии 1.4.0 Возвращается: всегда Пример: {"_vimtype": "vim.ResourceConfigSpec", "changeVersion": null, "cpuAllocation": {"_vimtype": "vim.ResourceAllocationInfo", "expandableReservation": true, "limit": -1, "overheadLimit": null, "reservation": 0, "shares": {"_vimtype": "vim.SharesInfo", "level": "normal", "shares": 4000}}, "entity": "vim.ResourcePool:resgroup-1108", "lastModified": null, "memoryAllocation": {"_vimtype": "vim.ResourceAllocationInfo", "expandableReservation": true, "limit": -1, "overheadLimit": null, "reservation": 0, "shares": {"_vimtype": "vim.SharesInfo", "level": "high", "shares": 327680}}, "name": "test_pr1", "scaleDescendantsShares": null}

Ключ

Описание

instance

словарь

метаданные нового пула ресурсов

Возвращается: всегда

Пример: "None"

resource_pool_config

словарь

данные конфигурации пула ресурсов; добавлено в версии 1.4.0

Возвращается: всегда

Пример: {"_vimtype": "vim.ResourceConfigSpec", "changeVersion": null, "cpuAllocation": {"_vimtype": "vim.ResourceAllocationInfo", "expandableReservation": true, "limit": -1, "overheadLimit": null, "reservation": 0, "shares": {"_vimtype": "vim.SharesInfo", "level": "normal", "shares": 4000}}, "entity": "vim.ResourcePool:resgroup-1108", "lastModified": null, "memoryAllocation": {"_vimtype": "vim.ResourceAllocationInfo", "expandableReservation": true, "limit": -1, "overheadLimit": null, "reservation": 0, "shares": {"_vimtype": "vim.SharesInfo", "level": "high", "shares": 327680}}, "name": "test_pr1", "scaleDescendantsShares": null}

Авторы

Davis Phillips (@dav1x)

Ссылки на коллекцию

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