acl – Набор и получение информации об ACL файла
Описание
- Установка и получение информации об ACL файла.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| default boolean |
| Если целевой объект – это директория, установка этого значения в yes сделает его стандартным ACL для сущностей, созданных внутри директории.Установка значения default в yes вызывает ошибку, если путь указывает на файл. |
| entity - | Фактический пользователь или группа, к которым применяется ACL при выборе типов сущностей «пользователь» или «группа». | |
| entry - | УСТАРЕЛО. ACL для установки или удаления. Это всегда должно быть заключено в кавычки в формате <etype>:<qualifier>:<perms>. Квалификатор может быть пустым для некоторых типов, но тип и разрешения всегда требуются. - может использоваться в качестве плейсхолдера, когда вас не интересуют разрешения.Данный параметр устарел, теперь используются поля entity, type и permissions. | |
| etype - |
| Тип сущности ACL для применения, см. документацию setfacl для получения дополнительной информации. |
| follow boolean |
| Учитывать ли символические ссылки по пути, если встречается символическая ссылка. |
| path путь / обязательно | Полный путь к файлу или объекту. псевдонимы: имя | |
| permissions - | Разрешения для применения/удаления могут быть любой комбинацией r, w и x (чтение, запись и выполнение соответственно) | |
| recalculate_mask - добавлено в 2.7 |
| Выберите, пересчитывать ли эффективные маски прав файлов и когда. См. документацию setfacl для получения дополнительной информации.Несовместимо с state=query. |
| recursive boolean добавлено в 2.0 |
| Рекурсивно устанавливает указанный ACL. Несовместимо с state=query. |
| state - |
| Определите, должно ли ACL присутствовать или нет. Состояние query получает текущий ACL без его изменения, для использования в операциях register. |
| use_nfsv4_acls boolean добавлено в 2.2 |
| Использовать NFSv4 ACL вместо POSIX ACL. |
Примечания
Примечание
- Модуль
aclтребует, чтобы ACL были включены в целевой файловой системе, и что исполняемые файлыsetfaclиgetfaclбыли установлены. - Начиная с Ansible 2.0, этот модуль поддерживает только дистрибутивы Linux.
- Начиная с Ansible 2.3, параметр name был изменён на path по умолчанию, но name всё ещё работает.
Примеры
- name: Grant user Joe read access to a file
acl:
path: /etc/foo.conf
entity: joe
etype: user
permissions: r
state: present
- name: Removes the ACL for Joe on a specific file
acl:
path: /etc/foo.conf
entity: joe
etype: user
state: absent
- name: Sets default ACL for joe on /etc/foo.d/
acl:
path: /etc/foo.d/
entity: joe
etype: user
permissions: rw
default: yes
state: present
- name: Same as previous but using entry shorthand
acl:
path: /etc/foo.d/
entry: default:user:joe:rw-
state: present
- name: Obtain the ACL for a specific file
acl:
path: /etc/foo.conf
register: acl_info
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| acl список | успех | Текущий ACL по указанному пути (после изменений, если таковые имелись) Пример: ['user::rwx', 'group::rwx', 'other::rwx'] |
Статус
- Этот модуль гарантированно не будет иметь обратной несовместимости в будущих изменениях. [stableinterface]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительная информация о поддержке этого модуля Red Hat доступна в этой статье базы знаний Red Hat.
Авторы
- Brian Coca (@bcoca)
- Jérémie Astori (@astorije)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/acl_module.html
