ansible.builtin.human_readable 过滤器 – 将字节/比特转换为人类可读的格式

注意

此过滤器插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 human_readable。但是，我们建议您使用完全限定集合名称 (FQCN) ansible.builtin.human_readable，以便轻松链接到插件文档并避免与可能具有相同过滤器插件名称的其他集合冲突。

概要

  • 将字节或比特数字转换为更易于人类阅读的格式。

输入

此部分描述过滤器的输入，即 | ansible.builtin.human_readable 之前的数值。

参数

注释

输入

整数 / 必填

字节数或比特数。取决于 isbits。

位置参数

此部分描述过滤器的 位置参数。这些参数在以下示例中为 positional1、positional2 等：input | ansible.builtin.human_readable(positional1, positional2, ...)

参数

注释

isbits

布尔值

输入是否为比特而不是字节。

选项

  • false ← (默认)

  • true

unit

字符串

强制输出的单位。如果没有指定，则将使用获得的最大的单位。

选项

  • "Y"

  • "Z"

  • "E"

  • "P"

  • "T"

  • "G"

  • "M"

  • "K"

  • "B"

示例

# size => "1.15 GB"
size: "{{ 1232345345 | human_readable }}"

# size => "1.15 Gb"
size_bits: "{{ 1232345345 | human_readable(true) }}"

# size => "1175.26 MB"
size_MB: "{{ 1232345345 | human_readable(unit='M') }}"

返回值

键

描述

返回值

字符串

人类可读的字节或比特大小。

返回：成功

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖列表中较高的变量。