Acl
Resumo
- Define e recupera informações de ACL de arquivo.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
default - required | boolean | Escolhas: - false (default) - true | Se o destino for um diretório, definir como sim o tornará o acl padrão para entidades criadas dentro do diretório. Isso causa um erro se o caminho for um arquivo. |
entity | string | | Usuário ou grupo real ao qual a ACL se aplica quando os tipos de entidade de usuário ou grupo correspondentes são selecionados. |
etype | string | Escolhas: - group - mask - other - user | O tipo de entidade da ACL a ser aplicada, consulte a documentação setfacl para obter mais informações. |
follow | boolean | Escolhas: - false - true(default) | Se deve seguir links simbólicos no caminho se um link simbólico for encontrado. |
caminho - required | string | | O caminho completo do arquivo ou objeto. aliases: nome |
permissions | | | As permissões para aplicar / remover podem ser qualquer combinação de r, w e x (ler, escrever e executar respectivamente) |
recursive | string | Escolhas: - false (default) - true | Define recursivamente a ACL especificada (adicionada em Atmosphere 2.0). Incompatível com state=query. |
state | string | Escolhas: - query (default) - absent - present | define se a ACL deve estar presente ou não. O queryestado obtém o acl atual sem alterá-lo, para uso em operações de 'registro'. |
Notas
- O módulo “acl” requer que acls estejam habilitados no sistema de arquivos de destino e que os binários setfacl e getfacl estejam instalados.
Exemplos
# Grant user Joe read access to a file
acl:
path: /etc/foo.conf
entity: joe
etype: user
permissions: r
state: present
# Removes the acl for Joe on a specific file
acl:
path: /etc/foo.conf
entity: joe
etype: user
state: absent
# Sets default acl for joe on foo.d
acl:
path: /etc/foo.d
entity: joe
etype: user
permissions: rw
default: yes
state: present
# Same as previous but using entry shorthand
acl:
path: /etc/foo.d
entry: "default:user:joe:rw-"
state: present
# Obtain the acl for a specific file
acl:
path: /etc/foo.conf
register: acl_infoValores Retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
acl | list / elements=string | sucesso | ACL atual no caminho fornecido (após as alterações, se houver) Amostra:['user :: rwx', 'group :: rwx', 'other :: rwx'] |