Модуль openstack.cloud.compute_flavor_access – Управление доступом к виртуальным машинам OpenStack

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install openstack.cloud. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. Требования.

Для использования в playbook укажите: openstack.cloud.compute_flavor_access.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Добавление или удаление доступа к виртуальным машинам OpenStack

Требования

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

python >= 3.6
openstacksdk >= 1.0.0

Параметры

Параметр	Комментарии
api_timeout целое число	Сколько времени должна ждать сокетная прослойка, прежде чем отказать из-за таймаута вызовов API. Если это опущено, библиотека requests ничего не получит.
auth словарь	Словарь, содержащий информацию об авторизации, необходимую для стратегии плагина авторизации облака. Для стандартного плагина password он будет содержать auth_url, username, password, project_name и любую информацию о домене (например, user_domain_name или project_domain_name), если облако ее поддерживает. Для других плагинов этот параметр должен содержать параметры, необходимые этому плагину. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type строка	Имя плагина авторизации для использования. Если облако использует что-то кроме парольной авторизации, здесь должно быть указано имя плагина, и содержимое параметра auth должно быть соответствующим образом обновлено.
ca_cert алиасы: cacert строка	Путь к пакету сертификатов CA, который можно использовать для проверки запросов API SSL.
client_cert алиасы: cert строка	Путь к клиенту сертификату для использования в рамках SSL-транзакции.
client_key алиасы: key строка	Путь к ключу клиента для использования в рамках SSL-транзакции.
cloud любой	Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на именованную конфигурацию облака, определенную в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_*.
interface алиасы: endpoint_type строка	Тип URL конечной точки для извлечения из каталога служб. Варианты: `"admin"` `"internal"` `"public"` ← (по умолчанию)
name строка / обязательный	Имя или ID вычислительного флейвора.
project строка / обязательный	Идентификатор или имя проекта для предоставления доступа. Разрешить project доступ к закрытому флейвору (имя или ID).
project_domain строка	Домен, к которому принадлежит проект (имя или ID). Это может быть использовано в случае коллизий между именами проектов.
region_name строка	Имя региона.
sdk_log_level строка	Уровень логов OpenStackSDK Варианты: `"INFO"` ← (по умолчанию) `"DEBUG"`
sdk_log_path строка	Путь к лог-файлу OpenStackSDK. Если пусто, логи не записываются.
state строка	Указывает, должен ли проект иметь доступ к вычислительному флейвору. Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout целое число	Сколько времени Ansible должно ждать запрошенного ресурса. По умолчанию: `180`
validate_certs алиасы: verify булево	Нужно ли проверять запросы API SSL. До Ansible 2.3 по умолчанию было `true`. Варианты: `false` `true`
wait булево	Должен ли Ansible ждать завершения запрошенного ресурса. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Grant access to tiny flavor
  openstack.cloud.compute_flavor_access:
    cloud: devstack
    name: tiny
    project: demo
    state: present

- name: Revoke access to compute flavor
  openstack.cloud.compute_flavor_access:
    cloud: devstack
    name: tiny
    project: demo
    state: absent

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

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

Ключ	Описание
flavor dictionary	Словарь, описывающий профиль. Возвращается: При успехе, когда state имеет значение ‘present’
description string	Описание, прикрепленное к профилю Возвращается: при успехе Пример: `"Example description"`
disk integer	Размер локального диска в ГБ. Возвращается: при успехе Пример: `10`
ephemeral integer	Размер эфемерного пространства в ГБ. Возвращается: при успехе Пример: `10`
extra_specs dictionary	Метаданные профиля Возвращается: при успехе Пример: `{"aggregate_instance_extra_specs:pinned": false, "quota:disk_read_iops_sec": 5000}`
id string	Идентификатор профиля. Возвращается: при успехе Пример: `"515256b8-7027-4d73-aa54-4e30a4a4a339"`
is_disabled boolean	Отключен ли профиль Возвращается: при успехе Пример: `true`
is_public boolean	Сделать профиль доступным публично. Возвращается: при успехе Пример: `true`
name string	Имя профиля. Возвращается: при успехе Пример: `"tiny"`
original_name string	Имя этого профиля при возврате из списка/показа сервера Возвращается: при успехе
ram integer	Объём памяти в МБ. Возвращается: при успехе Пример: `1024`
rxtx_factor integer	Коэффициент масштабирования пропускной способности, который получает этот профиль в сети Возвращается: при успехе Пример: `100`
swap integer	Размер подкачки в МБ. Возвращается: при успехе Пример: `100`
vcpus integer	Количество виртуальных процессоров. Возвращается: при успехе Пример: `2`

Авторы

OpenStack Ansible SIG

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

© 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/openstack/cloud/compute_flavor_access_module.html