Модуль vmware.vmware_rest.vcenter_resourcepool_info — получает сведения о пуле ресурсов, указанном параметром 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_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 псевдонимы: filter_datacenters list / elements=string | Центры обработки данных, в которых должен находиться пул ресурсов, чтобы соответствовать фильтру. Если значение не задано или список пуст, фильтру соответствуют пулы ресурсов в любом центре обработки данных. При передаче клиентами значения этой структуры в качестве параметра поле должно содержать идентификатор ресурса, возвращаемый модулем vmware.vmware_rest.vcenter_datacenter_info. |
hosts list / elements=string | Узлы, на которых должен находиться пул ресурсов, чтобы соответствовать фильтру. Если значение не задано или список пуст, фильтру соответствуют пулы ресурсов на любом узле. При передаче клиентами значения этой структуры в качестве параметра поле должно содержать идентификатор ресурса, возвращаемый модулем vmware.vmware_rest.vcenter_host_info. |
names псевдонимы: 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 / обязательный | Имя узла или IP-адрес vCenter в vSphere Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения |
vcenter_password string / обязательный | Пароль vCenter в vSphere Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения |
vcenter_rest_log_file string | Этот необязательный параметр позволяет указать расположение файла журнала. В этом файле будет записываться взаимодействие по HTTP REST. Файл будет сохранен на узле, на котором выполняется модуль. Если значение не указано в задаче, будет использоваться значение переменной окружения |
vcenter_username string / обязательный | Имя пользователя vCenter в vSphere Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения |
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 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_info_module.html