Spec-Zone.ru › Ansible

vmware.vmware_rest.vcenter_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.

Новый в 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

added in vmware.vmware_rest 2.1.0

Настройки времени ожидания для сеанса клиента.

Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и ответ.

Значение по умолчанию - 300 с.

state

string

Варианты:

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

vcenter_hostname

string / required

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

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

vcenter_password

string / required

Пароль vSphere vCenter

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

vcenter_rest_log_file

string

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

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

Файл будет храниться на хосте, на котором запущен модуль.

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

переменной среды VMWARE_REST_LOG_FILE.

vcenter_username

string / required

Имя пользователя 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

строка

moid ресурса

Возвращается: При успехе

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

value

словарь

Создать общий пул ресурсов

Возвращается: При успехе

Пример: {"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–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_module.html

Spec-Zone.ru

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