Documentation

parted

Manage disk partitions using parted.

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
device	true	string		The block device (e.g., /dev/sdb).
number		integer		The partition number (1-128 for GPT, 1-4 for MBR).
state		string	present absent info	Desired state of the partition. If present, create the partition if it doesn’t exist. If absent, remove the partition if it exists. If info, return information about partitions on the device. [default: `"info"`]
part_start		string		Start of the partition (e.g., “0%”, “1GB”, “100MB”). [default: `"0%"`]
part_end		string		End of the partition (e.g., “100%”, “10GB”, “500MB”). [default: `"100%"`]
fs_type		string		Filesystem type for the partition (e.g., ext4, xfs, fat32).
label		string		Disk label type (e.g., gpt, msdos). Only used when creating a new partition table.

Example

- name: Create partition
  parted:
    device: /dev/sdb
    number: 1
    state: present
    part_start: 0%
    part_end: 100%

- name: Create partition with filesystem type
  parted:
    device: /dev/sdb
    number: 2
    state: present
    part_start: 50%
    part_end: 100%
    fs_type: ext4

- name: Remove partition
  parted:
    device: /dev/sdb
    number: 1
    state: absent

- name: Get partition info
  parted:
    device: /dev/sdb
    state: info
  register: part_info