metalcloud-cli role

Manage user roles and permissions

Synopsis

Manage user roles and permissions in the MetalCloud platform.

Roles define sets of permissions that can be assigned to users to control access to various platform features and resources. This command group provides operations to list, view, create, update, and delete roles.

Available operations: list - List all available roles get - View detailed information about a specific role create - Create a new role with specified permissions update - Update an existing role’s permissions or metadata delete - Remove a role from the system

Examples:

List all roles

metalcloud-cli role list

View details of a specific role

metalcloud-cli role get admin-role

Create a new role from a JSON file

metalcloud-cli role create –config-source role-config.json

Update a role using piped JSON

echo ‘{“permissions”: [“read”, “write”]}’ | metalcloud-cli role update my-role –config-source pipe

Options

  -h, --help   help for role

Options inherited from parent commands

  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")

SEE ALSO

Auto generated by spf13/cobra on 11-Aug-2025