pve_role_create
Create a custom role with optional privilege set. Dry-run by default; use confirm=True to execute.
Instructions
MUTATION: create a custom role with an optional privilege set. Dry-run by default (MEDIUM risk — inert until an ACL entry references it). confirm=True executes and returns a dict, synchronous with no UPID. privs format: comma-separated privilege names (e.g. 'VM.PowerMgmt,VM.Config.Disk'). Use pve_acl_modify to assign the new role to a principal.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| privs | No | Comma-separated privilege names for the role, e.g. 'VM.PowerMgmt,VM.Config.Disk'. | |
| roleid | Yes | New role id. | |
| confirm | No | False (default) returns a dry-run PLAN preview; True executes the mutation. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |