acl – Установка и получение информации об ACL файла

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

Описание

Установка и получение информации об ACL файла.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
default boolean	Варианты: нет ← да	Если целевой объект является директорией, установка этого значения в `yes` сделает его стандартным ACL для сущностей, созданных внутри директории. Установка `default` в `yes` вызывает ошибку, если путь указывает на файл.
entity -		Фактический пользователь или группа, к которым применяется ACL при соответствии типам сущностей «пользователь» или «группа».
entry -		УСТАРЕЛО. ACL для установки или удаления. Этот параметр всегда должен быть заключён в кавычки в виде `<etype>:<qualifier>:<perms>`. Квалификатор может быть пустым для некоторых типов, но тип и разрешения всегда обязательны. `-` может использоваться в качестве заглушки, если разрешения не важны. Данный параметр теперь устарел и заменён полями entity, type и permissions.
etype -	Варианты: group mask other user	Тип сущности ACL, который необходимо применить. См. документацию `setfacl` для получения дополнительной информации.
follow boolean	Варианты: нет да ←	Следовать ли ссылкам при обнаружении символьных ссылок в пути.
path path / обязательно		Полный путь к файлу или объекту. псевдонимы: имя
permissions -		Применяемые/удаляемые разрешения могут быть любой комбинацией `r`, `w` и `x` (чтение, запись и выполнение соответственно).
recalculate_mask - добавлено в 2.7	Варианты: по умолчанию ← маска без маски	Выберите, пересчитывать ли эффективные маски прав файлов и когда. См. документацию `setfacl` для получения дополнительной информации. Несовместимо с `state=query`.
recursive boolean	Варианты: нет ← да	Рекурсивно устанавливает указанный ACL. Несовместимо с `state=query`.
state -	Варианты: отсутствует наличие запрос ←	Определяет, должно ли ACL быть присутствующим. Состояние `query` получает текущий ACL без его изменения, для использования в операциях `register`.
use_nfsv4_acls boolean	Варианты: нет ← да	Использовать 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]

Поддержка 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.9/modules/acl_module.html