Модуль vmware.vmware_rest.vcenter_resourcepool_info – Извлекает информацию о пуле ресурсов, указанном параметром resourcePool.
Примечание
Этот модуль входит в состав коллекции vmware.vmware_rest (версия 3.2.0).
Если вы используете пакет ansible, эта коллекция, возможно, уже установлена. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля требуются дополнительные зависимости. Подробнее см. Требования.
Для использования в плейбуке укажите: vmware.vmware_rest.vcenter_resourcepool_info.
Новый в vmware.vmware_rest 0.3.0
Обзор
- Извлекает информацию о пуле ресурсов, указанном параметром resourcePool.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- vSphere 7.0.3 или выше
- python >= 3.6
- aiohttp
Параметры
Параметр | Комментарии |
|---|---|
clusters list / elements=string | Кластеры, которые должны содержать пул ресурсов, чтобы пул ресурсов соответствовал фильтру. Если не задано или пусто, пулы ресурсов в любом кластере соответствуют фильтру. Когда клиенты передают значение этой структуры в качестве параметра, поле должно содержать идентификатор ресурсов, возвращаемых vmware.vmware_rest.vcenter_cluster_info. |
datacenters aliases: filter_datacenters list / elements=string | Центры обработки данных, которые должны содержать пул ресурсов, чтобы пул ресурсов соответствовал фильтру. Если не задано или пусто, пулы ресурсов в любом центре обработки данных соответствуют фильтру. Когда клиенты передают значение этой структуры в качестве параметра, поле должно содержать идентификатор ресурсов, возвращаемых vmware.vmware_rest.vcenter_datacenter_info. |
hosts list / elements=string | Хосты, которые должны содержать пул ресурсов, чтобы пул ресурсов соответствовал фильтру. Если не задано или пусто, пулы ресурсов на любом хосте соответствуют фильтру. Когда клиенты передают значение этой структуры в качестве параметра, поле должно содержать идентификатор ресурсов, возвращаемых vmware.vmware_rest.vcenter_host_info. |
names aliases: filter_names list / elements=string | Имена, которые должны иметь пулы ресурсов, чтобы соответствовать фильтру (см. name). Если не задано или пусто, пулы ресурсов с любым именем соответствуют фильтру. |
parent_resource_pools list / elements=string | Пулы ресурсов, которые должны содержать пул ресурсов, чтобы пул ресурсов соответствовал фильтру. Если не задано или пусто, пулы ресурсов в любом пуле ресурсов соответствуют фильтру. Когда клиенты передают значение этой структуры в качестве параметра, поле должно содержать идентификатор ресурсов, возвращаемых vmware.vmware_rest.vcenter_resourcepool_info. |
resource_pool string | Идентификатор пула ресурсов, для которого следует получить информацию. Параметр должен быть идентификатором ресурса, возвращаемого vmware.vmware_rest.vcenter_resourcepool_info. Обязательно с state=[‘get’] |
resource_pools list / elements=string | Идентификаторы пулов ресурсов, которые могут соответствовать фильтру. Если не задано или пусто, пулы ресурсов с любым идентификатором соответствуют фильтру. Когда клиенты передают значение этой структуры в качестве параметра, поле должно содержать идентификатор ресурсов, возвращаемых vmware.vmware_rest.vcenter_resourcepool_info. |
session_timeout float добавлено в vmware.vmware_rest 2.1.0 | Настройки времени ожидания для сеанса клиента. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и ответ. Значение по умолчанию — 300 с. |
vcenter_hostname string / required | Имя хоста или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_password string / required | Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_rest_log_file string | Этот необязательный параметр можно использовать для указания местоположения файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет храниться на хосте, на котором запущен модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_username string / required | Имя пользователя 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: Get the existing resource pool
vmware.vmware_rest.vcenter_resourcepool_info:
resource_pool: '{{ resource_pools.value[0].resource_pool }}'
register: my_resource_pool
- 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: Read details from a specific resource pool
vmware.vmware_rest.vcenter_resourcepool_info:
resource_pool: '{{ my_resource_pool.id }}'
register: my_resource_pool
Значения возврата
Общие значения возврата описаны здесь, ниже приведены поля, уникальные для данного модуля:
Ключ | Описание |
|---|---|
id строка | moid ресурса Возвращается: При успехе Пример: |
value словарь | Чтение подробностей из конкретного пула ресурсов Возвращается: При успехе Пример: |
Ссылки на коллекцию
© 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/vmware/vmware_rest/vcenter_resourcepool_info_module.html