> ## Documentation Index
> Fetch the complete documentation index at: https://gns3util.saygex.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Gns3util cluster control roles

## gns3util cluster-control roles

Manage control-plane roles in etcd

### Synopsis

List, inspect, create, update, and delete role definitions stored in etcd.

```
gns3util cluster-control roles [flags]
```

### Options

```
  -h, --help   help for roles
```

### Options inherited from parent commands

```
  -c, --cluster string      Cluster name from keyfile. Mutually exclusive with --server
  -i, --insecure            Ignore unsigned SSL-Certificates. Can be set via GNS3_INSECURE
  -k, --key-file string     Path to authentication keyfile. Can be set via GNS3_KEY_FILE or config.toml
  -o, --output string       Output format: [json, json-colorless, collapsed, yaml, toml, table, table-ascii]. Can be set via GNS3_OUTPUT (default "table")
  -s, --server string       GNS3v3 Server URL. Can be set via GNS3_SERVER or config.toml
      --user string[="~"]   User to select from the keyfile. Omit the value to open a fuzzy picker (--user), or pass a name (--user alice).
```

### SEE ALSO

* [gns3util cluster-control](gns3util_cluster-control.md)	 - gns3util control plane operations
* [gns3util cluster-control roles create](gns3util_cluster-control_roles_create.md)	 - Create a new role in etcd
* [gns3util cluster-control roles delete](gns3util_cluster-control_roles_delete.md)	 - Delete a role from etcd
* [gns3util cluster-control roles get](gns3util_cluster-control_roles_get.md)	 - Get a role's details from etcd
* [gns3util cluster-control roles list](gns3util_cluster-control_roles_list.md)	 - List all roles in etcd
* [gns3util cluster-control roles update](gns3util_cluster-control_roles_update.md)	 - Replace a role's description and scopes in etcd

###### Auto generated by spf13/cobra on 9-May-2026