os_object – Создание или удаление объектов и контейнеров из OpenStack
Новая версия с 2.0.
Описание
- Создание или удаление объектов и контейнеров из OpenStack
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7
- openstacksdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout - | Сколько времени должна ждать сокетная прослойка, прежде чем произойдёт таймаут для вызовов API. Если это опущено, то ничто не будет передано библиотеке requests. | |
| auth - | Словарь, содержащий информацию об аутентификации, необходимую для стратегии подключаемого модуля аутентификации облака. Для стандартного подключаемого модуля password, он будет содержать auth_url, username, password, project_name и любую информацию о домен, если облако их поддерживает. Для других подключаемых модулей, этот параметр должен содержать параметры, необходимые для подключаемого модуля аутентификации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды 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. | |
| container - / обязательно | Имя контейнера, в котором необходимо создать объект. | |
| container_access - |
| Желаемый уровень доступа к контейнеру. |
| filename - | Путь к локальному файлу для загрузки. | |
| interface - добавлено в 2.3 |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| key - | Путь к ключу клиента для использования в рамках SSL транзакции. | |
| name - | Имя, которое должно быть дано объекту. Если опущено, операции будут выполняться над всем контейнером. | |
| region_name - | Имя региона. | |
| state - |
| Ресурс должен присутствовать или отсутствовать. |
| timeout - | По умолчанию: 180 | Сколько времени Ansible должно ждать запрашиваемый ресурс. |
| verify boolean |
| Необходимо ли проверять запросы SSL API. До версии 2.3 значение по умолчанию было True. псевдонимы: validate_certs |
| wait boolean |
| Должен ли Ansible ждать, пока запрашиваемый ресурс не будет завершён. |
Примечания
Примечание
- Могут использоваться стандартные переменные среды OpenStack, такие как
OS_USERNAME, вместо явного указания значений. - Информация об аутентификации управляется os-client-config, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в playbook. Дополнительную информацию можно найти по адресу http://docs.openstack.org/developer/os-client-config
Примеры
- name: "Create a object named 'fstab' in the 'config' container"
os_object:
cloud: mordred
state: present
name: fstab
container: config
filename: /etc/fstab
- name: Delete a container called config and all of its contents
os_object:
cloud: rax-iad
state: absent
container: config
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Monty Taylor (@emonty)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/os_object_module.html
