Documentation
PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.19
Documentation for other releases can be found by using the version selector in the top right of any doc page.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). | |
| 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. | ||
| number | integer | The partition number (1-128 for GPT, 1-4 for MBR). | ||
| part_end | string | End of the partition (e.g., “100%”, “10GB”, “500MB”). [default: "100%"] |
||
| part_start | string | Start of the partition (e.g., “0%”, “1GB”, “100MB”). [default: "0%"] |
||
| 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"] |
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