os_nova_flavor – Управление вкусами вычислений OpenStack
Описание
- Добавление или удаление вкусов вычислений OpenStack.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- openstacksdk
- openstacksdk >= 0.12.0
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout целое число | Сколько времени должен ожидать уровень сокета, прежде чем истечёт время ожидания для вызовов API. Если этот параметр опущен, он не будет передан в библиотеку requests. | |
| auth словарь | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного плагина password, он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, os_user_domain_name или os_project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все необходимые параметры для этого плагина. Этот параметр не нужен, если предоставлен именованное облако или присутствуют переменные окружения OpenStack OS_*. | |
| auth_type строка | Имя плагина авторизации для использования. Если облако использует что-то кроме парольной аутентификации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone - | Игнорируется. Присутствует для обратной совместимости | |
| ca_cert строка | Путь к пакету сертификатов CA, который может использоваться для проверки запросов SSL API. псевдонимы: cacert | |
| client_cert строка | Путь к клиенту сертификату для использования в рамках транзакции SSL. псевдонимы: cert | |
| client_key строка | Путь к ключу клиента для использования в рамках транзакции SSL. псевдонимы: key | |
| cloud raw | Именованное облако или конфигурация облака для работы с ним. Если cloud является строкой, она ссылается на конфигурацию именованного облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен auth или присутствуют переменные окружения OpenStack OS_*. Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| disk - | Размер локального диска в ГБ. | |
| ephemeral - | Значение по умолчанию: 0 | Размер временного пространства в ГБ. |
| extra_specs - | Словарь метаданных | |
| flavorid - | Значение по умолчанию: "auto" | Идентификатор вкуса. Это необязательно, так как уникальный UUID будет назначен, если значение не указано. |
| interface строка |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| is_public булево |
| Сделать вкус доступным для общественности. |
| name - / обязательно | Название вкуса. | |
| ram - | Объём памяти в МБ. | |
| region_name строка | Название региона. | |
| rxtx_factor - | Значение по умолчанию: 1.0 | Коэффициент RX/TX. |
| state - |
| Укажите желаемое состояние ресурса. Когда state равен 'present', то ram, vcpus и disk являются обязательными. Для этих параметров нет значений по умолчанию. |
| swap - | Значение по умолчанию: 0 | Размер пространства подкачки в МБ. |
| timeout целое число | Значение по умолчанию: 180 | Сколько времени Ansible должен ждать запрошенного ресурса. |
| validate_certs булево |
| Проверяются ли запросы SSL API. До Ansible 2.3 по умолчанию было yes.псевдонимы: verify |
| vcpus - | Количество виртуальных процессоров. | |
| wait булево |
| Должен ли Ansible ждать, пока запрашиваемый ресурс будет завершен. |
Примечания
Примечание
- Могут использоваться стандартные переменные окружения OpenStack, такие как
OS_USERNAME, вместо явного указания значений. - Информация об авторизации управляется openstacksdk, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, а затем из стандартных переменных окружения, и, наконец, из явных параметров в сценариях. Более подробную информацию можно найти на https://docs.openstack.org/openstacksdk/
Примеры
- 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' | Словарь, описывающий вкус. | |
| disk целое число | успех | Размер локального диска в ГБ. Пример: 10 | |
| ephemeral целое число | успех | Размер временного пространства в ГБ. Пример: 10 | |
| extra_specs словарь | успех | Метаданные вкуса. Пример: {'quota:disk_read_iops_sec': 5000, 'aggregate_instance_extra_specs:pinned': False} | |
| id строка | успех | ID вкуса. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339 | |
| is_public булево | успех | Сделать вкус доступным для публичного использования. Пример: True | |
| name строка | успех | Название вкуса. Пример: tiny | |
| ram целое число | успех | Объем памяти в МБ. Пример: 1024 | |
| swap целое число | успех | Размер пространства подкачки в МБ. Пример: 100 | |
| vcpus целое число | успех | Количество виртуальных процессоров. Пример: 2 | |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.9/modules/os_nova_flavor_module.html