os_nova_flavor - Управление вкусами вычислений OpenStack

Введено в версии 2.0.

Краткое описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Обслуживание
- Автор

Краткое описание

Добавление или удаление вкусов из OpenStack.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

openstacksdk
python >= 2.7

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout		Сколько времени (в секундах) уровень сокета должен ждать перед таймаутом для вызовов API. Если этот параметр опущен, он не будет передан библиотеке requests.
auth		Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля аутентификации облака. Для стандартного подключаемого модуля password он будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры. Этот параметр не нужен, если предоставлен параметр cloud или установлены переменные окружения OpenStack OS_*.
auth_type		Имя подключаемого модуля аутентификации для использования. Если облако использует что-то отличное от аутентификации по паролю, имя подключаемого модуля должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone		Игнорируется. Существует для обратной совместимости.
cacert		Путь к пакету сертификатов CA, который может использоваться для проверки запросов SSL API.
cert		Путь к клиенту сертификат, который нужно использовать в рамках SSL-транзакции.
cloud		Именованное облако или конфигурация облака для работы с ним. Если cloud — строка, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан параметр auth или присутствуют переменные окружения OpenStack OS_* . Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
disk		Размер локального диска в ГБ.
ephemeral	Значение по умолчанию: 0	Размер быстросъёмного пространства в ГБ.
extra_specs (добавлен в 2.3)		Словарь метаданных
flavorid	Значение по умолчанию: "auto"	Идентификатор вкуса. Это необязательно, так как уникальный UUID будет присвоен, если значение не указано.
interface (добавлен в 2.3)	Варианты: public ← internal admin	Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type
is_public bool	Варианты: нет да ←	Сделать вкус доступным для публичного доступа.
key		Путь к клиентскому ключу для использования в рамках SSL-транзакции.
name обязательно		Имя вкуса.
ram		Объем памяти в МБ.
region_name		Имя региона.
rxtx_factor	Значение по умолчанию: 1.0	Коэффициент RX/TX.
state	Варианты: present ← absent	Укажите желаемое состояние ресурса. Когда state равен 'present', тогда ram, vcpus и disk — все обязательны. Для этих параметров нет значений по умолчанию.
swap	Значение по умолчанию: 0	Размер пространства подкачки в МБ.
timeout	Значение по умолчанию: 180	Сколько времени Ansible должно ждать требуемого ресурса.
vcpus		Количество виртуальных процессоров.
verify bool	Варианты: нет да	Необходимо ли проверять запросы SSL API. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs
wait bool	Варианты: нет да ←	Должен ли Ansible ждать, пока требуемый ресурс не будет завершён.

Примечания

Примечание

Можно использовать стандартные переменные окружения OpenStack, такие как OS_USERNAME, вместо явных значений.
Информация об авторизации управляется os-client-config, что означает, что значения могут поступать из файла yaml-конфигурации в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, и, наконец, из явных параметров в плейбуках. Более подробную информацию можно найти на http://docs.openstack.org/developer/os-client-config

Примеры

- name: "Create 'tiny' flavor with 1024MB of RAM, 1 virtual CPU, and 10GB of local disk, and 10GB of ephemeral."
  os_nova_flavor:
    cloud: mycloud
    state: present
    name: tiny
    ram: 1024
    vcpus: 1
    disk: 10
    ephemeral: 10

- name: "Delete 'tiny' flavor"
  os_nova_flavor:
    cloud: mycloud
    state: absent
    name: tiny

- name: Create flavor with metadata
  os_nova_flavor:
    cloud: mycloud
    state: present
    name: tiny
    ram: 1024
    vcpus: 1
    disk: 10
    extra_specs:
      "quota:disk_read_iops_sec": 5000
      "aggregate_instance_extra_specs:pinned": false

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

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

Ключ		Возвращается	Описание
flavor сложное		При успехе, когда state равен 'present'	Словарь, описывающий вкус.
	id строка	успех	Идентификатор вкуса. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339
	name строка	успех	Имя вкуса. Пример: tiny
	disk целое число	успех	Размер локального диска в ГБ. Пример: 10
	ephemeral целое число	успех	Размер быстросъёмного пространства в ГБ. Пример: 10
	ram целое число	успех	Объем памяти в МБ. Пример: 1024
	swap целое число	успех	Размер пространства подкачки в МБ. Пример: 100
	vcpus целое число	успех	Количество виртуальных процессоров. Пример: 2
	is_public bool	успех	Сделать вкус доступным для публичного доступа. Пример: True
	extra_specs словарь	успех	Метаданные вкуса Пример: {'quota:disk_read_iops_sec': 5000, 'aggregate_instance_extra_specs:pinned': False}

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.

Для просмотра списка других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

David Shrewsbury (@Shrews)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/os_nova_flavor_module.html