Модуль community.general.parted — настройка разделов блочных устройств

align

string

Задает выравнивание для создаваемых разделов. Чтобы использовать выравнивание по умолчанию в parted, укажите undefined.

Варианты:

• "cylinder"
• "minimal"
• "none"
• "optimal" ← (по умолчанию)
• "undefined"

device

string / обязательный

Блочное устройство (диск), с которым выполняются операции.

Также можно создавать разделы в обычных файлах, но рекомендуется создать устройство обратной связи с помощью losetup, чтобы упростить доступ к его разделам.

flags

list / элементы=string

Список флагов, которые необходимо установить для раздела.

fs_type

string

добавлено в community.general 0.2.0

Если параметр указан, а раздел не существует, для создаваемого раздела задается указанный тип файловой системы.

Параметр необязателен, но см. приведенные ниже примечания о отрицательных значениях part_start.

label

string

Тип метки диска или используемой таблицы разделов.

Если device уже содержит метку другого типа, она заменяется на label, а все существующие разделы теряются.

Для таблицы разделов gpt необходимо указать name.

Варианты:

• "aix"
• "amiga"
• "bsd"
• "dvh"
• "gpt"
• "loop"
• "mac"
• "msdos" ← (по умолчанию)
• "pc98"
• "sun"

name

string

Задает имя раздела (только для GPT, Mac, MIPS и PC98).

number

integer

Номер изменяемого раздела.

Обязателен при выполнении любых операций с диском, кроме получения информации.

part_end

string

Положение конца раздела относительно начала диска, то есть «расстояние» от начала диска. Отрицательные числа задают расстояние от конца диска.

Расстояние можно указать в любых единицах, поддерживаемых parted (кроме compat); регистр символов учитывается. Например: 10GiB, 15%.

По умолчанию: "100%"

part_start

string

Положение начала раздела относительно начала диска, то есть «расстояние» от начала диска. Отрицательные числа задают расстояние от конца диска.

Расстояние можно указать в любых единицах, поддерживаемых parted (кроме compat); регистр символов учитывается. Например: 10GiB, 15%.

При использовании отрицательных значений может потребоваться задать fs_type (см. примечания).

По умолчанию: "0%"

part_type

string

Можно указать только вместе с label=msdos или label=dvh.

Нельзя использовать ни part_type, ни name вместе с label=sun.

Варианты:

• "extended"
• "logical"
• "primary" ← (по умолчанию)

resize

boolean

добавлено в community.general 1.3.0

Выполняет resizepart для существующих разделов, чтобы привести их размер в соответствие с указанным в part_end.

Варианты:

• false ← (по умолчанию)
• true

state

string

Создать или удалить раздел.

Если задано значение info, модуль только возвращает информацию об устройстве.

Варианты:

• "absent"
• "present"
• "info" ← (по умолчанию)

unit

string

Выбирает текущую единицу измерения по умолчанию, которую Parted использует для отображения расположения и емкости на диске, а также для интерпретации введенных пользователем значений, если к ним не добавлена единица измерения.

При получении информации о диске рекомендуется всегда указывать единицу измерения.

Параметр unit_preserve_case управляет регистром единиц измерения в возвращаемых значениях. Ранее все единицы возвращались в нижнем регистре, но с помощью этого параметра можно вернуть текст единиц точно в том виде, в котором они указаны в вариантах unit.

Варианты:

• "s"
• "B"
• "KB"
• "KiB" ← (по умолчанию)
• "MB"
• "MiB"
• "GB"
• "GiB"
• "TB"
• "TiB"
• "%"
• "cyl"
• "chs"
• "compact"

unit_preserve_case

boolean

добавлено в community.general 12.6.0

Управляет регистром поля unit в выводе модуля (partition_info.disk.unit, partition_info.partitions[].unit).

Если задано значение true, единица измерения возвращается с исходным смешанным регистром, например KiB или MiB. Это соответствует значениям, принимаемым unit, поэтому вывод можно безопасно передавать обратно в качестве входных данных.

Если задано значение false, единица измерения возвращается в нижнем регистре (старое поведение), например kib или mib.

Варианты:

• false ← (по умолчанию)
• true

check_mode

Поддержка: полная

Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект.

diff_mode

Поддержка: нет

В режиме сравнения возвращает сведения об изменениях (или о возможных изменениях в check_mode).

disk

dictionary

Общие сведения об устройстве.

Возвращается: при успешном выполнении

Пример: {"dev": "/dev/sdb", "logical_block": 512, "model": "VMware Virtual disk", "physical_block": 512, "size": 5.0, "table": "msdos", "unit": "GiB"}

partitions

list / элементы=dictionary

Список разделов устройства.

Возвращается: при успешном выполнении

Пример: [{"begin": 0.0, "end": 1.0, "flags": ["boot", "lvm"], "fstype": "", "name": "", "num": 1, "size": 1.0}, {"begin": 1.0, "end": 5.0, "flags": [], "fstype": "", "name": "", "num": 2, "size": 4.0}]

script

string

Сценарий Parted, выполненный модулем.

Возвращается: при успешном выполнении

Пример: "unit KiB print "