os_project_access – Управление доступом к флейворам вычислений OpenStack
Новая версия с 2.5.
Описание
- Добавление или удаление доступа к флейворам, типам томов или другим ресурсам OpenStack.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout целое число | Сколько времени должна ждать транспортная среда перед истечением времени ожидания для API-запросов. Если этот параметр опущен, ничего не будет передано в библиотеку запросов. | |
| 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 сырой | Именованное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_*. Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| interface строка добавлен в 2.3 |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| region_name строка | Имя региона. | |
| resource_name - | Имя ресурса (например, tiny). | |
| resource_type - | Тип ресурса (например, nova_flavor, cinder_volume_type). | |
| state - |
| Указывает желаемое состояние ресурса. |
| target_project_id - / обязательно | Идентификатор проекта. | |
| timeout целое число | По умолчанию: 180 | Сколько времени Ansible должен ждать запрашиваемый ресурс. |
| validate_certs булево |
| Требуется ли проверка SSL-API-запросов. До Ansible 2.3 это по умолчанию было yes. псевдонимы: verify |
| Ожидание boolean |
| Должен ли Ansible ожидать завершения запрошенного ресурса. |
Примечания
Примечание
- Стандартные переменные окружения OpenStack, такие как
OS_USERNAME, могут использоваться вместо явного указания значений. - Информация об авторизации управляется openstacksdk, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, и, наконец, из явных параметров в плейбуках. Дополнительную информацию можно найти на странице https://docs.openstack.org/openstacksdk/
Примеры
- name: "Enable access to tiny flavor to your tenant."
os_project_access:
cloud: mycloud
state: present
target_project_id: f0f1f2f3f4f5f67f8f9e0e1
resource_name: tiny
resource_type: nova_flavor
- name: "Disable access to the given flavor to project"
os_project_access:
cloud: mycloud
state: absent
target_project_id: f0f1f2f3f4f5f67f8f9e0e1
resource_name: tiny
resource_type: nova_flavor
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращается | Описание | |
|---|---|---|---|
| flavor сложный | При успехе, когда состояние равно 'present' | Словарь, описывающий flavour. | |
| id строка | успех | Идентификатор flavour. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339 | |
| name строка | успех | Имя flavour. Пример: tiny | |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Roberto Polli (@ioggstream)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/os_project_access_module.html