index.mdx

layout	page_title	description
docs	roles - Command	The "roles" command lets you perform operations on Boundary role resources.

roles

Command: boundary roles

The roles command lets you perform operations on Boundary role resources.

Example

The following command creates a role with the name prodops and the description For ProdOps usage:

$ boundary roles create -name prodops -description "For ProdOps usage"

Usage

Usage: boundary roles <subcommand> [options] [args]
  # ...
Subcommands:
    add-grant-scopes     Add grant scopes to a role
    add-grants           Add grants to a role
    add-principals       Add principals (users, groups) to a role
    create               Create a role
    delete               Delete a role
    list                 List a role
    read                 Read a role
    remove-grant-scopes  Remove grant scopes from a role
    remove-grants        Remove grants from a role
    remove-principals    Remove principals (users, groups) from a role
    set-grant-scopes     Set the full contents of grant scopes on a role
    set-grants           Set the full contents of the grants on a role
    set-principals       Set the full contents of the principals (users, groups) on a role
    update               Update a role

For more information, examples, and usage, click on the name of the subcommand in the sidebar or one of the links below:

• add-grant-scopes
• add-grants
• add-principals
• create
• delete
• list
• read
• remove-grant-scopes
• remove-grants
• remove-principals
• set-grant-scopes
• set-grants
• set-principals
• update