Boundary
groups
Command: boundary groups
The groups
command lets you create and manage group resources in Boundary.
A group in Boundary is a resource that represents a collection of users that are treated equally for the purposes of access control. A group is a principal, which means it can be assigned to roles. Roles assigned to a group are indirectly assigned to the users in the group, and users receive all permissions of the assigned roles. You can define groups at the global, organization, or project scope.
Examples
The following example creates a group, group01
in a scope with the id o_R0wbo0H6Zl
:
$ boundary groups create -name "group01" \
-description "A test group" \
-scope-id o_R0wbo0H6Zl
Example output:
Group information:
Created Time: Thu, 24 Aug 2023 09:51:44 PDT
Description: A test group
ID: g_XzlDiNLgoz
Name: group01
Updated Time: Thu, 24 Aug 2023 09:51:44 PDT
Version: 1
Scope:
ID: o_R0wbo0H6Zl
Name: quick-start-org
Parent Scope ID: global
Type: org
Authorized Actions:
no-op
read
update
delete
add-members
set-members
remove-members
Usage
Usage: boundary groups [sub command] [options] [args]
# ...
Subcommands:
add-members Add members to a group
create Create a group
delete Delete a group
list List a group
read Read a group
remove-members Remove members from a group
set-members Set the full contents of the members on a group
update Update a group
For more information, examples, and usage, click on the name of the subcommand in the sidebar or one of the links below: