Stat

5 min

Resumo

Recupera fatos para um arquivo semelhante ao comando 'stat' do Linux / Unix.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
checksum_algorithm aliases: checksum, checksum_algo	string	Escolhas: - md5 - sha1(default) - sha224 - sha256 - sha384 - sha512	Algoritmo para determinar a soma de verificação do arquivo. Irá gerar um erro se o host não puder usar o algoritmo especificado. O host remoto deve suportar o método de hash especificado, md5 pode não estar disponível se o host for compatível com FIPS-140.
follow	boolean	Escolhas: - false(default) - true	Se deve seguir links simbólicos.
get_attributes aliases: attr, attributes	boolean	Escolhas: - false - true(default)	Obtenha atributos de arquivo usando a ferramenta lsattr, se houver.
get_checksum	boolean	Escolhas: - false - true(default)	Se deve retornar uma soma de verificação do arquivo.
get_mime aliases: mime, mime_type, mime-type	boolean	Escolhas: - false - true(default)	Use a magia do arquivo e retorne dados sobre a natureza do arquivo. isso usa o utilitário 'arquivo' encontrado na maioria dos sistemas Linux / Unix. Isso adicionará os campos `mime_type` e 'charset' ao retorno, se possível.
path - required aliases: dest, name	path		O path completo do arquivo / objeto para obter os fatos.

Exemplos

# Obtenha as estatísticas de /etc/foo.conf e verifique se o arquivo ainda pertence ao 'root'. Falha de outra forma.
- stat:
    path: /etc/foo.conf
  register: st
- fail:
    msg: "Whoops! file ownership has changed"
  when: st.stat.pw_name != 'root'

# Determine se um path existe e é um link simbólico.
# Observe que, se o path não existir, e testarmos sym.stat.islnk, 
# ele falhará com um erro. Portanto, devemos testar se ele está definido. 
#Execute isso para entender a estrutura, os ignorados não passam na verificação realizada por 'when'
- stat:
    path: /path/to/something
  register: sym

- debug:
    msg: "islnk isn't defined (path doesn't exist)"
  when: sym.stat.islnk is not defined

- debug:
    msg: "islnk is defined (path must exist)"
  when: sym.stat.islnk is defined

- debug:
    msg: "Path exists and is a symlink"
  when: sym.stat.islnk is defined and sym.stat.islnk

- debug:
    msg: "Path exists and isn't a symlink"
  when: sym.stat.islnk is defined and sym.stat.islnk == False


# Determine se um path existe e é um diretório. Observe que precisamos testar se 
# p.stat.isdir realmente existe e também se está definido como verdadeiro.
- stat:
    path: /path/to/something
  register: p
- debug:
    msg: "Path exists and is a directory"
  when: p.stat.isdir is defined and p.stat.isdir

# Não faça checksum
- stat:
    path: /path/to/myhugefile
    get_checksum: no

# Use sha256 para calcular a soma de verificação
- stat:
    path: /path/to/something
    checksum_algorithm: sha256

Valores Retornados

Parâmetro
stat	complex	sucesso	Dicionário contendo todos os dados estatísticos, algumas plataformas podem adicionar campos adicionais.

Subcampos da opção stat

Chave	Tipo	Retornado quando	Descrição
atime	float	sucesso, o path existe e o usuário pode ler as estatísticas	Hora do último acesso
attributes	list / elements=string	sucesso, o path existe e o usuário pode executar o path	lista de atributos de arquivo
charset	string	sucesso, o path existe e o usuário pode ler estatísticas e o python instalado suporta isso e a opção `mime` era verdadeira, retornará 'desconhecido' em caso de erro.	conjunto de caracteres de arquivo ou codificação
checksum	string	sucesso, o path existe, o usuário pode ler estatísticas, o path suporta hash e o algoritmo de soma de verificação fornecido está disponível	hash do path
ctime	float	sucesso, o path existe e o usuário pode ler as estatísticas	Hora da última atualização ou criação de metadados (depende do sistema operacional)
dev	integer	sucesso, o path existe e o usuário pode ler as estatísticas	Dispositivo em que o inode reside
executable	boolean	sucesso, o path existe e o usuário pode executar o path	Diz se o usuário que fez a chamada tem permissão de execução no path
exists	boolean	sucesso	Se o path de destino realmente existe ou não
gid	integer	sucesso, o path existe e o usuário pode ler as estatísticas	ID numérico que representa o grupo do proprietário
gr_name	string	sucesso, o path existe e o usuário pode ler estatísticas e o python instalado oferece suporte para isso	Nome do grupo do proprietário
inode	integer	sucesso, o path existe e o usuário pode ler as estatísticas	Número de inode do path
isblk	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um dispositivo de bloco
ischr	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um dispositivo de caractere
isdir	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um diretório
isfifo	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um tubo nomeado
isgid	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o ID do grupo do usuário que está chamando corresponde ao ID do grupo do proprietário
islnk	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um link simbólico
isreg	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um arquivo normal
issock	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o path é um soquete de domínio unix
isuid	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o id do usuário de invocação corresponde ao id do proprietário
lnk_source	string	sucesso, o path existe e o usuário pode ler as estatísticas e o path é um link simbólico	Destino do link simbólico normalizado para o sistema de arquivos remoto
lnk_target	string	sucesso, o path existe e o usuário pode ler as estatísticas e o path é um link simbólico	Destino do link simbólico. Observe que os path relativos permanecem relativos
md5	string	sucesso, o path existe e o usuário pode ler estatísticas e o path é compatível com hashing e MD5 é compatível	hash md5 do path
mimetype	string	sucesso, o path existe e o usuário pode ler estatísticas e o python instalado suporta isso e a opção `mime` era verdadeira, retornará 'desconhecido' em caso de erro.	arquivo de dados mágicos ou tipo MIME
mode	string	sucesso, o path existe e o usuário pode ler as estatísticas	Permissões Unix do arquivo em representação octal como uma string
mtime	float	sucesso, o path existe e o usuário pode ler as estatísticas	Hora da última modificação
nlink	integer	sucesso, o path existe e o usuário pode ler as estatísticas	Número de links para o inode (links físicos)
path	string	sucesso e se existe path	O path completo do arquivo / objeto para obter os fatos de
pw_name	string	sucesso, o path existe e o usuário pode ler estatísticas e o python instalado oferece suporte para isso	Nome de usuário do proprietário
readable	boolean	sucesso, o path existe e o usuário pode ler o path	Diz se o usuário que fez a chamada tem o direito de ler o path
rgrp	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o grupo do proprietário tem permissão de leitura
roth	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se outros têm permissão de leitura
rusr	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o proprietário tem permissão de leitura
size	integer	sucesso, o path existe e o usuário pode ler as estatísticas	Tamanho em bytes para um arquivo simples, quantidade de dados para alguns arquivos especiais
uid	integer	sucesso, o path existe e o usuário pode ler as estatísticas	ID numérico que representa o proprietário do arquivo
wgrp	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o grupo do proprietário tem permissão de gravação
woth	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se outros têm permissão de escrita
writeable	boolean	sucesso, o path existe e o usuário pode escrever o path	Diz se o usuário que fez a chamada tem o direito de escrever o path
wusr	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o proprietário tem permissão de escrita
xgrp	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o grupo do proprietário tem permissão de execução
xoth	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se outros têm permissão de execução
xusr	boolean	sucesso, o path existe e o usuário pode ler as estatísticas	Diz se o proprietário tem permissão de execução