Spec-Zone.ru › Ansible

Модуль 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 (int): Объём ресурсов, гарантированно доступный пулу ресурсов. Зарезервированные ресурсы не пропадают зря, если они не используются. Если загрузка меньше резерва, ресурсы могут использоваться другими работающими виртуальными машинами. Единицы измерения: МБ для памяти и МГц для ЦП.

Если значение не задано или пусто, reservation будет установлено в 0. ([‘present’])

- expandable_reservation (bool): В пуле ресурсов с расширяемым резервированием резерв может превышать указанное значение, если в родительском пуле ресурсов есть незарезервированные ресурсы. Нерасширяемое резервирование называется фиксированным.

Если значение не задано или пусто, expandable_reservation будет установлено в true. ([‘present’])

- limit (int): Использование ресурсов пулом не превысит это ограничение, даже если доступны дополнительные ресурсы. Обычно этот параметр используют, чтобы обеспечить стабильную производительность пулов ресурсов независимо от доступности ресурсов. Если задано значение -1, фиксированное ограничение на использование ресурсов отсутствует (использование ограничено только доступными ресурсами и долями). Единицы измерения: МБ для памяти и МГц для ЦП.

Если значение не задано или пусто, limit будет установлено в -1. ([‘present’])

- shares (dict): Доли используются при конкуренции за ресурсы. ([‘present’])

- Допустимые ключи:

- level (string): Этот параметр задаёт возможные значения уровня распределения.

Допустимые значения этого поля:

- CUSTOM

- HIGH

- LOW

- NORMAL

- shares (integer): Если для level задано значение CUSTOM, это количество выделенных долей. В противном случае значение игнорируется.

У этого значения нет единицы измерения. Это относительная величина, зависящая от настроек других пулов ресурсов.

Это поле необязательное и имеет значение только тогда, когда для level задано значение CUSTOM.

memory_allocation

dictionary

Распределение ресурсов ЦП.

Если значение не задано или пусто, распределение ресурсов ЦП пула ресурсов не изменится.

Допустимые атрибуты:

- reservation (int): Объём ресурсов, гарантированно доступный пулу ресурсов. Зарезервированные ресурсы не пропадают зря, если они не используются. Если загрузка меньше резерва, ресурсы могут использоваться другими работающими виртуальными машинами. Единицы измерения: МБ для памяти и МГц для ЦП.

Если значение не задано или пусто, reservation будет установлено в 0. ([‘present’])

- expandable_reservation (bool): В пуле ресурсов с расширяемым резервированием резерв может превышать указанное значение, если в родительском пуле ресурсов есть незарезервированные ресурсы. Нерасширяемое резервирование называется фиксированным.

Если значение не задано или пусто, expandable_reservation будет установлено в true. ([‘present’])

- limit (int): Использование ресурсов пулом не превысит это ограничение, даже если доступны дополнительные ресурсы. Обычно этот параметр используют, чтобы обеспечить стабильную производительность пулов ресурсов независимо от доступности ресурсов. Если задано значение -1, фиксированное ограничение на использование ресурсов отсутствует (использование ограничено только доступными ресурсами и долями). Единицы измерения: МБ для памяти и МГц для ЦП.

Если значение не задано или пусто, limit будет установлено в -1. ([‘present’])

- shares (dict): Доли используются при конкуренции за ресурсы. ([‘present’])

- Допустимые ключи:

- level (string): Этот параметр задаёт возможные значения уровня распределения.

Допустимые значения этого поля:

- CUSTOM

- HIGH

- LOW

- NORMAL

- 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

Варианты:

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

vcenter_hostname

string / обязательный

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

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

vcenter_password

string / обязательный

Пароль vSphere vCenter

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

vcenter_rest_log_file

string

Этот необязательный параметр позволяет указать расположение файла журнала.

В этом файле будет записываться взаимодействие по HTTP REST.

Файл будет сохранён на хосте, на котором выполняется модуль.

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

значение переменной окружения VMWARE_REST_LOG_FILE.

vcenter_username

string / обязательный

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

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

vcenter_validate_certs

boolean

Разрешает подключение при недействительных сертификатах SSL. Если сертификатам нельзя доверять, установите значение false.

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

Варианты:

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

Примечания

Примечание

  • Проверено на 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 ресурса

Возвращается: При успешном выполнении

Пример: "resgroup-1009"

value

dictionary

Создание универсального пула ресурсов

Возвращается: При успешном выполнении

Пример: {"cpu_allocation": {"expandable_reservation": 1, "limit": -1, "reservation": 0, "shares": {"level": "NORMAL"}}, "memory_allocation": {"expandable_reservation": 1, "limit": -1, "reservation": 0, "shares": {"level": "NORMAL"}}, "name": "my_resource_pool", "resource_pools": []}

Авторы

  • Команда Ansible Cloud (@ansible-collections)

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

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

© 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

Spec-Zone.ru

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