acl — Установка и получение информации об ACL файлов.
Новое в версии 1.4.
Описание
- Устанавливает и получает информацию об ACL файла.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| default (добавлено в 1.5) |
| если целевой объект — директория, установка значения «да» сделает его стандартным ACL для сущностей, созданных внутри директории. Применяется к файлам, вызовет ошибку. |
| entity (добавлено в 1.5) | фактический пользователь или группа, к которым применяется ACL при выборе типов сущностей «пользователь» или «группа». | |
| entry | УСТАРЕЛО. ACL для установки или удаления. Это всегда должно быть в формате '<тип>:<квалификатор>:<разрешения>'. Квалификатор может быть пустым для некоторых типов, но тип и разрешения всегда необходимы. '-' может использоваться в качестве заполнителя, когда разрешения не важны. Этот параметр устарел, теперь используются поля entity, type и permissions. | |
| etype (добавлено в 1.5) |
| тип сущности ACL для применения, см. документацию setfacl для получения дополнительной информации. |
| follow |
| следовать ли символическим ссылкам в пути, если встречается символическая ссылка. |
| path обязательно | Полный путь к файлу или объекту. Псевдонимы: имя | |
| permissions (добавлено в 1.5) | Разрешения для применения/удаления могут быть любой комбинацией r, w и x (чтение, запись и выполнение соответственно) | |
| recursive (добавлено в 2.0) |
| Рекурсивно устанавливает указанный ACL (добавлено в Ansible 2.0). Несовместимо с state=query. |
| state |
| определяет, должно ли ACL присутствовать. Состояние query получает текущий 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 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 в указанном пути (после изменений, если таковые имеются) Пример: ['пользователь::rwx', 'группа::rwx', 'другие::rwx'] |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будет внесено обратной совместимости.
Поддержка
Дополнительную информацию о поддержке этого модуля 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.5/modules/acl_module.html
