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